Struct ProtoError

#[non_exhaustive]
pub struct ProtoError {
    pub kind: Box<ProtoErrorKind>,
    pub backtrack: Option<ExtBacktrace>,
}

The error type for errors that get returned in the crate

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

kind: Box<ProtoErrorKind>

Kind of error that ocurred

backtrack: Option<ExtBacktrace>

Available on crate feature backtrace only.

Backtrace to the source of the error

Implementations

impl ProtoError

pub fn nx_error( query: Box<Query>, soa: Option<Box<Record<SOA>>>, ns: Option<Arc<[ForwardNSData]>>, negative_ttl: Option<u32>, response_code: ResponseCode, trusted: bool, authorities: Option<Arc<[Record]>>, ) -> Self

Constructor to NX type errors

pub fn kind(&self) -> &ProtoErrorKind

Get the kind of the error

pub fn is_busy(&self) -> bool

If this is a ProtoErrorKind::Busy

pub fn is_no_connections(&self) -> bool

Returns true if this error represents NoConnections

pub fn is_nx_domain(&self) -> bool

Returns true if the domain does not exist

pub fn is_no_records_found(&self) -> bool

Returns true if the error represents NoRecordsFound

pub fn into_soa(self) -> Option<Box<Record<SOA>>>

Returns the SOA record, if the error contains one

pub fn is_io(&self) -> bool

Returns true if this is a std::io::Error

pub fn from_response( response: DnsResponse, trust_nx: bool, ) -> Result<DnsResponse, Self>

A conversion to determine if the response is an error

pub fn cmp_specificity(&self, other: &Self) -> Ordering

Compare two errors to see if one contains a server response.

Trait Implementations

impl Clone for ProtoError

fn clone(&self) -> ProtoError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ProtoError

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

Formats the value using the given formatter.

impl Display for ProtoError

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

Formats the value using the given formatter.

impl Error for ProtoError

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<&'static str> for ProtoError

fn from(msg: &'static str) -> Self

Converts to this type from the input type.

impl From<DecodeError> for ProtoError

fn from(err: DecodeError) -> Self

Converts to this type from the input type.

impl<E> From<E> for ProtoError

where E: Into<ProtoErrorKind>,

fn from(error: E) -> Self

Converts to this type from the input type.

impl<T> From<PoisonError<T>> for ProtoError

fn from(_e: PoisonError<T>) -> Self

Converts to this type from the input type.

impl From<ProtoError> for DnsResponseStream

fn from(e: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for DnsSecError

Available on crate feature dnssec only.

fn from(e: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for DnsSecErrorKind

fn from(source: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for Error

fn from(e: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for Error

Available on crate features dns-over-https-rustls or dns-over-h3 only.

fn from(msg: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for JsValue

Available on crate feature wasm-bindgen only.

fn from(e: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for ParseError

Available on crate feature text-parsing only.

fn from(e: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for ParseErrorKind

Available on crate feature text-parsing only.

fn from(source: ProtoError) -> Self

Converts to this type from the input type.

impl From<ProtoError> for String

fn from(e: ProtoError) -> Self

Converts to this type from the input type.

impl From<String> for ProtoError

fn from(msg: String) -> Self

Converts to this type from the input type.

impl RetryableError for ProtoError

fn should_retry(&self) -> bool

Whether the query should be retried after this error

fn attempted(&self) -> bool

Whether this error should count as an attempt