From: Tomek Mrugalski <tomasz@isc.org>
Date: Mon, 21 Nov 2016 10:55:32 +0000 (+0100)
Subject: [experiments/fuzz] A sketchy documentation added.
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=67c7a6b286f5180b82a30e627431968894620ae2;p=thirdparty%2Fkea.git

[experiments/fuzz] A sketchy documentation added.
---

diff --git a/doc/fuzz.txt b/doc/fuzz.txt
new file mode 100644
index 0000000000..5f55e30054
--- /dev/null
+++ b/doc/fuzz.txt
@@ -0,0 +1,48 @@
+1. Download AFL
+  Homepage: http://lcamtuf.coredump.cx/afl/
+  Version used: 2.35b (afl-latest.tgz)
+
+2. Compile AFL
+  cd afl-2.35b
+  make
+  cd llvm_mode
+  make
+
+the last step requires to have LLVM installed. On
+Ubuntu 16.04 I had to do this:
+ 
+  sudo apt-get install llvm
+
+3. Set up path to AFL binaries
+
+ EXPORT AFL_PATH=/home/thomson/devel/afl-2.35b
+ EXPORT PATH=$PATH:/home/thomson/devel/afl-2.35b
+
+4. Build Kea using AFL
+
+ cd kea
+ git pull
+ git checkout experiments/fuzz
+ autoreconf -i
+ CXX=afl-clang-fast++ ./configure --enable-fuzz
+ make
+
+ Note: no unit-tests needed. We will be fuzzing the
+ production code only.
+
+5. Run fuzzer
+
+ The defaults (see src/bin/dhcp6/fuzz.cc) are:
+ interface: eth0
+ dest address: ff02::1:2
+ dest port: 547
+
+ Those can be changed with the following env. variables:
+ KEA_AFL_INTERFACE
+ KEA_AFL_ADDR
+ KEA_AFL_PORT
+
+ E.g.
+ export KEA_AFL_INTERFACE=eth1
+
+