linuxppc CI scripts

Scripts I use to do continuous integration for linuxppc.

Still (and probably always) under heavy development.

Quick start

Make sure you can run containers.

On Ubuntu the scripts will use docker, on Fedora they will use podman.

You need a Linux source tree, which hasn't been built in. You can make sure it's clean with make mrproper, or clone a fresh tree.

Clone this repo.

$ cd ci-scripts
$ cd build
$ make pull-image@ppc64le@ubuntu
$ make SRC=~/src/linux kernel@ppc64le@ubuntu JFACTOR=$(nproc)

This will build you a ppc64le_defconfig using the latest Ubuntu toolchain.

The kernel will be in output/ppc64le@ubuntu/ppc64le_defconfig/vmlinux.

For more help try make help.

Building different defconfigs

You can specify a defconfig with DEFCONFIG.

$ make SRC=~/src/linux kernel@ppc64le@ubuntu DEFCONFIG=powernv_defconfig JFACTOR=$(nproc)

Note that the subarch (eg. ppc64le) needs to match the defconfig, so to build ppc64_defconfig, use ppc64.

$ make SRC=~/src/linux kernel@ppc64@ubuntu DEFCONFIG=ppc64_defconfig JFACTOR=$(nproc)

Different toolchains

There are images for various toolchains, they are encoded in the distro name/version.

• [email protected]: kernel.org gcc 14.2.0, binutils 2.42
• [email protected]: kernel.org gcc 14.1.0, binutils 2.42
• [email protected]: kernel.org gcc 13.1.0, binutils 2.42
• [email protected]: kernel.org gcc 13.1.0, binutils 2.41
• [email protected]: kernel.org gcc 13.1.0, binutils 2.40
• [email protected]: kernel.org gcc 12.3.0, binutils 2.42
• [email protected]: kernel.org gcc 12.3.0, binutils 2.40
• [email protected]: kernel.org gcc 12.2.0, binutils 2.39
• [email protected]: kernel.org gcc 12.1.0, binutils 2.38
• [email protected]: kernel.org gcc 11.3.0, binutils 2.38
• [email protected]: kernel.org gcc 11.1.0, binutils 2.36.1
• [email protected]: kernel.org gcc 10.3.0, binutils 2.36.1
• [email protected]: kernel.org gcc 9.4.0, binutils 2.36.1
• [email protected]: kernel.org gcc 9.3.0, binutils 2.34
• [email protected]: kernel.org gcc 8.5.0, binutils 2.36.1
• [email protected]: kernel.org gcc 8.1.0, binutils 2.30
• [email protected]: kernel.org gcc 5.5.0, binutils 2.29.1
• [email protected]: Ubuntu 24.04, gcc 13.2.0, binutils 2.42
• [email protected]: Ubuntu 22.04, gcc 11.2.0, binutils 2.38
• [email protected]: Ubuntu 21.10, gcc 11.2.0, binutils 2.37
• [email protected]: Ubuntu 21.04, gcc 10.3.0, binutils 2.36.1
• [email protected]: Ubuntu 20.04, gcc 9.4.0, binutils 2.34
• [email protected]: Ubuntu 18.04, gcc 7.5.0, binutils 2.30
• [email protected]: Ubuntu 16.04, gcc 5.4.0, binutils 2.26.1
• fedora@40: Fedora 40, gcc 14.0.1, binutils 2.41-34, clang 18.1.1
• fedora@39: Fedora 39, gcc 13.2.1, binutils 2.40-14, clang 17.0.6
• fedora@38: Fedora 38, gcc 12.2.1, binutils 2.39-3, clang 16.0.2
• fedora@37: Fedora 37, gcc 12.2.1, binutils 2.38-5, clang 15.0.7
• fedora@36: Fedora 36, gcc 12.1.1, binutils 2.37-7, clang 14.0.5
• fedora@35: Fedora 35, gcc 11.2.1, binutils 2.37-3, clang 13.0.1
• fedora@34: Fedora 34, gcc 11.2.1, binutils 2.35.2, clang 12.0.1
• fedora@33: Fedora 33, gcc 10.2.1, binutils 2.35.1, clang 11.0.0
• fedora@31: Fedora 31, gcc 9.2.1, binutils 2.32, clang 9.0.1

Only the Ubuntu toolchains can build the selftests.

Building selftests

To build the kernel selftests:

$ make SRC=~/src/linux selftests@ppc64le@ubuntu JFACTOR=$(nproc)

Or just the powerpc selftests:

$ make SRC=~/src/linux ppctests@ppc64le@ubuntu JFACTOR=$(nproc)

You can also build the powerpc selftests with all available toolchains using:

$ make SRC=~/src/linux ppctests JFACTOR=$(nproc)

Other options

As mentioned above you pass the make -j factor with JFACTOR=n.

To run sparse use the ubuntu image and pass SPARSE=2.

$ make SRC=~/src/linux kernel@ppc64le@ubuntu SPARSE=2 JFACTOR=$(nproc)

The log will be in eg. output/ppc64le@ubuntu/ppc64le_defconfig/sparse.log.

To only run sparse on files being recompiled, pass SPARSE=1.

To build modules pass MODULES=1

To convert all modules to builtin, pass MOD2YES=1.

To build with clang pass CLANG=1, only works using the latest Fedora or Ubuntu image.

For a quiet build pass QUIET=1, for verbose pass VERBOSE=1.

By default the script does an incremental build, ie. it doesn't clean. You can clean before building by passing PRE_CLEAN=1, or afterward with POST_CLEAN=1.

Alternately you can clean everything with make clean.

Multiple builds

If you have enough CPU and disk space, you can run multiple builds at once. The output directory is namespaced based on the subarch, distro, version, and defconfig.

Building your own image

If you don't want to pull an untrusted image, you can build it yourself with:

$ make rebuild-image@ppc64le@ubuntu

Note that the build mounts the source tree read-only, so nothing it does can affect your source tree.

Bisecting the kernel vs a selftest

Build the selftests using a version of the test that's known good. Usually there's no reason to rebuild the tests on every kernel revision.

These examples are run from the kernel directory, not the ci-scripts directory. It can be done either way, but it's more natural to run from the kernel directory when bisectting the kernel. This assumes Linux is in ~/linux and these scripts are in ~/ci-scripts, adapt as appropriate.

$ cd ~/linux

$ make SRC=$PWD -C ~/ci-scripts/build QUIET=1 JFACTOR=$(nproc) ppctests@ppc64le@[email protected] INSTALL=1

🚨 Using an old Ubuntu image uses an older libc, which is more likely to be present on the guest root filesystem. Another option is to build the selftests statically.

Tar up the selftests into the current directory, the qemu scripts will detect them:

$ tar -czf selftests.tar.gz -C $HOME/ci-scripts/build/output/selftests_powerpc@ppc64le@[email protected]/ install

$ ~/ci-scripts/scripts/boot/qemu-pseries+kvm --callback "run_selftests(powerpc/mm:wild_bctr)"
...
INFO: Running 'qemu-system-ppc64 -nographic -vga none -M pseries -smp 8 -m 4G -accel kvm ...
...
/ # INFO: Running individual selftests powerpc/mm:wild_bctr
/var/tmp/selftests/run_kselftest.sh -t powerpc/mm:wild_bctr
[    2.783761][  T201] kselftest: Running tests in powerpc
TAP version 13
1..1
# timeout set to 300
# selftests: powerpc/mm: wild_bctr
# test: wild_bctr
# tags: git_version:v6.8-rc6-2555-gfe559db
# Everything is OK in here.
...
# success: wild_bctr
ok 1 selftests: powerpc/mm: wild_bctr
/ # poweroff
/ # Stopping network: [    3.104385][  T274] ip (274) used greatest stack depth: 10912 bytes left
OK
Saving random seed: OK
Stopping klogd: OK
Stopping syslogd: OK
umount: devtmpfs busy - remounted read-only
umount: can't unmount /: Invalid argument
The system is going down NOW!
Sent SIGTERM to all processes
Sent SIGKILL to all processes
Requesting system poweroff
[    5.152672][  T293] reboot: Power down
INFO: Test completed OK

More than one selftest can be run by passing multiple arguments to run_selftests or by passing multiple --callback options.

From there the bisection can either be run by hand, or fully automated by creating a script to build the kernel and run the qemu test.