net-lattice-platform 0.10.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
21
22
23
24
25

use net_lattice_core::Result;

use crate::DnsProvider;

/// Replaces the resolver configuration managed by a backend.
///
/// This is an official third-party backend extension contract. A successful
/// call must return the resolver view subsequently observed through
/// [`DnsProvider::dns_config`]. Backends must preserve input ordering where
/// their operating-system mechanism represents it, and must report platform,
/// permission, or manager-ownership failures through [`Result`] rather than
/// silently accepting a configuration they cannot apply.
///
/// The concrete system mechanism differs by platform. In particular, a
/// resolver manager may later replace configuration written by this operation;
/// callers that require persistence should re-read the observed state and use
/// a platform-specific manager integration where appropriate.
pub trait DnsMutator: DnsProvider {
    /// The desired resolver configuration accepted by this backend.
    type NewDnsConfig;

    /// Replaces the resolver configuration and returns its resulting observed
    /// representation.
    fn set_dns_config(&self, config: Self::NewDnsConfig) -> Result<Self::DnsConfig>;
}