Struct KeyTag 

pub struct KeyTag<Octs>
where
    Octs: ?Sized,
{ /* private fields */ }

Option data for the edns-key-tag option.

This option allows a client to indicate the key tags of the trust anchor keys they are using to validate responses. The option contains a sequence of key tags.

Implementations

impl<Octs> KeyTag<Octs>

pub fn from_octets(octets: Octs) -> Result<KeyTag<Octs>, ParseError>

where Octs: AsRef<[u8]>,

Creates a new value from its content in wire format.

The function returns an error if the octets do not encode a valid edns-key-tag option: the length needs to be an even number of octets and no longer than 65,536 octets.

pub unsafe fn from_octets_unchecked(octets: Octs) -> KeyTag<Octs>

Creates a new value from its wire-format content without checking.

Safety

The caller needs to ensure that octets is a valid key tag. The length needs to be an even number of octets and no longer than 65,536 octets.

pub fn parse<'a, Src>( parser: &mut Parser<'a, Src>, ) -> Result<KeyTag<Octs>, ParseError>

where Src: Octets<Range<'a> = Octs> + ?Sized,

impl KeyTag<[u8]>

pub fn from_slice(slice: &[u8]) -> Result<&KeyTag<[u8]>, ParseError>

Creates a key tag value from a slice.

Returns an error if slice does not contain a valid key tag.

pub unsafe fn from_slice_unchecked(slice: &[u8]) -> &KeyTag<[u8]>

Creates a key tag value from a slice without checking.

Safety

The caller needs to ensure that slice contains a valid key tag. The length needs to be an even number of octets and no longer than 65,536 octets.

impl<Octs> KeyTag<Octs>

where Octs: ?Sized,

pub fn as_octets(&self) -> &Octs

Returns a reference to the underlying octets.

The octets contain the key tag value in its wire format: a sequence of u16 in network byte order.

pub fn into_octets(self) -> Octs

where Octs: Sized,

Converts the value to the underlying octets.

The octets contain the key tag value in its wire format: a sequence of u16 in network byte order.

pub fn as_slice(&self) -> &[u8]

where Octs: AsRef<[u8]>,

Returns a slice of the underlying octets.

The slice will contain the key tag value in its wire format: a sequence of u16 in network byte order.

pub fn as_slice_mut(&mut self) -> &mut [u8]

where Octs: AsMut<[u8]>,

Returns a mutable slice of the underlying octets.

The slice will contain the key tag value in its wire format: a sequence of u16 in network byte order.

pub fn iter(&self) -> KeyTagIter<'_>

where Octs: AsRef<[u8]>,

Returns an iterator over the individual key tags.

Trait Implementations

impl<Octs> AsMut<[u8]> for KeyTag<Octs>

where Octs: AsMut<[u8]> + ?Sized,

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<Octs> AsRef<[u8]> for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized,

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<Octs> Borrow<[u8]> for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized,

fn borrow(&self) -> &[u8]

Immutably borrows from an owned value.

impl<Octs> BorrowMut<[u8]> for KeyTag<Octs>

where Octs: AsMut<[u8]> + AsRef<[u8]> + ?Sized,

fn borrow_mut(&mut self) -> &mut [u8]

Mutably borrows from an owned value.

impl<Octs> Clone for KeyTag<Octs>

where Octs: Clone + ?Sized,

fn clone(&self) -> KeyTag<Octs>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Octs> ComposeOptData for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized,

fn compose_len(&self) -> u16

fn compose_option<Target>( &self, target: &mut Target, ) -> Result<(), <Target as OctetsBuilder>::AppendError>

where Target: OctetsBuilder + ?Sized,

impl<Octets> Debug for KeyTag<Octets>

where Octets: AsRef<[u8]> + ?Sized,

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

Formats the value using the given formatter.

impl<Octets> Display for KeyTag<Octets>

where Octets: AsRef<[u8]> + ?Sized,

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

Formats the value using the given formatter.

impl<Octs> Eq for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized,

impl<Octs, Name> From<KeyTag<Octs>> for AllOptData<Octs, Name>

fn from(value: KeyTag<Octs>) -> AllOptData<Octs, Name>

Converts to this type from the input type.

impl<Octs> Hash for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized,

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

where H: Hasher,

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, Octs> IntoIterator for &'a KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized,

type Item = u16

The type of the elements being iterated over.

type IntoIter = KeyTagIter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a KeyTag<Octs> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<Octs, SrcOcts> OctetsFrom<KeyTag<SrcOcts>> for KeyTag<Octs>

where Octs: OctetsFrom<SrcOcts>,

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

fn try_octets_from( src: KeyTag<SrcOcts>, ) -> Result<KeyTag<Octs>, <KeyTag<Octs> as OctetsFrom<KeyTag<SrcOcts>>>::Error>

Performs the conversion.

fn octets_from(source: Source) -> Self

where Self::Error: Into<Infallible>,

Performs an infallible conversion.

impl<Octs> OptData for KeyTag<Octs>

where Octs: ?Sized,

fn code(&self) -> OptionCode

Returns the option code associated with this option.

impl<Octs> Ord for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized,

fn cmp(&self, other: &KeyTag<Octs>) -> Ordering

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'a, Octs> ParseOptData<'a, Octs> for KeyTag<<Octs as Octets>::Range<'a>>

where Octs: Octets,

fn parse_option( code: OptionCode, parser: &mut Parser<'a, Octs>, ) -> Result<Option<KeyTag<<Octs as Octets>::Range<'a>>>, ParseError>

Parses the option code data.

impl<Octs, Other> PartialEq<Other> for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized, Other: AsRef<[u8]> + ?Sized,

fn eq(&self, other: &Other) -> 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<Octs, Other> PartialOrd<Other> for KeyTag<Octs>

where Octs: AsRef<[u8]> + ?Sized, Other: AsRef<[u8]> + ?Sized,

fn partial_cmp(&self, other: &Other) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

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