Struct ByteBudget 

pub struct ByteBudget { /* private fields */ }

A shared cap on memory-resident bytes.

Cloned via Arc into every filesystem that should draw from the same pool. Exceeding the limit fails the write loudly, ENOSPC-style — an in-band error a model reads and adapts to; fail loud over quietly eating RAM.

Implementations

impl ByteBudget

pub fn new(limit: u64) -> ByteBudget

A budget of limit bytes labeled “memory” in error messages.

pub fn labeled(limit: u64, label: impl Into<String>) -> ByteBudget

A budget whose errors name label (e.g. a config knob like vfs-budget), so the failure tells the reader what to raise.

pub fn limit(&self) -> u64

The configured cap in bytes.

pub fn used(&self) -> u64

Bytes currently charged against the budget.

pub fn label(&self) -> &str

The label used in error messages and introspection.

pub fn remaining(&self) -> u64

Bytes still available.

pub fn try_charge(&self, bytes: u64) -> Result<(), Error>

Reserve bytes against the budget, or fail loudly without charging.

pub fn credit(&self, bytes: u64)

Return bytes to the budget.

Panics if it would underflow: crediting more than was charged means the caller’s accounting is wrong, and a limiter that under-reports is worse than no limiter — crash over drift.

Trait Implementations

impl Debug for ByteBudget

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

Formats the value using the given formatter.