Struct MutationLock 

pub struct MutationLock { /* private fields */ }

An exclusive ownership record for one installation domain.

The lock is fail-closed: ambiguous, malformed, oversized, or otherwise unreadable records never trigger automatic removal. There is deliberately no automatic stale-lock recovery based on PID liveness alone, because PID reuse cannot prove process identity across the public contract. Operators establish ownership out-of-band (for example via MutationLock::inspect plus deployment-specific process evidence) and remove a stale record manually.

Implementations

impl MutationLock

pub fn acquire( root: &Path, product: &ProductId, release: &ReleaseId, ) -> Result<Self>

Acquires the installation-root lock using create-new filesystem semantics.

pub fn inspect(root: &Path) -> Result<LockStatus>

Inspects the lock record without acquiring or removing it.

Returns LockStatus::Available when no record exists, LockStatus::Held when a bounded readable record exists, and LockStatus::Malformed when the record is missing, unreadable, oversized, or non-UTF-8. This function never deletes anything.

pub fn path(&self) -> &Path

Returns the lock record path.

Trait Implementations

impl Debug for MutationLock

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

Formats the value using the given formatter.

impl Drop for MutationLock

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.