Struct FileStatFingerprint 

pub struct FileStatFingerprint { /* private fields */ }

A snapshot of the filesystem identity and size of a committed file.

This is captured while constructing CommittedFileEvidence and can be compared by callers before trusting that the committed path still names the file whose checksums were recorded.

Implementations

impl FileStatFingerprint

pub fn capture_path(path: impl AsRef<Path>) -> Option<Self>

Fingerprint path exactly as this crate’s stat gates compare it.

Symlinks are not followed and only regular files fingerprint, so a path that is (or became) a directory, a symlink or a device reads as None rather than as a file — the same rule the carry gate applies, because this is the function that gate calls.

Callers building a crate::ScanCarry from their own verification pass must capture the fingerprint at the moment they read the file’s bytes, not afterwards: the gate’s whole guarantee is that the file the repair reads is the file the fingerprint describes, and a fingerprint taken late silently covers whatever changed in between.

What this can prove is what stat can prove — length, mtime, and on Unix device and inode. A same-length rewrite that also restores the original mtime in place is invisible to it, which is why a repair that consumes a carry re-checks the bytes themselves against their slice checksums as it reads them.

pub fn length(&self) -> u64

File length recorded by the stat call.

pub fn modified(&self) -> Option<SystemTime>

Last-modified timestamp recorded by the stat call, when available.

pub fn device(&self) -> u64

Unix device number recorded by the stat call.

pub fn inode(&self) -> u64

Unix inode number recorded by the stat call.

Trait Implementations

impl Clone for FileStatFingerprint

fn clone(&self) -> FileStatFingerprint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileStatFingerprint

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

Formats the value using the given formatter.

impl Eq for FileStatFingerprint

impl PartialEq for FileStatFingerprint

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FileStatFingerprint