Struct WireEncoder 

pub struct WireEncoder<'a, Q: QueryOrResponse, S: EncoderState> { /* private fields */ }

Writes a DNS message to an external buffer.

WireEncoder guards against buffer overflow. If the external buffer is too small to contain all content, then the encoder sets the message’s TC (truncation) flag and elides questions and/or resource records such that the DNS message is valid and fits within the buffer.

Implementations

impl<'a, Q: QueryOrResponse> WireEncoder<'a, Q, QuestionSection>

pub fn finalize_questions(self) -> WireEncoder<'a, Q, AnswerSection>

Transitions the encoder into a state for encoding answers.

pub fn encode_question<'b, F: Format<'b>>( &mut self, q: &'b Question<'b, F>, ) -> Result<(), EncoderError>

impl<'a> WireEncoder<'a, Query, QuestionSection>

pub fn new_query(buffer: &'a mut [u8], id: u16) -> Result<Self, EncoderError>

impl<'a> WireEncoder<'a, Response, AnswerSection>

pub fn new_response( buffer: &'a mut [u8], request: &WireMessage<'_>, ) -> Result<Self, EncoderError>

Constructs an encoder for encoding a response message.

The target response is initialized such that:

• Its ID field is copied from the request.
• Its QR bit is set.
• Its RD bit is copied from the request.
• Its question section is copied verbatim from the request.

If the request contains multiple questions, then the response will also contain multiple questions.

pub fn finalize_answers(self) -> WireEncoder<'a, Response, AuthoritySection>

pub fn encode_answer<'b, F: Format<'b>>( &mut self, r: &'b ResourceRecord<'b, F>, ) -> Result<(), EncoderError>

impl<'a> WireEncoder<'a, Response, AuthoritySection>

pub fn finalize_authorities( self, ) -> WireEncoder<'a, Response, AdditionalSection>

pub fn encode_authority<'b, F: Format<'b>>( &mut self, r: &'b ResourceRecord<'b, F>, ) -> Result<(), EncoderError>

impl<'a> WireEncoder<'a, Response, AdditionalSection>

pub fn finalize_additionals(self) -> WireEncoder<'a, Response, Done>

pub fn encode_additional<'b, F: Format<'b>>( &mut self, r: &'b ResourceRecord<'b, F>, ) -> Result<(), EncoderError>

impl<'a, Q: QueryOrResponse> WireEncoder<'a, Q, Done>

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

Trait Implementations

impl<'a, Q: Debug + QueryOrResponse, S: Debug + EncoderState> Debug for WireEncoder<'a, Q, S>

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

Formats the value using the given formatter.

impl<'a, Q: PartialEq + QueryOrResponse, S: PartialEq + EncoderState> PartialEq for WireEncoder<'a, Q, S>

fn eq(&self, other: &WireEncoder<'a, Q, S>) -> 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<'a, Q: Eq + QueryOrResponse, S: Eq + EncoderState> Eq for WireEncoder<'a, Q, S>

impl<'a, Q: QueryOrResponse, S: EncoderState> StructuralPartialEq for WireEncoder<'a, Q, S>