Struct ResolverConfig 

#[non_exhaustive]
pub struct ResolverConfig {
    pub domain: Option<Name>,
    pub search: Vec<Name>,
    pub name_servers: Vec<NameServerConfig>,
}

Configuration for the upstream nameservers to use for resolution

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

domain: Option<Name>

Base search domain

search: Vec<Name>

Search domains

name_servers: Vec<NameServerConfig>

Name servers to use for resolution

Implementations

impl ResolverConfig

pub fn udp_and_tcp(config: &ServerGroup<'_>) -> Self

Create a new ResolverConfig from ServerGroup configuration.

Connects via UDP and TCP.

pub fn tls(config: &ServerGroup<'_>) -> Self

Available on crate feature __tls only.

Create a new ResolverConfig from ServerGroup configuration.

Only connects via TLS.

pub fn https(config: &ServerGroup<'_>) -> Self

Available on crate feature __https only.

Create a new ResolverConfig from ServerGroup configuration.

Only connects via HTTPS (HTTP/2).

pub fn quic(config: &ServerGroup<'_>) -> Self

Available on crate feature __quic only.

Create a new ResolverConfig from ServerGroup configuration.

Only connects via QUIC.

pub fn h3(config: &ServerGroup<'_>) -> Self

Available on crate feature __h3 only.

Create a new ResolverConfig from ServerGroup configuration.

Only connects via HTTP/3.

pub fn from_parts( domain: Option<Name>, search: Vec<Name>, name_servers: Vec<NameServerConfig>, ) -> Self

Create a ResolverConfig with all parts specified

Arguments

• domain - domain of the entity querying results. If the Name being looked up is not an FQDN, then this is the first part appended to attempt a lookup. ndots in the ResolverOption does take precedence over this.
• search - additional search domains that are attempted if the Name is not found in domain, defaults to vec![]
• name_servers - set of name servers to use for lookups

pub fn into_parts(self) -> (Option<Name>, Vec<Name>, Vec<NameServerConfig>)

Take the domain, search, and name_servers from the config.

pub fn domain(&self) -> Option<&Name>

Returns the local domain

By default any names will be appended to all non-fully-qualified-domain names, and searched for after any ndots rules

pub fn set_domain(&mut self, domain: Name)

Set the domain of the entity querying results.

pub fn search(&self) -> &[Name]

Returns the search domains

These will be queried after any local domain and then in the order of the set of search domains

pub fn add_search(&mut self, search: Name)

Add a search domain

pub fn add_name_server(&mut self, name_server: NameServerConfig)

Add the configuration for a name server

pub fn name_servers(&self) -> &[NameServerConfig]

Returns a reference to the name servers

Trait Implementations

impl Clone for ResolverConfig

fn clone(&self) -> ResolverConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResolverConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ResolverConfig

fn default() -> ResolverConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ResolverConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ResolverConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.