diff options
Diffstat (limited to 'scripts/poky-qemu.README')
-rw-r--r-- | scripts/poky-qemu.README | 90 |
1 files changed, 0 insertions, 90 deletions
diff --git a/scripts/poky-qemu.README b/scripts/poky-qemu.README deleted file mode 100644 index ecceae9784..0000000000 --- a/scripts/poky-qemu.README +++ /dev/null | |||
@@ -1,90 +0,0 @@ | |||
1 | Poky images with QEMU | ||
2 | ===================== | ||
3 | |||
4 | Poky can generate qemu bootable kernels and images with can be used | ||
5 | on a desktop system. Both arm and x86 images can currently be booted. | ||
6 | There are two scripts, runqemu and poky-qemu, one for use within poky, | ||
7 | the other externally. | ||
8 | |||
9 | QEMU outside Poky (poky-qemu) | ||
10 | ============================= | ||
11 | |||
12 | The poky-qemu script is run as: | ||
13 | |||
14 | MACHINE=<machine> poky-qemu <zimage> <filesystem> | ||
15 | |||
16 | where: | ||
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 | |||
22 | The MACHINE=<machine> prefix is optional and without it the script will try | ||
23 | to detect the machine name from the name of the <zimage> file. | ||
24 | |||
25 | If <filesystem> isn't specified, nfs booting will be assumed. | ||
26 | |||
27 | |||
28 | QEMU within Poky (runqemu) | ||
29 | ========================== | ||
30 | |||
31 | The runqemu script is run as: | ||
32 | |||
33 | runqemu <target> <type> <zimage> <filesystem> | ||
34 | |||
35 | where: | ||
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 | |||
42 | It will default to the qemuarm, ext2 and the last kernel and poky-image-sdk | ||
43 | image built by poky. | ||
44 | |||
45 | |||
46 | Notes | ||
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 | |||
62 | NFS Image Notes | ||
63 | =============== | ||
64 | |||
65 | As root; | ||
66 | |||
67 | % apt-get install nfs-kernel-server | ||
68 | |||
69 | % mkdir /srv/nfs/qemuarm | ||
70 | |||
71 | Edit 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 | |||
81 | untar build/tmp/deploy/images/<built image>.rootfs.tar.bz2 into /srv/nfs/qemuarm | ||
82 | |||
83 | Finally, launch: | ||
84 | |||
85 | % runqemu <target> nfs | ||
86 | |||
87 | (Substitute qemux86 for qemuarm when using qemux86) | ||
88 | |||
89 | |||
90 | Copyright (C) 2006-2008 OpenedHand Ltd. | ||