| commit | 1b0f479bcdd9b499eaa584d6b97e82381a05df9c | [log] [tgz] |
|---|---|---|
| author | Ivan Lozano <[email protected]> | Mon Nov 16 11:00:19 2020 -0500 |
| committer | Ivan Lozano <[email protected]> | Tue Nov 17 10:05:40 2020 -0500 |
| tree | 20ca241ea27f48740dcbca22ba00bc936bfe82f1 | |
| parent | d4c94dacf666d5ad26d334b2a48d0d63ee31b972 [diff] |
Add metadata and build files for libfuzzer-sys Bug: 147140513 Test: mma Change-Id: Ic144aef7341eb6e651badffe977d6d028f4793f0
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.3.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' \ -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.