diff options
author | Richard Purdie <richard.purdie@linuxfoundation.org> | 2011-04-20 16:44:10 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2011-04-20 16:44:10 +0100 |
commit | 7687d91f73f4a116593315b3b1488ac3f0904905 (patch) | |
tree | 8a00b11e6efc7a37427b03704b9fb59461afc8a5 /scripts/runqemu.README | |
parent | fa6176219b741eed346b21a3d923e9abc9b5442a (diff) | |
download | openembedded-core-contrib-7687d91f73f4a116593315b3b1488ac3f0904905.tar.gz |
Rename poky-qemu to runqemu
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'scripts/runqemu.README')
-rw-r--r-- | scripts/runqemu.README | 90 |
1 files changed, 90 insertions, 0 deletions
diff --git a/scripts/runqemu.README b/scripts/runqemu.README new file mode 100644 index 00000000000..12f1191ab75 --- /dev/null +++ b/scripts/runqemu.README @@ -0,0 +1,90 @@ +Poky images with QEMU +===================== + +Poky can generate qemu bootable kernels and images with can be used +on a desktop system. Both arm and x86 images can currently be booted. +There are two scripts, runqemu and runqemu, one for use within poky, +the other externally. + +QEMU outside Poky (runqemu) +============================= + +The runqemu script is run as: + + MACHINE=<machine> runqemu <zimage> <filesystem> + +where: + + <zimage> is the path to a kernel (e.g. zimage-qemuarm.bin) + <filesystem> is the path to an ext2 image (e.g. filesystem-qemuarm.ext2) + <machine> is "qemuarm" or "qemux86" + +The MACHINE=<machine> prefix is optional and without it the script will try +to detect the machine name from the name of the <zimage> file. + +If <filesystem> isn't specified, nfs booting will be assumed. + + +QEMU within Poky (runqemu) +========================== + +The runqemu script is run as: + + runqemu <target> <type> <zimage> <filesystem> + +where: + + <target> is "qemuarm","qemux86","nokia800","spitz" or "akita" + <type> is "ext2", "nfs", "ext3" or "jffs2". (not all machines support all options) + <zimage> is the path to a kernel (e.g. zimage-qemuarm.bin) + <filesystem> is the path to the image (e.g. filesystem-qemuarm.ext2) + +It will default to the qemuarm, ext2 and the last kernel and poky-image-sdk +image built by poky. + + +Notes +===== + + - The scripts run qemu using sudo. Change perms on /dev/net/tun to + run as non root + - You can access the host computer at 192.168.7.1 within the image. + - Your qemu system will be accessible as 192.16.7.2. + - The default NFS mount points are /srv/nfs/qemux86 or /srv/nfs/qemuarm + depending on the target type. + - Images built for qemux86/qemuarm contain NFS server which export whole + rootfs (/) in read/write mode. + - You can set QEMU_MEMORY to control amount of available memory (default 64M). + - You can set SERIAL_LOGFILE to have the serial output from the image logged + to a file. + + +NFS Image Notes +=============== + +As root; + +% apt-get install nfs-kernel-server + +% mkdir /srv/nfs/qemuarm + +Edit via /etc/exports : + +# /etc/exports: the access control list for filesystems which may be exported +# to NFS clients. See exports(5). +/srv/nfs/qemuarm 192.168.7.2(rw,no_root_squash) + +% /etc/init.d/nfs-kernel-server restart + +% modprobe tun + +untar build/tmp/deploy/images/<built image>.rootfs.tar.bz2 into /srv/nfs/qemuarm + +Finally, launch: + +% runqemu <target> nfs + +(Substitute qemux86 for qemuarm when using qemux86) + + + Copyright (C) 2006-2008 OpenedHand Ltd. |