somo 1.1.0

A human-friendly alternative to netstat for socket and port monitoring on Linux and macOS.
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
63
64
65
66
67
68
69
70
71

use std::net::IpAddr;

/// Represents the type of an IP address.
///
/// # Variants
/// * `Localhost`: Represents the localhost/127.0.0.1 address.
/// * `Unspecified`: Represents an unspecified or wildcard address.
/// * `Extern`: Represents an external address.
#[derive(Debug, PartialEq, serde::Serialize)]
pub enum AddressType {
    Localhost,
    Unspecified,
    Extern,
}

/// Contains which type(s) of protocols the user wants to see.
#[derive(Debug, Default)]
pub struct Protocols {
    pub tcp: bool,
    pub udp: bool,
}

/// Represents a processed socket connection with all its attributes.
#[derive(Debug, serde::Serialize)]
#[serde(rename_all = "snake_case")]
pub struct Connection {
    pub proto: String,
    pub local_port: String,
    pub remote_address: String,
    pub remote_port: String,
    pub program: String,
    pub pid: String,
    pub state: String,
    pub address_type: AddressType,

    /// Internal variable used only for ordering operations of raw ipv4/6 addresses
    #[serde(skip_serializing)]
    pub ipvx_raw: IpAddr,
}

/// Contains options for filtering a `Connection`.
#[derive(Debug, Default)]
pub struct FilterOptions {
    pub by_proto: Protocols,
    pub by_program: Option<String>,
    pub by_pid: Option<String>,
    pub by_remote_address: Option<String>,
    pub by_remote_port: Option<String>,
    pub by_local_port: Option<String>,
    pub by_open: bool,
    pub by_listen: bool,
    pub exclude_ipv6: bool,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Protocol {
    Tcp,
    Udp,
}

impl std::str::FromStr for Protocol {
    type Err = ();

    fn from_str(input: &str) -> Result<Self, Self::Err> {
        match input.to_lowercase().as_str() {
            "tcp" => Ok(Protocol::Tcp),
            "udp" => Ok(Protocol::Udp),
            _ => Err(()),
        }
    }
}