# gmsoft-tuxicoman/pktaddikt architecture

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

- Interactive diagram: https://gitdiagram.com/gmsoft-tuxicoman/pktaddikt
- Repository: https://github.com/gmsoft-tuxicoman/pktaddikt

## Overview

pktaddikt is an event-driven Rust DPI application. Its workflow starts with live-interface or capture-file input, parses packet layers, tracks connections and streams, and emits protocol events and extracted blobs to configured output workers. Protocol coverage includes DNS, HTTP, DHCP, TLS, SSH, and SunRPC. The graph preserves the event/blob dispatch and output capabilities documented in the README and source index; some subsystem wiring is not shown in the sampled excerpts, so uncertain links are omitted.

Main entry points: [`src/output.rs`](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output.rs) (Output workers), [`src/messagebus.rs`](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/messagebus.rs) (Message bus), [`src/proto.rs`](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto.rs) (Layer dispatch), [`src/config.rs`](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/config.rs) (Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Traffic ingest"]
  node_config["Configuration<br/>[config.rs]"]
  node_input["Input selection<br/>[input.rs]"]
  node_pcap["PCAP reader<br/>[pcap.rs]"]
end

subgraph group_inspection["Packet inspection"]
  node_packet["Packet model<br/>[packet.rs]"]
  node_protocols["Layer dispatch<br/>[proto.rs]"]
  node_ipv4["IP parsing<br/>[ipv4.rs]"]
  node_transport["TCP and UDP<br/>[tcp.rs]"]
  node_conntrack[("Connection tracking<br/>[conntrack.rs]")]
  node_streams["Stream reassembly<br/>[stream.rs]"]
  node_http["HTTP inspection<br/>[http.rs]"]
  node_dns["DNS inspection<br/>[dns.rs]"]
  node_otherproto["Other protocols"]
end

subgraph group_dispatch["Events and blobs"]
  node_blobs["Blob extraction<br/>[blob.rs]"]
  node_events["Event types<br/>[event.rs]"]
  node_bus["Message bus<br/>[messagebus.rs]"]
end

subgraph group_outputs["Output sinks"]
  node_outputbuilder["Output workers<br/>[output.rs]"]
  node_json["JSON logs<br/>[logjson.rs]"]
  node_zeek["Zeek logs<br/>[logzeek.rs]"]
  node_blobdisk["Blob to disk<br/>[blob2disk.rs]"]
  node_nfsmirror["NFS mirror<br/>[nfsmirror.rs]"]
  node_nftset["DNS nftables<br/>[dns2nftset.rs]"]
end

node_operator(("Operator"))
node_live(("Live interface"))
node_capture["Capture file"]

node_operator -->|"sets options"| node_config
node_live -.->|"live capture"| node_input
node_capture -->|"read capture"| node_input
node_input -->|"selects reader"| node_pcap
node_pcap -->|"creates packets"| node_packet
node_config -->|"configures"| node_input
node_config -->|"configures"| node_protocols
node_config -->|"configures"| node_outputbuilder
node_packet -->|"parses"| node_protocols
node_protocols -->|"dispatches"| node_ipv4
node_protocols -->|"dispatches"| node_transport
node_protocols -->|"dispatches"| node_otherproto
node_transport -->|"tracks flows"| node_conntrack
node_transport -->|"feeds streams"| node_streams
node_streams -->|"parses HTTP"| node_http
node_streams -->|"parses DNS"| node_dns
node_http -->|"extracts bodies"| node_blobs
node_http -->|"defines payloads"| node_events
node_dns -->|"defines payloads"| node_events
node_otherproto -->|"defines payloads"| node_events
node_blobs -->|"publishes blobs"| node_bus
node_events -->|"dispatches events"| node_bus
node_outputbuilder -->|"builds worker"| node_json
node_outputbuilder -->|"builds worker"| node_zeek
node_outputbuilder -->|"builds worker"| node_blobdisk
node_outputbuilder -->|"builds worker"| node_nfsmirror
node_outputbuilder -->|"builds worker"| node_nftset
node_json -->|"subscribes"| node_bus
node_zeek -->|"subscribes"| node_bus
node_blobdisk -->|"subscribes"| node_bus
node_nfsmirror -->|"subscribes"| node_bus
node_nftset -->|"subscribes"| node_bus

click node_config "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/config.rs"
click node_input "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/input.rs"
click node_pcap "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/input/pcap.rs"
click node_packet "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/packet.rs"
click node_protocols "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto.rs"
click node_ipv4 "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/ipv4.rs"
click node_transport "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/tcp.rs"
click node_conntrack "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/conntrack.rs"
click node_streams "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/stream.rs"
click node_http "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/http.rs"
click node_dns "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/dns.rs"
click node_otherproto "https://github.com/gmsoft-tuxicoman/pktaddikt/tree/master/src/proto"
click node_blobs "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/blob.rs"
click node_events "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/event.rs"
click node_bus "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/messagebus.rs"
click node_outputbuilder "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output.rs"
click node_json "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/logjson.rs"
click node_zeek "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/logzeek.rs"
click node_blobdisk "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/blob2disk.rs"
click node_nfsmirror "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/nfsmirror.rs"
click node_nftset "https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/dns2nftset.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_config,node_input,node_pcap toneBlue
class node_packet,node_protocols,node_ipv4,node_transport,node_conntrack,node_streams,node_http,node_dns,node_otherproto toneAmber
class node_blobs,node_events,node_bus toneMint
class node_outputbuilder,node_json,node_zeek,node_blobdisk,node_nfsmirror,node_nftset toneRose
class node_operator,node_live,node_capture toneIndigo
```

## Components

### Traffic ingest

- [Configuration](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/config.rs): `src/config.rs`
- [Input selection](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/input.rs): `src/input.rs`
- [PCAP reader](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/input/pcap.rs): `src/input/pcap.rs`

### Packet inspection

- [Packet model](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/packet.rs): `src/packet.rs`
- [Layer dispatch](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto.rs): `src/proto.rs`
- [IP parsing](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/ipv4.rs): `src/proto/ipv4.rs`
- [TCP and UDP](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/tcp.rs): `src/proto/tcp.rs`
- [Connection tracking](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/conntrack.rs): `src/conntrack.rs`
- [Stream reassembly](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/stream.rs): `src/stream.rs`
- [HTTP inspection](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/http.rs): `src/proto/http.rs`
- [DNS inspection](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/proto/dns.rs): `src/proto/dns.rs`
- [Other protocols](https://github.com/gmsoft-tuxicoman/pktaddikt/tree/master/src/proto): `src/proto`

### Events and blobs

- [Blob extraction](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/blob.rs): `src/blob.rs`
- [Event types](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/event.rs): `src/event.rs`
- [Message bus](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/messagebus.rs): `src/messagebus.rs`

### Output sinks

- [Output workers](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output.rs): `src/output.rs`
- [JSON logs](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/logjson.rs): `src/output/logjson.rs`
- [Zeek logs](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/logzeek.rs): `src/output/logzeek.rs`
- [Blob to disk](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/blob2disk.rs): `src/output/blob2disk.rs`
- [NFS mirror](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/nfsmirror.rs): `src/output/nfsmirror.rs`
- [DNS nftables](https://github.com/gmsoft-tuxicoman/pktaddikt/blob/master/src/output/dns2nftset.rs): `src/output/dns2nftset.rs`

### Other components

- **Operator**
- **Live interface**
- **Capture file**

## Connections

- Operator → Configuration: sets options
- Live interface → Input selection: live capture
- Capture file → Input selection: read capture
- Input selection → PCAP reader: selects reader (evidence: `src/input.rs`)
- PCAP reader → Packet model: creates packets (evidence: `src/input/pcap.rs`)
- Configuration → Input selection: configures (evidence: `src/config.rs`)
- Configuration → Layer dispatch: configures (evidence: `src/config.rs`)
- Configuration → Output workers: configures (evidence: `src/config.rs`)
- Packet model → Layer dispatch: parses (evidence: `src/packet.rs`)
- Layer dispatch → IP parsing: dispatches (evidence: `src/proto.rs`)
- Layer dispatch → TCP and UDP: dispatches (evidence: `src/proto.rs`)
- Layer dispatch → Other protocols: dispatches (evidence: `src/proto.rs`)
- TCP and UDP → Connection tracking: tracks flows (evidence: `src/proto/tcp.rs`)
- TCP and UDP → Stream reassembly: feeds streams (evidence: `src/proto/tcp/conntrack.rs`)
- Stream reassembly → HTTP inspection: parses HTTP (evidence: `src/stream.rs`)
- Stream reassembly → DNS inspection: parses DNS (evidence: `src/stream.rs`)
- HTTP inspection → Blob extraction: extracts bodies (evidence: `src/proto/http.rs`)
- HTTP inspection → Event types: defines payloads (evidence: `src/event.rs`)
- DNS inspection → Event types: defines payloads (evidence: `src/event.rs`)
- Other protocols → Event types: defines payloads (evidence: `src/event.rs`)
- Blob extraction → Message bus: publishes blobs (evidence: `src/blob.rs`)
- Event types → Message bus: dispatches events (evidence: `src/messagebus.rs`)
- Output workers → JSON logs: builds worker (evidence: `src/output.rs`)
- Output workers → Zeek logs: builds worker (evidence: `src/output.rs`)
- Output workers → Blob to disk: builds worker (evidence: `src/output.rs`)
- Output workers → NFS mirror: builds worker (evidence: `src/output.rs`)
- Output workers → DNS nftables: builds worker (evidence: `src/output.rs`)
- JSON logs → Message bus: subscribes (evidence: `src/output/logjson.rs`)
- Zeek logs → Message bus: subscribes (evidence: `src/output/logzeek.rs`)
- Blob to disk → Message bus: subscribes (evidence: `src/output/blob2disk.rs`)
- NFS mirror → Message bus: subscribes (evidence: `src/output/nfsmirror.rs`)
- DNS nftables → Message bus: subscribes (evidence: `src/output/dns2nftset.rs`)
