prt-core 0.3.0

Core library for prt — real-time network port scanner with change tracking, alerts, suspicious detection, known ports, bandwidth and container awareness
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

//! Platform-specific port scanning.
//!
//! - **macOS**: parses `lsof -F` output + batch `ps` calls (2 per cycle)
//! - **Linux**: reads `/proc/net/{tcp,tcp6,udp,udp6}` via `procfs` crate

#[cfg(target_os = "linux")]
mod linux;
#[cfg(target_os = "macos")]
mod macos;

use crate::model::PortEntry;
use anyhow::Result;

/// Scan all visible network ports (unprivileged).
pub fn scan_ports() -> Result<Vec<PortEntry>> {
    #[cfg(target_os = "linux")]
    {
        linux::scan()
    }
    #[cfg(target_os = "macos")]
    {
        macos::scan()
    }
    #[cfg(not(any(target_os = "linux", target_os = "macos")))]
    {
        anyhow::bail!("unsupported platform")
    }
}

/// Scan with cached sudo credentials (`sudo -n`).
pub fn scan_ports_elevated() -> Result<Vec<PortEntry>> {
    #[cfg(target_os = "macos")]
    {
        macos::scan_elevated()
    }
    #[cfg(target_os = "linux")]
    {
        linux::scan()
    }
    #[cfg(not(any(target_os = "linux", target_os = "macos")))]
    {
        anyhow::bail!("unsupported platform")
    }
}

/// Scan with explicit sudo password piped via stdin (`sudo -S`).
pub fn scan_ports_with_sudo(password: &str) -> Result<Vec<PortEntry>> {
    #[cfg(target_os = "macos")]
    {
        macos::scan_with_sudo(password)
    }
    #[cfg(target_os = "linux")]
    {
        let _ = password;
        linux::scan()
    }
    #[cfg(not(any(target_os = "linux", target_os = "macos")))]
    {
        let _ = password;
        anyhow::bail!("unsupported platform")
    }
}