diff options
-rw-r--r-- | examples/bind/README.md | 27 |
1 files changed, 16 insertions, 11 deletions
diff --git a/examples/bind/README.md b/examples/bind/README.md index aca5ffcc..d81804b3 100644 --- a/examples/bind/README.md +++ b/examples/bind/README.md @@ -2,17 +2,15 @@ **Requirements** - * honggfuzz (1.1 or from the master branch) - * clang-4.0, or newer (5.0 works as well) - * ISC Bind (verified with 9.15.4) + * honggfuzz (1.9 or from the master branch) + * clang-5.0 or newer (the newer, the better) + * ISC Bind (tested with 9.15.4) **Preparation** -Note: The examples provided below use hardcoded paths (here to: _/home/jagger/_). These will have to be modified, so they reflect your actual build environment. - -1. Compile honggfuzz -2. Download and unpack bind-9.15.4.tgz -3. Unpack bind, and patch it +*** 1. Compile honggfuzz +*** 2. Download and unpack bind-9.15.4.tgz +*** 3. Unpack bind, and patch it ```shell $ cd <fuzzing_dir> @@ -22,23 +20,30 @@ $ patch -p1 < <honggfuzz_dir>/examples/bind/bind-9.15.4.patch $ chmod 755 compile.sh ``` -4. Configure, compile and install ISC Bind +*** 4. Configure, compile and install ISC Bind * edit _compile.sh_, so it contains the correct dist (_--prefix_) path ```shell +$ vim compile.sh # [edit the --prefix] $ ./compile.sh $ make install ``` -5. Copy the custom configuration files to ```<fuzzing_directory>/bind/dist/etc/named.conf``` (i.e. to your bind/named dist directory) +*** 5. Copy the custom configuration files to ```<fuzzing_directory>/bind/dist/etc/named.conf``` (i.e. to your bind/named dist directory) ```shell $ cp honggfuzz/examples/bind/named.conf <fuzzing_directory>/bind/dist/etc/ $ cp honggfuzz/examples/bind/test.zone <fuzzing_directory>/bind/dist/etc/ ``` + +*** 6. Fix the _directory_ configuration directive inside your <fuzzing_directory>/bind/dist/etc/named.conf + +```shell +$ vim <fuzzing_directory>/bind/dist/etc/named.conf # [edit the *directory* directive] +``` -6. **Fuzz it!** +*** 7. **Fuzz it!** ```shell $ <honggfuzz_dir>/honggfuzz -i input_corpus -- ./dist/sbin/named -c /home/jagger/fuzz/bind/dist/etc/named.conf -g |