summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNikos Mavrogiannopoulos <nmav@redhat.com>2017-03-09 15:50:24 +0100
committerNikos Mavrogiannopoulos <nmav@redhat.com>2017-03-09 15:50:24 +0100
commit6dc53de2d42db8798c78872c390e547b41e81720 (patch)
tree045bf48e39bc128b33d9e0627fc85727ce4022f8
parent8e2b6e533b34def5f6e9c05377d84af9b5cc3e16 (diff)
downloadgnutls-6dc53de2d42db8798c78872c390e547b41e81720.tar.gz
fuzz: document how to run AFL [ci skip]
Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
-rw-r--r--devel/fuzz/README.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/devel/fuzz/README.md b/devel/fuzz/README.md
index 476fca09da..96e3d7dc7c 100644
--- a/devel/fuzz/README.md
+++ b/devel/fuzz/README.md
@@ -9,6 +9,23 @@ assume they are fuzzers it should run.
The initial values for each parser fuzzer are taken from the $NAME.in
directory.
+
+# Running a fuzzer using AFL
+
+Use the following commands on top dir:
+
+```
+$ CC="afl-gcc" ./configure
+$ make -j$(nproc)
+$ cd devel/fuzz
+$ make gnutls_pkcs7_parser_fuzzer
+$ ./run-afl.sh gnutls_pkcs7_parser_fuzzer
+```
+
+This will execute AFL (which runs indefinitely until CTRL+C is pressed) and
+provide its output in a "gnutls_pkcs7_parser_fuzzer.PID.out" directory.
+
+
# Reproducing a specific issue
Assuming an issue on the "gnutls_pkcs7_parser_fuzzer" was found, and the