Struct MemoryAccounting 

pub struct MemoryAccounting { /* private fields */ }

Thread-safe accounting shared by storage components.

Implementations

impl MemoryAccounting

pub fn new(budget: MemoryBudget) -> MemoryAccounting

pub fn budget(&self) -> MemoryBudget

pub fn report_usage(&self, category: MemoryCategory, bytes: u64)

Replace an observed usage value for a category.

pub fn try_reserve( self: &Arc<MemoryAccounting>, category: MemoryCategory, bytes: u64, ) -> Result<MemoryReservation, StorageError>

Reserve temporary memory for a background operation.

pub fn try_reserve_with_spill<F>( self: &Arc<MemoryAccounting>, category: MemoryCategory, bytes: u64, spill_fn: F, ) -> Result<MemoryReservation, StorageError>

where F: Fn() -> Option<u64>,

Reserve memory with automatic spilling on hard-limit failure.

If try_reserve fails with CapacityExceeded, invokes spill_fn to free memory, then retries the reservation. If the spill fails or the retry also fails, the original error is returned.

pub fn release_category(&self, category: MemoryCategory, bytes: u64)

Release memory from a category (public wrapper for eviction callbacks).

This is the public interface for components like the cache eviction listener to report memory that was freed outside the reservation system.

pub fn snapshot(&self) -> ResourceSnapshot

Trait Implementations

impl Debug for MemoryAccounting

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

Formats the value using the given formatter.