d9095bbe03
We now check for whether the build is done on Windows, so that: -We link to -lws2_32, which is necessary for the networking functions on Windows. -We default to using libicu on Windows for the runtime and builtins, as the code using libidn and libidn2 use stuff from langinfo.h, which is not available on Windows. -We do not build and run the tests under fuzz/ as Windows does not have fmemopen(). This enables the code to be built on Windows via MinGW. |
||
|---|---|---|
| .. | ||
| libpsl_fuzzer.in | ||
| libpsl_icu_fuzzer.in | ||
| libpsl_icu_load_dafsa_fuzzer.in | ||
| libpsl_icu_load_fuzzer.in | ||
| libpsl_icu_load_fuzzer.repro | ||
| libpsl_idn2_fuzzer.in | ||
| libpsl_idn2_fuzzer.repro | ||
| libpsl_idn2_load_dafsa_fuzzer.in | ||
| libpsl_idn2_load_fuzzer.in | ||
| libpsl_idn_fuzzer.in | ||
| libpsl_idn_load_dafsa_fuzzer.in | ||
| libpsl_idn_load_fuzzer.in | ||
| libpsl_load_dafsa_fuzzer.in | ||
| libpsl_load_fuzzer.in | ||
| Makefile.am | ||
| README.md | ||
| coverage.sh | ||
| fuzzer.h | ||
| get_all_corpora | ||
| get_ossfuzz_corpora | ||
| libpsl_fuzzer.c | ||
| libpsl_icu_load_fuzzer.dict | ||
| libpsl_idn2_load_fuzzer.dict | ||
| libpsl_idn_load_fuzzer.dict | ||
| libpsl_load_dafsa_fuzzer.c | ||
| libpsl_load_fuzzer.c | ||
| libpsl_load_fuzzer.dict | ||
| main.c | ||
| run-afl.sh | ||
| run-clang.sh | ||
| view-coverage.sh | ||
README.md
Fuzzers
These are fuzzers designed for use with libFuzzer or afl. They can
be used to run on Google's OSS-Fuzz (https://github.com/google/oss-fuzz/).
The convention used here is that the initial values for each parser fuzzer are taken from the $NAME.in directory.
Crash reproducers from OSS-Fuzz are put into $NAME.repro directory for regression testing with top dir 'make check' or 'make check-valgrind'.
The ./configure runs below are for libidn2. To test libicu replace 'libidn2' with 'libicu', to test with libidn replace 'libidn2' by 'libidn'.
Running a fuzzer using clang
Use the following commands on top dir:
export CC=clang-5.0
export CFLAGS="-O1 -fno-omit-frame-pointer -gline-tables-only -DFUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION -fsanitize=address -fsanitize-address-use-after-scope -fsanitize-coverage=trace-pc-guard,trace-cmp"
./configure --enable-static --disable-gtk-doc --enable-runtime=libidn2 --enable-builtin=libidn2
make clean
make -j$(nproc)
cd fuzz
# build and run libpsl_fuzzer
./run-clang.sh libpsl_fuzzer
Running a fuzzer using AFL
Use the following commands on top dir:
$ CC=afl-clang-fast ./configure --disable-gtk-doc --enable-runtime=libidn2 --enable-builtin=libidn2
$ make -j$(nproc) clean all
$ cd fuzz
$ ./run-afl.sh libpsl_fuzzer
Fuzz code coverage using the corpus directories *.in/
Code coverage reports currently work best with gcc+lcov+genhtml.
In the top directory:
CC=gcc CFLAGS="-O0 -g" ./configure --disable-gtk-doc --enable-runtime=libidn2 --enable-builtin=libidn2
make fuzz-coverage
xdg-open lcov/index.html
Each fuzzer target has it's own functions to cover, e.g.
libpsl_fuzzer covers psl_is_public_suffix.
To work on corpora for better coverage, cd fuzz and use e.g.
./view-coverage.sh libpsl_fuzzer.
Enhancing the testsuite for issues found
Each reproducer file should be dropped into the appropriate *.repro/ directory.
Clang CFI instrumentation
CC=clang-5.0 CFLAGS="-B/usr/bin/gold -O0 -fsanitize=cfi -flto -fvisibility=default -fno-sanitize-trap=all" ./configure
make clean
make
make check