How yacine204/snffff works
snffff is a minimal Unix packet sniffer: it reads raw AF_PACKET frames, decodes Ethernet and network-layer headers, prints packet details, and parses TCP segments into flows that can be printed on interrupt. The graph follows the sampled call paths; IPv6 TCP dispatch is represented because the parser explicitly supports it. ARP parsing is present, though Ethernet-type-specific ARP dispatch is not shown. Flow storage is an in-memory map, not persistent storage.
Main entry points: main.go Raw socket loop · l3.go IP/ARP dispatch · l4.go TCP parser · eth.go Packet output
Components 15
Capture
- Raw socket loop
main.go
Packet decoding
- Ethernet parser
internal/eth.go - IP/ARP dispatch
internal/l3.go - IPv4 parser
internal/l3.go - IPv6 parser
internal/l3.go - ARP parser
internal/l3.go - TCP parser
internal/l4.go - Packet output
internal/eth.go
TCP flows
- TCP output
internal/l4.go - TCP packet queue
internal/l4.go - Flow worker
internal/l4.go - Flow ID builder
internal/l4.go - TCP flow map
internal/l4.go - Interrupt printer
internal/l4.go
Other components
- Network packets
Connections 21
- Network packets → Raw socket loop: supplies frames
README.md - Raw socket loop → Ethernet parser: parses frame
main.go - Raw socket loop → Flow worker: starts worker
main.go - Raw socket loop → Interrupt printer: starts listener
main.go - Ethernet parser → IP/ARP dispatch: dispatches payload
internal/eth.go - Ethernet parser → Packet output: prints frame
internal/eth.go - IP/ARP dispatch → IPv4 parser: parses IPv4
internal/l3.go - IP/ARP dispatch → IPv6 parser: parses IPv6
internal/l3.go - IP/ARP dispatch → ARP parser: parses fallback
internal/l3.go - IPv4 parser → TCP parser: dispatches TCP
internal/l3.go - IPv6 parser → TCP parser: dispatches TCP
internal/l3.go - IPv4 parser → Packet output: prints headers
internal/l3.go - IPv6 parser → Packet output: prints headers
internal/l3.go - ARP parser → Packet output: prints headers
internal/l3.go - TCP parser → TCP output: prints segment
internal/l4.go - TCP parser → TCP packet queue: enqueues segment
internal/l4.go - TCP packet queue → Flow worker: delivers segments
internal/l4.go - Flow worker → TCP flow map: groups segments
internal/l4.go - Flow worker → Flow ID builder: builds flow key
internal/l4.go - Interrupt printer → TCP flow map: prints stored flows
internal/l4.go - Interrupt printer → TCP output: prints segments
internal/l4.go