Enum ConnectionFailureKind 

pub enum ConnectionFailureKind {
    Timeout,
    Refused,
    Auth,
    Dns,
    Transport,
    Unknown,
}

Classifies the type of failure that occurred during a connection attempt.

This enum categorizes connection failures into distinct types, allowing for more targeted error handling, retry logic, and diagnostic reporting. Each variant represents a different category of connection failure that may require different handling strategies.

Variants

• Timeout - The connection attempt exceeded the configured timeout period. This typically indicates network latency issues, an unresponsive host, or firewall rules blocking the connection.

• Refused - The connection was actively refused by the remote host. This usually means the host is reachable but the service is not running or is not accepting connections on the specified port.

• Auth - Authentication failed during the connection attempt. This indicates that the credentials provided were invalid, expired, or insufficient for establishing the connection.

• Dns - DNS resolution failed for the hostname. This means the hostname could not be resolved to an IP address, possibly due to DNS server issues or an invalid hostname.

• Transport - A transport-layer error occurred during the connection attempt. This includes network unreachable errors, connection reset by peer, and other low-level network failures.

• Unknown - The failure type could not be determined or does not fit into any of the other categories. This is used as a fallback for unexpected or unclassified errors.

Examples

// Create different failure kinds
let timeout = ConnectionFailureKind::Timeout;
let auth = ConnectionFailureKind::Auth;
let dns = ConnectionFailureKind::Dns;

// Use in connection status
let failed_status = ConnectionStatus::Failed(ConnectionFailureKind::Timeout);
assert!(matches!(failed_status, ConnectionStatus::Failed(_)));

Variants

Timeout

Refused

Auth

Dns

Transport

Unknown

Trait Implementations

impl Clone for ConnectionFailureKind

fn clone(&self) -> ConnectionFailureKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectionFailureKind

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

Formats the value using the given formatter.

impl Eq for ConnectionFailureKind

impl PartialEq for ConnectionFailureKind

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ConnectionFailureKind