]>
Commit | Line | Data |
---|---|---|
01ec9f08 RP |
1 | Using OE images with QEMU |
2 | ========================= | |
990788b2 | 3 | |
217b00d3 | 4 | OE-Core can generate qemu bootable kernels and images which can be used |
01ec9f08 | 5 | on a desktop system. The scripts currently support booting ARM, MIPS, PowerPC |
217b00d3 UÖ |
6 | and x86 (32 and 64 bit) images. The scripts can be used within the OE build |
7 | system or externally. | |
990788b2 | 8 | |
217b00d3 | 9 | The runqemu script is run as: |
990788b2 | 10 | |
01ec9f08 | 11 | runqemu <machine> <zimage> <filesystem> |
990788b2 RP |
12 | |
13 | where: | |
14 | ||
01ec9f08 | 15 | <machine> is the machine/architecture to use (qemuarm/qemumips/qemuppc/qemux86/qemux86-64) |
990788b2 | 16 | <zimage> is the path to a kernel (e.g. zimage-qemuarm.bin) |
01ec9f08 | 17 | <filesystem> is the path to an ext2 image (e.g. filesystem-qemuarm.ext2) or an nfs directory |
217b00d3 UÖ |
18 | |
19 | If <machine> isn't specified, the script will try to detect the machine name | |
01ec9f08 | 20 | from the name of the <zimage> file. |
990788b2 RP |
21 | |
22 | If <filesystem> isn't specified, nfs booting will be assumed. | |
23 | ||
217b00d3 | 24 | When used within the build system, it will default to qemuarm, ext2 and the last kernel and |
01ec9f08 RP |
25 | core-image-sato-sdk image built by the build system. If an sdk image isn't present it will look |
26 | for sato and minimal images. | |
990788b2 | 27 | |
01ec9f08 | 28 | Full usage instructions can be seen by running the command with no options specified. |
990788b2 RP |
29 | |
30 | ||
31 | Notes | |
32 | ===== | |
33 | ||
217b00d3 | 34 | - The scripts run qemu using sudo. Change perms on /dev/net/tun to |
01ec9f08 RP |
35 | run as non root. The runqemu-gen-tapdevs script can also be used by |
36 | root to prepopulate the appropriate network devices. | |
990788b2 | 37 | - You can access the host computer at 192.168.7.1 within the image. |
35d2cb0c | 38 | - Your qemu system will be accessible as 192.168.7.2. |
01ec9f08 RP |
39 | - 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. | |
8142b95b | 42 |