Struct SaaTrackingAllocator

pub struct SaaTrackingAllocator<A = System> { /* private fields */ }

A wrapper around a GlobalAlloc implementation (like std::alloc::System) that intercepts allocation calls to update the global memory counters defined in khora_core::memory.

This allocator is the key to enabling the SAA’s memory monitoring. By registering it as the #[global_allocator], all heap allocations made by the application will be tracked, providing essential telemetry to the Dynamic Context Core (DCC).

Type Parameters

• A: The underlying allocator that will perform the actual memory allocation. Defaults to System, the standard Rust allocator.

Usage

use khora_data::allocators::SaaTrackingAllocator;

#[global_allocator]
static GLOBAL: SaaTrackingAllocator = SaaTrackingAllocator::new(std::alloc::System);

Implementations

impl<A> SaaTrackingAllocator<A>

pub const fn new(inner: A) -> Self

Creates a new tracking allocator that wraps the given inner allocator.

Trait Implementations

impl<A: Clone> Clone for SaaTrackingAllocator<A>

fn clone(&self) -> SaaTrackingAllocator<A>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: Debug> Debug for SaaTrackingAllocator<A>

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

Formats the value using the given formatter.

impl<A: Default> Default for SaaTrackingAllocator<A>

fn default() -> SaaTrackingAllocator<A>

Returns the “default value” for a type.

impl<A: GlobalAlloc> GlobalAlloc for SaaTrackingAllocator<A>

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates memory and updates tracking counters.

Safety

This function is unsafe because it is part of the GlobalAlloc trait. The caller must ensure that layout has a non-zero size.

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocates memory and updates tracking counters.

Safety

This function is unsafe because it is part of the GlobalAlloc trait. The caller must ensure that ptr was allocated by this allocator with the same layout.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

Allocates zero-initialized memory and updates tracking counters.

Safety

This function is unsafe for the same reasons as alloc.

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Reallocates memory and updates tracking counters.

Safety

This function is unsafe for the same reasons as realloc in GlobalAlloc.

impl<A: Copy> Copy for SaaTrackingAllocator<A>