Struct MemoryGovernor 

pub struct MemoryGovernor { /* private fields */ }

The central memory governor.

Thread-safe: all budget operations use atomics internally.

Implementations

impl MemoryGovernor

pub fn new(config: GovernorConfig) -> Result<Self>

Create a new governor with the given configuration.

pub fn try_reserve(&self, engine: EngineId, size: usize) -> Result<()>

Try to reserve size bytes for the given engine.

Returns Ok(()) if the reservation succeeded, or an error describing why it was rejected.

pub fn release(&self, engine: EngineId, size: usize)

Release size bytes back to the given engine’s budget.

pub fn budget(&self, engine: EngineId) -> Option<&Budget>

Get the budget for a specific engine.

pub fn global_ceiling(&self) -> usize

Get the global ceiling.

pub fn total_allocated(&self) -> usize

Total memory allocated across all engines.

pub fn global_utilization_percent(&self) -> u8

Global utilization as a percentage (0-100).

pub fn engine_pressure(&self, engine: EngineId) -> PressureLevel

Current pressure level for a specific engine.

pub fn global_pressure(&self) -> PressureLevel

Current global pressure level.

pub fn set_thresholds(&mut self, thresholds: PressureThresholds)

Set custom pressure thresholds.

pub fn snapshot(&self) -> Vec<EngineSnapshot>

Snapshot of all engine budget states (for metrics/debugging).

Trait Implementations

impl Debug for MemoryGovernor

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

Formats the value using the given formatter.