tools/fuzz: add README.afl

And rename README to README.oss-fuzz.

Signed-off-by: Wei Liu <wei.liu2@citrix.com>
Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>
This commit is contained in:
Wei Liu committed 2017-01-25 10:04:31 +00:00
1 parent a304574abe
commit 9e739d7cfe
2 files changed
+31

No files matched your search

+31
View File
@@ -0,0 +1,31 @@
# OVERVIEW
Some fuzzing targets have American Fuzzy Lop (AFL) support.
See also http://lcamtuf.coredump.cx/afl/
# HOW IT WORKS
AFL provides a customised toolchain to build an executable, which in
turn is launched by the fuzzer.
# HOW TO USE IT
Use the x86 instruction emulator fuzzer as an example.
1. download and compile AFL in $AFLPATH.
2. run the following commands to build:
$ cd tools/fuzz/x86_instruction_emulator
$ make distclean
$ make CC=$AFLPATH/afl-gcc afl # produces afl-x86-insn-emulator-fuzzer
3. provide initial test case:
$ mkdir testcase_dir
$ echo -n -e '\xc3' > testcase_dir/ret.bin
4. run the fuzzer with AFL:
$ $AFLPATH/afl-fuzz -m none -t 1000 -i testcase_dir -o findings_dir -- \
./afl-x86-insn-emulator-fuzzer @@
Please see AFL documentation for more information.
File renamed without changes.
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.