Cleanup the README a bit more (#2569)

* Move fuzzers around some more

* back to baby

* this was missing..

* shuffeling shuffeling

* shuffeling

* md

* cleanup

* oops

* Move foldername to underscore

* more doc

* Add links

* cleanup
This commit is contained in:
Dominik Maier 2024-09-27 18:18:50 +02:00 committed by GitHub
parent 4b99c69e51
commit d72fa6ca6f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -5,14 +5,13 @@
You can find a large amount of example fuzzers built on top of LibAFL. You can find a large amount of example fuzzers built on top of LibAFL.
They are sorted by focus: They are sorted by focus:
- `baby`: Minimal fuzzers and fuzzers demonstrating specific features that don't fit anywhere else. - [`baby`](./baby/): Minimal fuzzers and fuzzers demonstrating specific features that don't fit anywhere else.
- `inprocess`: Common In-process fuzzers. Most of the time, this is what you want. - [`binary_only`](./binary_only/): Fuzzers for binary-only targets.
- `binary_only`: Fuzzers for binary-only targets. - [`forkserver`](./forkserver/): Fuzzers that use a forkserver-style executor.
- `forkserver`: Fuzzers that use a forkserver-style executor. - [`full_system`](./full_system/): Fuzzers for full-system targets (kernels, firmwares, etc...).
- `full_system`: Fuzzers for full-system targets (kernels, firmwares, etc...). - [`fuzz-anything`](./fuzz_anything/): Fuzzers for advanced targets like WASM or python, and other fuzzers that can be used for anything.
- `fuzzbench`: Fuzzbench fuzzers. - [`inprocess`](./inprocess/): Common In-process fuzzers. Most of the time, this is what you want.
- `structure_aware`: Grammar fuzzers, fuzzers for certain languages, fuzzers with custom inputs, and more. - [`structure_aware`](./structure_aware/): Grammar fuzzers, fuzzers for certain languages, fuzzers with custom inputs, and more.
- `fuzz-anything`: Fuzzers for advanced targets like WASM or python, and other fuzzers that can be used for anything.
(Some fuzzers may fit into multiple categories, in which case we sort them as it makes sense, for example `structure_aware > full_system > binary_only > the rest`) (Some fuzzers may fit into multiple categories, in which case we sort them as it makes sense, for example `structure_aware > full_system > binary_only > the rest`)
@ -20,7 +19,7 @@ They are sorted by focus:
Some rather complete fuzzers worth looking at are: Some rather complete fuzzers worth looking at are:
- [`Libfuzzer_Libpng_Launcher`](./inprocess//): That's what most people want to use: our InProcess fuzzer with a lot of features like ASAn on some cores, multi threading (a better libfuzzer). - [`Libfuzzer_Libpng_Launcher`](./inprocess/libfuzzer_libpng_launcher): That's what most people want to use: our InProcess fuzzer with a lot of features like ASAn on some cores, multi threading (a better libfuzzer).
- [`LibAFL-fuzz`](./forkserver/libafl-fuzz/): A reimplementation of afl-fuzz, the traditional forkserver fuzzer that tries to emulate the command line and behavior. - [`LibAFL-fuzz`](./forkserver/libafl-fuzz/): A reimplementation of afl-fuzz, the traditional forkserver fuzzer that tries to emulate the command line and behavior.
- [`LibAFL-QEMU-Launcher`](./binary_only/qemu_launcher/): A full-featured QEMU-mode fuzzer that runs on multiple cores - [`LibAFL-QEMU-Launcher`](./binary_only/qemu_launcher/): A full-featured QEMU-mode fuzzer that runs on multiple cores