commit | 9e47a4545b09e39adc8508274b8870a07e758aa0 | [log] [tgz] |
---|---|---|
author | Andrew Walbran <qwandor@google.com> | Mon Nov 20 18:25:48 2023 +0000 |
committer | Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com> | Mon Nov 20 18:25:48 2023 +0000 |
tree | 76997bf0e41150dd3770d52411a947bf2d4133e6 | |
parent | ec155a672f6372afb62b497db250628d941397af [diff] | |
parent | 778c748120ad0d3c910ecf072b22aae67c1a051a [diff] |
Migrate to cargo_embargo. am: 1995e408fd am: 778c748120 Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/libfuzzer-sys/+/2832653 Change-Id: I4d17bc128c410703c6b0c4c69150bfe720bbe389 Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
libfuzzer-sys
CrateBarebones wrapper around LLVM's libFuzzer runtime library.
The CPP parts are extracted from compiler-rt git repository with git filter-branch
.
libFuzzer relies on LLVM sanitizer support. The Rust compiler has built-in support for LLVM sanitizer support, for now, it's limited to Linux. As a result, libfuzzer-sys
only works on Linux.
cargo fuzz
!The recommended way to use this crate with cargo fuzz
!.
This crate can also be used manually as following:
First create a new cargo project:
$ cargo new --bin fuzzed $ cd fuzzed
Then add a dependency on the fuzzer-sys
crate and your own crate:
[dependencies] libfuzzer-sys = "0.4.0" your_crate = { path = "../path/to/your/crate" }
Change the fuzzed/src/main.rs
to fuzz your code:
#![no_main] use libfuzzer_sys::fuzz_target; fuzz_target!(|data: &[u8]| { // code to fuzz goes here });
Build by running the following command:
$ cargo rustc -- \ -C passes='sancov' \ -C llvm-args='-sanitizer-coverage-level=3' \ -C llvm-args='-sanitizer-coverage-inline-8bit-counters' \ -Z sanitizer=address
And finally, run the fuzzer:
$ ./target/debug/fuzzed
./update-libfuzzer.sh <github.com/llvm-mirror/llvm-project SHA1>
All files in libfuzzer
directory are licensed NCSA.
Everything else is dual-licensed Apache 2.0 and MIT.