Struct PidGuard 

pub struct PidGuard(/* private fields */);

Exclusive, flock(2)-backed guard on the daemon’s pid file.

Replaces the previous check-then-act sequence (read pid file, check liveness, remove if stale, then write) with a single atomic lock acquisition: only one process can ever hold the advisory lock on the pid file, so a second concurrent --daemon invocation fails immediately with DaemonError::AlreadyRunning instead of racing the first to write the file. Dropping the guard unlinks the pid file and releases the lock.

Examples

use zeph_core::daemon::PidGuard;

let guard = PidGuard::acquire("/tmp/zeph-daemon.pid").expect("no other instance running");
// ... run the daemon ...
drop(guard); // releases the lock and removes the pid file

Implementations

impl PidGuard

pub fn acquire(path: &str) -> Result<Self, DaemonError>

Acquire an exclusive lock on the pid file at path, creating it if necessary, and write the current process id into it.

Errors

Returns DaemonError::AlreadyRunning if another process already holds the lock, or DaemonError::PidFile for filesystem failures.

Trait Implementations

impl Debug for PidGuard

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

Formats the value using the given formatter.