Documentation
¶
Overview ¶
Command fuzzrun runs one fuzzing command and classifies its failure.
It exists to keep the nightly fuzz gate honest. A fuzz run that burns its whole -fuzztime budget without finding anything is a PASS, but Go's fuzz coordinator intermittently reports that budget expiry as "context deadline exceeded" and exits non-zero (see classify's doc comment for the exact stdlib race). That turned the nightly red on targets that had found nothing across millions of executions, which is precisely the noise that trains people to ignore a red safety net.
fuzzrun retries ONLY a run that exhibits the complete budget-expiry shape, once, and fails on everything else. Recognition is a positive whitelist rather than a denylist because "context deadline exceeded" is also what a timed-out FDB testcontainer start reports; retrying that class would hide real flakes.
Usage:
fuzzrun -label "FuzzFoo" -- go test -run='^$' -fuzz='^FuzzFoo$' -fuzztime=2m ./pkg/...
Source Files