summaryrefslogtreecommitdiffstats
path: root/scripts/runqemu.README
diff options
context:
space:
mode:
authorRichard Purdie <richard.purdie@linuxfoundation.org>2011-04-20 15:44:10 (GMT)
committerRichard Purdie <richard.purdie@linuxfoundation.org>2011-04-20 23:29:29 (GMT)
commit08127d444e05d8d33ce39abdce677655bd4766ea (patch)
tree926947a62cc4b1cbed4afc31a717305de9b1c57d /scripts/runqemu.README
parent46d0cc3dc88307d69a7884c0e5c79e0c8d5e4dc7 (diff)
downloadpoky-08127d444e05d8d33ce39abdce677655bd4766ea.tar.gz
Rename poky-qemu to runqemu
(From OE-Core rev: 7687d91f73f4a116593315b3b1488ac3f0904905) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'scripts/runqemu.README')
-rw-r--r--scripts/runqemu.README90
1 files changed, 90 insertions, 0 deletions
diff --git a/scripts/runqemu.README b/scripts/runqemu.README
new file mode 100644
index 0000000..12f1191
--- /dev/null
+++ b/scripts/runqemu.README
@@ -0,0 +1,90 @@
1Poky images with QEMU
2=====================
3
4Poky can generate qemu bootable kernels and images with can be used
5on a desktop system. Both arm and x86 images can currently be booted.
6There are two scripts, runqemu and runqemu, one for use within poky,
7the other externally.
8
9QEMU outside Poky (runqemu)
10=============================
11
12The runqemu script is run as:
13
14 MACHINE=<machine> runqemu <zimage> <filesystem>
15
16where:
17
18 <zimage> is the path to a kernel (e.g. zimage-qemuarm.bin)
19 <filesystem> is the path to an ext2 image (e.g. filesystem-qemuarm.ext2)
20 <machine> is "qemuarm" or "qemux86"
21
22The MACHINE=<machine> prefix is optional and without it the script will try
23to detect the machine name from the name of the <zimage> file.
24
25If <filesystem> isn't specified, nfs booting will be assumed.
26
27
28QEMU within Poky (runqemu)
29==========================
30
31The runqemu script is run as:
32
33 runqemu <target> <type> <zimage> <filesystem>
34
35where:
36
37 <target> is "qemuarm","qemux86","nokia800","spitz" or "akita"
38 <type> is "ext2", "nfs", "ext3" or "jffs2". (not all machines support all options)
39 <zimage> is the path to a kernel (e.g. zimage-qemuarm.bin)
40 <filesystem> is the path to the image (e.g. filesystem-qemuarm.ext2)
41
42It will default to the qemuarm, ext2 and the last kernel and poky-image-sdk
43image built by poky.
44
45
46Notes
47=====
48
49 - The scripts run qemu using sudo. Change perms on /dev/net/tun to
50 run as non root
51 - You can access the host computer at 192.168.7.1 within the image.
52 - Your qemu system will be accessible as 192.16.7.2.
53 - The default NFS mount points are /srv/nfs/qemux86 or /srv/nfs/qemuarm
54 depending on the target type.
55 - Images built for qemux86/qemuarm contain NFS server which export whole
56 rootfs (/) in read/write mode.
57 - You can set QEMU_MEMORY to control amount of available memory (default 64M).
58 - You can set SERIAL_LOGFILE to have the serial output from the image logged
59 to a file.
60
61
62NFS Image Notes
63===============
64
65As root;
66
67% apt-get install nfs-kernel-server
68
69% mkdir /srv/nfs/qemuarm
70
71Edit via /etc/exports :
72
73# /etc/exports: the access control list for filesystems which may be exported
74# to NFS clients. See exports(5).
75/srv/nfs/qemuarm 192.168.7.2(rw,no_root_squash)
76
77% /etc/init.d/nfs-kernel-server restart
78
79% modprobe tun
80
81untar build/tmp/deploy/images/<built image>.rootfs.tar.bz2 into /srv/nfs/qemuarm
82
83Finally, launch:
84
85% runqemu <target> nfs
86
87(Substitute qemux86 for qemuarm when using qemux86)
88
89
90 Copyright (C) 2006-2008 OpenedHand Ltd.