mirror of https://github.com/openssl/openssl.git synced 2024-11-21 01:15:20 +08:00

History

Alex Gaynor 03cb37acec Add comment about X509_print Signed-off-by: Kurt Roeckx <kurt@roeckx.be> Reviewed-by: Emilia Kasper <emilia@openssl.org> GH: #1255		2016-06-28 18:30:41 +02:00
..
corpora	Add x509 and crl corpora	2016-06-25 11:01:29 +02:00
asn1.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
asn1parse.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
bignum.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
bndiv.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
build.info	Add X509 and CRL fuzzer	2016-06-25 11:01:29 +02:00
cms.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
conf.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
crl.c	Add X509 and CRL fuzzer	2016-06-25 11:01:29 +02:00
ct.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
driver.c	include stdlib for malloc() and free()	2016-06-11 16:43:49 +02:00
fuzzer.h	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
helper.py
README.md	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
server.c	Add support for fuzzing with AFL	2016-06-04 14:39:24 +02:00
x509.c	Add comment about X509_print	2016-06-28 18:30:41 +02:00

README.md

I Can Haz Fuzz?

LibFuzzer

Or, how to fuzz OpenSSL with libfuzzer.

Starting from a vanilla+OpenSSH server Ubuntu install.

Use Chrome's handy recent build of clang. Older versions may also work.

$ sudo apt-get install git
$ mkdir git-work
$ git clone https://chromium.googlesource.com/chromium/src/tools/clang
$ clang/scripts/update.py

You may want to git pull and re-run the update from time to time.

Update your path:

$ PATH=~/third_party/llvm-build/Release+Asserts/bin/:$PATH

Get and build libFuzzer (there is a git mirror at https://github.com/llvm-mirror/llvm/tree/master/lib/Fuzzer if you prefer):

$ cd
$ sudo apt-get install subversion
$ mkdir svn-work
$ cd svn-work
$ svn co http://llvm.org/svn/llvm-project/llvm/trunk/lib/Fuzzer
$ cd Fuzzer
$ clang++ -c -g -O2 -std=c++11 *.cpp
$ ar r libFuzzer.a *.o
$ ranlib libFuzzer.a

Configure for fuzzing:

$ CC=clang ./config enable-fuzz-libfuzzer \
        --with-fuzzer-include=../../svn-work/Fuzzer \
        --with-fuzzer-lib=../../svn-work/Fuzzer/libFuzzer \
        enable-asan enable-ubsan no-shared
$ sudo apt-get install make
$ LDCMD=clang++ make -j
$ fuzz/helper.py <fuzzer> <arguments>

Where <fuzzer> is one of the executables in fuzz/. Most fuzzers do not need any command line arguments, but, for example, asn1 needs the name of a data type.

If you get a crash, you should find a corresponding input file in fuzz/corpora/<fuzzer>-crash/. You can reproduce the crash with

$ fuzz/<fuzzer> <crashfile>

AFL

Configure for fuzzing:

$ sudo apt-get install afl-clang
$ CC=afl-clang-fast ./config enable-fuzz-afl no-shared
$ make

Run one of the fuzzers:

$ afl-fuzz fuzz/<fuzzer> -i fuzz/corpora/<fuzzer> -o fuzz/corpora/<fuzzer>/out <fuzzer> <arguments>

Where <fuzzer> is one of the executables in fuzz/. Most fuzzers do not need any command line arguments, but, for example, asn1 needs the name of a data type.