Struct LockOptions 

pub struct LockOptions {
    pub attempts: u32,
    pub retry_delay: Duration,
    pub stale: Duration,
    pub update: Duration,
    pub lockfile_path: Option<PathBuf>,
}

Configurable acquisition and ownership policy.

Production callers use LockOptions::default. Focused tests shorten attempts, retry_delay, stale, and update so they stay within the 10 × 20 ms production sleep budget without an injectable clock.

Fields

attempts: u32

Maximum create attempts, including the first try. Must be ≥ 1.

retry_delay: Duration

Sleep between contention retries. Skipped when zero.

stale: Duration

Age at which an existing lock directory may be reclaimed.

update: Duration

Heartbeat interval for refreshing the held lock directory mtime.

When zero, no background refresh is started (the holder can still be stolen after stale elapses).

lockfile_path: Option<PathBuf>

Override for the lock directory path.

When None, the lock path is ${absolute_target}.lock. Trust storage passes an explicit sibling such as trust.json.lock while locking the parent directory.

Implementations

impl LockOptions

pub fn new() -> Self

Default production policy.

pub fn attempts(self, attempts: u32) -> Self

Set the maximum number of create attempts (including the first).

pub fn retry_delay(self, retry_delay: Duration) -> Self

Set the delay between contention retries.

pub fn stale(self, stale: Duration) -> Self

Set the stale threshold used when reclaiming an abandoned lock.

pub fn update(self, update: Duration) -> Self

Set the mtime refresh interval while the lock is held.

pub fn lockfile_path(self, lockfile_path: impl Into<PathBuf>) -> Self

Override the lock directory path.

Trait Implementations

impl Clone for LockOptions

fn clone(&self) -> LockOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LockOptions

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

Formats the value using the given formatter.

impl Default for LockOptions

fn default() -> Self

Returns the “default value” for a type.

impl Eq for LockOptions

impl PartialEq for LockOptions

fn eq(&self, other: &LockOptions) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for LockOptions