Enum ServiceState 

pub enum ServiceState {
    Inactive,
    Blocked {
        waiting_on: Vec<String>,
    },
    Starting {
        pid: u32,
    },
    Running {
        pid: u32,
    },
    Stopping {
        pid: u32,
    },
    Exited {
        exit_code: Option<i32>,
    },
    Failed {
        reason: FailureReason,
    },
}

The state of a service in the supervisor.

Variants

Inactive

Service has never been started.

Blocked

Service is waiting on dependencies.

Fields

waiting_on: Vec<String>

Starting

Process has been spawned, waiting for health check or startup.

Fields

pid: u32

Running

Process is running and healthy.

Fields

pid: u32

Stopping

SIGTERM sent, waiting for process to exit.

Fields

pid: u32

Exited

Process exited cleanly.

Fields

exit_code: Option<i32>

Failed

Process failed.

Fields

reason: FailureReason

Implementations

impl ServiceState

pub fn name(&self) -> &'static str

Returns the state name as a string.

pub fn symbol(&self) -> &'static str

Returns a symbol representing the state for display.

pub fn pid(&self) -> Option<u32>

Returns the PID if the service has a running process.

pub fn is_active(&self) -> bool

Returns true if the service has an active process.

pub fn is_satisfied(&self) -> bool

Returns true if the service can satisfy a “requires” dependency. A service satisfies requires if it’s Running OR exited successfully (exit code 0). This allows oneshot services to satisfy dependencies after they complete.

pub fn can_attempt_start(&self) -> bool

Returns true if the service is in a state where start can be attempted. Note: Services that failed due to MissingDependency cannot be restarted because the dependency will never appear - it’s a permanent config error.

Trait Implementations

impl Clone for ServiceState

fn clone(&self) -> ServiceState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceState

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

Formats the value using the given formatter.

impl Default for ServiceState

fn default() -> ServiceState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServiceState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ServiceState

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

Formats the value using the given formatter.

impl From<&ServiceState> for PersistedServiceState

fn from(state: &ServiceState) -> Self

Converts to this type from the input type.

impl From<&ServiceState> for State

fn from(state: &ServiceState) -> Self

Converts to this type from the input type.

impl PartialEq for ServiceState

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ServiceState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ServiceState

impl StructuralPartialEq for ServiceState