Enum PermitKind 

pub enum PermitKind {
    OpenFile,
    PendingMeta,
    None,
}

Which backpressure pool a leaf’s pre-acquired permit comes from.

The two pools are deliberately distinct (see LeafPermit) — this enum selects between them per tool, plus a None variant for metadata-only walks (e.g. rcmp-style traversals) that take no leaf permit at all.

Unifying the choice of pool here — alongside LeafPermit and preacquire_leaf_permit — is what lets the traversal driver own the “drop the leaf permit before recursing into a directory” invariant in a single place. Hand-coding that drop at every per-tool branch is the root cause of the hold-and-wait deadlock class this lifecycle eliminates.

Variants

OpenFile

File-descriptor backpressure (throttle::open_file_permit) — for tools that hold an open fd across leaf work (copy, link).

PendingMeta

Task-spawn backpressure (throttle::pending_meta_permit) — for recursive metadata-only walks that don’t hold an fd (chmod, rm).

None

The tool takes no leaf permit (it doesn’t gate at the leaf).

Trait Implementations

impl Clone for PermitKind

fn clone(&self) -> PermitKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PermitKind

impl Debug for PermitKind

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

Formats the value using the given formatter.

impl Eq for PermitKind

impl PartialEq for PermitKind

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PermitKind