osdns 0.2.0

Safe, transactional control of operating-system DNS configuration
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

use std::ffi::OsString;

/// Information about a network interface, as reported by the active backend.
///
/// Returned by [`DnsManager::interfaces`](crate::DnsManager::interfaces).
/// Read-only snapshot; `index` is the OS interface index (0 when the platform
/// does not expose one, e.g. macOS service enumeration), `name` the OS name,
/// `friendly_name` a human-readable name when available, `guid` the stable
/// native identifier when available (Windows GUID, macOS service UUID).
/// `is_up` reflects the backend's liveness signal and may be approximate.
///
/// Names and indexes are convenience selectors only. Their lifetime and
/// rename/reuse semantics are backend-specific; durable recovery separately
/// validates the native resource incarnation.
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub struct InterfaceInfo {
    /// OS interface index.
    pub index: u32,
    /// OS interface name.
    pub name: OsString,
    /// Human-friendly display name, when the platform provides one.
    pub friendly_name: Option<String>,
    /// Interface GUID, when the platform exposes one.
    pub guid: Option<String>,
    /// Whether the interface is currently up.
    pub is_up: bool,
}