Enum SessionError 

pub enum SessionError {
    Io(Error),
    InsecurePermissions {
        path: PathBuf,
        mode: u32,
    },
    ForeignOwner {
        path: PathBuf,
    },
    UnsupportedVersion {
        path: PathBuf,
        found: u32,
        expected: u32,
    },
    Malformed {
        path: PathBuf,
        source: Error,
    },
    NoConfigDir,
    UnsupportedPlatform,
}

Error taxonomy for session-file operations. Surfaces enough context to the CLI dispatcher to choose the right exit code (see criterion G) without leaking the session contents.

Variants

Io(Error)

Filesystem-level failure (read, write, permissions metadata).

InsecurePermissions

File mode is wider than 0o600 (§5.3 enforcement).

Fields

path: PathBuf

Path to the session file.

mode: u32

Actual mode bits (lower 9 bits).

ForeignOwner

File exists but is owned by a UID other than the current effective UID (§5.3 enforcement).

Fields

path: PathBuf

Path to the session file.

UnsupportedVersion

Session file’s version field doesn’t match the current schema; operator must re-run cairn login to produce a file the current binary understands.

Fields

path: PathBuf

Path to the session file.

found: u32

Version found on disk.

expected: u32

Version this binary expects.

Malformed

JSON parse failure on the session file body.

Fields

path: PathBuf

Path to the session file.

source: Error

Underlying serde_json error.

NoConfigDir

dirs::config_dir() returned None and no CAIRN_SESSION_FILE env override was set.

UnsupportedPlatform

Non-Unix platform (§5.3 invariants require POSIX semantics).

Trait Implementations

impl Debug for SessionError

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

Formats the value using the given formatter.

impl Display for SessionError

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

Formats the value using the given formatter.

impl Error for SessionError

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<CredentialFileError> for SessionError

fn from(e: CredentialFileError) -> Self

Converts to this type from the input type.

impl From<Error> for SessionError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<SessionError> for CliError

fn from(source: SessionError) -> Self

Converts to this type from the input type.