Struct Lock 

pub struct Lock { /* private fields */ }

An acquired single-instance lock.

The lock is released when this value is dropped (closing the file descriptor releases the OS-level lock). The lock file itself is not deleted on drop — leaving stale lock files on disk after a crash is normal and harmless because the lock is held by the open fd, not by the file’s mere existence.

Implementations

impl Lock

pub fn acquire(path: impl AsRef<Path>) -> Result<Self, LockError>

Acquire the single-instance lock at path.

The function:

1. Calls symlink_metadata and refuses if the path is a symlink (F-2).
2. Opens the file with O_NOFOLLOW semantics (via fresh metadata check then create-or-open).
3. Calls try_lock_exclusive. If another process holds the lock, returns LockError::AlreadyHeld.

pub fn path(&self) -> &Path

Path of the lock file (for diagnostics and tests).

Trait Implementations

impl Debug for Lock

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

Formats the value using the given formatter.