Enum Uri 

#[non_exhaustive]
pub enum Uri {
    #[non_exhaustive]
    Regular {
        addr: IpAddr,
        port: u16,
        prefer_tcp: bool,
    },
    #[non_exhaustive]
    TLS {
        host: Host,
        port: u16,
    },
    #[non_exhaustive]
    HTTPS {
        host: Host,
        port: u16,
        custom_http_endpoint: Option<String>,
        force_http3: bool,
    },
    #[non_exhaustive]
    QUIC {
        host: Host,
        port: u16,
    },
}

URI of a DNS server.

This implements parsing from the following string formats:

// Regular DNS, IPv4, without port (default port 53)
8.8.8.8
// Regular DNS, IPv4, with port
8.8.8.8:10053
// Regular DNS, IPv6, without port (default port 53)
[2001:4860:4860::8888]
// We don't accept bare IPv6 address without blanket.
2001:4860:4860::8888
// Regular DNS, IPv6, with port
[2001:4860:4860::8888]:10053
// Regular DNS, in URI format.
udp://8.8.8.8
udp://8.8.8.8:10053
tcp://[2001:4860:4860::8888]
tcp://[2001:4860:4860::8888]:10053
// DNS over TLS.
tls://dns.google
tls://dns.google:10853
// DNS over HTTPS, without custom endpoint.
https://dns.google
https://dns.google:8443
// DNS over HTTPS, with custom endpoint.
https://dns.google/dns-query
// For DoH, a root path `/` is also considered as a custom endpoint, please pay attention to this.
https://dns.google/
// For DoH / DoQ / DoT, you can specify custom SNI via query parameter `sni`.
tls://8.8.8.8?sni=dns.google

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

#[non_exhaustive]

Regular

Regular DNS, over UDP or TCP.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

addr: IpAddr

Server IP address

port: u16

Server port

prefer_tcp: bool

Prefer TCP over UDP.

#[non_exhaustive]

TLS

DNS over TLS

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

host: Host

Server Host

port: u16

Server port

#[non_exhaustive]

HTTPS

DNS over HTTPS

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

host: Host

Server Host

port: u16

Server port

custom_http_endpoint: Option<String>

The HTTP endpoint where the DNS NameServer provides service. Only relevant to DNS-over-HTTPS.

force_http3: bool

Force HTTP/3 (aka., DNS over HTTP/3).

#[non_exhaustive]

QUIC

DNS over QUIC

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

host: Host

Server Host

port: u16

Server port

Trait Implementations

impl Clone for Uri

fn clone(&self) -> Uri

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Uri

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

Formats the value using the given formatter.

impl Display for Uri

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

Formats the value using the given formatter.

impl FromStr for Uri

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Uri

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Uri

fn eq(&self, other: &Uri) -> 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 Eq for Uri

impl StructuralPartialEq for Uri