From c3f65bff5b904a430f36d5240bfb680bbb577ccb Mon Sep 17 00:00:00 2001 From: van Hauser Date: Mon, 27 Jul 2020 00:13:03 +0200 Subject: update new readme --- README_new.md | 36 +++++++++++++++++++++++------------- 1 file changed, 23 insertions(+), 13 deletions(-) diff --git a/README_new.md b/README_new.md index 7e817fd3..6b56f2ab 100644 --- a/README_new.md +++ b/README_new.md @@ -11,22 +11,32 @@ Repository: [https://github.com/AFLplusplus/AFLplusplus](https://github.com/AFLplusplus/AFLplusplus) afl++ is maintained by: - * Marc "van Hauser" Heuse , - * Heiko "hexcoder-" Eißfeldt , - * Andrea Fioraldi and - * Dominik Maier . + + * Marc "van Hauser" Heuse , + * Heiko "hexcoder-" Eißfeldt , + * Andrea Fioraldi and + * Dominik Maier . Originally developed by Michal "lcamtuf" Zalewski. - Note that although afl now has a Google afl repository [https://github.com/Google/afl](https://github.com/Google/afl), - it is unlikely to receive any notable enhancements: [https://twitter.com/Dor3s/status/1154737061787660288](https://twitter.com/Dor3s/status/1154737061787660288) - includes all necessary/interesting changes from Google's afl 2.57b + afl++ is superiour to Google's afl in any way - more speed, more and better + mutations, more and better instrumentation, etc. etc. + +## Contents + + 1. [Features](#important-features-of-afl++) + 2. [How to compile and install afl++](#building-and-installing-afl++) + 3. [How to fuzz a target](#how-to-fuzz-with-afl++) + 4. [Fuzzing binary-only targets](#fuzzing-binary-only-targets) + 5. [Branches](#branches) + 6. [Want to help?](#help-wanted) + 7. [Detailed help and description of afl++](#challenges-of-guided-fuzzing) -## The enhancements compared to the original stock afl +## Important features of afl++ - Among other changes afl++ has a more performant llvm_mode, supports - llvm up to version 12, QEMU 3.1 with more speed and features, - better *BSD, Solaris and Android support and much, much, much more. + afl++ supports llvm up to version 12, very fast binary fuzzing with QEMU 3.1 + with laf-intel and redqueen, unicorn mode, gcc plugin, full *BSD, Solaris and + Android support and much, much, much more. | Feature/Instrumentation | afl-gcc | llvm_mode | gcc_plugin | qemu_mode | unicorn_mode | | ----------------------- |:-------:|:---------:|:----------:|:----------------:|:------------:| @@ -114,7 +124,7 @@ For releases, please see the [Releases](https://github.com/AFLplusplus/AFLplusplus/releases) tab. -## Google Summer of Code 2020 (and any other students and enthusiast developers) +## Help wanted We are happy to be part of [Google Summer of Code 2020](https://summerofcode.withgoogle.com/organizations/5100744400699392/)! :-) @@ -632,7 +642,7 @@ PS. ASAN users are advised to review [docs/notes_for_asan.md](docs/notes_for_asa file for important caveats. -## Instrumenting binary-only apps +## Fuzzing binary-only targets When source code is *NOT* available, the fuzzer offers experimental support for fast, on-the-fly instrumentation of black-box binaries. This is accomplished -- cgit 1.4.1