Enum ForeignWhy 

pub enum ForeignWhy {
    HandWritten,
    NotUtf8,
    Unreadable {
        why: String,
    },
    MultiplyLinked {
        links: u64,
    },
}

Why a file at a hook path is not ours to write.

Every variant is a REASON, carried so the refusal can name it. “not ours” alone sends somebody to look at a file for a difference they cannot see; “not valid UTF-8” tells them it is a compiled hook in one word.

Variants

HandWritten

Readable text without our marker. Somebody wrote this on purpose.

NotUtf8

Not valid UTF-8 — a compiled binary, or text in another encoding. The case the old unwrap_or(false) silently overwrote.

Unreadable

It exists and we could not read it. Permissions, a bad mount, a disappearing network share. Never “therefore ours”.

Fields

why: String

MultiplyLinked

A hard link with other names pointing at the same inode. Truncating it would rewrite whatever else refers to it, and we cannot see from here what that is.

Fields

links: u64

Implementations

impl ForeignWhy

pub fn describe(&self) -> String

A fragment for the middle of a sentence: “… is {}”.

Trait Implementations

impl Clone for ForeignWhy

fn clone(&self) -> ForeignWhy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ForeignWhy

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

Formats the value using the given formatter.

impl Eq for ForeignWhy

impl PartialEq for ForeignWhy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ForeignWhy