Struct SVCB

pub struct SVCB<'a> {
    pub priority: u16,
    pub target: Name<'a>,
    /* private fields */
}

The SVCB DNS RR type is used to locate alternative endpoints for a service. RFC 9460.

Fields

priority: u16

The priority of this record (relative to others, with lower values preferred).

A value of 0 indicates AliasMode.

target: Name<'a>

The domain name of either the alias target (for AliasMode) or the alternative endpoint (for ServiceMode).

Implementations

impl<'a> SVCB<'a>

pub const MANDATORY: u16 = 0u16

Mandatory keys in this RR.

pub const ALPN: u16 = 1u16

Additional supported protocols.

pub const NO_DEFAULT_ALPN: u16 = 2u16

No support for default protocol.

pub const PORT: u16 = 3u16

Port for alternative endpoint.

pub const IPV4HINT: u16 = 4u16

IPv4 address hints.

pub const ECH: u16 = 5u16

Encrypted ClientHello (ECH) configuration.

pub const IPV6HINT: u16 = 6u16

IPv6 address hints.

pub fn new(priority: u16, target: Name<'a>) -> Self

Creates a new SVCB instance with no parameters.

pub fn set_param<V: Into<Cow<'a, [u8]>>>( &mut self, key: u16, value: V, ) -> Result<()>

Sets an arbitrary key=value parameter.

The format of value is not checked against the key.

If a parameter of the given key already existed, the previous entry will be replaced.

pub fn set_mandatory<I: IntoIterator<Item = u16>>( &mut self, keys: I, ) -> Result<()>

Sets the “mandatory” parameter.

The keys MUST not be empty and already in strictly increasing order.

pub fn set_alpn<'cs, I: IntoIterator<Item = CharacterString<'cs>>>( &mut self, alpn_ids: I, ) -> Result<()>

Sets the “alpn” parameter.

The alpn_ids MUST not be empty.

pub fn set_no_default_alpn(&mut self)

Sets the “no-default-alpn” parameter.

pub fn set_port(&mut self, port: u16)

Sets the “port” parameter.

pub fn set_ipv4hint<I: IntoIterator<Item = u32>>( &mut self, ips: I, ) -> Result<()>

Sets the “ipv4hint” parameter.

The ips MUST not be empty.

pub fn set_ipv6hint<I: IntoIterator<Item = u128>>( &mut self, ips: I, ) -> Result<()>

Sets the “ipv6hint” parameter.

The ips MUST not be empty.

pub fn get_param(&self, key: u16) -> Option<&[u8]>

Gets a read-only reference to the SvcParamValue of a given key in wire format.

Returns None if the key does not exist.

pub fn iter_params(&self) -> impl Iterator<Item = (u16, &[u8])>

Iterates over all parameters.

pub fn into_owned<'b>(self) -> SVCB<'b>

Transforms the inner data into its owned type

Trait Implementations

impl<'a> Clone for SVCB<'a>

fn clone(&self) -> SVCB<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for SVCB<'a>

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

Formats the value using the given formatter.

impl<'a> From<SVCB<'a>> for HTTPS<'a>

fn from(value: SVCB<'a>) -> Self

Converts to this type from the input type.

impl<'a> Hash for SVCB<'a>

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<'a> PartialEq for SVCB<'a>

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

impl<'a> StructuralPartialEq for SVCB<'a>