Struct conserve::blockdir::BlockDir

pub struct BlockDir {
    pub stats: BlockDirStats,
    /* private fields */
}

A readable, writable directory within a band holding data blocks.

Fields

stats: BlockDirStats

Implementations

impl BlockDir

pub fn open(transport: Arc<dyn Transport>) -> BlockDir

pub fn create(transport: Arc<dyn Transport>) -> Result<BlockDir>

pub fn contains( &self, hash: &BlockHash, monitor: Arc<dyn Monitor> ) -> Result<bool>

True if the named block is present and apparently in this blockdir.

Empty block files should never normally occur, because the index doesn’t point to empty blocks and anyhow the compression method would expand an empty block to a non-empty compressed form. However, it’s possible for an interrupted operation on a local filesystem to leave an empty file. So, these are specifically treated as missing, so there’s a chance to heal them later.

pub fn compressed_size(&self, hash: &BlockHash) -> Result<u64>

Returns the compressed on-disk size of a block.

pub fn read_address( &self, address: &Address, monitor: Arc<dyn Monitor> ) -> Result<Bytes>

Read back some content addressed by an Address (a block hash, start and end).

pub fn get_block_content( &self, hash: &BlockHash, monitor: Arc<dyn Monitor> ) -> Result<Bytes>

Return the entire contents of the block.

Checks that the hash is correct with the contents.

pub fn delete_block(&self, hash: &BlockHash) -> Result<()>

pub fn blocks( &self, monitor: Arc<dyn Monitor> ) -> Result<impl ParallelIterator<Item = BlockHash>>

Return all the blocknames in the blockdir, in arbitrary order.

pub fn validate( &self, monitor: Arc<dyn Monitor> ) -> Result<HashMap<BlockHash, usize>>

Check format invariants of the BlockDir.

Return a dict describing which blocks are present, and the length of their uncompressed data.

Trait Implementations

impl Debug for BlockDir

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

Formats the value using the given formatter.