erofs-freebsd-out-tree/tests/G3-MANUAL-SETUP.md

G3 Manual Test Setup

This setup supports only TC041-TC066, TC141, TC148, TC149, TC152, and TC153. It prepares deterministic fixtures and native probes; it does not assign runtime results.

Host Preparation

From the repo-pre-15 root, use an absent output directory:

git rev-parse HEAD
tests/prepare_g3_fixtures.sh /work/build/repo-pre15-g3
python3 -B tests/pre15/fixtures/g3.py verify \
  --output /work/build/repo-pre15-g3
sha256sum /work/build/repo-pre15-g3/G3-MANIFEST.json

The maintained generator is tests/pre15/fixtures/g3.py. The compatibility entry point tests/g3_fixtures.py delegates to it. Normal generation does not read tests/results/; B01 separately proves that the migrated metadata and final-review sets match both archived scripts byte for byte.

G3-MANIFEST.json records the generator SHA256, erofs-utils identity, exact mkfs.erofs argv, canonical source-tree inventories, image hashes, and expected directory sets. Record this manifest, all checksum files, 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 the probes directly:

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/repo-pre15-g3/mnt
unit=$(mdconfig -a -t vnode -f IMAGE)
mount -t erofs -o ro "/dev/$unit" /tmp/repo-pre15-g3/mnt
# Execute exactly one numbered test.
umount /tmp/repo-pre15-g3/mnt
mdconfig -d -u "$unit"

TC153 additionally creates and removes its documented multi-terabyte sparse provider. Final cleanup requires zero EROFS mounts, zero owned md providers, the test KLD unloaded, and all guest-generated sparse files removed.