afl-health - Man Page
Synopsis
afl-health [ options ] [TARGET ...]
Options
usage: afl-health [-h] [--config CONFIG] [--json] [--summary]
[--watch SECONDS] [--on-change CMD]
[--expect-eps EXPECT_EPS] [--state-dir STATE_DIR]
[--no-store] [--ssh-opt KEY=VAL]
[--fail-on {collection_error,dead,degraded,healthy,misconfigured,stalled}]
[--connect-timeout CONNECT_TIMEOUT] [--quiet] [--version]
[TARGET ...]
Health, trend, and action analysis for AFL++/cargo-afl/ziggy campaigns (local
or over ssh).
positional arguments:
TARGET local /path/to/out, or [user@]host:/path/to/out for
ssh; glob patterns (e.g. host:/runs/*/afl) expand to
one campaign per match (remotely for ssh)
options:
-h, --help show this help message and exit
--config CONFIG JSON config defining targets / ssh opts / state dir
--json machine report (incl. action directives)
--summary condensed one-line per campaign (fleet roll-up for
many)
--watch SECONDS live refresh every N seconds
--on-change CMD run CMD when a target changes state; event JSON is
piped on stdin
--expect-eps EXPECT_EPS
expected execs/sec (sharpens speed judgment)
--state-dir STATE_DIR
trend history location (default: XDG state dir)
--no-store do not persist/read trend history
--ssh-opt KEY=VAL extra ssh -o option (repeatable)
--fail-on {collection_error,dead,degraded,healthy,misconfigured,stalled}
exit nonzero only at/above this verdict
--connect-timeout CONNECT_TIMEOUT
ssh connect timeout (seconds)
--quiet suppress human output (for scripting)
--version show program's version number and exitAuthor
AFL++ was written by Michal "lcamtuf" Zalewski and is maintained by Marc "van Hauser" Heuse <mh@mh-sec.de>, Dominik Maier <domenukk@gmail.com>, Andrea Fioraldi <andreafioraldi@gmail.com> and Heiko "hexcoder-" Eissfeldt <heiko.eissfeldt@hexco.de> The homepage of AFL++ is: https://github.com/AFLplusplus/AFLplusplus
License
AFL++ is licensed under AGPL-3.0-or-later, with original components under Apache-2.0; an optional commercial license is available. See https://github.com/AFLplusplus/AFLplusplus/blob/stable/LICENSING.md
Info
2026-07-15 AFL++