search

rust-fuzz / cargo-fuzz

Command line helpers for fuzzing
https://rust-fuzz.github.io/book/cargo-fuzz.html
Apache License 2.0
1.48k stars 108 forks source link

Document getting started without sanitizers. #347

Open Eh2406 opened 9 months ago

Eh2406 commented 9 months ago

Apparently cargo-fuzz supports being used without sanitizers. This is mentioned on Reddit and in #158. After stumbling across this information I tried looking at the readme which claims:

Note: libFuzzer needs LLVM sanitizer support, ...

And the book which claims:

libFuzzer needs LLVM sanitizer support, ...

My first interpretation was that the post and issue were out of date, and sanitizer support was added back in. But I'm not sure. Is the documentation just out of date?

Can we clarify the introductory documentation about whether sanitizers are needed? At a minimum by changing those sentences. Even better would be adding instructions on how to get started if you explicitly do not want to use a sanitizer.

fitzgen commented 8 months ago

libfuzzer needs sancov to track coverage but doesn't need asan or anything like that.