Struct NameserverSpec 

pub struct NameserverSpec {
    pub protocol: NameserverProtocol,
    pub host: String,
    pub port: u16,
    pub path: Option<String>,
}

A parsed upstream nameserver specification.

Produced by NameserverSpec::parse from the opaque nameserver strings accepted everywhere in seer (CLI flags, REPL @server, config.toml).

Fields

protocol: NameserverProtocol

Transport to speak to the upstream server.

host: String

Hostname or IP literal (IPv6 stored unbracketed).

port: u16

Target port (defaulted per protocol: 53 / 853 / 443).

path: Option<String>

DoH query path. Always Some for NameserverProtocol::Https (defaulting to /dns-query), always None otherwise.

Implementations

impl NameserverSpec

pub fn parse(input: &str) -> Result<Self>

Parses a nameserver specification string.

Accepted forms:

• IP, hostname, host:port, [v6], [v6]:port → UDP (port 53)
• tls://host[:port] → DoT (port 853)
• https://host[:port][/path] → DoH (port 443, path /dns-query)

Errors

Returns SeerError::InvalidInput for empty input, embedded whitespace, unknown schemes, malformed brackets, bad ports, a path on a tls:// spec, or credentials in an https:// spec.

pub fn tls_name(&self) -> &str

The TLS server name presented for certificate verification (DoT/DoH).

For hostname specs this is the hostname. For IP-literal specs it is the IP itself: rustls accepts IP-address server names and verifies them against the certificate’s IP SANs, which the major public resolvers (1.1.1.1, 8.8.8.8, 9.9.9.9, …) all carry.

Trait Implementations

impl Clone for NameserverSpec

fn clone(&self) -> NameserverSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NameserverSpec

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

Formats the value using the given formatter.

impl Display for NameserverSpec

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

Formats the value using the given formatter.

impl Eq for NameserverSpec

impl PartialEq for NameserverSpec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for NameserverSpec