How gmsoft-tuxicoman/pktaddikt works
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: output.rs Output workers · messagebus.rs Message bus · proto.rs Layer dispatch · config.rs Configuration
Components 24
Traffic ingest
- Configuration
src/config.rs - Input selection
src/input.rs - PCAP reader
src/input/pcap.rs
Packet inspection
- Packet model
src/packet.rs - Layer dispatch
src/proto.rs - IP parsing
src/proto/ipv4.rs - TCP and UDP
src/proto/tcp.rs - Connection tracking
src/conntrack.rs - Stream reassembly
src/stream.rs - HTTP inspection
src/proto/http.rs - DNS inspection
src/proto/dns.rs - Other protocols
src/proto
Events and blobs
- Blob extraction
src/blob.rs - Event types
src/event.rs - Message bus
src/messagebus.rs
Output sinks
- Output workers
src/output.rs - JSON logs
src/output/logjson.rs - Zeek logs
src/output/logzeek.rs - Blob to disk
src/output/blob2disk.rs - NFS mirror
src/output/nfsmirror.rs - DNS nftables
src/output/dns2nftset.rs
Other components
- Operator
- Live interface
- Capture file
Connections 32
- Operator → Configuration: sets options
- Live interface → Input selection: live capture
- Capture file → Input selection: read capture
- Input selection → PCAP reader: selects reader
src/input.rs - PCAP reader → Packet model: creates packets
src/input/pcap.rs - Configuration → Input selection: configures
src/config.rs - Configuration → Layer dispatch: configures
src/config.rs - Configuration → Output workers: configures
src/config.rs - Packet model → Layer dispatch: parses
src/packet.rs - Layer dispatch → IP parsing: dispatches
src/proto.rs - Layer dispatch → TCP and UDP: dispatches
src/proto.rs - Layer dispatch → Other protocols: dispatches
src/proto.rs - TCP and UDP → Connection tracking: tracks flows
src/proto/tcp.rs - TCP and UDP → Stream reassembly: feeds streams
src/proto/tcp/conntrack.rs - Stream reassembly → HTTP inspection: parses HTTP
src/stream.rs - Stream reassembly → DNS inspection: parses DNS
src/stream.rs - HTTP inspection → Blob extraction: extracts bodies
src/proto/http.rs - HTTP inspection → Event types: defines payloads
src/event.rs - DNS inspection → Event types: defines payloads
src/event.rs - Other protocols → Event types: defines payloads
src/event.rs - Blob extraction → Message bus: publishes blobs
src/blob.rs - Event types → Message bus: dispatches events
src/messagebus.rs - Output workers → JSON logs: builds worker
src/output.rs - Output workers → Zeek logs: builds worker
src/output.rs - Output workers → Blob to disk: builds worker
src/output.rs - Output workers → NFS mirror: builds worker
src/output.rs - Output workers → DNS nftables: builds worker
src/output.rs - JSON logs → Message bus: subscribes
src/output/logjson.rs - Zeek logs → Message bus: subscribes
src/output/logzeek.rs - Blob to disk → Message bus: subscribes
src/output/blob2disk.rs - NFS mirror → Message bus: subscribes
src/output/nfsmirror.rs - DNS nftables → Message bus: subscribes
src/output/dns2nftset.rs