From: Tomek Mrugalski <tomasz@isc.org>
Date: Mon, 21 Nov 2016 12:30:43 +0000 (+0100)
Subject: [expriments/fuzz] Doc updated.
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3fe5d64238ec3132b59d75f71fe56086b483bd14;p=thirdparty%2Fkea.git

[expriments/fuzz] Doc updated.
---

diff --git a/doc/fuzz.txt b/doc/fuzz.txt
index 533e06aa4e..a1463bead5 100644
--- a/doc/fuzz.txt
+++ b/doc/fuzz.txt
@@ -1,3 +1,11 @@
+This file documents the process of initial trial runs for running
+AFL fuzzer for Kea. Currently only Kea-dhcp6 is extended with this
+capability. Once we get more experience with it, we should implement
+this capability for Kea-dhcp4.
+
+I have used Ubuntu 16.04 for this. I read somewhere that FreeBSD is
+ok for fuzzing, but Mac OS is not.
+
 1. Download AFL
   Homepage: http://lcamtuf.coredump.cx/afl/
   Version used: 2.35b (afl-latest.tgz)
@@ -45,6 +53,8 @@ Ubuntu 16.04 I had to do this:
  E.g.
  export KEA_AFL_INTERFACE=eth1
 
+ Overriding the parameters with variables has not been tested.
+
 6. Run fuzzer
 
  Set up max size of a virtual memory allowed to 4GB: