Struct SpillController 

pub struct SpillController { /* private fields */ }

Per-core spill controller.

Call check(utilization_percent) periodically from the core’s housekeeping loop. The controller tracks state transitions and returns the recommended action.

The controller implements a simple state machine:

• Normal (utilization < spill_threshold) → None
• Spilling (spill_threshold ≤ utilization) → BeginSpill, then ContinueSpill
• Restoring (utilization < restore_threshold while spilling) → BeginRestore, then None

Not Send or Sync — it’s single-core owned.

Implementations

impl SpillController

pub fn new(config: SpillConfig) -> Self

Create a new spill controller with the given configuration.

pub fn check(&mut self, utilization: u8) -> SpillAction

Check utilization and return the recommended action.

Call this periodically from the core’s housekeeping loop. utilization should be a percentage 0-100.

pub fn is_spilling(&self) -> bool

Whether spill mode is currently active.

pub fn spill_count(&self) -> u64

Total number of spill cycles initiated.

pub fn entries_spilled(&self) -> u64

Number of entries spilled in the current cycle.

pub fn record_spill(&mut self, count: u64)

Record that count entries were spilled in this cycle.

pub fn reset_cycle(&mut self)

Reset the current cycle’s spill counters (but keep total spill_count).