Struct DnsEntry 

pub struct DnsEntry {
    pub hostname: String,
    pub addresses: Vec<SocketAddr>,
    pub resolved_at: Instant,
    pub ttl: Duration,
    pub ipv4_preferred: bool,
}

A single cached DNS entry containing resolved addresses and metadata.

Each entry stores the resolved socket addresses for a hostname, along with when it was resolved and its time-to-live duration.

Fields

hostname: String

The hostname this entry was resolved for

addresses: Vec<SocketAddr>

Resolved socket addresses (sorted by preference)

resolved_at: Instant

Timestamp when this entry was created/resolved

ttl: Duration

Time-to-live for this entry before it’s considered stale

ipv4_preferred: bool

Whether IPv4 addresses should be preferred in ordering

Implementations

impl DnsEntry

pub fn is_expired(&self) -> bool

Check if this DNS entry has expired based on its TTL.

Returns true if the elapsed time since resolution exceeds the TTL, meaning the entry should be re-resolved.

pub fn best_address(&self) -> Option<SocketAddr>

Get the best address from this entry.

If IPv4 is preferred, returns the first IPv4 address if available, otherwise falls back to the first address in the list. Returns None if there are no addresses.

pub fn all_addresses(&self) -> Vec<SocketAddr>

Return a clone of all cached addresses for this entry.

Trait Implementations

impl Clone for DnsEntry

fn clone(&self) -> DnsEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DnsEntry

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

Formats the value using the given formatter.