From: Vincent Bernat <vincent@bernat.im>
Date: Sat, 3 Oct 2015 23:28:30 +0000 (+0200)
Subject: tests: add instructions on how to use afl for fuzzing
X-Git-Tag: 0.8.0~55
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=3ca100866133aef2d21cdb193ed8d9c39bf56cc0;p=thirdparty%2Flldpd.git

tests: add instructions on how to use afl for fuzzing
---

diff --git a/README.md b/README.md
index fae20942..1051aac2 100644
--- a/README.md
+++ b/README.md
@@ -213,6 +213,18 @@ You can append any further arguments. If lldpd is unable to find
 `lldpcli` it will start in an unconfigured mode and won't send or
 accept LLDP frames.
 
+You can use [afl](http://lcamtuf.coredump.cx/afl/) to test some
+aspects of lldpd. To test frame decoding, you can do something like
+that:
+
+    export AFL_USE_ASAN=1 # only on 32bit arch
+    ./configure CC=afl-gcc
+    make clean check
+    cd tests
+    mkdir inputs
+    mv *.pcap inputs
+    afl-fuzz -i inputs -o outputs ./decode @@
+
 Embedding
 ---------