Struct domain::rdata::svcb::SvcbRdata

source ·
pub struct SvcbRdata<Variant, Octs, Name> { /* private fields */ }
Expand description

Service binding record data.

This type provides the record data for the various service binding record types. The particular record type is encoded via the Variant type argument with marker types representing the concrete types. Currently these are ScvbVariant for the SVCB record type and HttpsVariant for HTTPS. The aliases Svcb<..> and Https<..> are available for less typing.

The service binding record data contains three fields: a integer priority, a target name – the type of which is determined by the Name type argument –, and a sequence of service parameters. A separate type SvcParams has been defined for those which is generic over an octets sequence determined by the Octs type argument.

The record can be used in one of two modes, ‘alias mode’ or ‘service mode.’

In alias mode, there should only be one record with its priority set to 0 and no service parameters. In this case, the target name indicates the name that actually provides the service and should be resolved further. The root name can be used as the target name to indicate that the particular service is not being provided.

In ‘service mode,’ one or more records can exist and used in the order provided by the priority field with lower priority looked at first. Each record describes an alternative endpoint for the service and parameters for its use. What exactly this means depends on the protocol in question.

The owner name of service binding records determines which service the records apply to. The domain name for which the service is provided is prefixed by first the port and protocol of the service, both as underscore labels. So, for HTTPS on port 443, the prefix would be _443._https. However, the HTTPS record type allows to drop the prefix in that particular case.

Note that the above is a wholy inadequate summary of service bindings records. For accurate details, see draft-ietf-dnsop-svcb-https.

Implementations§

source§

impl<Variant, Octs, Name> SvcbRdata<Variant, Octs, Name>

source

pub fn new( priority: u16, target: Name, params: SvcParams<Octs>, ) -> Result<Self, LongRecordData>
where Octs: AsRef<[u8]>, Name: ToDname,

Create a new value from its components.

Returns an error if the wire format of the record data would exceed the length of 65,535 octets.

source

pub unsafe fn new_unchecked( priority: u16, target: Name, params: SvcParams<Octs>, ) -> Self

Creates a new value from its components without checking.

§Safety

The called must ensure that the wire format of the record data does not exceed a length of 65,535 octets.

source§

impl<Variant, Octs: AsRef<[u8]>> SvcbRdata<Variant, Octs, ParsedDname<Octs>>

source

pub fn parse<'a, Src: Octets<Range<'a> = Octs> + ?Sized + 'a>( parser: &mut Parser<'a, Src>, ) -> Result<Self, ParseError>

Parses service bindings record data from its wire format.

source§

impl<Variant, Octs, Name> SvcbRdata<Variant, Octs, Name>

source

pub fn priority(&self) -> u16

Returns the priority.

source

pub fn is_alias(&self) -> bool

Returns whether this service binding is in alias mode.

This is identical to self.priority() == 0.

source

pub fn is_service(&self) -> bool

Returns whether this service binding is in service mode.

This is identical to self.priority() != 0.

source

pub fn target(&self) -> &Name

Returns the target name.

Note the target name won’t be translated to the owner automatically in service mode if it equals the root name.

source

pub fn params(&self) -> &SvcParams<Octs>

Returns the parameters.

Trait Implementations§

source§

impl<Variant: Clone, Octs: Clone, Name: Clone> Clone for SvcbRdata<Variant, Octs, Name>

source§

fn clone(&self) -> SvcbRdata<Variant, Octs, Name>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<Variant, Octs, Name> ComposeRecordData for SvcbRdata<Variant, Octs, Name>
where Self: RecordData, Octs: AsRef<[u8]>, Name: ToDname,

source§

fn rdlen(&self, _compress: bool) -> Option<u16>

Returns the length of the record data if available. Read more
source§

fn compose_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the wire format of the record data into target.
source§

fn compose_canonical_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the canonical wire format of the record data into target.
source§

fn compose_len_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the record data prefixed with its length.
source§

fn compose_canonical_len_rdata<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Appends the record data prefixed with its length.
source§

impl<Variant, Octs, Name> Debug for SvcbRdata<Variant, Octs, Name>
where Octs: Octets, Name: Debug,

source§

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

Formats the value using the given formatter. Read more
source§

impl<Variant, Octs, Name> Display for SvcbRdata<Variant, Octs, Name>
where Octs: Octets, Name: Display,

source§

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

Formats the value using the given formatter. Read more
source§

impl<Variant, Octs, TOcts, Name, TName> FlattenInto<SvcbRdata<Variant, TOcts, TName>> for SvcbRdata<Variant, Octs, Name>
where TOcts: OctetsFrom<Octs>, Name: FlattenInto<TName, AppendError = TOcts::Error>,

§

type AppendError = <TOcts as OctetsFrom<Octs>>::Error

source§

fn try_flatten_into( self, ) -> Result<SvcbRdata<Variant, TOcts, TName>, TOcts::Error>

source§

impl<O, N> From<SvcbRdata<HttpsVariant, O, N>> for AllRecordData<O, N>

source§

fn from(value: Https<O, N>) -> Self

Converts to this type from the input type.
source§

impl<O, N> From<SvcbRdata<SvcbVariant, O, N>> for AllRecordData<O, N>

source§

fn from(value: Svcb<O, N>) -> Self

Converts to this type from the input type.
source§

impl<Variant, Octs: AsRef<[u8]>, Name: Hash> Hash for SvcbRdata<Variant, Octs, Name>

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more
source§

impl<Variant, Octs, SrcOctets, Name, SrcName> OctetsFrom<SvcbRdata<Variant, SrcOctets, SrcName>> for SvcbRdata<Variant, Octs, Name>
where Octs: OctetsFrom<SrcOctets>, Name: OctetsFrom<SrcName, Error = Octs::Error>,

§

type Error = <Octs as OctetsFrom<SrcOctets>>::Error

source§

fn try_octets_from( source: SvcbRdata<Variant, SrcOctets, SrcName>, ) -> Result<Self, Self::Error>

Performs the conversion.
source§

impl<Variant, Octs: AsRef<[u8]>, Name: ToDname> Ord for SvcbRdata<Variant, Octs, Name>

source§

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

Restrict a value to a certain interval. Read more
source§

impl<'a, Octs: Octets + ?Sized> ParseRecordData<'a, Octs> for SvcbRdata<HttpsVariant, Octs::Range<'a>, ParsedDname<Octs::Range<'a>>>

source§

fn parse_rdata( rtype: Rtype, parser: &mut Parser<'a, Octs>, ) -> Result<Option<Self>, ParseError>

Parses the record data. Read more
source§

impl<'a, Octs: Octets + ?Sized> ParseRecordData<'a, Octs> for SvcbRdata<SvcbVariant, Octs::Range<'a>, ParsedDname<Octs::Range<'a>>>

source§

fn parse_rdata( rtype: Rtype, parser: &mut Parser<'a, Octs>, ) -> Result<Option<Self>, ParseError>

Parses the record data. Read more
source§

impl<Variant, OtherVariant, Octs, OtherOcts, Name, OtherName> PartialEq<SvcbRdata<OtherVariant, OtherOcts, OtherName>> for SvcbRdata<Variant, Octs, Name>
where Octs: AsRef<[u8]>, OtherOcts: AsRef<[u8]>, Name: ToDname, OtherName: ToDname,

source§

fn eq(&self, other: &SvcbRdata<OtherVariant, OtherOcts, OtherName>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<Variant, OtherVariant, Octs, OtherOcts, Name, OtherName> PartialOrd<SvcbRdata<OtherVariant, OtherOcts, OtherName>> for SvcbRdata<Variant, Octs, Name>
where Octs: AsRef<[u8]>, OtherOcts: AsRef<[u8]>, Name: ToDname, OtherName: ToDname,

source§

fn partial_cmp( &self, other: &SvcbRdata<OtherVariant, OtherOcts, OtherName>, ) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

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

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
source§

impl<Octs, Name> RecordData for SvcbRdata<HttpsVariant, Octs, Name>

source§

fn rtype(&self) -> Rtype

Returns the record type associated with this record data instance. Read more
source§

impl<Octs, Name> RecordData for SvcbRdata<SvcbVariant, Octs, Name>

source§

fn rtype(&self) -> Rtype

Returns the record type associated with this record data instance. Read more
source§

impl<Variant, Octs: AsRef<[u8]>, Name: ToDname> Eq for SvcbRdata<Variant, Octs, Name>

Auto Trait Implementations§

§

impl<Variant, Octs, Name> Freeze for SvcbRdata<Variant, Octs, Name>
where Name: Freeze, Octs: Freeze,

§

impl<Variant, Octs, Name> RefUnwindSafe for SvcbRdata<Variant, Octs, Name>
where Name: RefUnwindSafe, Octs: RefUnwindSafe, Variant: RefUnwindSafe,

§

impl<Variant, Octs, Name> Send for SvcbRdata<Variant, Octs, Name>
where Name: Send, Octs: Send, Variant: Send,

§

impl<Variant, Octs, Name> Sync for SvcbRdata<Variant, Octs, Name>
where Name: Sync, Octs: Sync, Variant: Sync,

§

impl<Variant, Octs, Name> Unpin for SvcbRdata<Variant, Octs, Name>
where Name: Unpin, Octs: Unpin, Variant: Unpin,

§

impl<Variant, Octs, Name> UnwindSafe for SvcbRdata<Variant, Octs, Name>
where Name: UnwindSafe, Octs: UnwindSafe, Variant: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Source, Target> OctetsInto<Target> for Source
where Target: OctetsFrom<Source>,

§

type Error = <Target as OctetsFrom<Source>>::Error

source§

fn try_octets_into( self, ) -> Result<Target, <Source as OctetsInto<Target>>::Error>

Performs the conversion.
source§

fn octets_into(self) -> Target
where Self::Error: Into<Infallible>,

Performs an infallible conversion.
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more