Struct FileLock 

pub struct FileLock { /* private fields */ }

File lock manager for spec directories

Implementations

impl FileLock

pub fn acquire( spec_id: &str, force: bool, ttl_seconds: Option<u64>, ) -> Result<Self, LockError>

Attempt to acquire an exclusive lock for the given spec ID

Uses atomic O_EXCL/create_new semantics to prevent TOCTOU race conditions. If the lock file already exists, validates the existing lock before deciding whether to override it.

Arguments

• spec_id - The spec ID to lock
• force - Whether to override stale locks
• ttl_seconds - Time-to-live for lock staleness detection (None uses default)

Returns

• Ok(FileLock) - Successfully acquired lock
• Err(LockError) - Failed to acquire lock (concurrent execution, stale lock, etc.)

pub fn exists(spec_id: &str) -> bool

Check if a lock exists for the given spec ID

pub fn get_lock_info(spec_id: &str) -> Result<Option<LockInfo>, LockError>

Get information about an existing lock (if any)

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

Release the lock (called automatically on drop)

pub fn spec_id(&self) -> &str

Get the spec ID for this lock

pub const fn lock_info(&self) -> &LockInfo

Get the lock information

Trait Implementations

impl Debug for FileLock

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

Formats the value using the given formatter.

impl Drop for FileLock

fn drop(&mut self)

Automatically release the lock when the FileLock is dropped