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 fn new(priority: u16, target: Name<'a>) -> Self

Creates a new SVCB instance with no parameters.

pub fn set_param(&mut self, param: SVCParam<'a>)

Sets a parameter, replacing any previous value.

pub fn with_param(self, param: SVCParam<'a>) -> Self

Same as Self::set_param, but returns self for chaining.

pub fn set_mandatory(&mut self, keys: impl Iterator<Item = u16>)

Sets the “mandatory” parameter.

If keys is empty, this method does nothing.

pub fn set_alpn(&mut self, alpn_ids: &[CharacterString<'a>])

Sets the “alpn” parameter.

if alpn_ids is empty, this method does nothing.

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(&mut self, ips: &[u32])

Sets the “ipv4hint” parameter.

if ips is empty, this method does nothing.

pub fn set_ipv6hint(&mut self, ips: &[u128])

Sets the “ipv6hint” parameter.

if ips is empty, this method does nothing

pub fn get_param(&'a self, key: u16) -> Option<&'a SVCParam<'a>>

Gets a read-only reference to the SVCParam

Returns None if the key does not exist.

pub fn iter_params(&self) -> impl Iterator<Item = &SVCParam<'_>>

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>