Enum ShutdownRequest 

pub enum ShutdownRequest {
    Requested,
    Signalled,
}

Why a shutdown was asked for.

The distinction is the whole point. Cleanup failing used to refuse the shutdown whatever asked for it, and that is right for one of these two and catastrophic for the other: a daemon whose cleanup can never succeed — because its state directory has been deleted out from under it, which is what happens to a parity gate’s temp fixture — becomes immortal. Four of them were found alive on this machine, up to ten days old, ignoring SIGTERM and holding a listening socket on a directory that no longer existed.

Variants

Requested

POST /api/daemon/shutdown. A caller asked and is waiting for an answer, so a cleanup failure is worth reporting and worth staying up for — the next request reaches a daemon that knows it has processes it could not account for.

Signalled

SIGTERM, SIGINT, or the future handed to serve_until.

Not a request that may be declined. Cleanup is still attempted and its failure still reported, but the process exits either way: a service this daemon could not stop is a leaked service, while refusing to exit leaks the service and the daemon, forever, with nothing left that can ask it again.

Trait Implementations

impl Clone for ShutdownRequest

fn clone(&self) -> ShutdownRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ShutdownRequest

impl Debug for ShutdownRequest

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

Formats the value using the given formatter.

impl Eq for ShutdownRequest

impl PartialEq for ShutdownRequest

fn eq(&self, other: &ShutdownRequest) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ShutdownRequest