# rust-fuzz/cargo-fuzz architecture

> Architecture diagram of the GitHub repository rust-fuzz/cargo-fuzz, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rust-fuzz/cargo-fuzz
- Repository: https://github.com/rust-fuzz/cargo-fuzz

## Overview

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: [`src/project.rs`](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/project.rs) (Project operations), [`src/options.rs`](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options.rs) (Command definitions), [`src/options/run.rs`](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/run.rs) (Fuzz execution), [`src/options/coverage.rs`](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/coverage.rs) (Coverage analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI dispatch"]
  node_entry["Command entry<br/>[main.rs]"]
  node_command_options["Command definitions<br/>[options.rs]"]
end

subgraph group_project["Fuzz project"]
  node_project_core["Project operations<br/>[project.rs]"]
  node_templates["Project templates<br/>[templates.rs]"]
end

subgraph group_operations["Fuzz operations"]
  node_init["Project initialization<br/>[init.rs]"]
  node_add["Target creation<br/>[add.rs]"]
  node_build["Target build<br/>[build.rs]"]
  node_check["Target check<br/>[check.rs]"]
  node_list["Target listing<br/>[list.rs]"]
  node_run["Fuzz execution<br/>[run.rs]"]
  node_fmt["Input formatter<br/>[fmt.rs]"]
  node_tmin["Case minimizer<br/>[tmin.rs]"]
  node_cmin["Corpus minimizer<br/>[cmin.rs]"]
  node_coverage["Coverage analysis<br/>[coverage.rs]"]
end

subgraph group_toolchain["Toolchain and state"]
  node_rust_version["Rust version detection<br/>[rustc_version.rs]"]
  node_cargo["Cargo"]
  node_libfuzzer["libFuzzer"]
  node_corpus[("Corpus and artifacts")]
  node_llvm_tools["LLVM coverage tools"]
end

node_user(("Cargo user"))

node_user -->|"invokes"| node_entry
node_entry -->|"dispatches"| node_command_options
node_command_options -->|"defines"| node_init
node_command_options -->|"defines"| node_add
node_command_options -->|"defines"| node_build
node_command_options -->|"defines"| node_check
node_command_options -->|"defines"| node_list
node_command_options -->|"defines"| node_run
node_command_options -->|"defines"| node_fmt
node_command_options -->|"defines"| node_tmin
node_command_options -->|"defines"| node_cmin
node_command_options -->|"defines"| node_coverage
node_init -->|"initializes"| node_project_core
node_add -->|"adds target"| node_project_core
node_list -->|"lists targets"| node_project_core
node_run -->|"runs target"| node_project_core
node_tmin -->|"minimizes case"| node_project_core
node_cmin -->|"minimizes corpus"| node_project_core
node_coverage -->|"generates coverage"| node_project_core
node_project_core -->|"uses templates"| node_templates
node_project_core -->|"discovers version"| node_rust_version
node_project_core -->|"invokes"| node_cargo
node_project_core -->|"runs fuzz binary"| node_libfuzzer
node_project_core -->|"reads and writes"| node_corpus
node_project_core -->|"merges profiles"| node_llvm_tools
node_run -->|"supplies inputs"| node_corpus
node_coverage -->|"selects tool path"| node_llvm_tools

click node_entry "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/main.rs"
click node_command_options "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options.rs"
click node_init "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/init.rs"
click node_add "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/add.rs"
click node_build "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/build.rs"
click node_check "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/check.rs"
click node_list "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/list.rs"
click node_run "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/run.rs"
click node_fmt "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/fmt.rs"
click node_tmin "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/tmin.rs"
click node_cmin "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/cmin.rs"
click node_coverage "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/coverage.rs"
click node_project_core "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/project.rs"
click node_templates "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/templates.rs"
click node_rust_version "https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/rustc_version.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_command_options,node_user toneBlue
class node_project_core,node_templates toneAmber
class node_init,node_add,node_build,node_check,node_list,node_run,node_fmt,node_tmin,node_cmin,node_coverage toneMint
class node_rust_version,node_cargo,node_libfuzzer,node_corpus,node_llvm_tools toneRose
```

## Components

### CLI dispatch

- [Command entry](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/main.rs): `src/main.rs`
- [Command definitions](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options.rs): `src/options.rs`

### Fuzz project

- [Project operations](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/project.rs): `src/project.rs`
- [Project templates](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/templates.rs): `src/templates.rs`

### Fuzz operations

- [Project initialization](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/init.rs): `src/options/init.rs`
- [Target creation](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/add.rs): `src/options/add.rs`
- [Target build](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/build.rs): `src/options/build.rs`
- [Target check](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/check.rs): `src/options/check.rs`
- [Target listing](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/list.rs): `src/options/list.rs`
- [Fuzz execution](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/run.rs): `src/options/run.rs`
- [Input formatter](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/fmt.rs): `src/options/fmt.rs`
- [Case minimizer](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/tmin.rs): `src/options/tmin.rs`
- [Corpus minimizer](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/cmin.rs): `src/options/cmin.rs`
- [Coverage analysis](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/options/coverage.rs): `src/options/coverage.rs`

### Toolchain and state

- [Rust version detection](https://github.com/rust-fuzz/cargo-fuzz/blob/main/src/rustc_version.rs): `src/rustc_version.rs`
- **Cargo**
- **libFuzzer**
- **Corpus and artifacts**
- **LLVM coverage tools**

### Other components

- **Cargo user**

## Connections

- Cargo user → Command entry: invokes (evidence: `README.md`)
- Command entry → Command definitions: dispatches (evidence: `src/main.rs`)
- Command definitions → Project initialization: defines (evidence: `src/options.rs`)
- Command definitions → Target creation: defines (evidence: `src/options.rs`)
- Command definitions → Target build: defines (evidence: `src/options.rs`)
- Command definitions → Target check: defines (evidence: `src/options.rs`)
- Command definitions → Target listing: defines (evidence: `src/options.rs`)
- Command definitions → Fuzz execution: defines (evidence: `src/options.rs`)
- Command definitions → Input formatter: defines (evidence: `src/options.rs`)
- Command definitions → Case minimizer: defines (evidence: `src/options.rs`)
- Command definitions → Corpus minimizer: defines (evidence: `src/options.rs`)
- Command definitions → Coverage analysis: defines (evidence: `src/options.rs`)
- Project initialization → Project operations: initializes (evidence: `src/options/init.rs`)
- Target creation → Project operations: adds target (evidence: `src/options/add.rs`)
- Target listing → Project operations: lists targets (evidence: `src/options/list.rs`)
- Fuzz execution → Project operations: runs target (evidence: `src/options/run.rs`)
- Case minimizer → Project operations: minimizes case (evidence: `src/options/tmin.rs`)
- Corpus minimizer → Project operations: minimizes corpus (evidence: `src/options/cmin.rs`)
- Coverage analysis → Project operations: generates coverage (evidence: `src/options/coverage.rs`)
- Project operations → Project templates: uses templates (evidence: `src/main.rs`)
- Project operations → Rust version detection: discovers version (evidence: `src/project.rs`)
- Project operations → Cargo: invokes (evidence: `src/project.rs`)
- Project operations → libFuzzer: runs fuzz binary (evidence: `src/project.rs`)
- Project operations → Corpus and artifacts: reads and writes (evidence: `README.md`)
- Project operations → LLVM coverage tools: merges profiles (evidence: `src/project.rs`)
- Fuzz execution → Corpus and artifacts: supplies inputs (evidence: `src/options/run.rs`)
- Coverage analysis → LLVM coverage tools: selects tool path (evidence: `src/options/coverage.rs`)
