Enum SignalOutcome 

#[non_exhaustive]
pub enum SignalOutcome {
    Delivered,
    NotRunning,
    Failed {
        reason: String,
    },
}

What happened when the shepherd tried to deliver one signal.

#[non_exhaustive]: a future outcome — a sheep refused because it is a dog, say, or a delivery held while a stop ladder runs — must not need a protocol version bump (IR-20).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Delivered

The kernel accepted the signal for this sheep’s pid.

Says the signal was delivered, not that the app did anything with it. A signal the app blocks, ignores, or has no handler for is Delivered exactly like one it acts on — there is nothing on this path that could tell the difference, and pretending otherwise would be the dishonest half of an honest report.

NotRunning

The sheep is registered but has no live process to signal — stopped, errored, or waiting out a restart backoff.

Failed

The kernel refused the delivery; carries its reason (ESRCH for a process reaped between the lookup and the syscall, EPERM for one this daemon may not signal).

Fields

reason: String

The refusal, as the OS worded it.

Trait Implementations

impl Clone for SignalOutcome

fn clone(&self) -> SignalOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SignalOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SignalOutcome

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SignalOutcome

impl PartialEq for SignalOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SignalOutcome

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SignalOutcome