Enum StopRefusal 

pub enum StopRefusal {
    NoPidFile {
        path: PathBuf,
    },
    StaleIncarnation {
        pid: u32,
        recorded_started_at: u64,
        live_started_at: u64,
        live_exe: String,
        path: PathBuf,
    },
    UnresolvedPatience {
        pid: u32,
        unresolved: String,
    },
    UnsupportedPlatform,
    SignalFailed {
        pid: u32,
        message: String,
    },
}

Why the stop refused to act. Each face is distinct and names its remedy.

Variants

NoPidFile

No pid file exists under the home: no server has claimed it (or the running server predates the pid-file era).

Fields

path: PathBuf

The path that held no file.

StaleIncarnation

The file names a live pid whose start instant is not the recorded one: the pid was recycled. Nothing is signalled.

Fields

pid: u32

The recycled pid.

recorded_started_at: u64

Start instant the file records.

live_started_at: u64

Start instant the live process wears.

live_exe: String

Rendered (running <exe>) fragment when the table knows it.

path: PathBuf

The pid file’s path, named for the operator’s own reconciliation.

UnresolvedPatience

The server is verified RUNNING but no wait patience could be resolved to govern the stop — no --patience, no usable recorded drain window, and the configuration could not answer. Nothing is signalled: signalling without a governed wait would leave the verb unable to report what became of the drain.

Fields

pid: u32

The verified-running pid that was NOT signalled.

unresolved: String

Why patience resolution failed — the configuration’s own bare account; this template supplies the sentence around it.

UnsupportedPlatform

This build cannot send POSIX signals.

SignalFailed

The signal could not be sent to a verified-live process.

Fields

pid: u32

The verified pid the signal was aimed at.

message: String

The OS error.

Trait Implementations

impl Clone for StopRefusal

fn clone(&self) -> StopRefusal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StopRefusal

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

Formats the value using the given formatter.

impl Display for StopRefusal

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

Formats the value using the given formatter.

impl Error for StopRefusal

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.