Struct trust_dns_resolver::config::ResolverOpts

pub struct ResolverOpts {
    pub ndots: usize,
    pub timeout: Duration,
    pub attempts: usize,
    pub validate: bool,
    pub ip_strategy: LookupIpStrategy,
    pub cache_size: usize,
    pub use_hosts_file: bool,
    pub positive_min_ttl: Option<Duration>,
    pub negative_min_ttl: Option<Duration>,
    pub positive_max_ttl: Option<Duration>,
    pub negative_max_ttl: Option<Duration>,
    pub distrust_nx_responses: bool,
    pub num_concurrent_reqs: usize,
    // some fields omitted
}

Configuration for the Resolver

Fields

ndots: usize

Sets the number of dots that must appear (unless it's a final dot representing the root) that must appear before a query is assumted to include the TLD. The default is one, which means that www would never be assumed to be a TLD, and would always be appended to either the search

timeout: Duration

Specify the timeout for a request. Defaults to 5 seconds

attempts: usize

Number of attempts before giving up. Defaults to 2

validate: bool

Use DNSSec to validate the request

ip_strategy: LookupIpStrategy

The ip_strategy for the Resolver to use when lookup Ipv4 or Ipv6 addresses

cache_size: usize

Cache size is in number of records (some records can be large)

use_hosts_file: bool

Check /ect/hosts file before dns requery (only works for unix like OS)

positive_min_ttl: Option<Duration>

Optional minimum TTL for positive responses.

If this is set, any positive responses with a TTL lower than this value will have a TTL of positive_min_ttl instead. Otherwise, this will default to 0 seconds.

negative_min_ttl: Option<Duration>

Optional minimum TTL for negative (NXDOMAIN) responses.

If this is set, any positive responses with a TTL lower than this value will have a TTL of negative_min_ttl instead. Otherwise, this will default to 0 seconds.

positive_max_ttl: Option<Duration>

Optional maximum TTL for positive responses.

If this is set, any positive responses with a TTL higher than this value will have a TTL of positive_max_ttl instead. Otherwise, this will default to MAX_TTL seconds.

negative_max_ttl: Option<Duration>

Optional maximum TTL for negative (NXDOMAIN) responses.

If this is set, any positive responses with a TTL higher than this value will have a TTL of negative_max_ttl instead. Otherwise, this will default to MAX_TTL seconds.

distrust_nx_responses: bool

Default is to distrust negative responses from upstream nameservers

Currently only SERVFAIL responses are continued on, this may be expanded to include NXDOMAIN or NoError/Empty responses

num_concurrent_reqs: usize

Concurrent requests where more than one Nameserver is registered, the default is 2

0 or 1 will configure this to execute all requests serially

Trait Implementations

impl Copy for ResolverOpts

impl PartialEq<ResolverOpts> for ResolverOpts

fn eq(&self, other: &ResolverOpts) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &ResolverOpts) -> bool

This method tests for !=.

impl Clone for ResolverOpts

fn clone(&self) -> ResolverOpts

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for ResolverOpts

fn default() -> Self

Default values for the Reolver configuration.

This follows the resolv.conf defaults as defined in the Linux man pages

impl Eq for ResolverOpts

impl Debug for ResolverOpts

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

Formats the value using the given formatter.