afl-health(8)

afl-health(8) System Manager's Manual afl-health(8)

NAME

afl-health

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

2026-06-29 AFL++