Enum SocketTransportError 

pub enum SocketTransportError {
    CreateParentDirectory {
        path: PathBuf,
        source: Error,
    },
    RefuseNonSocketPath {
        path: PathBuf,
    },
    ActiveSocketExists {
        path: PathBuf,
    },
    ProbeExistingSocket {
        path: PathBuf,
        source: Error,
    },
    RemoveStaleSocket {
        path: PathBuf,
        source: Error,
    },
    Bind {
        path: PathBuf,
        source: Error,
    },
    BoundSocketMetadata {
        path: PathBuf,
        source: Error,
    },
    Accept {
        source: Error,
    },
    Connect {
        path: PathBuf,
        source: Error,
    },
    Clone {
        source: Error,
    },
    SpawnReader {
        source: Error,
    },
    Encode {
        source: EncodeError,
    },
    Flush {
        source: Error,
    },
    Decode {
        source: DecodeError,
    },
}

Errors returned by the Unix socket transport.

Variants

CreateParentDirectory

Creating the parent directory for a socket path failed.

Fields

path: PathBuf

Directory that could not be created.

source: Error

Underlying filesystem error.

RefuseNonSocketPath

A pre-existing non-socket path blocked binding the listener.

Fields

path: PathBuf

Path that already existed but was not a Unix socket.

ActiveSocketExists

A pre-existing Unix socket accepted connections and was treated as live.

Fields

path: PathBuf

Socket path that appears to already have a listener.

ProbeExistingSocket

A pre-existing Unix socket could not be proven inactive.

Fields

path: PathBuf

Socket path whose liveness probe failed.

source: Error

Underlying probe error.

RemoveStaleSocket

Removing an inactive stale Unix socket path failed.

Fields

path: PathBuf

Stale socket path that could not be removed.

source: Error

Underlying filesystem error.

Bind

Binding the Unix listener failed.

Fields

path: PathBuf

Socket path that could not be bound.

source: Error

Underlying bind error.

BoundSocketMetadata

Reading metadata for the bound socket path failed.

Fields

path: PathBuf

Socket path whose metadata could not be read after bind.

source: Error

Underlying filesystem error.

Accept

Accepting an attached Unix socket client failed.

Fields

source: Error

Underlying accept error.

Connect

Connecting to a listener failed.

Fields

path: PathBuf

Socket path that could not be connected.

source: Error

Underlying connect error.

Clone

Cloning a Unix stream failed.

Fields

source: Error

Underlying stream clone error.

SpawnReader

Spawning the bounded background socket reader failed.

Fields

source: Error

Underlying thread admission error.

Encode

Encoding a protocol message failed.

Fields

source: EncodeError

Underlying protocol encode error.

Flush

Flushing a protocol message failed.

Fields

source: Error

Underlying writer flush error.

Decode

Decoding a protocol message failed.

Fields

source: DecodeError

Underlying protocol decode error.

Trait Implementations

impl Debug for SocketTransportError

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

Formats the value using the given formatter.

impl Display for SocketTransportError

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

Formats the value using the given formatter.

impl Error for SocketTransportError

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.