Fuzzing UC2
Two libFuzzer harnesses cover the code that handles untrusted input:
fuzz_extract.c-- the read path. Drivesuc2_open -> uc2_read_cdir -> uc2_finish_cdir -> uc2_extractover arbitrary bytes with an in-memory reader and a discard writer. This is the security-critical target: it parses attacker-controlled.uc2archives.fuzz_roundtrip.c-- the compress / round-trip path. Compresses the fuzzer bytes (the first byte selects the level), wraps them in a minimal one-file archive, decompresses, and asserts byte-identity. Catches encoder crashes and any compress<->decompress mismatch.
Build and run by hand
Compile a harness together with the library sources and the embedded
super-master, against a configured build tree (for uc2_version.h and
super_data.S):
cmake -B build -DCMAKE_BUILD_TYPE=Release # provides the generated files
clang -fsanitize=fuzzer,address -O1 -g \
-Ilib/include -Ilib/src -Ibuild/lib \
tests/fuzz/fuzz_extract.c lib/src/*.c build/lib/super_data.S \
-lm -o fuzz_extract
mkdir -p corpus && cp tests/fuzz/seeds/* tests/fuzz/regressions/* corpus/
./fuzz_extract -max_len=65536 -timeout=20 corpus/
ASan flags any out-of-bounds access; libFuzzer writes a crash-* (or
timeout-* / oom-*) artifact for each finding, and exits non-zero.
Re-run a single artifact with ./fuzz_extract <artifact>.
Corpus and regressions
seeds/-- valid sample archives, used to seed coverage.regressions/-- minimised crash/timeout artifacts kept as permanent guards.len0-match-underflow.uc2is the input behind git-bugb8f933c: a zero-length match code made the decoder's copy loop underflow (while (--len)withlen == 0) into ~4 billion iterations, a CPU denial-of-service. Fixed by rejectinglen == 0and the negative extra-bit reads indecompress_block.
CI
Two layers run automatically:
fuzz_regression(ctest, every platform) -- a portable replay (fuzz_replay.c, no Clang/ASan needed) runs the read-path harness over every file inregressions/andseeds/under a 30 s ctest TIMEOUT, so a hang or out-of-bounds regresses visibly in the normal matrix.- the
fuzzworkflow job (Linux) -- builds both harnesses with libFuzzer + ASan, replays the committed artifacts, then runs a bounded coverage-guided session over each path. A crash, OOM, or slow input fails the job and uploads the artifact.
regressions/turbo-empty-checksum.uc2 is a generated method80 archive with
a zero-length file and deliberately wrong file checksum. Libarchive must
verify the stream even when the declared file size is zero.