Skip to content

Commit

Permalink
fuzzing: Document how to use honggfuzz to fuzz libnbd.
Browse files Browse the repository at this point in the history
  • Loading branch information
rwmjones committed May 12, 2020
1 parent b3fbcc7 commit 329c523
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions fuzzing/README
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
To report security bugs, see ‘SECURITY’ in the top source directory.


Fuzzing libnbd using the American Fuzzy Lop (afl) fuzzer
========================================================

Expand Down Expand Up @@ -58,6 +59,27 @@ command below. You can run this even while afl-fuzz is running.
This will create an HTML test coverage report in
../libnbd-afl/fuzzing/sync_dir/cov/web/


Fuzzing libnbd using honggfuzz
==============================

Recompile libnbd with honggfuzz instrumentation:

./configure \
CC=/path/to/hfuzz-clang CXX=/path/to/hfuzz-clang++ \
--disable-shared \
--disable-golang --disable-ocaml --disable-python
make clean
make

Run honggfuzz using test cases:

honggfuzz -i fuzzing/testcase_dir -z -- \
./fuzzing/libnbd-fuzz-wrapper ___FILE___

(Note 3 underscore characters on each side.)


Fuzzing libnbd using Clang + libFuzzer
======================================

Expand Down

0 comments on commit 329c523

Please sign in to comment.