Struct NameServerConfig

pub struct NameServerConfig {
    pub socket_addr: SocketAddr,
    pub protocol: Protocol,
    pub tls_dns_name: Option<String>,
    pub http_endpoint: Option<String>,
    pub trust_negative_responses: bool,
    pub tls_config: Option<TlsClientConfig>,
    pub bind_addr: Option<SocketAddr>,
}

Configuration for the NameServer

Fields

socket_addr: SocketAddr

The address which the DNS NameServer is registered at.

protocol: Protocol

The protocol to use when communicating with the NameServer.

tls_dns_name: Option<String>

SPKI name, only relevant for TLS connections

http_endpoint: Option<String>

The HTTP endpoint where the DNS NameServer provides service. Only relevant to DNS-over-HTTPS. Defaults to /dns-query if unspecified.

trust_negative_responses: bool

Whether to trust NXDOMAIN responses from upstream nameservers.

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

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

Defaults to false.

tls_config: Option<TlsClientConfig>

Available on crate feature dns-over-rustls only.

Optional configuration for the TLS client.

The correct ALPN for the corresponding protocol is automatically inserted if none was specificed.

bind_addr: Option<SocketAddr>

The client address (IP and port) to use for connecting to the server.

Implementations

impl NameServerConfig

pub fn new(socket_addr: SocketAddr, protocol: Protocol) -> Self

Constructs a Nameserver configuration with some basic defaults

Trait Implementations

impl Clone for NameServerConfig

fn clone(&self) -> NameServerConfig

Returns a copy 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 Display for NameServerConfig

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

Formats the value using the given formatter.

impl PartialEq for NameServerConfig

fn eq(&self, other: &NameServerConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.

impl Eq for NameServerConfig

impl StructuralPartialEq for NameServerConfig