[thirdparty/hostap.git] / tests / fuzzing / README

hostap.git fuzz testing
-----------------------

These tools can be used for fuzz testing of various components used
within wpa_supplicant and hostapd. Each directory contains a fuzzing
tool that focuses on one input handler. Each tool can be compiled either
to work with the libFuzzer or as a separate tool that reads the input
from a file specified on the command line, e.g., for American fuzzy lop
(afl-fuzz). Example test corpus is included in */corpus directory.

Example fuzzing with libFuzzer

cd @TOOL@
make clean
make LIBFUZZER=y
./@TOOL@ corpus

Example fuzzing with afl-fuzz

cd @TOOL@
make clean
CC=afl-gcc make
afl-fuzz -i corpus -o findings -- $PWD/@TOOL@ @@
Commit	Line	Data
065e6e70 JM	1	hostap.git fuzz testing
	2	-----------------------
	3
	4	These tools can be used for fuzz testing of various components used
	5	within wpa_supplicant and hostapd. Each directory contains a fuzzing
	6	tool that focuses on one input handler. Each tool can be compiled either
	7	to work with the libFuzzer or as a separate tool that reads the input
	8	from a file specified on the command line, e.g., for American fuzzy lop
	9	(afl-fuzz). Example test corpus is included in */corpus directory.
	10
	11	Example fuzzing with libFuzzer
	12
	13	cd @TOOL@
	14	make clean
	15	make LIBFUZZER=y
	16	./@TOOL@ corpus
	17
	18	Example fuzzing with afl-fuzz
	19
	20	cd @TOOL@
	21	make clean
	22	CC=afl-gcc make
	23	afl-fuzz -i corpus -o findings -- $PWD/@TOOL@ @@