diff options
| author | dec05eba <dec05eba@protonmail.com> | 2020-11-05 01:45:06 +0100 |
|---|---|---|
| committer | dec05eba <dec05eba@protonmail.com> | 2020-11-05 01:45:06 +0100 |
| commit | 2a8202e74846d191a321cca1202175af9db6107d (patch) | |
| tree | a6f455caf07da1186851f343a237a4c4e4484f46 /fuzzers/README.rst | |
| parent | 8efa0ec17d8c262f9c3fd7603e8074f74a053708 (diff) | |
Diffstat (limited to 'fuzzers/README.rst')
| -rw-r--r-- | fuzzers/README.rst | 50 |
1 files changed, 0 insertions, 50 deletions
diff --git a/fuzzers/README.rst b/fuzzers/README.rst deleted file mode 100644 index b6f5f9c..0000000 --- a/fuzzers/README.rst +++ /dev/null @@ -1,50 +0,0 @@ -Fuzzers -======= - -This directory contains a collection of fuzzing tools. Each tests a different -entry point to the code. - -Usage notes: - -1. Install AFL: - - .. code:: - - apt-get install afl - -2. Build the fuzzers: - - .. code:: - - make fuzzers - -3. Some of the tests (eg ``fuzz_decrypt`` and ``fuzz_group_decrypt``) require a - session file. You can create one by pickling an Olm session. - -4. Make some work directories: - - .. code:: - - mkdir -p fuzzing/in fuzzing/out - -5. Generate starting input: - - .. code:: - - echo "Test" > fuzzing/in/test - -6. Run the test under ``afl-fuzz``: - - .. code:: - - afl-fuzz -i fuzzing/in -o fuzzing/out -- \ - ./build/fuzzers/fuzz_<fuzzing_tool> [<test args>] - -7. To resume with the data produced by an earlier run: - - .. code:: - - afl-fuzz -i- -o existing_output_dir [...etc...] - -8. If it shows failures, pipe the failure case into - ``./build/fuzzers/debug_<fuzzing_tool>``, fix, and repeat. |