Struct WorkspaceWriteLock 

pub struct WorkspaceWriteLock { /* private fields */ }

Exclusive write guard for one canonical log path.

The guard creates <canonical-log>.lock using create_new(true), so acquisition is atomic across processes on local filesystems. The lockfile is removed when the guard drops. If a process crashes, the file can remain behind; operators should inspect and remove that stale file deliberately rather than have Mimir guess liveness.

Implementations

impl WorkspaceWriteLock

pub fn acquire_for_log( log_path: impl AsRef<Path>, ) -> Result<Self, WorkspaceLockError>

Acquire the lock associated with log_path.

Errors

Returns WorkspaceLockError::AlreadyHeld when another holder’s lockfile already exists, or WorkspaceLockError::Io for filesystem failures creating, writing, or syncing the lockfile.

pub fn acquire_for_log_with_owner( log_path: impl AsRef<Path>, owner: impl AsRef<str>, ) -> Result<Self, WorkspaceLockError>

Acquire the lock associated with log_path and write an operator-visible owner string into the lockfile.

Errors

Same as Self::acquire_for_log.

pub fn path(&self) -> &Path

Filesystem path of the held lockfile.

Trait Implementations

impl Debug for WorkspaceWriteLock

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

Formats the value using the given formatter.

impl Drop for WorkspaceWriteLock

fn drop(&mut self)

Executes the destructor for this type.