Enum SshCliError 

pub enum SshCliError {
    Io(Error),
    Json(Error),
    TomlDe(Error),
    TomlSer(Error),
    SshConnection(String),
    SshAuthentication(String),
    ConnectionFailed(String),
    AuthenticationFailed,
    HostKeyChanged {
        host: String,
        port: u16,
        expected: String,
        obtained: String,
    },
    CommandTooLong {
        max: usize,
        len: usize,
    },
    SudoDisabled,
    SuPasswordMissing,
    ChannelFailed(String),
    SshTimeout(u64),
    CommandFailed {
        exit_code: i32,
        stderr: String,
    },
    VpsNotFound(String),
    NoActiveVps,
    VpsDuplicate(String),
    FileNotFound(String),
    InvalidArgument(String),
    Timeout(u64),
    XdgDirectory,
    SchemaIncompatible {
        expected: u32,
        found: u32,
    },
    Generic(String),
}

Domain errors produced by ssh-cli operations.

Variants

Io(Error)

Underlying I/O error.

Json(Error)

JSON serialization or deserialization error.

TomlDe(Error)

TOML deserialization error.

TomlSer(Error)

TOML serialization error.

SshConnection(String)

SSH connection-layer error.

SshAuthentication(String)

SSH authentication error with detail.

ConnectionFailed(String)

TCP/SSH connection failed before authentication.

AuthenticationFailed

SSH authentication rejected by the server.

HostKeyChanged

Host key diverged from known_hosts (possible MITM).

Fields

host: String

Host name.

port: u16

Port.

expected: String

Expected fingerprint.

obtained: String

Observed fingerprint.

CommandTooLong

Command exceeds max_command_chars.

Fields

max: usize

Configured limit.

len: usize

Command length.

SudoDisabled

Elevation disabled (disable_sudo).

SuPasswordMissing

Missing su password for su-exec.

ChannelFailed(String)

Failed to open or operate an SSH channel.

SshTimeout(u64)

SSH operation timed out.

CommandFailed

Remote command exited non-zero.

Fields

exit_code: i32

Remote process exit code.

stderr: String

Truncated stderr snippet.

VpsNotFound(String)

VPS name not found in the registry.

NoActiveVps

No active VPS (active sibling file missing) — GAP-SSH-EXIT-002.

VpsDuplicate(String)

Duplicate VPS name in the registry.

FileNotFound(String)

Local or remote file not found.

InvalidArgument(String)

Invalid CLI argument.

Timeout(u64)

Generic timeout.

XdgDirectory

XDG config directory unavailable.

SchemaIncompatible

Incompatible schema version.

Fields

expected: u32

Expected schema version.

found: u32

Found schema version.

Generic(String)

Uncategorized error.

Implementations

impl SshCliError

pub fn exit_code(&self) -> i32

Returns the sysexits.h exit code for this error.

Trait Implementations

impl Debug for SshCliError

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

Formats the value using the given formatter.

impl Display for SshCliError

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

Formats the value using the given formatter.

impl Error for SshCliError

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SshCliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SshCliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SshCliError

fn from(source: Error) -> Self

Converts to this type from the input type.