Enum StopOutcome 

pub enum StopOutcome {
    Stopped {
        record: PidRecord,
        fate: Result<NoteFate, String>,
        waited: Duration,
        pid_file_reconciled: Result<bool, String>,
    },
    AlreadyGone {
        record: PidRecord,
        fate: Result<NoteFate, String>,
        pid_file_reconciled: Result<bool, String>,
    },
    StillDraining {
        record: PidRecord,
        waited: Duration,
    },
}

How the stop ended when it was allowed to act.

Variants

Stopped

The server was signalled and exited within the patience window. The death note’s account of the exit rides along.

Fields

record: PidRecord

The incarnation that was stopped.

fate: Result<NoteFate, String>

What the death note records for it (the drain outcome lives here; its absence is a state, not an error), or why the note could not be read — a bookkeeping failure beside a server that is PROVEN exited, carried as its own fact, never allowed to destroy this outcome (see [exit_bookkeeping]).

waited: Duration

How long the wait took.

pid_file_reconciled: Result<bool, String>

Whether a pid file the dying server left behind was reconciled away (a clean exit removes its own; a forced one cannot), or why reconciliation failed — Err means the file may still name the dead pid and wants a manual look.

AlreadyGone

The recorded process was already gone: nothing to signal. The file is reconciled away and the note consulted for what happened.

Fields

record: PidRecord

The incarnation the file named.

fate: Result<NoteFate, String>

The death note’s account — ArmedNotDisarmed with no record here is the kill -9 shape, reported as exactly that — or why the note could not be read (carried, never propagated: the goal state already holds).

pid_file_reconciled: Result<bool, String>

Whether the stale file was removed, or why removing it failed.

StillDraining

The server is still draining when the patience elapsed. Not a failure and not a guess: the server owns its drain, and a second stop is the operator’s escalation (the server treats a second termination signal as “force immediate exit”).

Fields

record: PidRecord

The incarnation still running.

waited: Duration

How long the verb waited before reporting.

Trait Implementations

impl Clone for StopOutcome

fn clone(&self) -> StopOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StopOutcome

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

Formats the value using the given formatter.