Struct cdns_rs::sync::query::QDns

source ·

pub struct QDns<'req> { /* private fields */ }

Expand description

A main instance which contains all common logic.

Implementations§

source §

impl<'req> QDns<'req>

source

pub fn make_empty( resolvers: Arc<ResolveConfig>, planned_reqs_len: usize, opts: QuerySetup ) -> Self

Initializes new empty storage for requests.

In some cases it is good idea to combine different requests, because by default all requests are performed in parallel. But in some cases it is bad idea.

§Arguments

resolvers - an Arc ResolveConfig which contains configuration i.e nameservers
planned_reqs_len - how many requests are planned
opts - QuerySetup additional options or overrides. Use default() for default values.

§Returns

Never panics. Returns Self.

source

pub fn add_request<R>(&mut self, qtype: QType, req_name: R)
where R: Into<QDnsName<'req>>,

Adds new request to previously created empty storage for request with QDns::make_empty.

§Arguemnts

qtype - a QType type of the request
req_name - a Into QDnsName which is target. i.e ‘localhost’ or ‘domain.tld’

§Returns

CDnsResult - Ok with nothing in inner type
CDnsResult - Err with error description

source

pub fn make_a_aaaa_request<R>( resolvers: Arc<ResolveConfig>, req_name: R, opts: QuerySetup ) -> CDnsResult<Self>
where R: Into<QDnsName<'req>>,

This is helper which makes for you an A, AAAA query. The order of A and AAAA and which from both are allowed is defined in the ResolveConfig.

Use this function directly. Do not use QDns::make_empty

§Arguments

resolvers - an Arc ResolveConfig which contains configuration i.e nameservers
req_name - a Into QDnsName which is target i.e ‘localhost’ or ‘domain.tld’
opts - QuerySetup additional options or overrides. Use default() for default values.