setdns 0.1.1

Temporarily apply and restore system DNS configuration, including global and split DNS.
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

#![doc = include_str!("../README.md")]

mod config;
mod error;
mod platform;

pub use config::Config;
pub use error::{Error, Result};

/// Applied DNS configuration handle.
///
/// The DNS configuration stays active while this value is alive. Call
/// [`SetDns::close`] to restore the previous state and receive any restore
/// error. Dropping the handle also attempts restoration, but drop-time errors
/// can only be logged.
#[must_use = "the DNS configuration is restored when the handle is dropped"]
pub struct SetDns(Option<platform::SetDns>);

impl SetDns {
    /// Validate and apply a DNS configuration.
    ///
    /// Returns [`Error::InvalidConfig`] before touching the platform backend if
    /// the configuration is malformed. Platform, permission, D-Bus,
    /// SystemConfiguration, Windows API, registry, and I/O failures are
    /// returned as [`Error::Backend`].
    pub fn apply(config: Config) -> Result<Self> {
        let config = config.normalize()?;
        log::debug!(
            "applying DNS configuration: mode={}, servers={}, domains={}, device={}",
            if config.domains.is_empty() {
                "global"
            } else {
                "split"
            },
            config.servers.len(),
            config.domains.len(),
            config.device.as_deref().unwrap_or("default")
        );
        let inner = platform::SetDns::apply(config)?;
        log::info!("applied DNS configuration");
        Ok(Self(Some(inner)))
    }

    /// Restore the previous DNS configuration and consume this handle.
    ///
    /// Calling `close` is preferred over relying on `Drop` because this method
    /// reports restore failures to the caller.
    pub fn close(mut self) -> Result<()> {
        if let Some(inner) = self.0.take() {
            inner.close()?;
            log::info!("restored DNS configuration");
        }
        Ok(())
    }
}

impl Drop for SetDns {
    fn drop(&mut self) {
        if let Some(inner) = self.0.take()
            && let Err(err) = inner.close()
        {
            log::warn!("failed to restore DNS configuration for setdns: {err}");
        }
    }
}