Struct toluol::DnsHeader

pub struct DnsHeader { /* fields omitted */ }

Represents a DNS header. rcode is an Option<DnsRcode> because valid DNS queries do not have a RCODE. See here for a list of available flags and their respective defining RFCs. The general format of a header is defined in RFC 1035.

Implementations

impl DnsHeader

pub fn new_response_header(
    msg_id: u16,
    opcode: DnsOpcode,
    flags: DnsFlags,
    rcode: DnsRcode,
    counts: [u16; 4]
) -> Self

Creates a header for a DNS response message. See RFC 1035 and here for information about the parameters. qdcount, ancount, nscount and arcount are grouped in that order in the counts parameter.

pub fn new_query_header(
    msg_id: u16,
    opcode: DnsOpcode,
    flags: DnsFlags,
    edns: bool,
    qdcount: u16
) -> Result<Self, EncodeError>

Creates a header for a DNS query message. If the query includes an OPT record, edns must be true. See RFC 1035 and here for information about the other parameters.

pub fn encode(&self) -> Result<Vec<u8>, EncodeError>

Encodes a DnsHeader as a series of bytes. Returns an error if a method defined in byteorder::WriteBytesExt returns an error.

pub fn parse(header: &mut Cursor<&[u8]>) -> Result<Self, ParseError>

Parses an encoded DnsHeader from a series of bytes. Returns an error if DnsOpcode::parse(), DnsRcode::parse() or a method defined in byteorder::ReadBytesExt return an error.

pub fn info_str(&self) -> String

Creates a string containing information (id, opcode, rcode if applicable, flags) about the header.

Trait Implementations

impl Display for DnsHeader

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

Formats the value using the given formatter.