| 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
|
|---|
