//! Bindings to [libFuzzer](http://llvm.org/docs/LibFuzzer.html): a runtime for

//! coverage-guided fuzzing.

//!

//! See [the `cargo-fuzz`

//! guide](https://rust-fuzz.github.io/book/cargo-fuzz.html) for a usage

//! tutorial.

//!

//! The main export of this crate is [the `fuzz_target!`

//! macro](./macro.fuzz_target.html), which allows you to define targets for

//! libFuzzer to exercise.

#![deny(missing_docs, missing_debug_implementations)]

pub use arbitrary;

extern "C" {

    // We do not actually cross the FFI bound here.

    #[allow(improper_ctypes)]

    fn rust_fuzzer_test_input(input: &[u8]);

}

#[doc(hidden)]

#[export_name = "LLVMFuzzerTestOneInput"]

pub fn test_input_wrap(data: *const u8, size: usize) -> i32 {

    let test_input = ::std::panic::catch_unwind(|| unsafe {

        let data_slice = ::std::slice::from_raw_parts(data, size);

        rust_fuzzer_test_input(data_slice);

    });

    if test_input.err().is_some() {

        // hopefully the custom panic hook will be called before and abort the

        // process before the stack frames are unwinded.

        ::std::process::abort();

    }

    0

}

#[doc(hidden)]

#[export_name = "LLVMFuzzerInitialize"]

pub fn initialize(_argc: *const isize, _argv: *const *const *const u8) -> isize {

    // Registers a panic hook that aborts the process before unwinding.

    // It is useful to abort before unwinding so that the fuzzer will then be

    // able to analyse the process stack frames to tell different bugs appart.

    //

    // HACK / FIXME: it would be better to use `-C panic=abort` but it's currently

    // impossible to build code using compiler plugins with this flag.

    // We will be able to remove this code when

    // https://github.com/rust-lang/cargo/issues/5423 is fixed.

    let default_hook = ::std::panic::take_hook();

    ::std::panic::set_hook(Box::new(move |panic_info| {

        default_hook(panic_info);

        ::std::process::abort();

    }));

    0

}

/// Define a fuzz target.

///

/// ## Example

///

/// This example takes a `&[u8]` slice and attempts to parse it. The parsing

/// might fail and return an `Err`, but it shouldn't ever panic or segfault.

///

/// ```no_run

/// #![no_main]

///

/// use libfuzzer_sys::fuzz_target;

///

/// // Note: `|input|` is short for `|input: &[u8]|`.

/// fuzz_target!(|input| {

///     let _result: Result<_, _> = my_crate::parse(input);

/// });

/// # mod my_crate { pub fn parse(_: &[u8]) -> Result<(), ()> { unimplemented!() } }

/// ```

///

/// ## Arbitrary Input Types

///

/// The input is a `&[u8]` slice by default, but you can take arbitrary input

/// types, as long as the type implements [the `arbitrary` crate's `Arbitrary`

/// trait](https://docs.rs/arbitrary/*/arbitrary/trait.Arbitrary.html) (which is

/// also re-exported as `libfuzzer_sys::arbitrary::Arbitrary` for convenience).

///

/// For example, if you wanted to take an arbitrary RGB color, you could do the

/// following:

///

/// ```no_run

/// #![no_main]

///

/// use libfuzzer_sys::{arbitrary::{Arbitrary, Unstructured}, fuzz_target};

///

/// #[derive(Debug)]

/// pub struct Rgb {

///     r: u8,

///     g: u8,

///     b: u8,

/// }

///

/// impl Arbitrary for Rgb {

///     fn arbitrary<U>(raw: &mut U) -> Result<Self, U::Error>

///     where

///         U: Unstructured + ?Sized

///     {

///         let mut buf = [0; 3];

///         raw.fill_buffer(&mut buf)?;

///         let r = buf[0];

///         let g = buf[1];

///         let b = buf[2];

///         Ok(Rgb { r, g, b })

///     }

/// }

///

/// // Write a fuzz target that works with RGB colors instead of raw bytes.

/// fuzz_target!(|color: Rgb| {

///     my_crate::convert_color(color);

/// });

/// # mod my_crate { fn convert_color(_: super::Rgb) {} }

#[macro_export]

macro_rules! fuzz_target {

    (|$bytes:ident| $body:block) => {

        #[no_mangle]

        pub extern "C" fn rust_fuzzer_test_input($bytes: &[u8]) {

            $body

        }

    };

    (|$data:ident: &[u8]| $body:block) => {

        fuzz_target!(|$data| $body);

    };

    (|$data:ident: $dty: ty| $body:block) => {

        #[no_mangle]

        pub extern "C" fn rust_fuzzer_test_input(bytes: &[u8]) {

            use libfuzzer_sys::arbitrary::{Arbitrary, RingBuffer};

            let mut buf = match RingBuffer::new(bytes, bytes.len()) {

                Ok(b) => b,

                Err(_) => return,

            };

            let $data: $dty = match Arbitrary::arbitrary(&mut buf) {

                Ok(d) => d,

                Err(_) => return,

            };

            $body

        }

    };

}