Enum FileIdentityMode 

pub enum FileIdentityMode {
    Omit,
    BestEffort,
    Required,
}

How much work a request is willing to do for file identity.

The 128-bit file ID is inline in every record and always present. Only the volume serial that qualifies it costs an extra query, and that query runs once against the directory handle – no mode ever opens an individual entry.

Variants

Omit

Do not query the volume serial. Entries carry unqualified identities.

The default, because a caller that never compares identities across volumes should not pay for the query.

BestEffort

Query the volume serial once, and carry on without it if that fails.

Entries then carry unqualified identities rather than failing the enumeration – the shape a caller wants when identity refines its work but does not gate it.

Required

Query the volume serial once, and fail the enumeration before its first entry if it cannot be obtained.

Use this when an unqualified identity would be silently wrong.

Implementations

impl FileIdentityMode

pub const fn queries_volume(self) -> bool

Whether this mode performs the volume-serial query at all.

Trait Implementations

impl Clone for FileIdentityMode

fn clone(&self) -> FileIdentityMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FileIdentityMode

impl Debug for FileIdentityMode

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

Formats the value using the given formatter.

impl Default for FileIdentityMode

fn default() -> FileIdentityMode

Returns the “default value” for a type.

impl Eq for FileIdentityMode

impl Hash for FileIdentityMode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FileIdentityMode

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FileIdentityMode