Small fixes to fuzzing documentation.

This commit is contained in:
Nick Mathewson 2017-02-24 10:57:58 -05:00
parent 823fb68a14
commit 4d3310932a
2 changed files with 9 additions and 6 deletions

3
changes/bug21472 Normal file
View File

@ -0,0 +1,3 @@
o Documentation:
- Small fixes to the fuzzing documentation. Closes ticket
21472.

View File

@ -64,14 +64,14 @@ To Build:
make make
cd ../tor cd ../tor
PATH=$PATH:../afl/ CC="../afl/afl-gcc" ./configure --enable-expensive-hardening PATH=$PATH:../afl/ CC="../afl/afl-gcc" ./configure --enable-expensive-hardening
AFL_HARDEN=1 make clean fuzz AFL_HARDEN=1 make clean fuzzers
To Find The ASAN Memory Limit: (64-bit only) To Find The ASAN Memory Limit: (64-bit only)
On 64-bit platforms, afl needs to know how much memory ASAN uses. On 64-bit platforms, afl needs to know how much memory ASAN uses,
Or, you can configure tor without --enable-expensive-hardening, then use because ASAN tends to allocate a ridiculous amount of virtual memory,
make fuzz and then not actually use it.
to run the generated test cases through an ASAN-enabled fuzz-http.
Read afl/docs/notes_for_asan.txt for more details. Read afl/docs/notes_for_asan.txt for more details.
Download recidivm from http://jwilk.net/software/recidivm Download recidivm from http://jwilk.net/software/recidivm
@ -80,7 +80,7 @@ Read afl/docs/notes_for_asan.txt for more details.
tar xvzf recidivm*.tar.gz tar xvzf recidivm*.tar.gz
cd recidivm* cd recidivm*
make make
/path/to/recidivm -v src/test/fuzz_dir /path/to/recidivm -v src/test/fuzz/fuzz-http
Use the final "ok" figure as the input to -m when calling afl-fuzz Use the final "ok" figure as the input to -m when calling afl-fuzz
(Normally, recidivm would output a figure automatically, but in some cases, (Normally, recidivm would output a figure automatically, but in some cases,
the fuzzing harness will hang when the memory limit is too small.) the fuzzing harness will hang when the memory limit is too small.)