Struct dnsclientx::DNSClient

pub struct DNSClient { /* private fields */ }

A DNS Client. A simple DNS Client.

Example

use dnsclientx::DNSClient;

let nameservers = vec![SocketAddr::from_str("1.0.0.1:53").unwrap()];
let dns_client = DNSClient::new(nameservers);
let ips = dns_client.query_a("one.one.one.one").unwrap();

let expected = "1.1.1.1".parse().unwrap();
assert!(ips.contains(&expected));

Implementations

impl DNSClient

pub fn new(upstream_servers: Vec<SocketAddr>) -> Self

Create a new DNSClient.

Example

use dnsclientx::DNSClient;

let nameservers = vec![SocketAddr::from_str("1.0.0.1:53").unwrap()];
let dns_client = DNSClient::new(nameservers);

pub fn set_timeout(&mut self, timeout: Duration)

Set the timeout used for DNS requests.

Example

let mut dns_client = DNSClient::new(nameservers);
dns_client.set_timeout(Duration::from_secs(2));

pub fn set_local_v4_addr<T: Into<SocketAddr>>(&mut self, addr: T)

Set the local IPV4 socket address for use with UDP queries.

Example

let mut dns_client = DNSClient::new(nameservers);
dns_client.set_local_v4_addr(([192, 168, 1, 28], 1234));

pub fn set_local_v6_addr<T: Into<SocketAddr>>(&mut self, addr: T)

Set the local IPV6 socket address for use with UDP queries.

Example

let mut dns_client = DNSClient::new(nameservers);
dns_client.set_local_v6_addr(([0; 16], 1234));

pub fn query_a(&self, name: &str) -> Result<Vec<IpAddr>>

Get the IPV4 address of the given domain name.

Returns an empty Vec if no addresses were found.

Example

use dnsclientx::DNSClient;

let nameservers = vec![SocketAddr::from_str("1.0.0.1:53").unwrap()];
let dns_client = DNSClient::new(nameservers);
let ips = dns_client.query_a("one.one.one.one").unwrap();

let expected = "1.1.1.1".parse().unwrap();
assert!(ips.contains(&expected));

pub fn query_aaaa(&self, name: &str) -> Result<Vec<IpAddr>>

Get the IPV6 address of the given domain name.

Returns an empty Vec if no addresses were found.

Example

use dnsclientx::DNSClient;

let nameservers = vec![SocketAddr::from_str("1.0.0.1:53").unwrap()];
let dns_client = DNSClient::new(nameservers);
let ips = dns_client.query_aaaa("one.one.one.one").unwrap();

let expected = "2606:4700:4700::1001".parse().unwrap();
assert!(ips.contains(&expected));

pub fn query_ptr(&self, ip: IpAddr) -> Result<String>

Do a reverse lookup on the given IPV4 or IPV6 address.

Examples

let dns_client = DNSClient::new(nameservers);
let ip  = "1.1.1.1".parse().unwrap();
let name = dns_client.query_ptr(ip).unwrap();

assert!(name == "one.one.one.one");

Returns an error if no name exists.

let dns_client = DNSClient::new(nameservers);
// An IP address that has no name
let ip  = "1.2.3.4".parse().unwrap();
let res = dns_client.query_ptr(ip);

assert!(matches!(res, Err(e) if e.kind() == std::io::ErrorKind::NotFound));

pub fn query_ns(&self, domain: &str) -> Result<Vec<String>>

Get the name servers for the given domain.

Examples

let dns_client = DNSClient::new(nameservers);
let ns = dns_client.query_ns("one.one.one").unwrap();

Trait Implementations

impl Clone for DNSClient

fn clone(&self) -> DNSClient

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DNSClient

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

Formats the value using the given formatter.