Trait service_manager::ServiceManager

pub trait ServiceManager {
    fn available(&self) -> Result<bool>;
    fn install(&self, ctx: ServiceInstallCtx) -> Result<()>;
    fn uninstall(&self, ctx: ServiceUninstallCtx) -> Result<()>;
    fn start(&self, ctx: ServiceStartCtx) -> Result<()>;
    fn stop(&self, ctx: ServiceStopCtx) -> Result<()>;
    fn level(&self) -> ServiceLevel;
    fn set_level(&mut self, level: ServiceLevel) -> Result<()>;
}

Interface for a service manager

Required Methods

fn available(&self) -> Result<bool>

Determines if the service manager exists (e.g. is launchd available on the system?) and can be used

fn install(&self, ctx: ServiceInstallCtx) -> Result<()>

Installs a new service using the manager

fn uninstall(&self, ctx: ServiceUninstallCtx) -> Result<()>

Uninstalls an existing service using the manager

fn start(&self, ctx: ServiceStartCtx) -> Result<()>

Starts a service using the manager

fn stop(&self, ctx: ServiceStopCtx) -> Result<()>

Stops a running service using the manager

fn level(&self) -> ServiceLevel

Returns the current target level for the manager

fn set_level(&mut self, level: ServiceLevel) -> Result<()>

Sets the target level for the manager

Implementations

impl dyn ServiceManager

pub fn target_or_native(
    kind: impl Into<Option<ServiceManagerKind>>
) -> Result<Box<dyn ServiceManager>>

Creates a new service using the specified type, falling back to selecting based on native service manager for the current operating system if no type provided

pub fn target(kind: ServiceManagerKind) -> Box<dyn ServiceManager>

Creates a new service manager targeting the specific service manager kind using the default service manager instance

pub fn native() -> Result<Box<dyn ServiceManager>>

Attempts to select a native service manager for the current operating system

• For MacOS, this will use LaunchdServiceManager
• For Windows, this will use ScServiceManager
• For BSD variants, this will use RcdServiceManager
• For Linux variants, this will use either SystemdServiceManager or OpenRcServiceManager

Trait Implementations

impl<'a, S> From<S> for Box<dyn ServiceManager + 'a> where
    S: ServiceManager + 'a, 

fn from(service_manager: S) -> Self

Converts to this type from the input type.

Implementors

impl ServiceManager for TypedServiceManager

impl ServiceManager for LaunchdServiceManager

impl ServiceManager for OpenRcServiceManager

impl ServiceManager for RcdServiceManager

impl ServiceManager for ScServiceManager

impl ServiceManager for SystemdServiceManager