Enum Protocol

#[non_exhaustive]
pub enum Protocol {
    Udp,
    Tcp,
    Tls,
    Https,
    Quic,
    H3,
}

The protocol on which a NameServer should be communicated with

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.

Udp

UDP is the traditional DNS port, this is generally the correct choice

Tcp

TCP can be used for large queries, but not all NameServers support it

Tls

Available on crate feature dns-over-tls only.

Tls for DNS over TLS

Https

Available on crate feature dns-over-https-rustls only.

Https for DNS over HTTPS

Quic

Available on crate feature dns-over-quic only.

QUIC for DNS over QUIC

H3

Available on crate feature dns-over-h3 only.

HTTP/3 for DNS over HTTP/3

Implementations

impl Protocol

pub fn is_datagram(self) -> bool

Returns true if this is a datagram oriented protocol, e.g. UDP

pub fn is_stream(self) -> bool

Returns true if this is a stream oriented protocol, e.g. TCP

pub fn is_encrypted(self) -> bool

Is this an encrypted protocol, i.e. TLS or HTTPS

Trait Implementations

impl Clone for Protocol

fn clone(&self) -> Protocol

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Protocol

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

Formats the value using the given formatter.

impl Default for Protocol

fn default() -> Self

Default protocol should be UDP, which is supported by all DNS servers

impl<'de> Deserialize<'de> for Protocol

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Protocol

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

Formats the value using the given formatter.

impl Hash for Protocol

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 Protocol

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Protocol

impl Eq for Protocol

impl StructuralPartialEq for Protocol