Struct cdns_rs::a_sync::query::QDns

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

A main instance which contains all common logic.

Implementations

impl<'req> QDns<'req>

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

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.

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

pub fn make_a_aaaa_request<R>(
    resolvers: Arc<ResolveConfig>,
    req_name: R,
    opts: QuerySetup
) -> QDns<'req> 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.

Returns

• CDnsResult - Ok with Self as inner type

• CDnsResult - Err with error description

pub async fn query(self) -> QDnsQueriesRes

Runs the created query/ies

Returns

• CDnsResult with QDnsQueriesRes which may contain results

• CDnsResult with error

Should not panic. MT-safe.