Enum Error 

#[non_exhaustive]
pub enum Error {
    Transport(Error),
    Build(BuildError),
    NoResponse,
    CredentialsRequired,
    AuthenticationFailed,
    FlowRebound {
        previous: SocketAddr,
        current: SocketAddr,
    },
    TooManyFlows,
    PushNotSupported {
        reason: String,
    },
    Rejected {
        status: u16,
        reason: String,
    },
}

What can go wrong in the user agent.

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(Error)

The transport failed.

Build(BuildError)

A message could not be built.

NoResponse

The transaction ended without a final response — a timeout or a transport failure.

CredentialsRequired

The server challenged and no credentials were configured.

AuthenticationFailed

The server challenged again after credentials were supplied, and did not say the nonce was stale. Retrying would be guessing at a password.

FlowRebound

The flow’s reflexive address changed, so the flow has failed (RFC 5626 §4.4.2).

Not a transport error: the socket works. The NAT rebound, so the mapping the registrar holds for this flow no longer reaches it, and §4.4.2 requires the UA to treat that as a failure and re-establish rather than carry on pinging an address nothing routes to.

Fields

previous: SocketAddr

The address the previous keep-alive reported.

current: SocketAddr

The address this one did.

TooManyFlows

More flows were added than reg-id can number (RFC 5626 §4.2 caps it at 2^31 - 1).

PushNotSupported

The registrar answered 555: it does not support the push notification service the Contact named (RFC 8599 §8.1).

Distinct from Error::Rejected because retrying cannot help. Every attempt naming this push service will be refused the same way, and a client that treats it as a transient failure stays unreachable while looking busy.

Fields

reason: String

The reason phrase the registrar sent.

Rejected

The server refused.

Fields

status: u16

The status code.

reason: String

Its reason phrase.

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

fn from(source: BuildError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.