Struct DnsHandle 

pub struct DnsHandle { /* private fields */ }

Handle for managing DNS records after server is started

This handle can be cloned and used to add/remove records while the server is running.

Implementations

impl DnsHandle

pub async fn add_record( &self, hostname: &str, ip: IpAddr, ) -> Result<(), DnsError>

Add a DNS record for a hostname to IP mapping

Creates an A record for IPv4 addresses and an AAAA record for IPv6 addresses.

Errors

Returns DnsError::InvalidName if the hostname is invalid.

pub async fn remove_record(&self, hostname: &str) -> Result<bool, DnsError>

Remove DNS records for a hostname (both A and AAAA)

Tombstones both record types since we don’t track which type was stored.

Errors

Returns DnsError::InvalidName if the hostname is invalid.

pub fn zone_origin(&self) -> &Name

Get the zone origin

pub async fn lookup_a(&self, fqdn: &str) -> Option<IpAddr>

Look up the first A record for an absolute name directly against this handle’s in-memory authority, without any UDP roundtrip.

fqdn is treated as an absolute name (a trailing dot is optional). The name MUST already be fully qualified within the server’s zone — this does NOT apply resolv.conf-style search expansion. Returns the first A record’s address, or None when no matching A record exists.

Intended for in-process callers and tests that need deterministic resolution against the authority (the UDP DnsClient uses a blocking sync client that can deadlock a current-thread tokio runtime).

Trait Implementations

impl Clone for DnsHandle

fn clone(&self) -> DnsHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.