Enum Error 

pub enum Error {
    Spawn {
        program: String,
        source: Error,
    },
    CommandFailed {
        program: String,
        status: String,
        stderr: String,
    },
    Timeout {
        program: String,
        seconds: u64,
    },
    NoMachinePrincipal {
        keytab: PathBuf,
    },
    NoMachinePrincipalForRealm {
        realm: String,
        keytab: PathBuf,
    },
    KeytabUnreadable {
        keytab: PathBuf,
        source: Error,
    },
    KeytabMissing {
        keytab: PathBuf,
    },
    GroupNotFound(String),
    CacheStillInvalid(PathBuf),
    RefusingSharedDir(PathBuf),
    RefusingSymlink(PathBuf),
    Io(Error),
}

Errors produced by this crate.

Variants

Spawn

The program could not be spawned at all (missing binary, permissions…).

Fields

program: String

source: Error

CommandFailed

The program ran but exited non-zero.

Fields

program: String

status: String

stderr: String

Timeout

The program hung past the per-command cap and was killed. Typical cause: a half-up network where the KDC resolves but packets go nowhere, so kinit sits in its own retry cycle indefinitely.

Fields

program: String

seconds: u64

NoMachinePrincipal

The keytab holds no NAME$@REALM (machine sAMAccountName) entry.

Fields

keytab: PathBuf

NoMachinePrincipalForRealm

The keytab has machine principals, but none in the requested realm.

Fields

realm: String

keytab: PathBuf

KeytabUnreadable

The keytab exists but cannot be read — machine keytabs are root-only. (The io::Error is the source, not embedded here, so error chains don’t print it twice.)

Fields

keytab: PathBuf

source: Error

KeytabMissing

The keytab does not exist at all — most likely not AD-joined.

Fields

keytab: PathBuf

GroupNotFound(String)

The group to share the ticket cache with does not exist.

CacheStillInvalid(PathBuf)

Renew and mint both ran, yet the cache still fails klist -s.

RefusingSharedDir(PathBuf)

Refusing to take ownership of a shared system directory.

RefusingSymlink(PathBuf)

Refusing to operate through a symlink.

Io(Error)

Implementations

impl Error

pub fn is_transient(&self) -> bool

Whether retrying shortly might succeed (a network / KDC hiccup) versus a permanent setup or join problem that needs an operator to fix.

Setup errors (missing/unreadable keytab, no matching principal, missing group, refused path, missing tool) are permanent. A kinit/klist failure is classified from the KDC’s message: a stale/disabled/deleted machine account is permanent; unreachable-KDC / clock-skew / network is transient. Unknown states default to transient — a retry is cheap.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.