Enum LockWaitOutcome 

pub enum LockWaitOutcome {
    Done,
    TransientError,
    Dangling,
    WaitTimeout,
    AgeTimeout,
    GiveUp,
    Abandoned {
        reason: NoCacheReason,
        token: u64,
    },
}

What happened to this reader’s cache-lock wait, and so what to do next.

Distinct from LockStatus, the lock’s shared state, which cannot carry a payload. This is per-reader and never stored, which is what lets Self::Abandoned carry its cause.

Variants

Done

The writer populated the asset. Look it up again.

TransientError

The writer hit a transient error such as a network failure. Compete to be the new writer.

Dangling

The write lock was dropped without being unlocked. A bug, but the request recovers by competing to be the new writer.

WaitTimeout

This reader has spent too long waiting on cache locks.

AgeTimeout

The writer held the lock past its age. Compete for it rather than waiting, so a stuck writer cannot pin every reader to it.

GiveUp

The writer found no lock was needed, for instance because the asset turned out to be uncacheable. Every reader proceeds uncached.

Abandoned

This reader stopped waiting because the writer published a fill it cannot use. Local to this reader: the lock status is untouched and every other reader goes on coalescing behind the same writer.

Fields

reason: NoCacheReason

Why, from the matched UnusableFill.

token: u64

The published token it matched.

Implementations

impl LockWaitOutcome

pub fn lock_status(&self) -> LockStatus

The nearest shared-status label, for tracing and metrics only. Self::Abandoned reports LockStatus::GiveUp because it shares that handling, but is never stored as such.

Trait Implementations

impl Clone for LockWaitOutcome

fn clone(&self) -> LockWaitOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LockWaitOutcome

impl Debug for LockWaitOutcome

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

Formats the value using the given formatter.

impl Eq for LockWaitOutcome

impl PartialEq for LockWaitOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LockWaitOutcome