Struct CacheResidencyPool 

pub struct CacheResidencyPool { /* private fields */ }

Shareable aggregate ownership boundary for scheduler and standalone caches.

Implementations

impl CacheResidencyPool

pub fn new(limits: CachePoolLimits) -> Self

Creates an empty process pool under aggregate finite limits.

pub const fn id(&self) -> u64

Returns this pool’s stable process-local identity.

pub const fn limits(&self) -> CachePoolLimits

Returns aggregate finite limits.

pub fn register_manager( &self, manager: u64, ) -> Result<CachePoolMembership, CachePoolError>

Registers a manager and returns its exact RAII membership token.

pub fn update_manager( &self, manager: u64, usage: CachePoolUsage, ) -> Result<CachePoolUsage, CachePoolError>

Replaces the published occupancy owned by one registered manager.

Backends use reservations to admit growth before allocating it, publish the resulting concrete occupancy here, and then release the reservation. Publication records physical truth even when an unavoidable allocation boundary temporarily exceeds a limit; subsequent admissions fail and the backend must synchronously rebalance or roll back that allocation.

pub fn reserve( &self, usage: CachePoolUsage, ) -> Result<CachePoolReservation, CachePoolError>

Atomically admits additional occupancy until its RAII token is dropped.

pub fn reserve_transfer( &self, bytes: u64, ) -> Result<CachePoolReservation, CachePoolError>

Atomically admits resources retained by one submitted transfer.

pub fn report(&self) -> Result<CachePoolReport, CachePoolError>

Returns aggregate current occupancy and high-water marks.

Trait Implementations

impl Clone for CacheResidencyPool

fn clone(&self) -> CacheResidencyPool

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CacheResidencyPool

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

Formats the value using the given formatter.

impl Eq for CacheResidencyPool

impl PartialEq for CacheResidencyPool

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.