Struct NumaLocal 

pub struct NumaLocal<I: OsBacked> { /* private fields */ }

NumaLocal wrapper.

Implementations

impl<I: OsBacked> NumaLocal<I>

pub fn new(inner: I, policy: NumaPolicy) -> Result<Self, AllocError>

Wrap and apply policy to the inner allocator’s region.

Returns Err(AllocError) if the platform supports NUMA and the kernel rejects the bind (insufficient capability, invalid node id, no memory available on the bound nodes). On unsupported platforms (macOS, Windows, other) returns Ok without binding — caller can inspect with policy but the region’s physical placement is the kernel’s default.

pub fn inner(&self) -> &I

Borrow the inner allocator.

pub fn policy(&self) -> &NumaPolicy

Active policy.

Trait Implementations

impl<I: OsBacked> Allocator for NumaLocal<I>

fn allocate(&self, layout: NonZeroLayout) -> Result<NonNull<[u8]>, AllocError>

Allocate a block satisfying layout. The returned slice’s length is at least layout.size() but may be larger.

unsafe fn usable_size( &self, ptr: NonNull<u8>, layout: NonZeroLayout, ) -> Option<usize>

Usable size of an existing allocation, if the allocator can report it. Defaults to None — implementors that track usable size override.

fn capacity_bytes(&self) -> Option<usize>

Total bytes this allocator can issue, if bounded. None for unbounded allocators like System. Used by Watermark to compute thresholds.

fn corruption_events(&self) -> u64

Detected freelist / metadata corruption events observed by this allocator since construction.

fn allocate_zeroed( &self, layout: NonZeroLayout, ) -> Result<NonNull<[u8]>, AllocError>

Allocate a zero-initialized block.

unsafe fn grow( &self, ptr: NonNull<u8>, old: NonZeroLayout, new: NonZeroLayout, ) -> Result<NonNull<[u8]>, AllocError>

Grow an allocation in place if possible, otherwise allocate-copy-free.

unsafe fn shrink( &self, ptr: NonNull<u8>, old: NonZeroLayout, new: NonZeroLayout, ) -> Result<NonNull<[u8]>, AllocError>

Shrink an allocation in place if possible, otherwise allocate-copy-free.

fn reset(&mut self) -> Result<(), AllocError>

Reclaim everything previously allocated. Default impl returns AllocError — only arena-style allocators implement a meaningful reset.

impl<I: OsBacked> Deallocator for NumaLocal<I>

unsafe fn deallocate(&self, ptr: NonNull<u8>, layout: NonZeroLayout)

Release a previously allocated block.

impl<I: OsBacked + FixedRange> FixedRange for NumaLocal<I>

fn commit(&self, offset: usize, len: usize) -> Result<(), AllocError>

Pass-through forward so a commit-aware consumer reaches the inner backing when this wrapper sits over a lazy_commit MmapBacked.

fn base(&self) -> NonNull<u8>

First byte of the owned address range.

fn size(&self) -> usize

Length in bytes of the owned address range.

fn contains(&self, ptr: NonNull<u8>) -> bool

Whether ptr lies within [base, base + size).

impl<I: OsBacked> OsBacked for NumaLocal<I>

fn base_ptr(&self) -> NonNull<u8>

First byte of the OS-managed region.

fn region_size(&self) -> usize

Length in bytes of the OS-managed region.

unsafe fn release_pages(&self, ptr: NonNull<u8>, size: usize)

Release the physical pages backing [ptr, ptr + size) to the OS while keeping the virtual address range reserved.

unsafe fn protect(&self, ptr: NonNull<u8>, size: usize, flags: ProtectFlags)

Change memory protection flags on [ptr, ptr + size).