diff options
author | llzmb <46303940+llzmb@users.noreply.github.com> | 2021-08-12 23:06:34 +0200 |
---|---|---|
committer | llzmb <46303940+llzmb@users.noreply.github.com> | 2021-08-12 23:06:34 +0200 |
commit | 95b794744b4edd6e32eefc97998ec6aa041c5275 (patch) | |
tree | 3980caae2ec718d952ad5dce6be0a58551063af1 /docs/choosing_testcases.md | |
parent | b8fd0a1463fe5805d22f323777b65b7b2e2fcf46 (diff) | |
download | afl++-95b794744b4edd6e32eefc97998ec6aa041c5275.tar.gz |
Edit README.md
Changes: - Move advanced content to docs/. - Add links. - Fix links. - Restructure content.
Diffstat (limited to 'docs/choosing_testcases.md')
-rw-r--r-- | docs/choosing_testcases.md | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/docs/choosing_testcases.md b/docs/choosing_testcases.md new file mode 100644 index 00000000..25002929 --- /dev/null +++ b/docs/choosing_testcases.md @@ -0,0 +1,19 @@ +# Choosing initial test cases + +To operate correctly, the fuzzer requires one or more starting file that +contains a good example of the input data normally expected by the targeted +application. There are two basic rules: + + - Keep the files small. Under 1 kB is ideal, although not strictly necessary. + For a discussion of why size matters, see [perf_tips.md](perf_tips.md). + + - Use multiple test cases only if they are functionally different from + each other. There is no point in using fifty different vacation photos + to fuzz an image library. + +You can find many good examples of starting files in the testcases/ subdirectory +that comes with this tool. + +PS. If a large corpus of data is available for screening, you may want to use +the afl-cmin utility to identify a subset of functionally distinct files that +exercise different code paths in the target binary. \ No newline at end of file |