Struct BufferManager 

pub struct BufferManager { /* private fields */ }

The central unified buffer manager.

Manages memory allocation across all subsystems with pressure-aware eviction and optional spilling support.

Implementations

impl BufferManager

pub fn new(config: BufferManagerConfig) -> Arc<Self>

Creates a new buffer manager with the given configuration.

pub fn with_defaults() -> Arc<Self>

Creates a buffer manager with default configuration.

pub fn with_budget(budget: usize) -> Arc<Self>

Creates a buffer manager with a specific budget.

pub fn try_allocate( self: &Arc<Self>, size: usize, region: MemoryRegion, ) -> Option<MemoryGrant>

Attempts to allocate memory for the given region.

Returns None if allocation would exceed the hard limit after eviction attempts.

pub fn pressure_level(&self) -> PressureLevel

Returns the current pressure level.

pub fn stats(&self) -> BufferStats

Returns current buffer statistics.

pub fn register_consumer(&self, consumer: Arc<dyn MemoryConsumer>)

Registers a memory consumer for eviction callbacks.

pub fn unregister_consumer(&self, name: &str)

Unregisters a memory consumer by name.

pub fn evict_to_target(&self, target_bytes: usize) -> usize

Forces eviction to reach the target usage.

Returns the number of bytes actually freed.

pub fn spill_all(&self) -> usize

Spills all consumers that support it, regardless of memory pressure.

Used when TierOverride::ForceDisk is configured. Returns total bytes freed.

pub fn config(&self) -> &BufferManagerConfig

Returns the configuration.

pub fn budget(&self) -> usize

Returns the memory budget.

pub fn allocated(&self) -> usize

Returns currently allocated bytes.

pub fn available(&self) -> usize

Returns available bytes.

pub fn shutdown(&self)

Shuts down the buffer manager.

Trait Implementations

impl Drop for BufferManager

fn drop(&mut self)

Executes the destructor for this type.

impl GrantReleaser for BufferManager

fn release(&self, size: usize, region: MemoryRegion)

Releases memory back to the manager.

fn try_allocate_raw(&self, size: usize, region: MemoryRegion) -> bool

Tries to allocate additional memory (for resize operations).