Enum RecordError 

pub enum RecordError {
    RecordNotFound {
        name: String,
        zone: String,
        server: String,
    },
    RecordUpdateFailed {
        name: String,
        zone: String,
        server: String,
        reason: String,
    },
    RecordDeletionFailed {
        name: String,
        zone: String,
        server: String,
        reason: String,
    },
    InvalidRecordData {
        name: String,
        zone: String,
        reason: String,
    },
}

Errors that can occur during DNS record operations via Hickory DNS client.

These errors represent failures when performing dynamic DNS updates (nsupdate) or querying DNS records using the Hickory DNS client library.

Variants

RecordNotFound

DNS record not found when querying the primary server (NXDOMAIN or no records)

Returned when querying for a DNS record that doesn’t exist in the zone. This is typically returned as an NXDOMAIN response or an empty answer section.

Fields

name: String

The record name (e.g., “www”, “@”)

zone: String

The zone name (e.g., “example.com”)

server: String

The DNS server that was queried

RecordUpdateFailed

Failed to add or update a DNS record via dynamic update

Returned when a dynamic DNS update (nsupdate) fails. This could be due to TSIG authentication failure, zone not allowing updates, or invalid record data.

Fields

name: String

The record name being updated

zone: String

The zone containing the record

server: String

The DNS server where the update failed

reason: String

Specific reason for the failure

RecordDeletionFailed

Failed to delete a DNS record via dynamic update

Returned when attempting to delete a DNS record via nsupdate fails.

Fields

name: String

The record name being deleted

zone: String

The zone containing the record

server: String

The DNS server where deletion failed

reason: String

Specific reason for the failure

InvalidRecordData

Invalid record data (malformed IP, invalid FQDN, etc.)

Returned when record data fails validation before attempting to create/update. This includes invalid IP addresses, malformed FQDNs, or out-of-range TTL values.

Fields

name: String

The record name with invalid data

zone: String

The zone containing the record

reason: String

Explanation of what is invalid

Trait Implementations

impl Clone for RecordError

fn clone(&self) -> RecordError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecordError

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

Formats the value using the given formatter.

impl Display for RecordError

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

Formats the value using the given formatter.

impl Error for RecordError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<RecordError> for DnsError

fn from(source: RecordError) -> Self

Converts to this type from the input type.