Enum ReadFailureKind 

pub enum ReadFailureKind {
    Spawn,
    Auth,
    Trust,
    Network,
    Subsystem,
    Connect,
    NotFound,
    Permission,
    Protocol,
    Io,
    NotRegularFile,
    UnknownLength,
    TooLarge,
    ShortRead,
    InvalidUtf8,
    Cancelled,
    Stopped,
    NotConnected,
    QueueFull,
    NotDirectory,
    TooManyEntries,
    HomeUnsupported,
    Deadline,
}

What went wrong, classified far enough to act on. Auth, trust and install problems carry hints; the rest are honest transport facts.

Variants

Spawn

The local ssh(1) executable could not be started.

Auth

Noninteractive authentication failed (BatchMode refuses prompts).

Trust

Host key unknown or changed; trust is refused, never auto-accepted.

Network

Network-level failure: DNS, routing, refusal, reset.

Subsystem

The remote host does not offer the sftp subsystem.

Connect

Session establishment failed without a finer classification.

NotFound

The remote path does not exist.

Permission

The server denied access to the path.

Protocol

The SFTP protocol exchange failed.

Io

Local pipe/transport I/O failure.

NotRegularFile

The opened handle is not proven to be a regular file.

UnknownLength

The server reported no length for the opened handle.

TooLarge

The snapshot exceeds the in-memory cap.

ShortRead

Fewer bytes than the captured length arrived.

InvalidUtf8

The snapshot is not valid UTF-8.

Cancelled

The read was cancelled by its owner.

Stopped

The pooled session was stopped: explicit disconnect, or its last lease went away.

NotConnected

No authenticated session exists for the endpoint, and the caller refused to create one.

QueueFull

The bounded session admission queue has no free slot.

NotDirectory

The path is not a directory where one is required.

TooManyEntries

The directory exceeds the bounded listing cap.

HomeUnsupported

The server does not advertise expand-path@openssh.com, so a home query cannot be resolved. REALPATH is never guessed as a substitute.

Deadline

The total connection/read/close deadline elapsed.

Trait Implementations

impl Clone for ReadFailureKind

fn clone(&self) -> ReadFailureKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReadFailureKind

impl Debug for ReadFailureKind

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

Formats the value using the given formatter.

impl Display for ReadFailureKind

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

Formats the value using the given formatter.

impl Eq for ReadFailureKind

impl Hash for ReadFailureKind

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

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 ReadFailureKind

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReadFailureKind