xref: /freebsd/tools/boot/full-test.readme (revision 7ef62cebc2f965b0f640263e179276928885e33d)
1First, you will need a few things.
2
3(1) a small cache of binaries. You'll need to put these into
4 ~/stand-test-root/cache. You can find the tarball at
5 freefall.freebsd.org:~imp/cache.tar. You can just extract this in ~. These are
6 the linux kernels I'm testing with.
7
8(2) The latest qemu-system-aarch64 (I think ports/pkg version of emulators/qemu
9 is recent enough). If not, I know the latest master of qemu project works.
10
11(3) A recent enough universe that the building of stand will work for all the
12 architectures that I build. You can hack the ARCHES line near the top of
13 tools/boot/full-test.sh if need be, but you'll need at least amd64, arm64 and
14 maybe riscv (I don't have a good way to filter arches in this script yet, since
15 it's at an early state of development.
16
17(4) Build the kernel for at least arm64 and use it as an 'override'. I do this
18 by sudo -E make installkernel
19 DESTDIR=$HOME/stand-test-root/override/arm64-aarch64 TARGET=arm64 after
20 building the kernel. The script is designed to use kernels and binaries from
21 the latest CDs to do the testing, but has a way to override the kernel and
22 since we need to fix arm64...
23
24(5) You'll need to build the images. If you've done 1-5 correctly (and I've not
25 missed anything), then "cd <mumble>/src; sh tools/boot/full-test.sh" will create
26 all the images and scripts to run qemu. There should be no errors, though
27 warnings about zfs.ko etc missing from powerpc is fine (and ignored by the
28 script already).
29
30(6) There will be a script to recreate this created in
31 $HOME/stand-test-root/scripts/arm64-aarch64/linuxboot-test.sh. Just run it with
32 'sh'. And extra args are passed to qemu, so '-s -S' for gdb and
33 '-d trace:gicv3\* -D /tmp/gic.log' for verbose gic tracing (spaces are important).
34
35There's also a linuxboot-test-raw.sh which boots w/o EDK2+Linux.efi but loads
36the kernel directly. and freebsd-test.sh which uses EDK2+loader.efi to boot FreeBSD
37w/o kboot at all.
38