Struct NameServerConfig 

#[non_exhaustive]
pub struct NameServerConfig {
    pub ip: IpAddr,
    pub trust_negative_responses: bool,
    pub connections: Vec<ConnectionConfig>,
}

Configuration for the NameServer

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.

ip: IpAddr

The address which the DNS NameServer is registered at.

trust_negative_responses: bool

Whether to trust NXDOMAIN responses from upstream nameservers.

When this is true, and an empty NXDOMAIN response with an empty answers set is received, the query will not be retried against other configured name servers.

(On a response with any other error response code, the query will still be retried regardless of this configuration setting.)

Defaults to true.

connections: Vec<ConnectionConfig>

Connection protocols configured for this server.

Implementations

impl NameServerConfig

pub fn udp_and_tcp(ip: IpAddr) -> Self

Constructs a nameserver configuration with a UDP and TCP connections

pub fn udp(ip: IpAddr) -> Self

Constructs a nameserver configuration with a single UDP connection

pub fn tcp(ip: IpAddr) -> Self

Constructs a nameserver configuration with a single TCP connection

pub fn tls(ip: IpAddr, server_name: Arc<str>) -> Self

Available on crate feature __tls only.

Constructs a nameserver configuration with a single TLS connection

pub fn https(ip: IpAddr, server_name: Arc<str>, path: Option<Arc<str>>) -> Self

Available on crate feature __https only.

Constructs a nameserver configuration with a single HTTP/2 connection

pub fn quic(ip: IpAddr, server_name: Arc<str>) -> Self

Available on crate feature __quic only.

Constructs a nameserver configuration with a single QUIC connection

pub fn h3(ip: IpAddr, server_name: Arc<str>, path: Option<Arc<str>>) -> Self

Available on crate feature __h3 only.

Constructs a nameserver configuration with a single HTTP/3 connection

pub fn opportunistic_encryption(ip: IpAddr) -> Self

Available on crate features __tls or __quic only.

Constructs a nameserver configuration for opportunistic encryption.

This will include configurations for plaintext UDP/TCP as well as DNS-over-TLS and/or DNS-over-QUIC depending on feature flag support.

Notably, the TLS and QUIC configurations will not verify peer certificates, in keeping with RFC 9539’s requirement. See RFC 9539 §4.6.3.4 for more information.

pub fn new( ip: IpAddr, trust_negative_responses: bool, connections: Vec<ConnectionConfig>, ) -> Self

Create a new NameServerConfig from its constituent parts.

Trait Implementations

impl Clone for NameServerConfig

fn clone(&self) -> NameServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NameServerConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NameServerConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for NameServerConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.