blob: e5f4b4634cba958302283539a8c0cf09952f90f4 [file] [log] [blame]
Patrick Williamsc124f4f2015-09-15 14:41:29 -05001Using OE images with QEMU
Patrick Williams92b42cb2022-09-03 06:53:57 -05004OE-Core can generate qemu bootable kernels and images which can be used
Patrick Williamsc124f4f2015-09-15 14:41:29 -05005on a desktop system. The scripts currently support booting ARM, MIPS, PowerPC
Patrick Williams92b42cb2022-09-03 06:53:57 -05006and x86 (32 and 64 bit) images. The scripts can be used within the OE build
7system or externally.
Patrick Williamsc124f4f2015-09-15 14:41:29 -05008
Patrick Williams92b42cb2022-09-03 06:53:57 -05009The runqemu script is run as:
Patrick Williamsc124f4f2015-09-15 14:41:29 -050010
11 runqemu <machine> <zimage> <filesystem>
15 <machine> is the machine/architecture to use (qemuarm/qemumips/qemuppc/qemux86/qemux86-64)
16 <zimage> is the path to a kernel (e.g. zimage-qemuarm.bin)
17 <filesystem> is the path to an ext2 image (e.g. filesystem-qemuarm.ext2) or an nfs directory
Patrick Williams92b42cb2022-09-03 06:53:57 -050018
19If <machine> isn't specified, the script will try to detect the machine name
Patrick Williamsc124f4f2015-09-15 14:41:29 -050020from the name of the <zimage> file.
22If <filesystem> isn't specified, nfs booting will be assumed.
Patrick Williams92b42cb2022-09-03 06:53:57 -050024When used within the build system, it will default to qemuarm, ext2 and the last kernel and
Patrick Williamsc124f4f2015-09-15 14:41:29 -050025core-image-sato-sdk image built by the build system. If an sdk image isn't present it will look
26for sato and minimal images.
28Full usage instructions can be seen by running the command with no options specified.
Patrick Williams92b42cb2022-09-03 06:53:57 -050034 - The scripts run qemu using sudo. Change perms on /dev/net/tun to
Patrick Williamsc124f4f2015-09-15 14:41:29 -050035 run as non root. The runqemu-gen-tapdevs script can also be used by
36 root to prepopulate the appropriate network devices.
37 - You can access the host computer at within the image.
Brad Bishopd7bf8c12018-02-25 22:55:05 -050038 - Your qemu system will be accessible as
Patrick Williamsc124f4f2015-09-15 14:41:29 -050039 - The script extracts the root filesystem specified under pseudo and sets up a userspace
40 NFS server to share the image over by default meaning the filesystem can be accessed by
41 both the host and guest systems.