add helper script, bump version to 0.6.3

Author: vanhauser-thc

ChangeLog

@@ -1,3 +1,7 @@
+afl-cov-0.6.3 (2020-05-13):
+   - Allow @@ additionally to AFL_FILE
+   - added three helper scripts
+
 afl-cov-0.6.2 (12/26/2018):
     - (Tim Strazzere) Add support for llvm-cov compiled binaries. Add a check
       when ensuring the binary was instrumented with gcov to catch an llvm-cov

README.md

@@ -1,5 +1,7 @@
 # afl-cov - AFL Fuzzing Code Coverage
 
+Version: 0.6.3
+
 - [Preface](#preface)
 - [Introduction](#introduction)
 - [Prerequisites](#prerequisites)
@@ -20,6 +22,7 @@ It has three changes:
  * afl-cov now accepts "@@" like AFL++ in the command line
  * afl-cov.sh makes using afl-cov easier (just needs two parameters)
  * afl-cov-build.sh makes builing a target for coverage easier
+ * afl-stat.sh shows the statistics of a run (in progress or completed)
 
 Enjoy!
 

VERSION

@@ -1 +1 @@
-0.6.2
+0.6.3

afl-cov

@@ -2,7 +2,7 @@
 #
 #  File: afl-cov
 #
-#  Version: 0.6.2
+#  Version: 0.6.3
 #
 #  Purpose: Perform lcov coverage diff's against each AFL queue file to see
 #           new functions and line coverage evolve from an AFL fuzzing cycle.
@@ -44,7 +44,7 @@ try:
 except ImportError:
     import subprocess
 
-__version__ = '0.6.2.1'
+__version__ = '0.6.3'
 
 NO_OUTPUT   = 0
 WANT_OUTPUT = 1

afl-stat.sh

@@ -0,0 +1,17 @@
+#!/bin/sh
+test "$1" = "-h" -o -z "$1" -o -z "$1" && { 
+  echo Syntax: $0 out-dir 
+  echo "Shows statistics of a run (in progress or done)"
+  exit 1
+}
+test -n "$AFL_PATH" && PATH=$AFL_PATH:$PATH
+while [ -n "$1" ]; do
+  test -d "$1" || { echo Error: not a directory: $1 ;  } 
+  test -e "$1"/fuzzer_stats || { echo Error: not an afl-fuzz -o out directory ;  }
+  echo File: `realpath "$1"`
+  egrep 'run_time|execs_done|execs_per_sec|paths_total|^unique_|stability' "$1"/fuzzer_stats | sort | tee -a "$1"/stats.out
+  LINES=
+  test -e "$1"/cov/afl-cov.log && LINES=`grep -w lines "$1"/cov/afl-cov.log|tail -n 1|sed 's/.*(//'|sed 's/ .*//'`
+  echo "coverage          : $LINES" | tee -a "$1"/stats.out
+  shift
+done