somo 1.3.2

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

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, serde::Deserialize)]
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,
}

/// Contains which type(s) of IP versions the user wants to see.
#[derive(Debug, PartialEq, Eq, Default)]
pub struct IpVersions {
    pub ipv4: bool,
    pub ipv6: bool,
}
/// Represents a processed socket connection with all its attributes.
#[derive(Debug, serde::Serialize, serde::Deserialize)]
#[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)]
    pub ipvx_raw: Option<IpAddr>,
}

/// Contains options for filtering a `Connection`.
#[derive(Debug, Default)]
pub struct FilterOptions {
    pub by_proto: Protocols,
    pub by_ip_version: IpVersions,
    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 by_established: bool,
}

/// Represents the types of network protocols.
#[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(()),
        }
    }
}