rustnet_core/lib.rs
1//! # rustnet-core
2//!
3//! The reusable network-analysis core of [RustNet](https://github.com/domcyrus/rustnet):
4//! packet parsing, protocol types, deep packet inspection (DPI), link-layer
5//! parsers, connection merging, and DNS / GeoIP / OUI lookups.
6//!
7//! This crate is platform-independent and capture-independent: it operates on
8//! byte slices and parsed structures, with no dependency on `libpcap`, raw
9//! sockets, or OS process tables. Raw packet capture and platform-specific
10//! process attribution live in the `rustnet` binary crate.
11//!
12//! ## Capabilities
13//!
14//! - **Packet parsing** for Ethernet, Linux SLL/SLL2, PKTAP, raw IP, and
15//! TUN/TAP link layers, plus IPv4/IPv6, TCP, UDP, ICMP, and IGMP.
16//! - **Deep packet inspection** for HTTP, HTTPS/TLS with SNI extraction,
17//! DNS, SSH, QUIC, NTP, mDNS, LLMNR, DHCP, SNMP, SSDP, NetBIOS, and more.
18//! - **Connection merging**: fold parsed packets into long-lived connection
19//! state with protocol-aware lifecycle tracking and TCP analytics.
20//! - **Reusable filtering and retention policy** through `ConnectionFilter`
21//! and `TrackerConfig`, independent of any frontend.
22//! - **GeoIP** lookups against MaxMind GeoLite2 databases.
23//! - **Reverse DNS** with background async resolution and caching.
24//! - **OUI** vendor resolution and **service** name resolution (baked-in
25//! datasets).
26//!
27//! ## Layout
28//!
29//! All modules live under [`network`].
30
31pub mod network;