Struct TransientUnitHandle 

pub struct TransientUnitHandle { /* private fields */ }

Holds a reference on the unit (AddRef=true), so systemd keeps it loaded after it exits. Release it with release or by dropping the handle; until then, starting a unit of the same name fails with UnitStillLoaded.

Implementations

impl TransientUnitHandle

pub async fn stop(&self) -> Result<UnitExit, SystemdTransientError>

Stops the unit and returns the state it ended in. If the unit had already exited, nothing is stopped and that earlier state is returned. If someone else started the unit again since, it is left running and UnitRestarted is returned, unless this run’s exit was already seen.

The handle’s reference keeps the name from being reused, but the unit itself can be started again (systemctl start). The invocation ID check keeps this call from stopping that later run. A restart between the check and StopUnit is not caught.

pub fn name(&self) -> &str

pub async fn wait_for_exit(&self) -> Result<UnitExit, SystemdTransientError>

Resolves once the unit has exited, even if that happened before this call. Several tasks may wait at once, also while another one calls stop.

pub async fn release(self) -> Result<(), SystemdTransientError>

Drops the reference on the unit, so systemd can collect it once it is inactive. Does not stop the unit.

Trait Implementations

impl Debug for TransientUnitHandle

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

Formats the value using the given formatter.

impl Drop for TransientUnitHandle

fn drop(&mut self)

Releases the reference in a background task. Without a Tokio runtime the reference lasts until the bus connection closes.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.