runqemu.README 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. Using OE images with QEMU
  2. =========================
  3. OE-Core can generate qemu bootable kernels and images with can be used
  4. on a desktop system. The scripts currently support booting ARM, MIPS, PowerPC
  5. and x86 (32 and 64 bit) images. The scripts can be used within the OE build
  6. system or externaly.
  7. The runqemu script is run as:
  8. runqemu <machine> <zimage> <filesystem>
  9. where:
  10. <machine> is the machine/architecture to use (qemuarm/qemumips/qemuppc/qemux86/qemux86-64)
  11. <zimage> is the path to a kernel (e.g. zimage-qemuarm.bin)
  12. <filesystem> is the path to an ext2 image (e.g. filesystem-qemuarm.ext2) or an nfs directory
  13. If <machine> isn't specified, the script will try to detect the machine name
  14. from the name of the <zimage> file.
  15. If <filesystem> isn't specified, nfs booting will be assumed.
  16. When used within the build system, it will default to qemuarm, ext2 and the last kernel and
  17. core-image-sato-sdk image built by the build system. If an sdk image isn't present it will look
  18. for sato and minimal images.
  19. Full usage instructions can be seen by running the command with no options specified.
  20. Notes
  21. =====
  22. - The scripts run qemu using sudo. Change perms on /dev/net/tun to
  23. run as non root. The runqemu-gen-tapdevs script can also be used by
  24. root to prepopulate the appropriate network devices.
  25. - You can access the host computer at 192.168.7.1 within the image.
  26. - Your qemu system will be accessible as 192.168.7.2.
  27. - The script extracts the root filesystem specified under pseudo and sets up a userspace
  28. NFS server to share the image over by default meaning the filesystem can be accessed by
  29. both the host and guest systems.