Enum ConnectionErrorDomain 

#[non_exhaustive]
pub enum ConnectionErrorDomain {
    Transport,
    Application,
    Local,
    Unknown,
}

Available on crate feature net only.

The architectural domain in which establishing a client connection failed.

Domains describe the role a protocol or component plays in a connector stack rather than assigning protocols to fixed OSI layers. For example, TLS to a proxy is part of Transport, while TLS to the origin is part of Application.

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

Establishing the usable transport path selected for the connection.

This is the route-dependent domain. A route planner can generally use it as the signal that trying the next route may produce a different outcome.

Application

Establishing the end-to-end connection over the selected transport path.

This is not limited to a strict OSI application-layer protocol. It also includes protocols and handshakes between the transport path and the final application protocol, such as TLS to the origin. Which domain a protocol belongs to depends on its role: TLS to a proxy is transport establishment, while TLS to the origin is end-to-end application establishment. A different transport route should not normally be tried for these failures because the selected route was already usable.

Local

Client-local connection acquisition or orchestration failed.

These failures originate in the connector stack itself rather than in a remote route or application peer. Examples include invalid local configuration or input, connection-pool bookkeeping failures, exhaustion of a local resource, and cancellation of the overall connection attempt. These failures are not specific to a selected route.

Unknown

The failure has not been classified. Consumers should not assume that trying another route is safe merely because the domain is unknown.

Trait Implementations

impl Clone for ConnectionErrorDomain

fn clone(&self) -> ConnectionErrorDomain

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ConnectionErrorDomain

impl Debug for ConnectionErrorDomain

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

Formats the value using the given formatter.

impl Display for ConnectionErrorDomain

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

Formats the value using the given formatter.

impl Eq for ConnectionErrorDomain

impl Hash for ConnectionErrorDomain

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ConnectionErrorDomain

fn eq(&self, other: &ConnectionErrorDomain) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ConnectionErrorDomain