Struct dnsie::DnsRequest

pub struct DnsRequest<'a> {
    pub id: u16,
    pub query_name: Cow<'a, str>,
    pub query_kind: AnyQueryKind,
    pub ty: AnyDnsType,
    pub cls: AnyDnsClass,
}

DnsRequest is parsed(or manually constructed) dns request which may be serialized and sent to DNS server.

Right now the only serialization destination format is DNS binary but it may be serialized to some JSON specific for DNS resolver platform.

Note

It does not contain fields which are.

Fields

id: u16

query_name: Cow<'a, str>

query_name is domain name represented as string

query_kind: AnyQueryKind

ty: AnyDnsType

cls: AnyDnsClass

Methods

impl<'a> DnsRequest<'a>

pub fn make_simple(ty: AnyDnsType, domain: &'a str) -> Self

make_simple constructs request with reasonable defaults to resolve given record type for given domain

impl<'a> DnsRequest<'a>

pub fn to_dns_binary(&self, w: &mut impl Write) -> Result<(), Error>

to_dns_binary serializes given request into DNS binary format.

Error

It returns error if writer fails. If some label can't be encoded for some reason appropriate std::io::Error is returned. Otherwise it always succeeds and returns Ok(()).

Note

Checks for name correctness aren't necessarily strict and thus this function may create invalid(according to RFC) dns request. This may happen for instance when there are too many labels.