Struct MemBuilder 

pub struct MemBuilder { /* private fields */ }

Builder for acquiring a fabric memory lease with capacity constraints.

Use the builder pattern to specify minimum capacity requirements, then call acquire to perform the HELLO handshake and validate the arena size.

Examples

use grafos_std::mem::MemBuilder;

// Require at least 8 KiB
let lease = MemBuilder::new().min_bytes(8192).acquire()?;
assert!(lease.mem().arena_size()? >= 8192);

Implementations

impl MemBuilder

pub fn new() -> Self

Create a new builder with no minimum capacity constraint.

pub fn min_bytes(self, n: u64) -> Self

Set the minimum number of bytes required from the arena.

If the arena reported by the host is smaller than this value, acquire will return FabricError::CapacityExceeded.

pub fn lease_secs(self, secs: u64) -> Self

Set the lease TTL in seconds.

pub fn acquire(self) -> Result<MemLease>

Acquire the memory lease by performing the HELLO handshake and verifying that the arena meets the requested minimum.

Errors

• FabricError::CapacityExceeded if the arena size is less than the configured min_bytes.
• FabricError::Disconnected if the HELLO handshake fails.

pub fn attach(lease_id: u128) -> Result<MemLease>

Attach to an existing memory lease by ID.

Instead of allocating a new lease, this queries the host for the given lease_id and returns a MemLease bound to it if the lease is still active. This enables crash recovery: a replacement tasklet can reconnect to storage that survived the previous tasklet’s death.

Errors

• FabricError::LeaseExpired if the lease has expired.
• FabricError::Revoked if the lease has been revoked.
• FabricError::Disconnected if the query fails.

Trait Implementations

impl Default for MemBuilder

fn default() -> Self

Returns the “default value” for a type.