blob: ecb63f9ef6d88aba07bf4a974895f339037d75a9
1 | How to test build using Aboriginal Linux system images. |
2 | |
3 | * Put a source tree into hdc.dir/. |
4 | For example, this should work: |
5 | git clone git://busybox.net/var/lib/git/busybox.git |
6 | |
7 | * Run ./make-hdc-img.sh: it will generate ext2 image file, |
8 | hdc.img, from hdc.dir/* data. This requires root for loop mount. |
9 | |
10 | * Download and unpack, or build from source and unpack |
11 | one or more system-image-ARCH directories into this directory |
12 | (the one which contains this README). |
13 | |
14 | * Install qemu-system-ARCH. The arch names may differ from |
15 | system-image-ARCH: for example, all ARM flavors (armv4l...armv6l) |
16 | are served by the same qemu - qemu-system-arm. On my machine, |
17 | I needed to install qemu-system-{arm,mips,x86,ppc,sparc,m68k,sh4}. |
18 | |
19 | * Run: ./parallel-build-hdc-img.sh system-image-DIR1 system-image-DIR2... |
20 | (background it if you don't want to see "Waiting to finish" thing). |
21 | This runs build in several qemu virtual machines in parallel. |
22 | |
23 | * Observe system-image-*.log file(s) with growing log of the build. |
24 | |
25 | There is no automated detection of errors for now: you need to examine |
26 | logs yourself. |
27 | |
28 | Log files will also contain uuencoded (or if all else fails, od -tx1'ed) |
29 | binary, if build was successful. |
30 | |
31 | To debug a build problem in one of the sandboxes, change keep_hdb |
32 | to "keep_hdb=true" in parallel-build-hdc-img.sh |
33 | - this preserves system-image-ARCH/hdb.img after the build, |
34 | so you can go into system-image-ARCH and run |
35 | "HDB=hdb.img ./dev-environment.sh" to debug the problem. |
36 | |
37 | You can also run "./parallel-build-hdc-img.sh -s system-image-ARCH" |
38 | - single mode, output is to screen and serial input is from keyboard. |
39 | |
40 | If hdc.dir/bin/busybox-$ARCH exists, it will be used during build |
41 | to supply additional tools (dir with all applets appended to $PATH). |
42 | |
43 | For me, the following system images worked: |
44 | system-image-armv4l |
45 | system-image-armv4tl |
46 | system-image-armv5l |
47 | od is buggy on arm*: |
48 | # echo Hello-hello-hello-hello | od -b |
49 | 0000000 110 145 154 154 157 055 150 145 154 154 157 055 150 145 154 154 |
50 | 0000000 157 055 150 145 154 154 157 012 <= WRONG OFFSET |
51 | 0000000 (can also be even more bogus like 17767153361) |
52 | system-image-i686 |
53 | system-image-mips - od is buggy |
54 | system-image-mipsel - od is buggy |
55 | system-image-x86_64 |
56 | system-image-powerpc - qemu 1.2.2 didn't work, 2.4.0 worked; od is buggy |
57 | system-image-sparc - qemu 1.2.2 didn't work, 2.4.0 worked; od is buggy |
58 | |
59 | And these did not: |
60 | system-image-armv6l - hang on "Uncompressing Linux... done, booting the kernel" |
61 | system-image-m68k - my qemu doesn't like "-M q800" |
62 | system-image-mips64 - init dies "Kernel panic - not syncing: Attempted to kill init! exitcode=0x0000000a" |
63 | system-image-sh4 - qemu segfaults early in kernel boot |
64 |