How shashank17singh/dpi-engine works
DPI Engine is a C++ PCAP analyzer that parses packets, tracks 5-tuple flows, classifies traffic using TLS SNI and HTTP Host data, applies configurable firewall rules, and writes a filtered capture. The principal workflow is documented as PCAP reader → load balancers → fast paths → classification/rules → output writer. Internal parsing, flow state, classification, and concurrency stages are represented separately. The README documents the threaded architecture; sampled source confirms parser, rule, and extractor responsibilities, but excerpts do not expose every runtime call or queue handoff.
Main entry points: dpi_mt.cpp Fast Paths · packet_parser.cpp Packet Parser · pcap_reader.cpp PCAP Reader · main_working.cpp Single-thread Engine
Components 16
Capture Ingestion
- Engine CLI
src/dpi_mt.cpp - PCAP Reader
src/pcap_reader.cpp - Output Writer
src/dpi_mt.cpp - Single-thread Engine
src/main_working.cpp
Packet Inspection
- Packet Parser
src/packet_parser.cpp - Byte Order
include/platform.h - Flow State
include/types.h - Protocol Extractors
src/sni_extractor.cpp
Classification Policy
- App Classification
src/types.cpp - Firewall Rules
src/dpi_mt.cpp
Parallel Processing
- Load Balancers
src/dpi_mt.cpp - Fast Paths
src/dpi_mt.cpp - Thread Queues
src/dpi_mt.cpp
Other components
- Operator
- Input PCAP
- Filtered PCAP
Connections 18
- Operator → Engine CLI: configures
README.md - Input PCAP → PCAP Reader: reads packets
README.md - Engine CLI → PCAP Reader: processes capture
src/dpi_mt.cpp - PCAP Reader → Packet Parser: parses packets
README.md - Packet Parser → Byte Order: converts byte order
src/packet_parser.cpp - Packet Parser → Flow State: builds flow tuple
- Fast Paths → Protocol Extractors: inspects payload
src/dpi_mt.cpp - Fast Paths → App Classification: maps domain
- Engine CLI → Firewall Rules: configures rules
src/dpi_mt.cpp - Load Balancers → Fast Paths: dispatches flows
README.md - Engine CLI → Load Balancers: distributes packets
README.md - Load Balancers → Thread Queues: enqueues packets
src/dpi_mt.cpp - Thread Queues → Fast Paths: delivers packets
src/dpi_mt.cpp - Fast Paths → Firewall Rules: checks policy
src/dpi_mt.cpp - Fast Paths → Output Writer: forwards allowed packets
README.md - Output Writer → Filtered PCAP: writes capture
README.md - Operator → Single-thread Engine: runs reference engine
README.md - Single-thread Engine → Input PCAP: reads capture