# mutilin/kernel-sanitizers architecture

> Architecture diagram of the GitHub repository mutilin/kernel-sanitizers, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mutilin/kernel-sanitizers
- Repository: https://github.com/mutilin/kernel-sanitizers

## Overview

This repository is primarily out-of-tree information and prototypes for six Linux kernel sanitizers; most sanitizer implementations live in the kernel or elsewhere. Its only indexed runtime module is a Python symbolizer that reads sanitizer reports, resolves stack frames against kernel binaries, and prints annotated output. The excerpts show its command-line entry point, report processing, and addr2line use. The sanitizer guides are represented as documented capability areas, not as runtime components; their internal implementations and connections are not established by the supplied source.

Main entry points: [`tools/symbolizer.py`](https://github.com/mutilin/kernel-sanitizers/blob/master/tools/symbolizer.py) (Report processor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guides["Sanitizer guides"]
  node_kasan["KASAN guide<br/>[KASAN.md]"]
  node_ubsan["UBSAN guide<br/>[UBSAN.md]"]
  node_kcsan["KCSAN guide<br/>[KCSAN.md]"]
  node_kfence["KFENCE guide<br/>[KFENCE.md]"]
  node_kmsan["KMSAN guide<br/>[KMSAN.md]"]
  node_ktsan["KTSAN guide<br/>[KTSAN.md]"]
end

subgraph group_symbolizer["Report symbolizer"]
  node_cli["CLI entry<br/>[symbolizer.py]"]
  node_processor["Report processor<br/>[symbolizer.py]"]
end

node_report["Sanitizer report"]
node_addr2line["addr2line"]

node_report -->|"reads stdin"| node_processor
node_cli -->|"starts processing"| node_processor
node_processor -->|"resolves frames"| node_addr2line

click node_kasan "https://github.com/mutilin/kernel-sanitizers/blob/master/KASAN.md"
click node_ubsan "https://github.com/mutilin/kernel-sanitizers/blob/master/UBSAN.md"
click node_kcsan "https://github.com/mutilin/kernel-sanitizers/blob/master/KCSAN.md"
click node_kfence "https://github.com/mutilin/kernel-sanitizers/blob/master/KFENCE.md"
click node_kmsan "https://github.com/mutilin/kernel-sanitizers/blob/master/KMSAN.md"
click node_ktsan "https://github.com/mutilin/kernel-sanitizers/blob/master/KTSAN.md"
click node_cli "https://github.com/mutilin/kernel-sanitizers/blob/master/tools/symbolizer.py"
click node_processor "https://github.com/mutilin/kernel-sanitizers/blob/master/tools/symbolizer.py"

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_kasan,node_ubsan,node_kcsan,node_kfence,node_kmsan,node_ktsan toneBlue
class node_cli,node_processor toneAmber
class node_report,node_addr2line toneIndigo
```

## Components

### Sanitizer guides

- [KASAN guide](https://github.com/mutilin/kernel-sanitizers/blob/master/KASAN.md): `KASAN.md`
- [UBSAN guide](https://github.com/mutilin/kernel-sanitizers/blob/master/UBSAN.md): `UBSAN.md`
- [KCSAN guide](https://github.com/mutilin/kernel-sanitizers/blob/master/KCSAN.md): `KCSAN.md`
- [KFENCE guide](https://github.com/mutilin/kernel-sanitizers/blob/master/KFENCE.md): `KFENCE.md`
- [KMSAN guide](https://github.com/mutilin/kernel-sanitizers/blob/master/KMSAN.md): `KMSAN.md`
- [KTSAN guide](https://github.com/mutilin/kernel-sanitizers/blob/master/KTSAN.md): `KTSAN.md`

### Report symbolizer

- [CLI entry](https://github.com/mutilin/kernel-sanitizers/blob/master/tools/symbolizer.py): `tools/symbolizer.py`
- [Report processor](https://github.com/mutilin/kernel-sanitizers/blob/master/tools/symbolizer.py): `tools/symbolizer.py`

### Other components

- **Sanitizer report**
- **addr2line**

## Connections

- Sanitizer report → Report processor: reads stdin (evidence: `tools/symbolizer.py`)
- CLI entry → Report processor: starts processing (evidence: `tools/symbolizer.py`)
- Report processor → addr2line: resolves frames (evidence: `tools/symbolizer.py`)
