monitord 0.22.0

monitord ... know how happy your systemd is! 😊
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

//! Varlink proxy for the io.systemd.Network interface.
//! Adapted from the interface definition in systemd's
//! `src/shared/varlink-io.systemd.Network.c`.

use serde::{Deserialize, Serialize};
use zlink::{proxy, ReplyError};

pub const NETWORK_SOCKET_PATH: &str = "/run/systemd/netif/io.systemd.Network";

/// Proxy trait for calling methods on the io.systemd.Network interface.
#[proxy("io.systemd.Network")]
pub trait Network {
    /// Describe all interfaces managed by systemd-networkd.
    async fn describe(&mut self) -> zlink::Result<Result<DescribeOutput, NetworkError>>;
}

/// Output parameters for the Describe method.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DescribeOutput {
    /// All network interfaces known to systemd-networkd.
    #[serde(rename = "Interfaces")]
    pub interfaces: Option<Vec<Interface>>,
}

/// Per-interface information returned by io.systemd.Network.Describe.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Interface {
    /// Kernel interface index.
    #[serde(rename = "Index")]
    pub index: i64,
    /// Primary interface name (e.g. "eth0").
    #[serde(rename = "Name")]
    pub name: String,
    /// Administrative state (configured, configuring, pending, …).
    #[serde(rename = "AdministrativeState")]
    pub administrative_state: String,
    /// Operational state (routable, degraded, carrier, …).
    #[serde(rename = "OperationalState")]
    pub operational_state: String,
    /// Carrier state (carrier, no-carrier, …).
    #[serde(rename = "CarrierState")]
    pub carrier_state: String,
    /// Combined address state across all address families.
    #[serde(rename = "AddressState")]
    pub address_state: String,
    /// IPv4-specific address state.
    #[serde(rename = "IPv4AddressState")]
    pub ipv4_address_state: String,
    /// IPv6-specific address state.
    #[serde(rename = "IPv6AddressState")]
    pub ipv6_address_state: String,
    /// Overall online state (online, offline, partial); absent when unknown.
    #[serde(rename = "OnlineState")]
    pub online_state: Option<String>,
    /// Path to the applied .network configuration file; absent for unmanaged interfaces.
    #[serde(rename = "NetworkFile")]
    pub network_file: Option<String>,
    /// Whether this interface is required for the system to be considered online.
    #[serde(rename = "RequiredForOnline")]
    pub required_for_online: Option<bool>,
}

/// Errors that can occur in the io.systemd.Network interface.
#[derive(Debug, Clone, PartialEq, ReplyError)]
#[zlink(interface = "io.systemd.Network")]
pub enum NetworkError {
    /// The requested interface was not found.
    NoSuchInterface,
}

impl std::fmt::Display for NetworkError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            NetworkError::NoSuchInterface => write!(f, "No such interface"),
        }
    }
}

impl std::error::Error for NetworkError {}