Struct Padding

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

Option data for the padding option.

This option is used to increase the size of a DNS message to a fixed value so eavesdropper can’t dertermine information from the size.

Generally, you should not need to use this type. Instead, you can use the OptBuilder::padding and OptBuilder::random_padding methods to add padding to a message – and ignore it when receving one.

The option is defined in RFC 7830.

Implementations

impl Padding<()>

pub const CODE: OptionCode = OptionCode::PADDING

The option code for this option.

impl<Octs> Padding<Octs>

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

where Octs: AsRef<[u8]>,

Creates a value from the padding octets.

Returns an error if octets are longer than 65,535 octets.

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

Creates a value from the padding octets without checking.

Safety

The caller needs to ensure that octets are not 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 formal.

impl<Octs: ?Sized> Padding<Octs>

pub fn as_octets(&self) -> &Octs

Returns a reference to the padding octets.

pub fn into_octets(self) -> Octs

where Octs: Sized,

Converts the value into the padding octets.

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

where Octs: AsRef<[u8]>,

Returns a slice of the padding octets.

Trait Implementations

impl<Octs: AsRef<[u8]> + ?Sized> AsRef<[u8]> for Padding<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 Padding<Octs>

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

Immutably borrows from an owned value.

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Octs: AsRef<[u8]>> ComposeOptData for Padding<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 Padding<Octs>

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

Formats the value using the given formatter.

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

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

Formats the value using the given formatter.

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

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

Converts to this type from the input type.

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

where Octs: OctetsFrom<SrcOcts>,

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

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

Performs the conversion.

impl<Octs> OptData for Padding<Octs>

fn code(&self) -> OptionCode

Returns the option code associated with this option.

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

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

Parses the option code data.

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