diff options
author | van Hauser <vh@thc.org> | 2020-07-27 00:13:03 +0200 |
---|---|---|
committer | van Hauser <vh@thc.org> | 2020-07-27 00:13:03 +0200 |
commit | c3f65bff5b904a430f36d5240bfb680bbb577ccb (patch) | |
tree | 3b6276534db42e58f3d66280e6e1398881f1b404 | |
parent | 2323c30b5b655e207bfb143fec34621052ea4e90 (diff) | |
download | afl++-c3f65bff5b904a430f36d5240bfb680bbb577ccb.tar.gz |
update new readme
-rw-r--r-- | README_new.md | 36 |
1 files 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 <mh@mh-sec.de>, - * Heiko "hexcoder-" Eißfeldt <heiko.eissfeldt@hexco.de>, - * Andrea Fioraldi <andreafioraldi@gmail.com> and - * Dominik Maier <mail@dmnk.co>. + + * Marc "van Hauser" Heuse <mh@mh-sec.de>, + * Heiko "hexcoder-" Eißfeldt <heiko.eissfeldt@hexco.de>, + * Andrea Fioraldi <andreafioraldi@gmail.com> and + * Dominik Maier <mail@dmnk.co>. 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 |