Enum Error 

#[non_exhaustive]
pub enum Error {
    Transport {
        server: String,
        source: Box<dyn Error + Send + Sync>,
    },
    Decode {
        server: String,
        source: Error,
    },
    Status {
        server: String,
        status: u16,
        target: String,
    },
    Refused {
        server: String,
        reason: String,
    },
    TooLarge {
        server: String,
        limit: usize,
    },
    NoServer {
        target: String,
    },
    NotPublic {
        target: String,
    },
    Dns {
        name: String,
        source: Box<dyn Error + Send + Sync>,
    },
    Validation(ValidationError),
}

A lookup that did not finish.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Transport

The request did not complete: DNS, TLS, connection or timeout.

Fields

server: String

The server the request went to.

source: Box<dyn Error + Send + Sync>

What the HTTP layer reported.

Decode

The body was not the RDAP this crate expects.

Fields

server: String

The server that answered.

source: Error

What the reader reported.

Status

The server answered, and the answer was not a record.

Fields

server: String

The server that answered.

status: u16

The HTTP status it sent.

target: String

What was asked about.

Refused

The client did not send the request, or did not follow a redirect.

A link in a record and a redirect from a server come from outside the process. The client refuses one that goes to an address that is not public, uses a scheme other than HTTP or HTTPS, drops from HTTPS to HTTP, or redirects too many times.

Fields

server: String

The URL the client did not request.

reason: String

Why.

TooLarge

The server sent a body longer than the crate reads.

A record is a few kilobytes. A body past the limit is a fault on the server, or a server that tries to use up the memory of the process.

Fields

server: String

The server that answered.

limit: usize

The most the crate reads, in bytes.

NoServer

No registry holds the address or the name.

The bootstrap registry names a server for every range IANA has given out. A target with no server is a private address, a reserved range, or a name under a top-level domain that runs no RDAP server.

Fields

target: String

What was asked about.

NotPublic

The address is not one the public registries describe.

A regional registry holds a record for the reserved block a private address sits in, and that record names IANA. Answering with it gives a contact that cannot act, so the lookup stops here instead.

Fields

target: String

The address that was asked about.

Dns

A DNS lookup did not finish.

A name that does not exist, or that holds no records of the type asked for, is an answer and not this error. This is a lookup that got no answer: a timeout, a server that failed, or a resolver configuration the system could not read.

Fields

name: String

The name that was looked up, or what was being read.

source: Box<dyn Error + Send + Sync>

What the resolver reported.

Validation(ValidationError)

A value did not satisfy a documented limit.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<ValidationError> for Error

fn from(source: ValidationError) -> Self

Converts to this type from the input type.