# ydh6226/ndpi_pins7_finaldraft architecture

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

- Interactive diagram: https://gitdiagram.com/ydh6226/ndpi_pins7_finaldraft
- Repository: https://github.com/ydh6226/ndpi_pins7_finaldraft

## Overview

nDPI is a deep-packet-inspection library embedded by applications. Its main workflow accepts packets and per-flow state, detects protocols, and returns protocol identification; protocol dissectors are the domain-specific detection stage. The repository also exposes Python bindings, traffic classification, analysis utilities, and serialization. The supplied excerpts establish the public packet-processing call and examples, but do not show the full internal dispatch or every capability’s implementation, so uncertain internal links are dashed and uncited.

Main entry points: [`src/include/ndpi_protocols.h`](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_protocols.h) (Protocol registration), [`src/lib/ndpi_main.c`](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_main.c) (Packet processing), [`python/ndpi_example.py`](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/ndpi_example.py) (Python capture example), [`src/include/ndpi_api.h`](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_api.h) (Public API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Library interface"]
  node_public_api["Public API<br/>[ndpi_api.h]"]
end

subgraph group_detection["Packet detection"]
  node_engine["Packet processing<br/>[ndpi_main.c]"]
  node_flow_model["Flow state model<br/>[ndpi_typedefs.h]"]
  node_protocol_ids["Protocol identifiers"]
  node_protocol_registry["Protocol registration<br/>[ndpi_protocols.h]"]
end

subgraph group_protocols["Protocol dissectors"]
  node_http["HTTP dissector<br/>[http.c]"]
  node_tls["TLS dissector<br/>[tls.c]"]
  node_protocol_family["Other dissectors"]
end

subgraph group_outputs["Classification and output"]
  node_classifier["Traffic classifier<br/>[ndpi_classify.c]"]
  node_analyzer["Flow analysis<br/>[ndpi_analyze.c]"]
  node_serializer["Result serialization<br/>[ndpi_serializer.c]"]
  node_utilities["Inspection utilities<br/>[ndpi_utils.c]"]
end

subgraph group_bindings["Language bindings"]
  node_python_binding["Python wrapper<br/>[ndpi.py]"]
  node_python_types["Python flow types<br/>[ndpi_typestruct.py]"]
  node_python_example["Python capture example<br/>[ndpi_example.py]"]
  node_flow_printer["Flow printer<br/>[flow_printer.py]"]
end

node_consumer(("Embedding application"))
node_packet["Packets and flow state"]
node_result["Detected protocol"]

node_consumer -->|"embeds"| node_public_api
node_packet -->|"processes"| node_engine
node_public_api -.->|"exposes"| node_engine
node_engine -.->|"updates"| node_flow_model
node_engine -.->|"dispatches"| node_protocol_registry
node_protocol_registry -.->|"registers"| node_protocol_ids
node_protocol_registry -.->|"registers"| node_http
node_protocol_registry -.->|"registers"| node_tls
node_protocol_registry -.->|"registers"| node_protocol_family
node_engine -->|"returns"| node_result
node_result -.->|"classifies"| node_classifier
node_result -.->|"analyzes"| node_analyzer
node_result -.->|"serializes"| node_serializer
node_result -.->|"inspects"| node_utilities
node_python_example -->|"uses"| node_python_binding
node_python_example -->|"uses"| node_python_types
node_python_example -.->|"calls"| node_public_api
node_flow_printer -.->|"uses"| node_python_binding

click node_public_api "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_api.h"
click node_engine "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_main.c"
click node_flow_model "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_typedefs.h"
click node_protocol_ids "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_protocol_ids.h"
click node_protocol_registry "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_protocols.h"
click node_http "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/protocols/http.c"
click node_tls "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/protocols/tls.c"
click node_protocol_family "https://github.com/ydh6226/ndpi_pins7_finaldraft/tree/dev/src/lib/protocols"
click node_classifier "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_classify.c"
click node_analyzer "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_analyze.c"
click node_serializer "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_serializer.c"
click node_utilities "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_utils.c"
click node_python_binding "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/ndpi.py"
click node_python_types "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/ndpi_typestruct.py"
click node_python_example "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/ndpi_example.py"
click node_flow_printer "https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/flow_printer.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_public_api toneBlue
class node_engine,node_flow_model,node_protocol_ids,node_protocol_registry toneAmber
class node_http,node_tls,node_protocol_family toneMint
class node_classifier,node_analyzer,node_serializer,node_utilities toneRose
class node_python_binding,node_python_types,node_python_example,node_flow_printer,node_consumer,node_packet,node_result toneIndigo
```

## Components

### Library interface

- [Public API](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_api.h): `src/include/ndpi_api.h`

### Packet detection

- [Packet processing](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_main.c): `src/lib/ndpi_main.c`
- [Flow state model](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_typedefs.h): `src/include/ndpi_typedefs.h`
- [Protocol identifiers](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_protocol_ids.h): `src/include/ndpi_protocol_ids.h`
- [Protocol registration](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/include/ndpi_protocols.h): `src/include/ndpi_protocols.h`

### Protocol dissectors

- [HTTP dissector](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/protocols/http.c): `src/lib/protocols/http.c`
- [TLS dissector](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/protocols/tls.c): `src/lib/protocols/tls.c`
- [Other dissectors](https://github.com/ydh6226/ndpi_pins7_finaldraft/tree/dev/src/lib/protocols): `src/lib/protocols`

### Classification and output

- [Traffic classifier](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_classify.c): `src/lib/ndpi_classify.c`
- [Flow analysis](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_analyze.c): `src/lib/ndpi_analyze.c`
- [Result serialization](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_serializer.c): `src/lib/ndpi_serializer.c`
- [Inspection utilities](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/src/lib/ndpi_utils.c): `src/lib/ndpi_utils.c`

### Language bindings

- [Python wrapper](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/ndpi.py): `python/ndpi.py`
- [Python flow types](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/ndpi_typestruct.py): `python/ndpi_typestruct.py`
- [Python capture example](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/ndpi_example.py): `python/ndpi_example.py`
- [Flow printer](https://github.com/ydh6226/ndpi_pins7_finaldraft/blob/dev/python/flow_printer.py): `python/flow_printer.py`

### Other components

- **Embedding application**
- **Packets and flow state**
- **Detected protocol**

## Connections

- Embedding application → Public API: embeds
- Packets and flow state → Packet processing: processes
- Public API → Packet processing: exposes (evidence: `src/lib/ndpi_main.c`)
- Packet processing → Flow state model: updates
- Packet processing → Protocol registration: dispatches
- Protocol registration → Protocol identifiers: registers
- Protocol registration → HTTP dissector: registers
- Protocol registration → TLS dissector: registers
- Protocol registration → Other dissectors: registers (evidence: `src/lib/protocols/attic/ftp.c`)
- Packet processing → Detected protocol: returns
- Detected protocol → Traffic classifier: classifies
- Detected protocol → Flow analysis: analyzes
- Detected protocol → Result serialization: serializes
- Detected protocol → Inspection utilities: inspects
- Python capture example → Python wrapper: uses (evidence: `python/ndpi_example.py`)
- Python capture example → Python flow types: uses (evidence: `python/ndpi_example.py`)
- Python capture example → Public API: calls
- Flow printer → Python wrapper: uses
