net-lattice-platform 0.12.0

Generic provider traits and Capability contract between the model and platform backends. Depends only on net-lattice-core — never on net-lattice-model.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

use net_lattice_core::Result;

/// Assigns and removes IP addresses on network interfaces.
///
/// Mutation is deliberately separate from [`crate::AddressProvider`]: listing
/// is normally unprivileged, while changing an address requires
/// `CAP_NET_ADMIN`, an elevated Windows token, or root on BSD/macOS. The
/// associated input and output types are distinct because an OS-observed
/// address has an ID and derived attributes that are not caller intent.
pub trait AddressMutator {
    type NewInterfaceAddress;
    type InterfaceAddress;

    /// Assigns an address and returns the canonical record observed from the
    /// backend after creation.
    fn add_address(&self, address: Self::NewInterfaceAddress) -> Result<Self::InterfaceAddress>;

    /// Removes the address identified by the observed record.
    fn remove_address(&self, address: Self::InterfaceAddress) -> Result<()>;
}