domcyrus/rustnet
78.5
Strong · 14 November 2026
79.1k
lines of production code
Rust
primary language
5
measurements over time
What this system is
Features
Add container and Kubernetes attribution for network connections
The network module now enriches connection data with container and Kubernetes metadata. On Linux, it identifies Docker, Podman, and LXC containers by parsing cgroup paths and loading runtime metadata from local disk files, and it resolves Kubernetes pod and container identities from cgroup layouts (supporting both cgroup v1 and v2). A Kubernetes resolver with Auto/On/Off modes detects if the app runs inside a pod and caches results per PID. This attribution is performed without requiring access to a runtime daemon or elevated privileges beyond what is needed for packet capture.
src/network · high confidence
Added IANA services port database
The \crates/rustnet-core/assets/services\ file has been added to the project, containing the standard IANA network services and port assignments (based on the 2021-01-19 update). This asset provides the reference data for mapping well-known TCP, UDP, and SCTP port numbers to their corresponding service names, enabling the application to identify network services by port.
crates/rustnet-core/assets · high confidence
Initial RPM packaging specification for RustNet
The RPM package specification (rustnet.spec) has been added, enabling the distribution of RustNet version 1.6.0 via RPM-based Linux distributions. This packaging includes build requirements for Rust, libpcap, and eBPF tooling, and configures the binary to run with minimal Linux capabilities (cap\_net\_raw, cap\_bpf, cap\_perfmon) for secure packet capture and process tracking. The package also installs desktop integration files, icons, and documentation, with specific build and runtime dependencies adjusted for openSUSE compatibility.
rpm · high confidence
Initial Ubuntu PPA packaging support for RustNet
RustNet is now available as a native package for Ubuntu 22.04, 24.04, and 26.04 via the \domcyrus/rustnet\ PPA. Users can install the tool using \sudo add-apt-repository ppa:domcyrus/rustnet\ and \sudo apt install rustnet\. The package includes a desktop entry, icons, shell completions, and manpages. It is built with Rust 1.88 and includes eBPF support for enhanced process detection, with capabilities automatically configured during installation to allow packet capture without requiring full root privileges.
debian · high confidence
Initial cross-platform packaging resources and Windows UTF-8 fix
This change introduces the foundational packaging assets for Linux, macOS, and Windows, including a desktop entry for Linux, an application bundle with a terminal wrapper for macOS, and a WiX installer definition for Windows. It also adds a Windows application manifest that sets the active code page to UTF-8 to prevent character encoding errors with network device descriptions, and provides documentation for generating and managing icon artwork across platforms.
resources · high confidence
Initial release of RustNet network monitor with TUI, headless, and export features
This change introduces the RustNet application, a cross-platform network monitoring tool. It provides an interactive terminal user interface (TUI) built on Ratatui, featuring live connection tracking, deep packet inspection (DPI), process attribution, and configurable color themes. For automated or remote usage, it supports a headless mode that outputs JSON snapshots or streams JSONL data, with optional filtering. The tool also includes packet capture capabilities, allowing exports to standard PCAP and annotated PCAPNG formats for analysis in tools like Wireshark. Additional features include GeoIP location lookups, reverse DNS resolution, and configurable refresh intervals. Also in this area: DPI protocol detection no longer relies on port numbers.
src · high confidence
Initial release of RustNet v1.6.0
RustNet is a cross-platform network monitoring tool featuring deep packet inspection (DPI) for protocols such as HTTP, HTTPS, DNS, SSH, FTP, QUIC, and more. It provides a terminal user interface (TUI) and a headless mode for production monitoring, with per-connection process attribution on Linux (eBPF/procfs), macOS (PKTAP/lsof), Windows (ETW/IP Helper), and FreeBSD (sockstat). The application supports PCAP/PCAPNG export, JSON logging, and runs with minimal privileges via platform-specific sandboxing (Landlock, Seatbelt, restricted tokens). Installation is available via Homebrew, Chocolatey, Scoop, PPA, COPR, and Docker.
(repo-wide) · high confidence
Introduce rustnet-host crate for cross-platform process attribution and socket inventory
The new \rustnet-host\ crate provides a unified interface for per-connection process attribution and a point-in-time host socket inventory across Linux, macOS, Windows, and FreeBSD. It exposes a \ProcessLookup\ trait that identifies the owning process (PID, name, UID/GID, executable, and lineage) using the best available OS mechanism—eBPF with procfs fallback on Linux, PKTAP/libproc on macOS, ETW on Windows, and \sockstat\/sysctl on FreeBSD. Additionally, it offers a \socket\_snapshot\ API that lists all active host sockets (including TCP listeners and UDP endpoints) with their native states, independent of captured traffic.
crates/rustnet-host · high confidence
New headless capture example and Kubernetes resolver smoke test
Added two new examples to demonstrate core capabilities without the TUI. The \headless\ example (\examples/headless.rs\) provides a low-level, machine-readable connection summary by chaining \rustnet-capture\, \rustnet-core\, and \rustnet-host\, including sandboxing and process attribution. The \k8s\_resolver\_check\ example (\examples/k8s\_resolver\_check.rs\) serves as a smoke test for Kubernetes pod and container attribution, enriching a given PID with cgroup-based metadata when built with the \kubernetes\ feature.
examples · high confidence
New modular UI architecture with tabbed layout and shared components
The terminal UI has been restructured into a modular, tabbed interface (Overview, Details, Activity, Graph, Host) using a Component pattern. This introduces a unified connection table with responsive column visibility, a clipboard system with sandbox awareness, and shared input handling for navigation and scrolling across all tabs.
src/ui · high confidence
New reusable network-analysis core library
The \rustnet-core\ crate introduces a platform-independent, reusable library for network analysis, separating packet parsing, protocol types, deep packet inspection (DPI), link-layer parsers, connection merging, and DNS/GeoIP/OUI lookups from the platform-specific capture logic. This core provides capabilities for parsing Ethernet, Linux SLL/SLL2, PKTAP, raw IP, and TUN/TAP link layers, along with IPv4/IPv6, TCP, UDP, ICMP, and IGMP. It includes DPI for HTTP, HTTPS/TLS (with SNI extraction), DNS, SSH, QUIC, NTP, mDNS, LLMNR, DHCP, SNMP, SSDP, NetBIOS, and BitTorrent. The library also features connection merging with protocol-aware lifecycle tracking, reusable filtering and retention policies, GeoIP lookups, reverse DNS with background async resolution and caching, and OUI vendor resolution.
crates/rustnet-core/src · high confidence
New utility and packaging scripts for release, testing, and asset generation
The scripts directory now includes several new tools: a log rotation script (clear\_old\_logs.sh) to manage log files, a Python script (generate-icons.py) to regenerate packaging artwork from SVG assets, and a pre-release validation script (pre-release-check.sh) that checks version consistency, changelog entries, and runs workspace-wide clippy and tests. For packaging, a new DEB packaging script (package-deb.sh) with ABI verification (verify-linux-abi.py) ensures binaries meet baseline requirements, while test scripts (test-deb-install.sh, test-package-capture.py) validate installation and capture functionality. Additionally, a PCAP enrichment script (pcap\_enrich.py) correlates packet captures with process and GeoIP sidecar data, and a demo recording script (record-rustnet-demo.sh) automates the generation of GIFs and screenshots for documentation.
scripts · high confidence
Architecture
Project restructured into a Cargo workspace with dedicated crates
The project has been refactored from a single crate into a Cargo workspace containing four distinct crates: \rustnet-core\ (network analysis, packet parsing, and DPI), \rustnet-capture\ (packet capture backend), \rustnet-host\ (process attribution and socket inventory), and \rustnet-sandbox\ (privilege dropping and sandboxing). This separation allows for better modularity, with dependencies like \libbpf-rs\ and \procfs\ now isolated in the host crate and core logic moved to the core crate, while the main binary \rustnet-monitor\ acts as the integration point.
(dependencies) · high confidence
Restructured application core into a modular src/app directory
The application's internal architecture has been reorganized from a single \src/app.rs\ file into a dedicated \src/app/\ module containing distinct components for capture, enrichment, logging, output, packet queuing, PCAPNG export, runtime lifecycle, sampling, and state management. This refactoring improves code maintainability and separation of concerns without changing the external product behavior.
src/app · high confidence
Behavioural changes
13 commits (1 fix) modifying src/headless
A change to existing behaviour in src/headless — 13 commits (1 fix), 8 files: “refactor: deduplicate tracking, parsing and output (\#699)”; “feat: add generic container attribution (\#637)”; “feat: add global capture counters (\#629)”; and 10 more (refs \#699, \#637, \#629, \#709, \#721, …).
src/headless · medium confidence · unverified
5 commits (0 fixes) modifying crates/rustnet-sandbox/src/linux, crates/rustnet-sandbox/src/macos
A change to existing behaviour in crates/rustnet-sandbox/src/linux, crates/rustnet-sandbox/src/macos — 5 commits, 5 files: “refactor: establish reusable runtime lifecycle (\#599)”; “refactor: workspace-wide dedup, dead code removal, and visibility narrowing (\#556)”; “refactor: consolidate duplicated code across the workspace (\#597)”; and 2 more (refs \#599, \#556, \#597, \#548, \#650).
crates/rustnet-sandbox/src/linux, crates/rustnet-sandbox/src/macos · medium confidence · unverified
5 commits (0 fixes) modifying crates/rustnet-sandbox/src/windows
A change to existing behaviour in crates/rustnet-sandbox/src/windows — 5 commits, 2 files: “refactor: workspace-wide dedup, dead code removal, and visibility narrowing (\#556)”; “refactor: consolidate duplicated code across the workspace (\#597)”; “docs: align guides with current behavior (\#633)”; and 2 more (refs \#556, \#597, \#633, \#721, \#548).
crates/rustnet-sandbox/src/windows · medium confidence · unverified
6 commits (1 fix) modifying crates/rustnet-sandbox/src
A change to existing behaviour in crates/rustnet-sandbox/src — 6 commits (1 fix), 3 files: “fix: secure Unix output file creation (\#651)”; “refactor: establish reusable runtime lifecycle (\#599)”; “refactor: workspace-wide dedup, dead code removal, and visibility narrowing (\#556)”; and 3 more (refs \#651, \#599, \#556, \#597, \#548, …).
crates/rustnet-sandbox/src · medium confidence · unverified
Refactored capture wait logic into platform-specific adapters
The capture wait mechanism has been restructured to use a shared \WaitPolicy\ that manages idle budgets and guards against spurious readiness, delegating to platform-specific \NativeWait\ adapters. On Unix, the adapter uses \libc::poll\ on the libpcap selectable file descriptor, while on Windows it waits on the Npcap capture event handle. This change ensures bounded, non-spinning waits and proper error handling for unsupported backends across both platforms.
crates/rustnet-capture/src · high confidence
Test coverage
Add benchmark suite for network performance; Added integration tests for platform lookups, Kubernetes resolution, and CLI startup validation; Added tests for packet capture idle behavior and readiness.
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 81 → 78 (-2.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 89 → 83 (-6.0)
- Architecture 88 → 88 (-0.0)
- Maturity 80 → 83 (+3.2)
- Readiness 83 → 82 (-0.5)
- Security 80 → 73 (-6.7)
- Performance 85 → 85 (+0.0)
Resolved (15)
- Duplicated block (10 lines × 2) (src/ui/tabs/details.rs)
- Duplicated block (11 lines × 2) (src/ui/tabs/graph.rs)
- Duplicated block (7 lines × 2) (crates/rustnet-core/src/network/tracker.rs)
- Duplicated block (9 lines × 2) (src/ui/tabs/graph.rs)
- Hotspot: src/app/logging.rs (src/app/logging.rs)
- Hotspot: src/ui/connection_table.rs (src/ui/connection_table.rs)
- LinuxProcessLookup::parse_and_map_content (cognitive 16) (crates/rustnet-host/src/linux/process.rs)
- MethodTooLong: ConnectionSnapshot.from_connection (src/headless/schema.rs)
- No ADRs found
- pcap_enrich.create_pcapng (cognitive 30) (scripts/pcap_enrich.py)
- pcap_enrich.create_pcapng (cyclomatic 16) (scripts/pcap_enrich.py)
- pcap_enrich.find_matching_connection (cognitive 17) (scripts/pcap_enrich.py)
- pcap_enrich.load_connections (cognitive 16) (scripts/pcap_enrich.py)
- pcap_enrich.print_table (cognitive 16) (scripts/pcap_enrich.py)
- rustnet_monitor::app::unix_output::parent_dir (cognitive 19) (src/app/unix_output.rs)
New (26)
- Duplicated block (11 lines × 2) (src/ui/tabs/graph.rs)
- Duplicated block (7 lines × 2) (crates/rustnet-core/src/network/dns.rs)
- Duplicated block (9 lines × 2) (crates/rustnet-host/src/linux/lifecycle.rs)
- Edited copy of a member (10 corresponding lines) (src/ui/theme/derive.rs)
- Edited copy of a member (11 corresponding lines) (src/app/output/unix.rs)
- Edited copy of a member (12 corresponding lines) (src/ui/theme/mod.rs)
- Edited copy of a member (14 corresponding lines) (crates/rustnet-host/src/freebsd/process.rs)
- Edited copy of a member (15 corresponding lines) (crates/rustnet-core/src/network/link_layer/raw_ip.rs)
- Edited copy of a member (15 corresponding lines) (crates/rustnet-host/src/freebsd/process.rs)
- Edited copy of a member (16 corresponding lines) (crates/rustnet-host/src/linux/ebpf/tracker_libbpf.rs)
- Edited copy of a member (19 corresponding lines) (crates/rustnet-core/src/network/types/rtt.rs)
- Edited copy of a member (29 corresponding lines) (crates/rustnet-core/src/network/dpi/tls_common.rs)
- Edited copy of a member (8 corresponding lines) (src/export/pcapng.rs)
- FileTooLong: headless/schema.rs (src/headless/schema.rs)
- FileTooLong: linux/process.rs (crates/rustnet-host/src/linux/process.rs)
- FunctionTooLong: rustnet_monitor::connection_details::visit_application_fields (src/connection_details.rs)
- Hotspot: crates/rustnet-core/src/network/dns_analytics.rs (crates/rustnet-core/src/network/dns_analytics.rs)
- IncrementalEncoder::serialize_connections (cognitive 21) (src/headless/schema/incremental.rs)
- Medium advisory (unsound): RUSTSEC-2026-0486 (Cargo.lock)
- MethodTooLong: ConnectionSnapshot.from_connection_with_process (src/headless/schema.rs)
- …and 6 more
Changes since last survey
- 30 commits — 26 feature/other, 4 fixes
By area
- (root) — 20 commits
- .github/workflows — 4 commits
- crates/rustnet-core — 2 commits
- src/headless — 2 commits
- src/ui — 2 commits
Notable commits
- fix: Fix DNS validation and STUN detection on port 53 (#722)
- fix: fix(ci): replace retired macOS 14 runners with macOS 15 (#717)
- fix: fix(deps): update zstd dependencies to patched releases (#701)
- fix: fix: discard pending RTT probes on TCP keepalives (#716)
- change: Add headless snapshot profiling and controlled baselines (#720)
- change: Add incremental headless JSONL (#719)
- change: Do not count one-byte TCP keepalive probes as loss (#714)
- change: Extend headless metadata and CLI automation (#721)
- change: Limit Npcap ZIP features (#718)
- change: Update OUI vendor database (#708)
- change: chore(deps): bump debian from a29215f to a72b443 in the docker group (#729)
- change: chore(deps): bump docker/login-action (#700)
- change: chore(deps): bump docker/login-action (#723)
- change: chore(deps): bump log (#711)
- change: chore(deps): bump the rust-dependencies group with 2 updates (#724)
- change: chore(deps): bump the rust-dependencies group with 3 updates (#725)
- change: chore(deps): bump zip from 9.0.5 to 9.1.0 in the rust-dependencies group (#703)
- change: chore(deps): bump zip from 9.1.0 to 9.1.2 in the rust-dependencies group (#704)
- change: chore(deps): bump zip from 9.1.2 to 9.1.3 in the rust-dependencies group (#710)
- change: chore(deps): bump zip from 9.1.3 to 9.2.0 in the rust-dependencies group (#712)
- …and 10 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
domcyrus/rustnet was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 09d7fbf152c7a7d3dc688602ca8c67904c28a5c2 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-36d4cd83012f.