https://github.com/reflare/afl-monitor

A monitoring script for AFL
https://github.com/reflare/afl-monitor

afl afl-fuzz fuzzing graphing monitoring overview statistics

Last synced: about 1 month ago
JSON representation

A monitoring script for AFL

• Host: GitHub
• URL: https://github.com/reflare/afl-monitor
• Owner: reflare
• License: apache-2.0
• Created: 2017-02-01T09:11:59.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2017-02-08T10:48:12.000Z (about 8 years ago)
• Last Synced: 2024-09-26T01:51:43.990Z (5 months ago)
• Topics: afl, afl-fuzz, fuzzing, graphing, monitoring, overview, statistics
• Language: Python
• Size: 3.15 MB
• Stars: 39
• Watchers: 6
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# afl-monitor

#### Extended monitoring and reporting tool for AFL

This program processes a findings directory generated by afl-fuzz and displays the findings in various formats.

#### Usage

`./afl-monitor [-n | --nocolor] [-c | --commandLine] [-v | --verbose] [-h | --html output_directory] [-e | --execute command] [-r | --recursive second_count]  findings_directory`

The findings_directory parameter should point to an existing findings directory containing one or several state directories for any active or stopped instance of afl-fuzz.

#### Options

`-n | --nocolor` Suppresses color output.

`-c | --commandLine` 

Output to the command line (can be used with -h)

`-v | --verbose` 

Show per-fuzzer statistics in commandline mode and Per-Fuzzer graphing in HTML mode.

`-h | --html` 

Output in HTML format. output_directory must be an empty directory in which the output files will be saved. Will generate 1 index.html file and several plot images.

`-e | --execute` 

Executes the provided command (use quotes if using arguments) and passes the commandline output via stdin (pipe) if a new crash is detected.

`-r | --recursive` 

Re-runs this script with all provided arguments every 'second_count' seconds.

#### Usage Examples

`./afl-monitor -c -v findings/` Display colored status information summaries and per-fuzzer stats on the command line.

`./afl-monitor -g graphs/ -c -n findings/` Display summary information as HTML and uncolored console output.

`./afl-monitor -c -e send_push_message -r 60 findings/` Generate summary stats once a minute and display them on the command line. If a new crash was detected since the last run, pipe the summary into `send_push_message` (placeholder example).

#### Installation

Place afl-monitor anywhere in your file system and execute it. Requires Python 2.7.

### Screenshots

#### Console Summary

![General Overview](https://github.com/reflare/afl-monitor/raw/master/documentation/screenshots/summary.png)

#### Console Per-Fuzzer Output

![Per Fuzzer](https://github.com/reflare/afl-monitor/raw/master/documentation/screenshots/perfuzzer.png)

#### HTML Summary

![HTML Summary](https://raw.githubusercontent.com/reflare/afl-monitor/master/documentation/screenshots/html-summary.png)

#### HTML Per-Fuzzer Output

![HTML Per Fuzzer](https://github.com/reflare/afl-monitor/raw/master/documentation/screenshots/html-detail.png)