Struct BlockLease 

pub struct BlockLease { /* private fields */ }

A block storage lease that auto-frees on drop.

Wraps a FabricBlock handle with RAII lifecycle management. When the BlockLease is dropped, the underlying resource will be released (once the host provides an explicit fbbu_free() call).

Created via BlockBuilder::acquire.

Examples

use grafos_std::block::{BlockBuilder, BLOCK_SIZE};

let lease = BlockBuilder::new().min_blocks(16).acquire()?;
let data = [42u8; BLOCK_SIZE];
lease.block().write_block(0, &data)?;
// lease is freed when it goes out of scope

Implementations

impl BlockLease

pub fn block(&self) -> &FabricBlock

Access the underlying FabricBlock handle for I/O operations.

pub fn info(&self) -> LeaseInfo

Lease metadata snapshot (id, creation time, expiry, and status).

pub fn lease_id(&self) -> u128

Unique lease identifier.

pub fn created_at_unix_secs(&self) -> u64

Lease creation timestamp (unix seconds).

pub fn expires_at_unix_secs(&self) -> u64

Lease expiry timestamp (unix seconds).

pub fn status(&self) -> LeaseStatus

Current lease status.

pub fn renew(&self, duration_secs: u64) -> Result<()>

Renew the lease TTL by duration_secs.

pub fn free(&self)

Explicitly revoke/free this lease.

Trait Implementations

impl Debug for BlockLease

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

Formats the value using the given formatter.

impl Drop for BlockLease

fn drop(&mut self)

Executes the destructor for this type.