Skip to content

Commit c3f65bf

Browse files
committed
update new readme
1 parent 2323c30 commit c3f65bf

File tree

1 file changed

+23
-13
lines changed

1 file changed

+23
-13
lines changed

README_new.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,22 +11,32 @@
1111
Repository: [https://github.com/AFLplusplus/AFLplusplus](https://github.com/AFLplusplus/AFLplusplus)
1212

1313
afl++ is maintained by:
14-
* Marc "van Hauser" Heuse <[email protected]>,
15-
* Heiko "hexcoder-" Eißfeldt <[email protected]>,
16-
* Andrea Fioraldi <[email protected]> and
17-
* Dominik Maier <[email protected]>.
14+
15+
* Marc "van Hauser" Heuse <[email protected]>,
16+
* Heiko "hexcoder-" Eißfeldt <[email protected]>,
17+
* Andrea Fioraldi <[email protected]> and
18+
* Dominik Maier <[email protected]>.
1819

1920
Originally developed by Michal "lcamtuf" Zalewski.
2021

21-
Note that although afl now has a Google afl repository [https://github.com/Google/afl](https://github.com/Google/afl),
22-
it is unlikely to receive any notable enhancements: [https://twitter.com/Dor3s/status/1154737061787660288](https://twitter.com/Dor3s/status/1154737061787660288)
23-
includes all necessary/interesting changes from Google's afl 2.57b
22+
afl++ is superiour to Google's afl in any way - more speed, more and better
23+
mutations, more and better instrumentation, etc. etc.
24+
25+
## Contents
26+
27+
1. [Features](#important-features-of-afl++)
28+
2. [How to compile and install afl++](#building-and-installing-afl++)
29+
3. [How to fuzz a target](#how-to-fuzz-with-afl++)
30+
4. [Fuzzing binary-only targets](#fuzzing-binary-only-targets)
31+
5. [Branches](#branches)
32+
6. [Want to help?](#help-wanted)
33+
7. [Detailed help and description of afl++](#challenges-of-guided-fuzzing)
2434

25-
## The enhancements compared to the original stock afl
35+
## Important features of afl++
2636

27-
Among other changes afl++ has a more performant llvm_mode, supports
28-
llvm up to version 12, QEMU 3.1 with more speed and features,
29-
better *BSD, Solaris and Android support and much, much, much more.
37+
afl++ supports llvm up to version 12, very fast binary fuzzing with QEMU 3.1
38+
with laf-intel and redqueen, unicorn mode, gcc plugin, full *BSD, Solaris and
39+
Android support and much, much, much more.
3040

3141
| Feature/Instrumentation | afl-gcc | llvm_mode | gcc_plugin | qemu_mode | unicorn_mode |
3242
| ----------------------- |:-------:|:---------:|:----------:|:----------------:|:------------:|
@@ -114,7 +124,7 @@
114124

115125
For releases, please see the [Releases](https://github.com/AFLplusplus/AFLplusplus/releases) tab.
116126

117-
## Google Summer of Code 2020 (and any other students and enthusiast developers)
127+
## Help wanted
118128

119129
We are happy to be part of [Google Summer of Code 2020](https://summerofcode.withgoogle.com/organizations/5100744400699392/)! :-)
120130

@@ -632,7 +642,7 @@ PS. ASAN users are advised to review [docs/notes_for_asan.md](docs/notes_for_asa
632642
file for important caveats.
633643

634644

635-
## Instrumenting binary-only apps
645+
## Fuzzing binary-only targets
636646

637647
When source code is *NOT* available, the fuzzer offers experimental support for
638648
fast, on-the-fly instrumentation of black-box binaries. This is accomplished

0 commit comments

Comments
 (0)