Struct DnsResolver

pub struct DnsResolver { /* private fields */ }

A DNS resolver

Implementations

impl DnsResolver

pub fn new(dns: SocketAddr) -> Result<Self, DnsError>

Create a new DNS resolver

Parameters

• dns: The SocketAddr of the DNS server

Errors

• DnsError::FailedToCreate: The DNS resolver failed to create. This may happen if the socket could not be created or bound to the specified address

pub fn try_default() -> Result<Self, DnsError>

Try to create a new DNS resolver with default settings The default settings are to use Google’s DNS server at 8.8.8.8:53

Errors

• DnsError::FailedToCreate: The DNS resolver failed to create. This may happen if the socket could not be created or bound to the specified address

pub fn resolve(&mut self, host: &str) -> Result<in_addr, DnsError>

Resolve a hostname to an IP address

Parameters

• host: The hostname to resolve

Returns

• Ok(in_addr): The IP address of the hostname
• Err(()): If the hostname could not be resolved

Errors

• DnsError::HostnameResolutionFailed: The hostname could not be resolved. This may happen if the connection of the socket fails, or if the DNS server does not answer the query, or any other error occurs

pub fn dns(&self) -> SocketAddr

Get the SocketAddr of the DNS server

Trait Implementations

impl ResolveAddr for DnsResolver

type Error = DnsError

fn resolve_addr(&mut self, _addr: in_addr) -> Result<String, DnsError>

Resolve an IP address to a hostname

impl ResolveHostname for DnsResolver

fn resolve_hostname(&mut self, hostname: &str) -> Result<SocketAddr, DnsError>

Resolve a hostname to an IP address

Parameters

• host: The hostname to resolve

Returns

• Ok(SocketAddr): The IP address of the hostname
• Err(DnsError): If the hostname could not be resolved

Errors

• DnsError::HostnameResolutionFailed: The hostname could not be resolved. This may happen if the connection of the socket fails, or if the DNS server does not answer the query, or any other error occurs

type Error = DnsError

impl DnsResolver for DnsResolver