README.md

Description

A security oriented, feedback-driven, evolutionary, easy-to-use fuzzer with interesting analysis options. See the Usage document for a primer on Honggfuzz use.

Code

• Latest stable version: 1.9
• Changelog

Features

• It's multi-process and multi-threaded: there's no need to run multiple copies of your fuzzer, as honggfuzz can unlock potential of all your available CPU cores with a single running instance. The file corpus is automatically shared and improved between all fuzzed processes.
• It's blazingly fast when the persistent fuzzing mode) is used. A simple/empty LLVMFuzzerTestOneInput function can be tested with up to 1mo iterations per second on a relatively modern CPU (e.g. i7-6700K).
• Has a solid track record of uncovered security bugs: the only (to the date) vulnerability in OpenSSL with the critical score mark was discovered by honggfuzz. See the Trophies paragraph for the summary of findings to the date.
• Uses low-level interfaces to monitor processes (e.g. ptrace under Linux and NetBSD). As opposed to other fuzzers, it will discover and report hijacked/ignored signals from crashes (intercepted and potentially hidden by a fuzzed program).
• Easy-to-use, feed it a simple corpus directory (can even be empty for [feedback-driven fuzzing]) and it will work its way up, expanding it by utilizing feedback-based coverage metrics.
• Supports several (more than any other coverage-based feedback-driven fuzzer) hardware-based (CPU: branch/instruction counting, Intel BTS, Intel PT) and software-based feedback-driven fuzzing modes. Also, see the new qemu mode for blackbox binary fuzzing.
• Works (at least) under GNU/Linux, FreeBSD, NetBSD, Mac OS X, Windows/CygWin and Android.
• Supports the persistent fuzzing mode (long-lived process calling a fuzzed API repeatedly). More on that can be found here.
• It comes with the examples directory, consisting of real world fuzz setups for widely-used software (e.g. Apache HTTPS, OpenSSL, libjpeg etc.).
• Provides corpus minimization modes.

Requirements

• Linux - The BFD library (libbfd-dev) and libunwind (libunwind-dev/libunwind8-dev), clang-4.0 or higher for software-based coverage modes
• FreeBSD - gmake, clang-3.6 or newer (clang-devel/4.0 suggested)
• NetBSD - gmake, clang, capstone, libBlocksRuntime
• Android - Android SDK/NDK. Also see this detailed doc on how to build and run it
• Windows - CygWin
• Darwin/OS X - Xcode 10.8+
• if Clang/LLVM is used to compile honggfuzz - link it with the BlocksRuntime Library (libblocksruntime-dev)

Trophies

Honggfuzz has been used to find a few interesting security problems in major software packages; An incomplete list:

• Pre-auth remote crash in OpenSSH
• Apache HTTPD
  • Remote crash in mod_http2 • CVE-2017-7659
  • Use-after-free in mod_http2 • CVE-2017-9789
  • Memory leak in mod_auth_digest • CVE-2017-9788
  • Out of bound access • CVE-2018-1301
  • Write after free in HTTP/2 • CVE-2018-1302
  • Out of bound read • CVE-2018-1303
• Various SSL libs
  • Remote OOB read in OpenSSL • CVE-2015-1789
  • Remote Use-after-Free (potential RCE, rated as critical) in OpenSSL • CVE-2016-6309
  • Remote OOB write in OpenSSL • CVE-2016-7054
  • Remote OOB read in OpenSSL • CVE-2017-3731
  • Uninitialized mem use in OpenSSL
  • Crash in LibreSSL
  • Invalid free in LibreSSL
  • Uninitialized mem use in BoringSSL
• Adobe Flash memory corruption • CVE-2015-0316
• Multiple bugs in the libtiff library
• Multiple bugs in the librsvg library
• Multiple bugs in the poppler library
• Multiple exploitable bugs in IDA-Pro
• Remote DoS in Crypto++ • CVE-2016-9939
• Programming language interpreters
  • PHP/Python/Ruby
  • PHP WDDX
  • PHP
  • Perl
• Double-free in LibXMP
• Heap buffer overflow in SAPCAR • CVE-2017-8852
• Crashes in libbass
• FreeType 2:
  • CVE-2010-2497
  • CVE-2010-2498
  • CVE-2010-2499
  • CVE-2010-2500
  • CVE-2010-2519
  • CVE-2010-2520
  • CVE-2010-2527
• Infinite loop in NGINX Unit
• A couple of problems in the MATLAB MAT File I/O Library: #1, #2, #3, #4, #5
• Samba's tdbdump + tdbtool
• Crash in djvulibre
• Multiple crashes in VLC
• Buffer overflow in ClassiCube
• Crash in MPV
• Heap buffer-overflow in picoc
• Crashes in OpenCOBOL: #1, #2
• Rust:
  • panic() in regex #1, #2, #3
  • panic() in h2 #1, #2, #3
  • panic() in sleep-parser #1
  • panic() in lewton #1
  • panic()/DoS in Ethereum-Parity #1
  • crash() in Parts - a GPT partition manager #1
  • crashes in rust-bitcoin/rust-lightning #1
• ... and more

Projects utilizing Honggfuzz

• QuickFuzz by CIFASIS
• OSS-Fuzz
• Frog And Fuzz
• dyjakan's interpreters fuzzing project
• riufuzz: honggfuzz with AFL-like UI
• h2fuzz: fuzzing Apache's HTTP/2 implementation
• honggfuzz-dharma: honggfuzz with dharma grammar fuzzer
• Owl: a system for finding concurrency attacks
• honggfuzz-docker-apps
• FFW - Fuzzing For Worms
• honggfuzz-rs: fuzzing Rust with Honggfuzz
• roughenough-fuzz
• Monkey: a HTTP server
• Killerbeez API
• FuzzM: a gray box model-based fuzzing framework
• FuzzOS: by Mozilla Security
• Android: by OHA
• QDBI: by Quarkslab
• fuzzer-test-suite: by Google
• DeepState: by Trail-of-Bits
• DeepState: by Trail-of-Bits
• Quiche-HTTP/3: by Cloudflare
  • Rust's fuzztest
  • and multiple Rust projecs

Fuzzing examples

The examples directory contains code demonstrating (among others) how to use honggfuzz to find bugs in the OpenSSL library and in the Apache HTTPD web server.

Contact

• User mailing list: [email protected], sign up with this link.

This is NOT an official Google product