Function fuzzcheck::launch[−][src]

pub fn launch<T, FT, F, M, S>(
    test: F, 
    mutator: M, 
    serializer: S
) -> Result<(), Error> where
    FT: ?Sized,
    T: Clone + Borrow<FT>,
    F: Fn(&FT) -> bool,
    M: Mutator<T>,
    S: Serializer<Value = T>,
    Fuzzer<T, FT, F, M, S>: 'static, 

Fuzz-test the given test function, following to the command-line arguments provided by the cargo-fuzzcheck tool.

  • The first argument is a function fn(T) -> bool to fuzz-test. It is only allowed to use the main thread. If it tries to perform asynchronous operations, the fuzzing engine will be confused and act in unpredictable ways.

  • The second argument is a mutator for values of type T. See the Mutator trait for more information. Some basic mutators are provided by the fuzzcheck_mutators crate.

  • The third argument is a serializer for values of type T. See the Serializer trait for more information. Some basic serializers are provided by the fuzzcheck_serializer crate.

This function will either:

  • never return

    • the fuzz-test does not find any crash and continuously keeps running
    • if a test failure or crash is detected
    • if the command line arguments could not be parsed. It will then print the help section of cargo-fuzzcheck and exit.

  • return Ok(()) if the maximum number of iterations has been reached

  • return an error if some necessary IO operation could not be performed. You do not need to catch or handle the error.