How rust-fuzz/cargo-fuzz works
cargo-fuzz is a Cargo subcommand that creates and manages fuzzing projects, builds and runs fuzz targets, and supports corpus/test-case minimization and coverage. The principal workflow is to initialize a fuzz workspace, add a target, build/run it with libFuzzer, and inspect crashes or coverage. The graph separates command dispatch, project operations, compiler/toolchain support, and generated fuzzing state. Some command implementations are unsampled; their documented capabilities are retained, but uncertain implementation links are omitted.
Main entry points: project.rs Project operations · options.rs Command definitions · run.rs Fuzz execution · coverage.rs Coverage analysis
Components 20
CLI dispatch
- Command entry
src/main.rs - Command definitions
src/options.rs
Fuzz project
- Project operations
src/project.rs - Project templates
src/templates.rs
Fuzz operations
- Project initialization
src/options/init.rs - Target creation
src/options/add.rs - Target build
src/options/build.rs - Target check
src/options/check.rs - Target listing
src/options/list.rs - Fuzz execution
src/options/run.rs - Input formatter
src/options/fmt.rs - Case minimizer
src/options/tmin.rs - Corpus minimizer
src/options/cmin.rs - Coverage analysis
src/options/coverage.rs
Toolchain and state
- Rust version detection
src/rustc_version.rs - Cargo
- libFuzzer
- Corpus and artifacts
- LLVM coverage tools
Other components
- Cargo user
Connections 27
- Cargo user → Command entry: invokes
README.md - Command entry → Command definitions: dispatches
src/main.rs - Command definitions → Project initialization: defines
src/options.rs - Command definitions → Target creation: defines
src/options.rs - Command definitions → Target build: defines
src/options.rs - Command definitions → Target check: defines
src/options.rs - Command definitions → Target listing: defines
src/options.rs - Command definitions → Fuzz execution: defines
src/options.rs - Command definitions → Input formatter: defines
src/options.rs - Command definitions → Case minimizer: defines
src/options.rs - Command definitions → Corpus minimizer: defines
src/options.rs - Command definitions → Coverage analysis: defines
src/options.rs - Project initialization → Project operations: initializes
src/options/init.rs - Target creation → Project operations: adds target
src/options/add.rs - Target listing → Project operations: lists targets
src/options/list.rs - Fuzz execution → Project operations: runs target
src/options/run.rs - Case minimizer → Project operations: minimizes case
src/options/tmin.rs - Corpus minimizer → Project operations: minimizes corpus
src/options/cmin.rs - Coverage analysis → Project operations: generates coverage
src/options/coverage.rs - Project operations → Project templates: uses templates
src/main.rs - Project operations → Rust version detection: discovers version
src/project.rs - Project operations → Cargo: invokes
src/project.rs - Project operations → libFuzzer: runs fuzz binary
src/project.rs - Project operations → Corpus and artifacts: reads and writes
README.md - Project operations → LLVM coverage tools: merges profiles
src/project.rs - Fuzz execution → Corpus and artifacts: supplies inputs
src/options/run.rs - Coverage analysis → LLVM coverage tools: selects tool path
src/options/coverage.rs