2.4 KiB
G3 Manual Test Setup
This setup supports only TC041-TC066, TC141, TC148, TC149, TC152, and TC153. It prepares fixtures and native probes; it does not run tests or assign results.
Host Preparation
From the repo22 root, use an absent output directory:
git rev-parse HEAD
tests/prepare_g3_fixtures.sh /work/build/repo22-g3
(cd /work/build/repo22-g3/vfs && sha256sum -c IMAGE-SHA256SUMS)
(cd /work/build/repo22-g3/vfs/source &&
sha256sum -c ../SOURCE-SHA256SUMS)
(cd /work/build/repo22-g3/metadata && sha256sum -c SHA256SUMS)
(cd /work/build/repo22-g3/final && sha256sum -c SHA256SUMS)
Record fixture-evidence.txt, all checksum manifests, the erofs-utils version, the exact source commit, and the KLD SHA256. Transfer the fixtures, sources, and only these native probes to the FreeBSD 15 guest:
readdir_probe.c g3_vfs_probe.c stat_special.c nfs_fh_tool.c
mmap_fault.c sparse_hole_probe.c
Guest Preparation
Build the KLD natively from an archive exported from the recorded commit. Build probes directly; no runner or result wrapper is permitted:
cc -O2 -Wall -Wextra -Werror -std=c17 readdir_probe.c -o readdir_probe
cc -O2 -Wall -Wextra -Werror -std=c17 g3_vfs_probe.c -o g3_vfs_probe
cc -O2 -Wall -Wextra -Werror -std=c17 stat_special.c -o stat_special
cc -O2 -Wall -Wextra -Werror -std=c17 nfs_fh_tool.c -o nfs_fh_tool
cc -O2 -Wall -Wextra -Werror -std=c17 mmap_fault.c -o mmap_fault
cc -O2 -Wall -Wextra -Werror -std=c17 sparse_hole_probe.c \
-o sparse_hole_probe
Before the first test, require no EROFS mount, no md provider, and no stale EROFS KLD. Load only the exact KLD under test. For each test, attach a fresh dynamic vnode md, mount read-only, execute that numbered Markdown procedure, then unmount and detach before continuing.
The report records the literal command, exit status or syscall errno, relevant fixture/data/KLD hashes, dmesg delta, and cleanup state for every test.
Common Mount Pattern
mkdir -p /tmp/repo22-g3/mnt
unit=$(mdconfig -a -t vnode -f IMAGE)
mount -t erofs -o ro "/dev/$unit" /tmp/repo22-g3/mnt
# Execute exactly one numbered test.
umount /tmp/repo22-g3/mnt
mdconfig -d -u "$unit"
TC153 additionally creates and removes its documented multi-terabyte sparse provider. Final cleanup requires zero EROFS mounts, zero md providers, the test KLD unloaded, and all guest-generated sparse files removed.