Browse Source

Build docs: document fuzz testing for control protocol.

Davin McCall 5 years ago
parent
commit
a897b3e5fa
1 changed files with 14 additions and 0 deletions
  1. 14 0
      BUILD

+ 14 - 0
BUILD

@@ -50,6 +50,20 @@ If you get this, either disable the address sanitizer or make sure you have over
 
 
 Any test failures will abort the test suite run immediately.
 Any test failures will abort the test suite run immediately.
 
 
+In addition to the standard test suite, there is experimental support for fuzzing the control
+protocol handling using LLVM/clang's fuzzer (libFuzzer). Change to the `src/tests/cptests`
+directory and build the "fuzz" target:
+
+    make fuzz
+
+Then create a "corpus" directory and run the fuzzer:
+
+    mkdir corpus
+    ./fuzz corpus
+
+This will auto-generate test data as it finds input which triggers new execution paths. Check
+libFuzzer documentation for further details.
+
 
 
 Special note for GCC/Libstdc++
 Special note for GCC/Libstdc++
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-