And rename README to README.oss-fuzz. Signed-off-by: Wei Liu <wei.l...@citrix.com> --- Cc: Andrew Cooper <andrew.coop...@citrix.com> Cc: George Dunlap <george.dun...@eu.citrix.com> Cc: Ian Jackson <ian.jack...@eu.citrix.com> Cc: Jan Beulich <jbeul...@suse.com> --- tools/fuzz/README.afl | 27 +++++++++++++++++++++++++++ tools/fuzz/{README => README.oss-fuzz} | 0 2 files changed, 27 insertions(+) create mode 100644 tools/fuzz/README.afl rename tools/fuzz/{README => README.oss-fuzz} (100%)
diff --git a/tools/fuzz/README.afl b/tools/fuzz/README.afl new file mode 100644 index 0000000..7214b61 --- /dev/null +++ b/tools/fuzz/README.afl @@ -0,0 +1,27 @@ +# 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. 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. diff --git a/tools/fuzz/README b/tools/fuzz/README.oss-fuzz similarity index 100% rename from tools/fuzz/README rename to tools/fuzz/README.oss-fuzz -- 2.1.4 _______________________________________________ Xen-devel mailing list Xen-devel@lists.xen.org https://lists.xen.org/xen-devel