[LSC] Add LOCAL_LICENSE_KINDS to external/rust/crates/libfuzzer-sys am: 276f901c04 am: 31b9bb6b3b am: f15f241abf

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/libfuzzer-sys/+/1588729

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: Ic9a0f6447dda760b778b6bd225d6f33d4370a3a1
tree: 68d013bee6544df7e821cd8f9598d6a6b9c5e37c
  1. .github/
  2. ci/
  3. libfuzzer/
  4. patches/
  5. src/
  6. .cargo_vcs_info.json
  7. .gitignore
  8. Android.bp
  9. build.rs
  10. Cargo.toml
  11. Cargo.toml.orig
  12. CHANGELOG.md
  13. LICENSE
  14. METADATA
  15. MODULE_LICENSE_APACHE2
  16. MODULE_LICENSE_MIT
  17. OWNERS
  18. README.md
  19. rust-toolchain
  20. update-libfuzzer.sh
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!

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

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.