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 exit

Author

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++