Enum fsverity_merkle::FsVerityHasher

pub enum FsVerityHasher {
    Sha256(FsVerityHasherOptions),
    Sha512(FsVerityHasherOptions),
}

FsVerityHasher is used by fsverity to construct merkle trees for verity-enabled files. FsVerityHasher is parameterized by a salt and a block size.

Variants

Sha256(FsVerityHasherOptions)

Sha512(FsVerityHasherOptions)

Implementations

impl FsVerityHasher

pub fn block_size(&self) -> usize

pub fn hash_size(&self) -> usize

pub fn hash_block(&self, block: &[u8]) -> Vec<u8>

Computes the MerkleTree digest from a block of data.

A MerkleTree digest is a hash of a block of data. The block will be zero filled if its len is less than the block_size, except for when the first data block is completely empty. If salt.len() > 0, we prepend the block with the salt which itself is zero filled up to the padding.

Panics

Panics if block.len() exceeds self.block_size().

pub fn hash_hashes(&self, hashes: &[Vec<u8>]) -> Vec<u8>

Computes a MerkleTree digest from a block of hashes.

Like hash_block, hash_hashes zero fills incomplete buffers and prepends the digests with a salt, which is zero filled up to the padding.

Panics

Panics if any of the following conditions are met:

• hashes.len() is 0
• hashes.len() > self.block_size() / digest length

Trait Implementations

impl Clone for FsVerityHasher

fn clone(&self) -> FsVerityHasher

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FsVerityHasher

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

Formats the value using the given formatter.