16 releases

0.4.6 Jan 26, 2023
0.4.5 Oct 18, 2022
0.4.4 Sep 1, 2022
0.4.3 Mar 3, 2022
0.1.1 Sep 10, 2019

#79 in Development tools

Download history 19297/week @ 2022-11-28 20697/week @ 2022-12-05 20643/week @ 2022-12-12 16904/week @ 2022-12-19 11854/week @ 2022-12-26 21001/week @ 2023-01-02 21001/week @ 2023-01-09 19671/week @ 2023-01-16 19537/week @ 2023-01-23 22468/week @ 2023-01-30 22663/week @ 2023-02-06 21873/week @ 2023-02-13 19606/week @ 2023-02-20 20181/week @ 2023-02-27 19529/week @ 2023-03-06 19638/week @ 2023-03-13

80,393 downloads per month
Used in 21 crates (8 directly)

MIT/Apache-2.0/NCSA

380KB
8K SLoC

C++ 8K SLoC // 0.1% comments Rust 190 SLoC // 0.2% comments Python 63 SLoC // 0.2% comments Shell 43 SLoC // 0.2% comments C 25 SLoC // 0.4% comments

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!

The recommended way to use this crate with 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.

Dependencies

~110–440KB