Struct StorageChecksumEngine 

pub struct StorageChecksumEngine {
    pub algorithm: ChecksumAlgorithm,
    pub verify_on_read: bool,
    /* private fields */
}

Multi-algorithm checksum engine for storage integrity verification.

Stores one ChecksumRecord per object and allows efficient batch computation and verification.

Fields

algorithm: ChecksumAlgorithm

Default algorithm used for new computations.

verify_on_read: bool

When true, callers are encouraged to verify on every read.

Implementations

impl StorageChecksumEngine

pub fn new(algorithm: ChecksumAlgorithm) -> Self

Create a new engine with the given default algorithm.

pub fn compute(&self, data: &[u8]) -> Checksum

Compute a checksum for data using the engine’s current algorithm.

pub fn compute_with_algorithm( algorithm: ChecksumAlgorithm, data: &[u8], ) -> Checksum

Compute a checksum for data using the specified algorithm.

pub fn compute_for( &mut self, object_id: String, data: &[u8], now: u64, ) -> ChecksumRecord

Compute a checksum for data, store the resulting record, and return it.

pub fn verify( &mut self, object_id: &str, data: &[u8], now: u64, ) -> Option<CeVerificationResult>

Compare the stored checksum for object_id with a freshly computed one.

Returns None when no record exists for object_id. On a successful match the record’s verified_at is updated to now.

pub fn record(&self, object_id: &str) -> Option<&ChecksumRecord>

Retrieve the stored record for object_id, if any.

pub fn remove(&mut self, object_id: &str) -> bool

Remove the record for object_id. Returns true if the record existed.

pub fn verify_all( &mut self, data_fn: impl Fn(&str) -> Option<Vec<u8>>, now: u64, ) -> Vec<CeVerificationResult>

Verify all stored records by calling data_fn for each object_id.

If data_fn returns None for a given id the object is skipped.

pub fn batch_compute( &mut self, items: &[(&str, &[u8])], now: u64, ) -> Vec<ChecksumRecord>

Compute and store checksums for a batch of (object_id, data) pairs.

pub fn corruption_count(results: &[CeVerificationResult]) -> usize

Count the number of verification results where !matches.

pub fn object_count(&self) -> usize

Number of objects currently tracked.

pub fn stats(&self, results: &[CeVerificationResult]) -> ChecksumStats

Compute aggregate statistics from the engine’s state and a set of results.

Trait Implementations

impl Clone for StorageChecksumEngine

fn clone(&self) -> StorageChecksumEngine

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StorageChecksumEngine

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

Formats the value using the given formatter.