Struct ModelFingerprint 

pub struct ModelFingerprint {
    pub file_size: u64,
    pub mtime_secs: i64,
    pub head_hash: [u8; 32],
    pub tail_hash: [u8; 32],
    pub probe_size: u32,
}

Bounded O(constant) fingerprint of a GGUF model file.

Avoids the O(file-size) cost of hashing the whole file by reading only probe_size bytes from the head and probe_size bytes from the tail, then hashing each block independently. The combination of file size, modification time, and the two content hashes is sufficient to detect truncation, replacement, or in-place modification of any real GGUF file while capping I/O at 2 * probe_size bytes regardless of model size.

Fields

file_size: u64

Total file size in bytes.

mtime_secs: i64

File mtime as Unix seconds (best-effort; 0 if unavailable).

head_hash: [u8; 32]

Blake3 hash of the first probe_size bytes.

tail_hash: [u8; 32]

Blake3 hash of the last probe_size bytes.

probe_size: u32

Number of bytes probed from each end of the file.

Implementations

impl ModelFingerprint

pub fn compute(path: &Path) -> RuntimeResult<Self>

Compute a fingerprint for the file at path.

Reads at most 2 * DEFAULT_PROBE_SIZE bytes in total.

pub fn compute_with_probe(path: &Path, probe_size: u32) -> RuntimeResult<Self>

Compute a fingerprint with a custom probe size.

pub fn verify(&self, path: &Path) -> RuntimeResult<()>

Verify that path matches this fingerprint.

Returns Ok(()) if the file matches, or a RuntimeError::ModelFingerprintMismatch if it does not.

pub fn display(&self) -> String

Human-readable display string for error messages.

Trait Implementations

impl Clone for ModelFingerprint

fn clone(&self) -> ModelFingerprint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelFingerprint

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

Formats the value using the given formatter.

impl Decode for ModelFingerprint

fn decode<__D: Decoder<Context = ()>>(decoder: &mut __D) -> Result<Self, Error>

Decode a value from the given decoder

impl Encode for ModelFingerprint

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), Error>

Encode this value into the given encoder

impl PartialEq for ModelFingerprint

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ModelFingerprint