Struct InstanceLock 

pub struct InstanceLock { /* private fields */ }

A guard that holds the singleton instance lock

The lock is automatically released when this struct is dropped. The PID file is removed on drop to allow other instances to start.

Implementations

impl InstanceLock

pub fn acquire(pid_path: PathBuf) -> Result<Self, SingletonError>

Attempt to acquire the singleton lock

Returns

• Ok(InstanceLock) if the lock was successfully acquired
• Err(SingletonError::AlreadyRunning(pid)) if another instance is running
• Err(SingletonError::*) for other errors

Stale Lock Detection

If a PID file exists but the process is no longer running, the stale file is automatically cleaned up before acquiring the lock.

pub fn release(self)

Explicitly release the lock

This is called automatically on drop, but can be called explicitly if you want to release the lock early.

pub fn pid_path(&self) -> &PathBuf

Get the path to the PID file

Trait Implementations

impl Drop for InstanceLock

fn drop(&mut self)

Executes the destructor for this type.