//===-- FuzzerCLI.h - Common logic for CLIs of fuzzers ----------*- C++ -*-===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// // // Common logic needed to implement LLVM's fuzz targets' CLIs - including LLVM // concepts like cl::opt and libFuzzer concepts like -ignore_remaining_args=1. // //===----------------------------------------------------------------------===// #ifndef LLVM_FUZZMUTATE_FUZZERCLI_H #define LLVM_FUZZMUTATE_FUZZERCLI_H #include "llvm/Support/DataTypes.h" #include <stddef.h> namespace llvm { class StringRef; /// Parse cl::opts from a fuzz target commandline. /// /// This handles all arguments after -ignore_remaining_args=1 as cl::opts. void parseFuzzerCLOpts(int ArgC, char *ArgV[]); /// Handle backend options that are encoded in the executable name. /// /// Parses some common backend options out of a specially crafted executable /// name (argv[0]). For example, a name like llvm-foo-fuzzer--aarch64-gisel /// might set up an AArch64 triple and the Global ISel selector. This should be /// called *before* parseFuzzerCLOpts if calling both. /// /// This is meant to be used for environments like OSS-Fuzz that aren't capable /// of passing in command line arguments in the normal way. void handleExecNameEncodedBEOpts(StringRef ExecName); /// Handle optimizer options which are encoded in the executable name. /// Same semantics as in 'handleExecNameEncodedBEOpts'. void handleExecNameEncodedOptimizerOpts(StringRef ExecName); FuzzerTestFun; FuzzerInitFun; /// Runs a fuzz target on the inputs specified on the command line. /// /// Useful for testing fuzz targets without linking to libFuzzer. Finds inputs /// in the argument list in a libFuzzer compatible way. int runFuzzerOnInputs( int ArgC, char *ArgV[], FuzzerTestFun TestOne, FuzzerInitFun Init = [](int *, char ***) { return 0; }); } // namespace llvm #endif // LLVM_FUZZMUTATE_FUZZERCLI_H