Struct AdditionalBuilder

pub struct AdditionalBuilder { /* private fields */ }

Builds the additional section of a DNS message.

This type can be constructed by calling additional on a MessageBuilder, AnswerBuilder, or AuthorityBuilder. See the module documentation for on overview on building messages.

Once aquired, you can add records to the additional section via the push method. If the record you want to add is an OPT record, you can also use the OptBuilder type which you can acquire via the opt method.

Implementations

impl AdditionalBuilder

pub fn opt(self) -> Result<OptBuilder, ShortBuf>

where Self: Sized,

Proceeds to building the OPT record.

The method will start by adding the record header. Since this may exceed the message limit, the method may fail. If you have saved space for the OPT record via set_limit earlier, remember to increase the limit again before calling opt.

Trait Implementations

impl Clone for AdditionalBuilder

fn clone(&self) -> AdditionalBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AdditionalBuilder

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

Formats the value using the given formatter.

impl RecordSectionBuilder for AdditionalBuilder

fn push<N, D, R>(&mut self, record: R) -> Result<(), ShortBuf>

where N: ToDname, D: RecordData, R: Into<Record<N, D>>,

Appends a new resource record to the section.

impl SectionBuilder for AdditionalBuilder

fn into_target(self) -> MessageTarget

Converts into target

fn get_target(&self) -> &MessageTarget

Returns message target

fn get_target_mut(&mut self) -> &mut MessageTarget

Returns message target

fn set_limit(&mut self, limit: usize)

Updates the message’s size limit.

fn header(&self) -> &Header

Returns a reference to the messages header.

fn header_mut(&mut self) -> &mut Header

Returns a mutable reference to the messages header.

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

Returns a reference to the message assembled so far.

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

Returns a reference to the slice preceeding the message.

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

Returns a mutable reference to the slice preceeding the message.

fn finish(self) -> BytesMut

Finishes the message and returns the underlying bytes buffer.

fn freeze(self) -> Message

Finishes the message and returns the resulting bytes value.

fn snapshot(&self) -> Snapshot<Self>

Returns a snapshot indicating the current state of the message.

fn rewind(&mut self, snapshot: &Snapshot<Self>)

Rewinds the message to the state it had at snapshot.