commit	1cbca1f4c6219058636242acfaded544bfadc26c	[log] [tgz]
author	Android Build Coastguard Worker <[email protected]>	Sat Jul 03 03:07:59 2021 +0000
committer	Android Build Coastguard Worker <[email protected]>	Sat Jul 03 03:07:59 2021 +0000
tree	7696ff23d6a2a0ae49c20e4bcfae2561022b8406
parent	27c3dfe8fbe46d2180ca0a4dd84c86483b5f287b [diff]
parent	74af3bd446cc65e32cc90d82cfa57cd5f67a759c [diff]

tree: 7696ff23d6a2a0ae49c20e4bcfae2561022b8406

README.md

The `libfuzzer-sys` Crate

Barebones 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.

Usage

Use `cargo fuzz`!

Manual Usage

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

Updating libfuzzer from upstream

./update-libfuzzer.sh <github.com/llvm-mirror/llvm-project SHA1>

License

All files in libfuzzer directory are licensed NCSA.

Everything else is dual-licensed Apache 2.0 and MIT.

The libfuzzer-sys Crate