summaryrefslogtreecommitdiffstats
path: root/scripts/runqemu.README
diff options
context:
space:
mode:
authorRichard Purdie <richard@openedhand.com>2006-11-17 11:08:32 +0000
committerRichard Purdie <richard@openedhand.com>2006-11-17 11:08:32 +0000
commit4a9392f5a3295b900eebc81fd6fd64a8029525df (patch)
tree9211a76434c7cf72cbe4b55b4320d9574089bc3b /scripts/runqemu.README
parentf4a8621a19550e4168a45e69386c82f031aa37f1 (diff)
downloadopenembedded-core-4a9392f5a3295b900eebc81fd6fd64a8029525df.tar.gz
openembedded-core-4a9392f5a3295b900eebc81fd6fd64a8029525df.tar.bz2
openembedded-core-4a9392f5a3295b900eebc81fd6fd64a8029525df.zip
Improve the qemu scripts and documentation (qemux86 support isn't complete yet)
git-svn-id: https://svn.o-hand.com/repos/poky/trunk@867 311d38ba-8fff-0310-9ca6-ca027cbcb966
Diffstat (limited to 'scripts/runqemu.README')
-rw-r--r--scripts/runqemu.README59
1 files changed, 59 insertions, 0 deletions
diff --git a/scripts/runqemu.README b/scripts/runqemu.README
new file mode 100644
index 0000000000..713e273946
--- /dev/null
+++ b/scripts/runqemu.README
@@ -0,0 +1,59 @@
+Using qemu with poky notes
+==========================
+
+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.
+The runqemu script is run as:
+
+ runqemu <target> <type> <zimage> <filesystem>
+
+where:
+
+ <target> is "qemuarm" or "qemux86"
+ <type> is "ext2" or "nfs"
+ <zimage> is the path to a kernel (zimage-qemuarm.bin)
+ <filesystem> is the path to an ext2 image (filesystem-qemuarm.ext2)
+
+It will default to the qemuarm, ext2 and the last kernel and oh-image-pda
+image built by poky.
+
+NFS Image Notes
+===============
+
+As root;
+
+% apt-get install nfs-kernel-server
+
+% mkdir /srv/qemuarm
+
+Edit via /etc/exports :
+
+# /etc/exports: the access control list for filesystems which may be exported
+# to NFS clients. See exports(5).
+/srv/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/qemuarm
+
+Finally, launch:
+
+% runqemu <target> nfs
+
+Notes
+=====
+
+ - The runqemu script runs qemu with sudo. Change perms on /dev/net/tun to
+ run as non root
+ - You can set QEMU_MEMORY env var to control amount of available memory
+ ( defaults to 64M )
+ - There is a bug in qemu in that means occasionally it will use 100% cpu.
+ You will need to restart it in this situation.
+
+More Info
+=========
+
+ - See http://o-hand.com/~richard/qemu.html
+