Package com.code_intelligence.jazzer.api

Class Autofuzz

java.lang.Object

com.code_intelligence.jazzer.api.Autofuzz

public final class Autofuzz
extends Object

Static helper functions that allow Jazzer fuzz targets to use Autofuzz.

Method Summary

Modifier and Type	Method	Description
static <T1> void	autofuzz(FuzzedDataProvider data, Consumer1<T1> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2> void	autofuzz(FuzzedDataProvider data, Consumer2<T1,T2> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2,T3> void	autofuzz(FuzzedDataProvider data, Consumer3<T1,T2,T3> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2,T3,T4> void	autofuzz(FuzzedDataProvider data, Consumer4<T1,T2,T3,T4> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2,T3,T4,T5> void	autofuzz(FuzzedDataProvider data, Consumer5<T1,T2,T3,T4,T5> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,R> R	autofuzz(FuzzedDataProvider data, Function1<T1,R> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2,R> R	autofuzz(FuzzedDataProvider data, Function2<T1,T2,R> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2,T3,R> R	autofuzz(FuzzedDataProvider data, Function3<T1,T2,T3,R> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2,T3,T4,R> R	autofuzz(FuzzedDataProvider data, Function4<T1,T2,T3,T4,R> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T1,T2,T3,T4,T5,R> R	autofuzz(FuzzedDataProvider data, Function5<T1,T2,T3,T4,T5,R> func)	Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.
static <T> T	consume(FuzzedDataProvider data, Class<T> type)	Attempts to construct an instance of type from the fuzzer input using only public methods available on the classpath.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

autofuzz

public static <T1,R> R autofuzz(FuzzedDataProvider data,
                                      Function1<T1,R> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Function1 with (partially) specified type variables, e.g. (Function1<String, ?>) String::new.

Returns:

the return value of func, or null if autofuzz failed to invoke the function.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2,R> R autofuzz(FuzzedDataProvider data,
                                               Function2<T1,T2,R> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Function2 with (partially) specified type variables.

Returns:

the return value of func, or null if autofuzz failed to invoke the function.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2,T3,R> R autofuzz(FuzzedDataProvider data,
                                                        Function3<T1,T2,T3,R> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Function3 with (partially) specified type variables.

Returns:

the return value of func, or null if autofuzz failed to invoke the function.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2,T3,T4,R> R autofuzz(FuzzedDataProvider data,
                                                                 Function4<T1,T2,T3,T4,R> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Function4 with (partially) specified type variables.

Returns:

the return value of func, or null if autofuzz failed to invoke the function.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2,T3,T4,T5,R> R autofuzz(FuzzedDataProvider data,
                                                                          Function5<T1,T2,T3,T4,T5,R> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Function5 with (partially) specified type variables.

Returns:

the return value of func, or null if autofuzz failed to invoke the function.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1> void autofuzz(FuzzedDataProvider data,
                                 Consumer1<T1> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Consumer1 with explicitly specified type variable.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2> void autofuzz(FuzzedDataProvider data,
                                          Consumer2<T1,T2> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Consumer2 with (partially) specified type variables.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2,T3> void autofuzz(FuzzedDataProvider data,
                                                   Consumer3<T1,T2,T3> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Consumer3 with (partially) specified type variables.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2,T3,T4> void autofuzz(FuzzedDataProvider data,
                                                            Consumer4<T1,T2,T3,T4> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Consumer4 with (partially) specified type variables.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

autofuzz

public static <T1,T2,T3,T4,T5> void autofuzz(FuzzedDataProvider data,
                                                                     Consumer5<T1,T2,T3,T4,T5> func)

Attempts to invoke func with arguments created automatically from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to execute func in meaningful ways for a number of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

func - a method reference for the function to autofuzz. If there are multiple overloads, resolve ambiguities by explicitly casting to Consumer5 with (partially) specified type variables.

Throws:

Throwable - any Throwable thrown by func, or an AutofuzzConstructionException if autofuzz failed to construct the arguments for the call. The Throwable is thrown unchecked.

consume

public static <T> T consume(FuzzedDataProvider data,
                            Class<T> type)

Attempts to construct an instance of type from the fuzzer input using only public methods available on the classpath.

Note: This function is inherently heuristic and may fail to return meaningful values for a variety of reasons.

Parameters:

data - the FuzzedDataProvider instance provided to fuzzerTestOneInput.

type - the Class to construct an instance of.

Returns:

an instance of type constructed from the fuzzer input, or null if autofuzz failed to create an instance.