Struct PoolStatsTracker 

pub struct PoolStatsTracker { /* private fields */ }

Thread-safe allocation tracking for memory pools.

Uses an RwLock-protected inner state so that multiple readers can snapshot stats concurrently while mutations are serialized.

Implementations

impl PoolStatsTracker

pub fn new() -> Self

Creates a new tracker with all counters at zero.

pub fn record_alloc(&self, size: usize)

Records an allocation of size bytes.

Updates allocated_bytes, peak_bytes, allocation_count, and the histogram.

pub fn record_free(&self, size: usize)

Records a deallocation of size bytes.

Updates allocated_bytes and free_count.

pub fn snapshot(&self) -> PoolReport

Takes a snapshot of current stats as a PoolReport.

The fragmentation field is set to default values since this tracker does not have visibility into the free-list structure.

pub fn reset(&self)

Resets all statistics to zero.

pub fn current_allocated(&self) -> usize

Returns the current number of allocated bytes.

pub fn peak_allocated(&self) -> usize

Returns the peak number of allocated bytes.

pub fn trim(&self) -> usize

Trims the pool: simulates cuMemPoolTrimTo, releasing all freed (outstanding) allocations back to the system.

Returns the number of bytes that were outstanding and are now released. After trim, current_allocated() is set to 0 and is_fully_trimmed() returns true.

In a real GPU pool (cuMemPoolTrimTo), this releases pool memory pages back to the OS. Here we track the logical accounting: after all frees have been recorded via PoolStatsTracker::record_free, trim marks the remaining outstanding bytes as released.

pub fn is_fully_trimmed(&self) -> bool

Returns true when there are no outstanding allocations — i.e., every allocated byte has been freed (and optionally trimmed).

Equivalent to current_allocated() == 0.

pub fn has_leaks(&self) -> bool

Returns true if there are bytes still allocated (not yet freed).

Equivalent to current_allocated() > 0.

Trait Implementations

impl Debug for PoolStatsTracker

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

Formats the value using the given formatter.

impl Default for PoolStatsTracker

fn default() -> Self

Returns the “default value” for a type.