Struct Config

pub struct Config { /* private fields */ }

Configuration of a datagram transport.

Implementations

impl Config

pub fn new() -> Self

Creates a new config with default values.

pub fn set_max_parallel(&mut self, value: usize)

Sets the maximum number of parallel requests.

Once this many number of requests are currently outstanding, additional requests will wait.

If this value is too small or too large, it will be capped.

pub fn max_parallel(&self) -> usize

Returns the maximum number of parallel requests.

pub fn set_read_timeout(&mut self, value: Duration)

Sets the read timeout.

The read timeout is the maximum amount of time to wait for any response after a request was sent.

If this value is too small or too large, it will be capped.

pub fn read_timeout(&self) -> Duration

Returns the read timeout.

pub fn set_max_retries(&mut self, value: u8)

Sets the maximum number of times a request is retried before giving up.

If this value is too small or too large, it will be capped.

pub fn max_retries(&self) -> u8

Returns the maximum number of request retries.

pub fn set_udp_payload_size(&mut self, value: Option<u16>)

Sets the requested UDP payload size.

This value indicates to the server the maximum size of a UDP packet. For UDP on public networks, this value should be left at the default of 1232 to avoid issues rising from packet fragmentation. See draft-ietf-dnsop-avoid-fragmentation for a discussion on these issues and recommendations.

On private networks or protocols other than UDP, other values can be used.

Setting the UDP payload size to None currently results in messages that will not include an OPT record.

pub fn udp_payload_size(&self) -> Option<u16>

Returns the UDP payload size.

pub fn set_recv_size(&mut self, size: usize)

Sets the receive buffer size.

This is the amount of memory that is allocated for receiving a response.

pub fn recv_size(&self) -> usize

Returns the receive buffer size.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.