Struct LockGuard 

pub struct LockGuard { /* private fields */ }

Owned proof that the holder currently has exclusive access to a key.

Drop semantics: when a LockGuard is dropped without an explicit DistributedLock::release call, a tracing::warn! records the leak. The lock will still expire by TTL, so correctness is preserved, but the warning surfaces forgotten release calls in telemetry.

Implementations

impl LockGuard

pub fn new(key: AdvisoryKey) -> Self

Construct a guard. Backend DistributedLock impls call this after a successful acquire — the token is the per-acquire ownership marker the backend stores alongside the lock value.

pub const fn key(&self) -> &AdvisoryKey

Borrow the lock key.

pub fn token(&self) -> &str

Borrow the per-acquire ownership token.

pub fn held_for(&self) -> Duration

Wall-clock duration the guard has been held.

pub fn mark_released(&mut self)

Mark the guard as released — backend DistributedLock impls call this from release() so the Drop impl does not warn. Outside backend code there is no reason to call this directly.

Trait Implementations

impl Debug for LockGuard

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

Formats the value using the given formatter.

impl Drop for LockGuard

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.