Struct Nsid

pub struct Nsid<Octs: ?Sized> { /* private fields */ }

Option data for the Name Server Identifier (NSID) Option.

This option allows identifying a particular name server that has answered a query. If a client is interested in this information, it includes an empty NSID option in its query. If the server supports the option, it includes it in its response with byte string identifying the server.

The option and details about its use are defined in RFC 5001.

Implementations

impl<Octs> Nsid<Octs>

pub fn from_octets(octets: Octs) -> Result<Self, LongOptData>

where Octs: AsRef<[u8]>,

Creates a value from the ocets of the name server identifier.

The function returns an error if octets is longer than 65,535 octets.

pub unsafe fn from_octets_unchecked(octets: Octs) -> Self

Creates a value from the name server identifier without checking.

Safety

The caller has to make sure that octets is no longer than 65,535 octets.

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

Parses a value from its wire format.

impl Nsid<[u8]>

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

Creates a value for a slice of the name server identifer.

The function returns an error if slice is longer than 65,535 octets.

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

Creates a value for a slice without checking.

Safety

The caller has to make sure that octets is no longer than 65,535 octets.

pub fn empty() -> &'static Self

Creates an empty NSID option value.

impl<Octs: ?Sized> Nsid<Octs>

pub fn as_octets(&self) -> &Octs

Returns a reference to the octets with the server identifier.

pub fn into_octets(self) -> Octs

where Octs: Sized,

Converts the value into the octets with the server identifier.

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

where Octs: AsRef<[u8]>,

Returns a slice of the server identifier.

pub fn for_slice(&self) -> &Nsid<[u8]>

where Octs: AsRef<[u8]>,

Returns a value over an octets slice.

Trait Implementations

impl<Octs: AsRef<[u8]> + ?Sized> AsRef<[u8]> for Nsid<Octs>

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

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

impl<Octs: AsRef<[u8]> + ?Sized> Borrow<[u8]> for Nsid<Octs>

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

Immutably borrows from an owned value.

impl<Octs: Clone + ?Sized> Clone for Nsid<Octs>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Octs: AsRef<[u8]> + ?Sized> ComposeOptData for Nsid<Octs>

fn compose_len(&self) -> u16

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

impl<Octs: AsRef<[u8]> + ?Sized> Debug for Nsid<Octs>

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

Formats the value using the given formatter.

impl<Octs: AsRef<[u8]> + ?Sized> Display for Nsid<Octs>

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

Formats the value using the given formatter.

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

fn from(value: Nsid<Octs>) -> Self

Converts to this type from the input type.

impl<Octs: AsRef<[u8]> + ?Sized> Hash for Nsid<Octs>

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<Octs, SrcOcts> OctetsFrom<Nsid<SrcOcts>> for Nsid<Octs>

where Octs: OctetsFrom<SrcOcts>,

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

fn try_octets_from(src: Nsid<SrcOcts>) -> Result<Self, Self::Error>

Performs the conversion.

fn octets_from(source: Source) -> Self

where Self::Error: Into<Infallible>,

Performs an infallible conversion.

impl<Octs: ?Sized> OptData for Nsid<Octs>

fn code(&self) -> OptionCode

Returns the option code associated with this option.

impl<Octs: AsRef<[u8]> + ?Sized> Ord for Nsid<Octs>

fn cmp(&self, other: &Self) -> 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: Octets> ParseOptData<'a, Octs> for Nsid<Octs::Range<'a>>

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

Parses the option code data.

impl<Octs, Other> PartialEq<Other> for Nsid<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 Nsid<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.

impl<Octs: Copy + ?Sized> Copy for Nsid<Octs>

impl<Octs: AsRef<[u8]> + ?Sized> Eq for Nsid<Octs>