Google Git
Sign in
android / platform / external / honggfuzz / 71aa60c5e5e8f38c4b281fc1f20cc8514e4e25cc
commit71aa60c5e5e8f38c4b281fc1f20cc8514e4e25cc[log] [tgz]
authorandroid-build-prod (mdb) <android-build-team-robot@google.com>Wed Feb 24 17:52:21 2021 +0000
committerandroid-build-prod (mdb) <android-build-team-robot@google.com>Wed Feb 24 17:52:21 2021 +0000
tree500cf6780f4769f7194dc50139b221794efcef84
parent9753ed4234cf5389522a06f89b443a7301c46c76 [diff]
parent81e95bc92a31c6024516ffe42556b0be760e2488 [diff]
Snap for 7168215 from 81e95bc92a31c6024516ffe42556b0be760e2488 to simpleperf-release

Change-Id: I61af97925344558f850c46e1b5249102da553dac
tree: 500cf6780f4769f7194dc50139b221794efcef84
  1. docs/
  2. examples/
  3. hfuzz_cc/
  4. includes/
  5. libhfcommon/
  6. libhfnetdriver/
  7. libhfuzz/
  8. linux/
  9. mac/
  10. netbsd/
  11. posix/
  12. qemu_mode/
  13. socketfuzzer/
  14. third_party/
  15. tools/
  16. LICENSE ⇨ COPYING
  17. NOTICE ⇨ COPYING
  18. .clang-format
  19. .gitattributes
  20. .gitignore
  21. Android.bp
  22. arch.h
  23. CHANGELOG
  24. cmdline.c
  25. cmdline.h
  26. CONTRIBUTING.md
  27. COPYING
  28. display.c
  29. display.h
  30. Dockerfile
  31. fuzz.c
  32. fuzz.h
  33. honggfuzz.c
  34. honggfuzz.h
  35. input.c
  36. input.h
  37. Makefile
  38. mangle.c
  39. mangle.h
  40. METADATA
  41. MODULE_LICENSE_APACHE2
  42. OWNERS
  43. README.md
  44. report.c
  45. report.h
  46. sanitizers.c
  47. sanitizers.h
  48. screenshot-honggfuzz-1.png
  49. socketfuzzer.c
  50. socketfuzzer.h
  51. subproc.c
  52. subproc.h
README.md

Honggfuzz

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

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 the 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 a corpus minimization mode.

Requirements

  • Linux - The BFD library (libbfd-dev) and libunwind (libunwind-dev/libunwind8-dev), clang-5.0 or higher for software-based coverage modes
  • FreeBSD - gmake, clang-5.0 or newer
  • 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:

Projects utilizing or inspired-by Honggfuzz

Contact

This is NOT an official Google product