aboutsummaryrefslogtreecommitdiff
path: root/scripts/qemu
diff options
context:
space:
mode:
authorSoccera1 <[email protected]>2026-06-15 21:10:43 +1000
committerSoccera1 <[email protected]>2026-07-13 17:02:02 +1000
commit7ea75fb4424af8df393dd75dfb9b14a08aa46959 (patch)
tree52772fa63c7ae0581b44d0c0b164252934acf5f0 /scripts/qemu
downloadbnu-7ea75fb4424af8df393dd75dfb9b14a08aa46959.tar.gz
bnu-7ea75fb4424af8df393dd75dfb9b14a08aa46959.zip
Initial commit
Diffstat (limited to 'scripts/qemu')
-rwxr-xr-xscripts/qemu/build-payload.sh49
-rwxr-xr-xscripts/qemu/check-host.sh36
-rw-r--r--scripts/qemu/common.sh227
-rwxr-xr-xscripts/qemu/download-images.sh106
-rwxr-xr-xscripts/qemu/guest/provision-base.sh27
-rwxr-xr-xscripts/qemu/guest/provision-selinux.sh79
-rwxr-xr-xscripts/qemu/guest/provision-smack.sh33
-rwxr-xr-xscripts/qemu/guest/run-tests.sh41
8 files changed, 598 insertions, 0 deletions
diff --git a/scripts/qemu/build-payload.sh b/scripts/qemu/build-payload.sh
new file mode 100755
index 0000000..a9ab1fd
--- /dev/null
+++ b/scripts/qemu/build-payload.sh
@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# Build an unprivileged ext4 disk containing BNU, Bun, and the GNU tarball.
+
+set -Eeuo pipefail
+source "$(cd -- "$(dirname -- "$0")" && pwd)/common.sh"
+
+output=$BNU_QEMU_DIR/bnu-test-payload.ext4
+size=${BNU_QEMU_PAYLOAD_SIZE:-4G}
+while (($#)); do
+ case $1 in
+ --dry-run) BNU_QEMU_DRY_RUN=1 ;;
+ --output) [[ $# -ge 2 ]] || die "--output needs a path"; output=$2; shift ;;
+ --size) [[ $# -ge 2 ]] || die "--size needs a value"; size=$2; shift ;;
+ -h|--help)
+ printf 'usage: %s [--dry-run] [--output PATH] [--size 4G]\n' "$0"
+ exit 0
+ ;;
+ *) die "unknown argument: $1" ;;
+ esac
+ shift
+done
+
+for command in bun mkfs.ext4 truncate; do require_command "$command"; done
+ensure_state_dir
+[[ -r $BNU_REPO_ROOT/coreutils-9.11.tar.xz ]] || die "missing coreutils-9.11.tar.xz"
+bun_path=$(command -v bun)
+staging=$(mktemp -d "${TMPDIR:-/tmp}/bnu-payload.XXXXXX")
+cleanup() { rm -rf -- "$staging"; }
+trap cleanup EXIT HUP INT TERM
+
+run mkdir -p -- "$staging/bnu/repo" "$staging/bnu/bin" "$staging/bnu/artifacts"
+for entry in bin src scripts tests docs package.json README.md coreutils-9.11.tar.xz; do
+ [[ -e $BNU_REPO_ROOT/$entry ]] || continue
+ run cp -a -- "$BNU_REPO_ROOT/$entry" "$staging/bnu/repo/"
+done
+run cp -L -- "$bun_path" "$staging/bnu/bin/bun"
+selinux_stage=$BNU_QEMU_DIR/selinux/stage3-amd64-hardened-selinux-systemd.tar.xz
+if [[ -s $selinux_stage ]]; then
+ run cp -a -- "$selinux_stage" "$staging/bnu/artifacts/"
+fi
+if [[ $BNU_QEMU_DRY_RUN != 1 ]]; then
+ printf '%s\n' "$(git -C "$BNU_REPO_ROOT" rev-parse HEAD 2>/dev/null || printf unknown)" >"$staging/bnu/REVISION"
+fi
+
+run rm -f -- "$output.new"
+run truncate -s "$size" "$output.new"
+run mkfs.ext4 -q -F -L BNU_PAYLOAD -d "$staging" "$output.new"
+run mv -- "$output.new" "$output"
+note "payload ready: $output"
diff --git a/scripts/qemu/check-host.sh b/scripts/qemu/check-host.sh
new file mode 100755
index 0000000..8b0684d
--- /dev/null
+++ b/scripts/qemu/check-host.sh
@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Report host-side prerequisites without changing anything.
+
+set -Eeuo pipefail
+source "$(cd -- "$(dirname -- "$0")" && pwd)/common.sh"
+
+missing=0
+for command in bash bun qemu-img qemu-system-x86_64 ssh scp ssh-keygen curl gpg \
+ mkfs.ext4 timeout awk sort comm sha512sum tar xz; do
+ if command -v "$command" >/dev/null 2>&1; then
+ printf 'ok %s\n' "$command"
+ else
+ printf 'missing %s\n' "$command"
+ missing=1
+ fi
+done
+if command -v xorriso >/dev/null 2>&1 || command -v genisoimage >/dev/null 2>&1; then
+ printf 'ok xorriso or genisoimage\n'
+else
+ printf 'missing xorriso or genisoimage\n'
+ missing=1
+fi
+if [[ -r /dev/kvm && -w /dev/kvm ]]; then
+ printf 'ok /dev/kvm (read/write)\n'
+else
+ printf 'missing /dev/kvm access (KVM group membership may require a new login)\n'
+ missing=1
+fi
+if code=$(find_ovmf code 2>/dev/null) && vars=$(find_ovmf vars 2>/dev/null); then
+ printf 'ok OVMF code: %s\n' "$code"
+ printf 'ok OVMF vars: %s\n' "$vars"
+else
+ printf 'missing OVMF firmware (or set BNU_OVMF_CODE and BNU_OVMF_VARS)\n'
+ missing=1
+fi
+exit "$missing"
diff --git a/scripts/qemu/common.sh b/scripts/qemu/common.sh
new file mode 100644
index 0000000..4c6cc70
--- /dev/null
+++ b/scripts/qemu/common.sh
@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+# Shared, host-distro-neutral helpers for the BNU Gentoo QEMU test matrix.
+
+set -Eeuo pipefail
+
+BNU_REPO_ROOT=${BNU_REPO_ROOT:-$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/../.." && pwd)}
+BNU_QEMU_DIR=${BNU_QEMU_DIR:-/var/tmp/bnu-qemu}
+BNU_QEMU_MEMORY=${BNU_QEMU_MEMORY:-1536M}
+BNU_QEMU_CPUS=${BNU_QEMU_CPUS:-2}
+BNU_QEMU_SSH_PORT=${BNU_QEMU_SSH_PORT:-22222}
+BNU_QEMU_TIMEOUT=${BNU_QEMU_TIMEOUT:-900}
+BNU_QEMU_DRY_RUN=${BNU_QEMU_DRY_RUN:-0}
+
+note() { printf 'bnu-qemu: %s\n' "$*" >&2; }
+die() { note "$*"; exit 2; }
+
+require_command() {
+ command -v "$1" >/dev/null 2>&1 || die "missing required command: $1"
+}
+
+run() {
+ if [[ $BNU_QEMU_DRY_RUN == 1 ]]; then
+ printf '+ ' >&2
+ printf '%q ' "$@" >&2
+ printf '\n' >&2
+ else
+ "$@"
+ fi
+}
+
+ensure_state_dir() {
+ if [[ $BNU_QEMU_DRY_RUN == 1 ]]; then
+ note "would create state directory $BNU_QEMU_DIR"
+ return
+ fi
+ mkdir -p -- "$BNU_QEMU_DIR" 2>/dev/null ||
+ die "cannot write $BNU_QEMU_DIR; create it for this user or set BNU_QEMU_DIR"
+ [[ -w $BNU_QEMU_DIR ]] || die "state directory is not writable: $BNU_QEMU_DIR"
+}
+
+require_free_gib() {
+ local required=$1 available_kib available_gib
+ available_kib=$(df -Pk "$BNU_QEMU_DIR" | awk 'NR == 2 {print $4}')
+ [[ $available_kib =~ ^[0-9]+$ ]] || die "could not determine free space below $BNU_QEMU_DIR"
+ available_gib=$((available_kib / 1024 / 1024))
+ (( available_gib >= required )) ||
+ die "$BNU_QEMU_DIR has ${available_gib} GiB free; this setup phase requires at least ${required} GiB free"
+}
+
+require_kvm() {
+ [[ -e /dev/kvm ]] || die "/dev/kvm is absent; this matrix intentionally has no software-emulation fallback"
+ [[ -r /dev/kvm && -w /dev/kvm ]] ||
+ die "/dev/kvm is not accessible; add this user to the host's KVM group and start a new login session"
+}
+
+find_ovmf() {
+ local kind=$1 candidate
+ local -a code=(
+ /usr/share/edk2/OvmfX64/OVMF_CODE.fd
+ /usr/share/OVMF/OVMF_CODE.fd
+ /usr/share/OVMF/OVMF_CODE_4M.fd
+ /usr/share/edk2-ovmf/x64/OVMF_CODE.fd
+ /usr/share/edk2/ovmf/OVMF_CODE.fd
+ /usr/share/edk2/x64/OVMF_CODE.fd
+ )
+ local -a vars=(
+ /usr/share/edk2/OvmfX64/OVMF_VARS.fd
+ /usr/share/OVMF/OVMF_VARS.fd
+ /usr/share/OVMF/OVMF_VARS_4M.fd
+ /usr/share/edk2-ovmf/x64/OVMF_VARS.fd
+ /usr/share/edk2/ovmf/OVMF_VARS.fd
+ /usr/share/edk2/x64/OVMF_VARS.fd
+ )
+ local -a candidates
+ if [[ $kind == code ]]; then candidates=("${code[@]}"); else candidates=("${vars[@]}"); fi
+ for candidate in "${candidates[@]}"; do
+ [[ -r $candidate ]] && { printf '%s\n' "$candidate"; return; }
+ done
+ die "could not find OVMF $kind firmware; set BNU_OVMF_CODE and BNU_OVMF_VARS explicitly"
+}
+
+ovmf_code() { printf '%s\n' "${BNU_OVMF_CODE:-$(find_ovmf code)}"; }
+ovmf_vars() { printf '%s\n' "${BNU_OVMF_VARS:-$(find_ovmf vars)}"; }
+
+download() {
+ local url=$1 output=$2
+ [[ -s $output ]] && { note "using cached $(basename -- "$output")"; return; }
+ run curl --fail --location --retry 4 --retry-delay 2 --continue-at - --output "$output.part" "$url"
+ run mv -- "$output.part" "$output"
+}
+
+prepare_gnupg() {
+ local gnupg=$1 bundle=$BNU_QEMU_DIR/gentoo-service-keys.gpg
+ run mkdir -p -- "$gnupg"
+ if [[ $BNU_QEMU_DRY_RUN != 1 ]]; then chmod 700 "$gnupg"; fi
+ download https://qa-reports.gentoo.org/output/service-keys.gpg "$bundle"
+ run gpg --batch --homedir "$gnupg" --import "$bundle"
+}
+
+verify_detached() {
+ local gnupg=$1 signature=$2 artifact=$3
+ run gpg --batch --homedir "$gnupg" --status-fd 1 --verify "$signature" "$artifact"
+}
+
+create_overlay() {
+ local base=$1 overlay=$2
+ [[ -s $overlay ]] && { note "using existing overlay $overlay"; return; }
+ run qemu-img create -q -f qcow2 -F qcow2 -b "$base" "$overlay"
+}
+
+ensure_ssh_key() {
+ BNU_QEMU_SSH_KEY=${BNU_QEMU_SSH_KEY:-$BNU_QEMU_DIR/id_ed25519}
+ if [[ ! -s $BNU_QEMU_SSH_KEY ]]; then
+ run ssh-keygen -q -t ed25519 -N '' -f "$BNU_QEMU_SSH_KEY"
+ fi
+ export BNU_QEMU_SSH_KEY
+}
+
+create_seed_iso() {
+ local output=$1 seed_dir
+ [[ -s $output ]] && return
+ ensure_ssh_key
+ seed_dir=$(mktemp -d "${TMPDIR:-/tmp}/bnu-seed.XXXXXX")
+ trap 'rm -rf -- "$seed_dir"' RETURN
+ if [[ $BNU_QEMU_DRY_RUN != 1 ]]; then
+ cat >"$seed_dir/meta-data" <<EOF
+instance-id: bnu-gentoo
+local-hostname: bnu-gentoo
+EOF
+ cat >"$seed_dir/user-data" <<EOF
+#cloud-config
+disable_root: false
+ssh_pwauth: false
+users:
+ - name: root
+ lock_passwd: true
+ shell: /bin/bash
+ ssh_authorized_keys:
+ - $(<"$BNU_QEMU_SSH_KEY.pub")
+runcmd:
+ - [ sh, -c, 'touch /var/lib/bnu-cloud-ready' ]
+EOF
+ fi
+ if command -v xorriso >/dev/null 2>&1; then
+ run xorriso -as mkisofs -quiet -output "$output" -volid cidata -joliet -rock \
+ "$seed_dir/user-data" "$seed_dir/meta-data"
+ elif command -v genisoimage >/dev/null 2>&1; then
+ run genisoimage -quiet -output "$output" -volid cidata -joliet -rock \
+ "$seed_dir/user-data" "$seed_dir/meta-data"
+ else
+ die "missing xorriso or genisoimage (needed for the NoCloud seed)"
+ fi
+ trap - RETURN
+ rm -rf -- "$seed_dir"
+}
+
+ssh_options() {
+ printf '%s\0' -i "$BNU_QEMU_SSH_KEY" -p "$BNU_QEMU_SSH_PORT" \
+ -o BatchMode=yes -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null \
+ -o ConnectTimeout=5 -o ServerAliveInterval=15 -o ServerAliveCountMax=4
+}
+
+guest_ssh() {
+ local -a options=()
+ while IFS= read -r -d '' item; do options+=("$item"); done < <(ssh_options)
+ ssh "${options[@]}" [email protected] "$@"
+}
+
+guest_scp() {
+ local -a options=()
+ while IFS= read -r -d '' item; do options+=("$item"); done < <(ssh_options)
+ scp "${options[@]/-p/-P}" "$@"
+}
+
+wait_for_ssh() {
+ local deadline=$((SECONDS + BNU_QEMU_TIMEOUT))
+ while (( SECONDS < deadline )); do
+ if guest_ssh 'test -e /var/lib/bnu-cloud-ready || test -e /var/lib/bnu-provisioned' >/dev/null 2>&1; then
+ return
+ fi
+ sleep 2
+ done
+ die "guest SSH did not become ready within ${BNU_QEMU_TIMEOUT}s"
+}
+
+start_vm() {
+ local image=$1 name=$2 payload=${3:-} seed=${4:-} extra_disk=${5:-}
+ local run_dir=$BNU_QEMU_DIR/run/$name vars pidfile serial
+ require_kvm
+ require_command qemu-system-x86_64
+ require_command qemu-img
+ ensure_ssh_key
+ run mkdir -p -- "$run_dir"
+ vars=$run_dir/OVMF_VARS.fd
+ pidfile=$run_dir/qemu.pid
+ serial=$run_dir/serial.log
+ if [[ $BNU_QEMU_DRY_RUN != 1 && -s $pidfile ]] && kill -0 "$(<"$pidfile")" 2>/dev/null; then
+ die "VM $name is already running (pid $(<"$pidfile"))"
+ fi
+ run cp -- "$(ovmf_vars)" "$vars"
+ local -a drives=(
+ -drive "if=pflash,format=raw,readonly=on,file=$(ovmf_code)"
+ -drive "if=pflash,format=raw,file=$vars"
+ -drive "if=virtio,format=qcow2,file=$image,cache=writeback,discard=unmap"
+ )
+ [[ -n $payload ]] && drives+=( -drive "if=virtio,format=raw,readonly=on,file=$payload" )
+ [[ -n $extra_disk ]] && drives+=( -drive "if=virtio,format=qcow2,file=$extra_disk,cache=writeback,discard=unmap" )
+ [[ -n $seed ]] && drives+=( -drive "media=cdrom,format=raw,readonly=on,file=$seed" )
+ run qemu-system-x86_64 \
+ -name "$name" -machine q35,accel=kvm -cpu host -smp "$BNU_QEMU_CPUS" -m "$BNU_QEMU_MEMORY" \
+ "${drives[@]}" -device virtio-net-pci,netdev=net0 \
+ -netdev "user,id=net0,hostfwd=tcp:127.0.0.1:${BNU_QEMU_SSH_PORT}-:22" \
+ -display none -serial "file:$serial" -monitor none -daemonize -pidfile "$pidfile"
+ [[ $BNU_QEMU_DRY_RUN == 1 ]] || wait_for_ssh
+}
+
+stop_vm() {
+ local name=$1 pidfile=$BNU_QEMU_DIR/run/$name/qemu.pid deadline
+ [[ -s $pidfile ]] || return
+ guest_ssh 'sync; systemctl poweroff || poweroff' >/dev/null 2>&1 || true
+ deadline=$((SECONDS + 60))
+ while kill -0 "$(<"$pidfile")" 2>/dev/null && (( SECONDS < deadline )); do sleep 1; done
+ if kill -0 "$(<"$pidfile")" 2>/dev/null; then
+ note "guest did not stop cleanly; terminating only QEMU pid $(<"$pidfile")"
+ kill -TERM "$(<"$pidfile")" 2>/dev/null || true
+ fi
+}
diff --git a/scripts/qemu/download-images.sh b/scripts/qemu/download-images.sh
new file mode 100755
index 0000000..26c1f36
--- /dev/null
+++ b/scripts/qemu/download-images.sh
@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# Download and authenticate the official Gentoo images used by the matrix.
+
+set -Eeuo pipefail
+source "$(cd -- "$(dirname -- "$0")" && pwd)/common.sh"
+
+usage() {
+ cat <<'EOF'
+usage: scripts/qemu/download-images.sh [--dry-run] [--only NAME]
+
+NAME is cloud, selinux, hurd, or all (the default). Files are cached beneath
+BNU_QEMU_DIR, which defaults to /var/tmp/bnu-qemu.
+EOF
+}
+
+only=all
+while (($#)); do
+ case $1 in
+ --dry-run) BNU_QEMU_DRY_RUN=1 ;;
+ --only) [[ $# -ge 2 ]] || die "--only needs a value"; only=$2; shift ;;
+ -h|--help) usage; exit 0 ;;
+ *) die "unknown argument: $1" ;;
+ esac
+ shift
+done
+[[ $only =~ ^(all|cloud|selinux|hurd)$ ]] || die "--only must be cloud, selinux, hurd, or all"
+
+for command in curl gpg qemu-img; do require_command "$command"; done
+ensure_state_dir
+gnupg=$BNU_QEMU_DIR/gnupg
+prepare_gnupg "$gnupg"
+
+signed_manifest_path() {
+ local url=$1 pattern=$2 name=$3 path
+ local manifest=$BNU_QEMU_DIR/$name
+ local plain=$BNU_QEMU_DIR/$name.plain
+ download "$url" "$manifest"
+ if [[ $BNU_QEMU_DRY_RUN == 1 ]]; then
+ printf 'DRY-RUN/%s\n' "$pattern"
+ return
+ fi
+ gpg --batch --homedir "$gnupg" --output "$plain.tmp" --decrypt "$manifest"
+ mv -- "$plain.tmp" "$plain"
+ path=$(awk -v pattern="$pattern" '$1 !~ /^#/ && $1 ~ pattern { print $1; exit }' "$plain")
+ [[ -n $path ]] || die "no $pattern artifact found in $url"
+ printf '%s\n' "$path"
+}
+
+fetch_signed_artifact() {
+ local url=$1 output=$2
+ download "$url" "$output"
+ download "$url.asc" "$output.asc"
+ verify_detached "$gnupg" "$output.asc" "$output"
+}
+
+autobuilds=https://distfiles.gentoo.org/releases/amd64/autobuilds
+if [[ $only == all || $only == cloud ]]; then
+ run mkdir -p -- "$BNU_QEMU_DIR/cloud"
+ cloud_path=$(signed_manifest_path "$autobuilds/latest-qcow2.txt" 'di-amd64-cloudinit-.*\.qcow2$' latest-qcow2.txt)
+ cloud_output=$BNU_QEMU_DIR/cloud/gentoo-cloudinit-amd64.qcow2
+ fetch_signed_artifact "$autobuilds/$cloud_path" "$cloud_output"
+ if [[ $BNU_QEMU_DRY_RUN != 1 ]]; then printf '%s\n' "$cloud_path" >"$cloud_output.source"; fi
+fi
+
+if [[ $only == all || $only == selinux ]]; then
+ run mkdir -p -- "$BNU_QEMU_DIR/selinux"
+ selinux_path=$(signed_manifest_path \
+ "$autobuilds/latest-stage3-amd64-hardened-selinux-systemd.txt" \
+ 'stage3-amd64-hardened-selinux-systemd-.*\.tar\.xz$' \
+ latest-stage3-amd64-hardened-selinux-systemd.txt)
+ selinux_output=$BNU_QEMU_DIR/selinux/stage3-amd64-hardened-selinux-systemd.tar.xz
+ fetch_signed_artifact "$autobuilds/$selinux_path" "$selinux_output"
+ if [[ $BNU_QEMU_DRY_RUN != 1 ]]; then printf '%s\n' "$selinux_path" >"$selinux_output.source"; fi
+fi
+
+if [[ $only == all || $only == hurd ]]; then
+ run mkdir -p -- "$BNU_QEMU_DIR/hurd-gentoo-amd64"
+ hurd_base=https://distfiles.gentoo.org/experimental/amd64/hurd/hurd-x86_64-preview.qcow2
+ hurd_image=$BNU_QEMU_DIR/hurd-gentoo-amd64/hurd-x86_64-preview.qcow2
+ download "$hurd_base" "$hurd_image"
+ download "$hurd_base.sig" "$hurd_image.sig"
+ download "$hurd_base.sha512" "$hurd_image.sha512"
+ # The experimental Hurd preview is signed by its Gentoo developer rather
+ # than the automated release key. Fetch its key block over HTTPS from
+ # Gentoo's own keyserver and assert the exact signing-subkey fingerprint.
+ hurd_signer=FD19E6D31B192EE4DC63EAD3DC2B16215ED5412A
+ if [[ $BNU_QEMU_DRY_RUN == 1 ]] || ! gpg --batch --homedir "$gnupg" --list-keys "$hurd_signer" >/dev/null 2>&1; then
+ hurd_key=$BNU_QEMU_DIR/hurd-gentoo-amd64/signer-$hurd_signer.asc
+ download "https://keys.gentoo.org/pks/lookup?op=get&search=0x$hurd_signer" "$hurd_key"
+ run gpg --batch --homedir "$gnupg" --import "$hurd_key"
+ fi
+ if [[ $BNU_QEMU_DRY_RUN != 1 ]]; then
+ gpg --batch --homedir "$gnupg" --with-colons --fingerprint "$hurd_signer" |
+ awk -F: '$1 == "fpr" {print $10}' | grep -Fxq "$hurd_signer" ||
+ die "Gentoo Hurd signing-key fingerprint did not match $hurd_signer"
+ fi
+ verify_detached "$gnupg" "$hurd_image.sig" "$hurd_image"
+ if [[ $BNU_QEMU_DRY_RUN != 1 ]]; then
+ (cd -- "$(dirname -- "$hurd_image")" && sha512sum --check "$(basename -- "$hurd_image.sha512")")
+ else
+ note "would verify the Hurd SHA-512 manifest"
+ fi
+ create_overlay "$hurd_image" "$BNU_QEMU_DIR/hurd-gentoo-amd64/bnu-matrix-overlay.qcow2"
+fi
+
+note "verified Gentoo artifacts are in $BNU_QEMU_DIR"
diff --git a/scripts/qemu/guest/provision-base.sh b/scripts/qemu/guest/provision-base.sh
new file mode 100755
index 0000000..702f923
--- /dev/null
+++ b/scripts/qemu/guest/provision-base.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+export MAKEOPTS=-j1
+export EMERGE_DEFAULT_OPTS='--jobs=1 --load-average=2 --nospinner'
+mkdir -p /etc/portage/package.use /etc/portage/package.accept_keywords
+grep -q '^MAKEOPTS=' /etc/portage/make.conf 2>/dev/null || printf '\nMAKEOPTS="-j1"\n' >>/etc/portage/make.conf
+grep -q '^EMERGE_DEFAULT_OPTS=' /etc/portage/make.conf 2>/dev/null ||
+ printf 'EMERGE_DEFAULT_OPTS="--jobs=1 --load-average=2 --nospinner"\n' >>/etc/portage/make.conf
+
+if [[ ${BNU_REFRESH_PORTAGE:-0} == 1 ]]; then emerge --sync; fi
+emerge --ask=n --verbose=n \
+ app-arch/xz-utils app-shells/bash dev-lang/perl dev-lang/python \
+ net-misc/openssh sys-apps/acl sys-apps/attr sys-apps/coreutils \
+ sys-apps/util-linux sys-block/parted sys-devel/binutils sys-devel/gcc \
+ sys-devel/make sys-fs/dosfstools sys-fs/e2fsprogs sys-fs/xfsprogs \
+ sys-libs/libcap sys-process/procps sys-process/psmisc
+
+if [[ ! -e /swapfile ]]; then
+ fallocate -l 2G /swapfile
+ chmod 600 /swapfile
+ mkswap /swapfile
+ printf '/swapfile none swap sw 0 0\n' >>/etc/fstab
+fi
+swapon /swapfile 2>/dev/null || true
+systemctl enable sshd 2>/dev/null || rc-update add sshd default 2>/dev/null || true
+touch /var/lib/bnu-provisioned
diff --git a/scripts/qemu/guest/provision-selinux.sh b/scripts/qemu/guest/provision-selinux.sh
new file mode 100755
index 0000000..5f79397
--- /dev/null
+++ b/scripts/qemu/guest/provision-selinux.sh
@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# Run in the standard Gentoo builder. Payload=/dev/vdb, target=/dev/vdc.
+set -Eeuo pipefail
+
+target=/mnt/bnu-target
+payload=/mnt/bnu-payload
+mkdir -p "$target" "$payload"
+mount -o ro /dev/vdb "$payload"
+stage=$payload/bnu/artifacts/stage3-amd64-hardened-selinux-systemd.tar.xz
+[[ -r $stage ]] || { echo "SELinux stage3 is absent from payload" >&2; exit 2; }
+
+wipefs -a /dev/vdc
+parted -s /dev/vdc mklabel gpt
+parted -s /dev/vdc mkpart ESP fat32 1MiB 513MiB
+parted -s /dev/vdc set 1 esp on
+parted -s /dev/vdc mkpart gentoo xfs 513MiB 100%
+udevadm settle
+mkfs.vfat -F 32 -n EFI /dev/vdc1
+mkfs.xfs -f -L gentoo /dev/vdc2
+mount /dev/vdc2 "$target"
+mkdir -p "$target/boot/efi"
+mount /dev/vdc1 "$target/boot/efi"
+tar --numeric-owner --acls --xattrs --xattrs-include='*' --selinux -xpf "$stage" -C "$target"
+
+root_uuid=$(blkid -s UUID -o value /dev/vdc2)
+efi_uuid=$(blkid -s UUID -o value /dev/vdc1)
+cat >"$target/etc/fstab" <<EOF
+UUID=$root_uuid / xfs defaults 0 1
+UUID=$efi_uuid /boot/efi vfat umask=0077 0 2
+/swapfile none swap sw 0 0
+EOF
+cp -L /etc/resolv.conf "$target/etc/resolv.conf"
+cat >>"$target/etc/portage/make.conf" <<'EOF'
+MAKEOPTS="-j1"
+EMERGE_DEFAULT_OPTS="--jobs=1 --load-average=2 --nospinner"
+SELINUX_POLICY_TYPES="mcs mls strict"
+EOF
+mkdir -p "$target/etc/portage/package.use"
+cat >"$target/etc/portage/package.use/bnu-selinux" <<'EOF'
+sys-apps/systemd selinux
+sys-apps/coreutils acl caps xattr
+sys-process/procps selinux
+EOF
+cat >"$target/etc/selinux/config" <<'EOF'
+SELINUX=permissive
+SELINUXTYPE=mls
+EOF
+mkdir -p "$target/etc/systemd/network" "$target/root/.ssh"
+cat >"$target/etc/systemd/network/20-wired.network" <<'EOF'
+[Match]
+Name=en* eth*
+
+[Network]
+DHCP=yes
+EOF
+install -m 600 /dev/null "$target/root/.ssh/authorized_keys"
+cat /root/.ssh/authorized_keys >"$target/root/.ssh/authorized_keys"
+chmod 700 "$target/root/.ssh"
+
+for fs in dev proc sys run; do mount --rbind "/$fs" "$target/$fs"; mount --make-rslave "$target/$fs"; done
+chroot "$target" /usr/bin/env MAKEOPTS=-j1 EMERGE_DEFAULT_OPTS='--jobs=1 --load-average=2 --nospinner' \
+ emerge --ask=n --verbose=n net-misc/openssh net-misc/dhcpcd sec-policy/selinux-base \
+ sec-policy/selinux-base-policy sys-apps/policycoreutils sys-boot/grub:2 \
+ sys-fs/dosfstools sys-fs/xfsprogs sys-kernel/gentoo-kernel-bin
+
+cat >"$target/etc/default/grub" <<'EOF'
+GRUB_CMDLINE_LINUX="console=ttyS0 lsm=selinux security=selinux selinux=1 enforcing=0"
+GRUB_TERMINAL="serial console"
+GRUB_SERIAL_COMMAND="serial --speed=115200 --unit=0 --word=8 --parity=no --stop=1"
+EOF
+chroot "$target" systemctl enable sshd systemd-networkd systemd-resolved
+chroot "$target" grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=Gentoo --removable --no-nvram
+chroot "$target" grub-mkconfig -o /boot/grub/grub.cfg
+chroot "$target" semodule -B || true
+fallocate -l 2G "$target/swapfile"
+chmod 600 "$target/swapfile"
+mkswap "$target/swapfile"
+touch "$target/.autorelabel" "$target/var/lib/bnu-provisioned" "$target/var/lib/bnu-selinux-mls"
+sync
diff --git a/scripts/qemu/guest/provision-smack.sh b/scripts/qemu/guest/provision-smack.sh
new file mode 100755
index 0000000..4cbb5a2
--- /dev/null
+++ b/scripts/qemu/guest/provision-smack.sh
@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# Run inside an overlay of the completed SELinux guest.
+set -Eeuo pipefail
+
+export MAKEOPTS=-j1
+export EMERGE_DEFAULT_OPTS='--jobs=1 --load-average=2 --nospinner'
+swapon /swapfile 2>/dev/null || true
+emerge --ask=n --verbose=n sys-apps/kmod sys-kernel/dracut sys-kernel/gentoo-sources
+eselect kernel set "$(eselect kernel list | awk '/gentoo/ {gsub(/\[|\]/, "", $1); n=$1} END {print n}')"
+kernel=/usr/src/linux
+cd "$kernel"
+if [[ -r /proc/config.gz ]]; then
+ zcat /proc/config.gz >.config
+else
+ cp "/boot/config-$(uname -r)" .config
+fi
+scripts/config --enable SECURITY --enable SECURITYFS --enable SECURITY_SMACK
+scripts/config --disable DEBUG_INFO_BTF --disable DEBUG_INFO_BTF_MODULES
+scripts/config --enable VIRTIO --enable VIRTIO_PCI --enable VIRTIO_BLK --enable VIRTIO_NET
+scripts/config --enable EXT4_FS --enable XFS_FS --enable VFAT_FS --enable ISO9660_FS
+scripts/config --set-str LOCALVERSION '-smack-bnu'
+make olddefconfig
+make -j1
+make -j1 modules_install
+version=$(make -s kernelrelease)
+cp arch/x86/boot/bzImage "/boot/vmlinuz-$version"
+cp .config "/boot/config-$version"
+cp System.map "/boot/System.map-$version"
+dracut --force "/boot/initramfs-$version.img" "$version"
+sed -i 's/lsm=selinux/security=smack lsm=smack/; s/security=selinux//; s/selinux=1//; s/enforcing=0//' /etc/default/grub
+grub-mkconfig -o /boot/grub/grub.cfg
+touch /var/lib/bnu-smack
+sync
diff --git a/scripts/qemu/guest/run-tests.sh b/scripts/qemu/guest/run-tests.sh
new file mode 100755
index 0000000..efbb26e
--- /dev/null
+++ b/scripts/qemu/guest/run-tests.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+mode=${1:?mode is required}
+shift
+mountpoint=/mnt/bnu-payload
+work=/var/tmp/bnu-current
+mkdir -p "$mountpoint"
+mountpoint -q "$mountpoint" || mount -o ro LABEL=BNU_PAYLOAD "$mountpoint"
+rm -rf -- "$work"
+mkdir -p "$work"
+cp -a "$mountpoint/bnu/repo/." "$work/"
+install -m 755 "$mountpoint/bnu/bin/bun" "$work/bun"
+chmod -R a+rX "$work"
+
+common=(
+ "$work/bun" "$work/scripts/run-gnu-tests.js"
+ --tarball "$work/coreutils-9.11.tar.xz"
+ --very-expensive --timeout 300s --rss-limit 1024MiB --memory-limit 3GiB
+)
+case $mode in
+ nonroot)
+ mkdir -p /tmp/bnu-nobody
+ chown nobody:nogroup /tmp/bnu-nobody 2>/dev/null || chown nobody:nobody /tmp/bnu-nobody
+ exec runuser -u nobody -- env HOME=/tmp/bnu-nobody TMPDIR=/tmp/bnu-nobody \
+ "${common[@]}" --all --nonroot-tests "$@"
+ ;;
+ root)
+ exec env HOME=/root TMPDIR=/tmp "${common[@]}" --all --root-tests "$@"
+ ;;
+ selected-root)
+ exec env HOME=/root TMPDIR=/tmp "${common[@]}" "$@"
+ ;;
+ selected-nonroot)
+ mkdir -p /tmp/bnu-nobody
+ chown nobody:nogroup /tmp/bnu-nobody 2>/dev/null || chown nobody:nobody /tmp/bnu-nobody
+ exec runuser -u nobody -- env HOME=/tmp/bnu-nobody TMPDIR=/tmp/bnu-nobody \
+ "${common[@]}" "$@"
+ ;;
+ *) echo "unknown test mode: $mode" >&2; exit 2 ;;
+esac