2019-11-29 03:41:27 +00:00
|
|
|
# AFL Fuzzing scripts
|
|
|
|
|
|
|
|
|
|
To use these, you need to install afl (of course), and xterm. A tiling window manager helps manage
|
|
|
|
|
many concurrent fuzzer instances.
|
|
|
|
|
|
2020-04-05 11:05:18 +00:00
|
|
|
Note, afl sometimes requires system configuration, if you find AFL quitting prematurely, try manually
|
|
|
|
|
launching it and addressing any error messages.
|
|
|
|
|
|
2019-11-29 03:41:27 +00:00
|
|
|
## Fuzz the parser
|
|
|
|
|
```
|
|
|
|
|
$ sh ./tools/afl/prepare_to_fuzz.sh
|
2020-04-05 11:05:18 +00:00
|
|
|
$ export NFUZZ=1
|
2019-11-29 03:41:27 +00:00
|
|
|
$ sh ./tools/afl/fuzz.sh parser
|
|
|
|
|
Ctrl+C when done to close all fuzzer terminals.
|
|
|
|
|
$ sh ./tools/afl/aggregate_cases.sh parser
|
|
|
|
|
$ ls ./fuzz_out/parser_aggregated/
|
2020-04-05 11:05:18 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Fuzz the unmarshaller
|
|
|
|
|
```
|
|
|
|
|
$ janet ./tools/afl/generate_unmarshal_testcases.janet
|
|
|
|
|
$ sh ./tools/afl/prepare_to_fuzz.sh
|
|
|
|
|
$ export NFUZZ=1
|
|
|
|
|
$ sh ./tools/afl/fuzz.sh unmarshal
|
|
|
|
|
Ctrl+C when done to close all fuzzer terminals.
|
|
|
|
|
$ sh ./tools/afl/aggregate_cases.sh unmarshal
|
|
|
|
|
$ ls ./fuzz_out/unmarshal_aggregated/
|
|
|
|
|
```
|
