Struct rustdb::block::BlockStg

pub struct BlockStg { /* private fields */ }

Manages allocation and deallocation of numbered relocatable fixed size blocks from underlying Storage.

Blocks are numbered. A map of the location of each block is kept at the start of the storage (after the header).

Blocks can be relocated by adjusting the map entry to point to the new location.

On save, the set of free block numbers is processed and any associated blocks are freed.

When a block is freed, the last block is relocated to fill it.

Implementations

impl BlockStg

pub fn new(stg: Box<dyn Storage>, blk_cap: u64) -> Self

Construct BlockStg with specified underlying Storage and block capacity. For existing file, block capacity will be read from file header.

pub fn blk_cap(&self) -> u64

Get the block capacity.

pub fn nsz(&self) -> usize

Get size of a block number in bytes.

pub fn is_new(&self) -> bool

Is this new storage.

pub fn new_block(&mut self) -> u64

Allocate a new block number.

pub fn drop_block(&mut self, bn: u64)

Release a block number.

pub fn set(&mut self, bn: u64, offset: u64, data: &[u8])

Set numbered block/offset to specified data.

pub fn set_data(&mut self, bn: u64, offset: u64, data: Data, s: usize, n: usize)

Set numbered block/offset to specified slice of Data.

pub fn get(&self, bn: u64, offset: u64, data: &mut [u8])

Get data from specified numbered block and offset.

pub fn set_rsvd(&mut self, rsvd: [u8; 16])

Set the reserved area in the storage header.

pub fn get_rsvd(&self) -> [u8; 16]

Get the reserved area from the storage header.

pub fn save(&mut self)

Save changes to underlying storage.

pub fn wait_complete(&self)

Wait for save to complete.