Struct DnsResolver 

pub struct DnsResolver;

DNS resolver for validating domain name resolution

Uses the system’s DNS resolver (std::net::ToSocketAddrs) to check if domains resolve to expected IP addresses. This checks actual DNS configuration including system DNS servers, /etc/hosts, and mDNS for .local domains.

Examples

use std::net::IpAddr;
use torrust_tracker_deployer_lib::infrastructure::dns::DnsResolver;
use torrust_tracker_deployer_lib::shared::domain_name::DomainName;

let resolver = DnsResolver::new();
let domain = DomainName::new("tracker.local")?;
let expected_ip: IpAddr = "10.140.190.254".parse()?;

match resolver.resolve_and_verify(&domain, expected_ip) {
    Ok(()) => println!("✓ Domain resolves correctly"),
    Err(e) => eprintln!("⚠ DNS check failed: {}", e),
}

Implementations

impl DnsResolver

pub const fn new() -> Self

Create a new DNS resolver

pub fn resolve( &self, domain: &DomainName, ) -> Result<Vec<IpAddr>, DnsResolutionError>

Resolve a domain name to IP addresses using system DNS

Arguments

• domain - Domain name to resolve

Returns

Vector of resolved IP addresses (may be empty if resolution fails)

Errors

Returns DnsResolutionError::ResolutionFailed if DNS resolution fails

pub fn resolve_and_verify( &self, domain: &DomainName, expected_ip: IpAddr, ) -> Result<(), DnsResolutionError>

Resolve a domain and verify it matches the expected IP address

This method resolves the domain and checks if any of the resolved IPs match the expected IP. It’s common for domains to resolve to multiple IPs (IPv4 and IPv6, or multiple servers).

Arguments

• domain - Domain name to resolve and verify
• expected_ip - Expected IP address

Returns

Ok(()) if the domain resolves and matches the expected IP

Errors

• DnsResolutionError::ResolutionFailed if DNS resolution fails
• DnsResolutionError::IpMismatch if domain resolves but not to expected IP

Trait Implementations

impl Clone for DnsResolver

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DnsResolver

impl Debug for DnsResolver

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

Formats the value using the given formatter.

impl Default for DnsResolver

fn default() -> Self

Returns the “default value” for a type.