Struct PidFile 

pub struct PidFile { /* private fields */ }

RAII handle for a pidfile we currently own. Releases on Drop.

Dropping removes the file only if its contents still match our pid — so a second daemon that stole the lock (e.g. after we crashed) doesn’t get its pidfile deleted out from under it when we eventually unwind.

Implementations

impl PidFile

pub fn acquire(path: impl Into<PathBuf>) -> Result<Self, LockError>

Try to take the pidfile at path. On success, our pid is written to disk and held until drop.

If a previous pidfile exists and that pid is still alive, Err(LockError::HeldBy) is returned and the file is left untouched. A stale pidfile (dead pid) is silently replaced.

pub fn path(&self) -> &Path

pub fn pid(&self) -> u32

pub fn release(self) -> Result<()>

Explicitly release the pidfile now. Equivalent to letting it drop, except the caller can observe the io error instead of swallowing it.

Trait Implementations

impl Debug for PidFile

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

Formats the value using the given formatter.

impl Drop for PidFile

fn drop(&mut self)

Executes the destructor for this type.