Struct MemoryBackendWrapper 

pub struct MemoryBackendWrapper;

High-level OS page mapping backend helper. Owns the wrapper struct shape and forwards the platform-conditional capability consts from crate::DefaultBackend; per-method bodies delegate to per-concern helpers in crate::guard and crate::reset.

Trait Implementations

impl HasSegmentPool for MemoryBackendWrapper

fn pools() -> &'static BackendPools

Returns this backend’s pool bundle.

fn global_segment_pool() -> &'static GlobalSegmentPool

Returns the global segment pool for this backend.

fn global_orphan_pool() -> &'static GlobalSegmentPool

Returns the global orphan pool for this backend.

fn global_huge_pool() -> &'static GlobalHugePool

Returns the global huge allocation pool for this backend.

impl LocalAllocatorSelector<MemoryBackendWrapper> for MemoryBackendWrapper

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Evaluates the closure with a mutable reference to the thread-local allocator cache, arming the re-entrancy guard.

unsafe fn with_allocator_unguarded<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Runs f with the thread-local allocator cache without arming the re-entrancy guard, returning None on same-thread re-entry.

fn get_allocator_ptr() -> *mut c_void

Returns the raw pointer to the thread-local allocator cache.

fn get_allocator_ptr_raw() -> *mut c_void

Returns the raw pointer to the thread-local allocator cache without triggering lazy initialization.

fn register_current_allocator_ptr(ptr: *mut c_void)

Registers a manually created allocator instance as the current thread’s active cache pointer for this backend mode so direct ThreadAllocator::new() uses remain compatible with the public free path.

fn with_allocator_for_policy<P, R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

where P: AllocPolicy,

Runs f against the TLS allocator selected by the compile-time free-list encryption mode.

unsafe fn with_allocator_unguarded_for_policy<P, R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

where P: AllocPolicy,

Mode-keyed counterpart of Self::with_allocator_unguarded.

fn get_allocator_ptr_for_policy<P>() -> *mut c_void

where P: AllocPolicy,

Returns the initialized mode-keyed allocator pointer, arming its TLS slot when necessary.

fn get_allocator_ptr_raw_for_policy<P>() -> *mut c_void

where P: AllocPolicy,

Returns the initialized mode-keyed allocator pointer without creating its slot.

fn get_allocator_ptr_raw_for_encryption<const ENCRYPTED: bool>() -> *mut c_void

Returns the raw pointer for a statically selected free-list encoding mode without creating its slot.

impl MemoryBackend for MemoryBackendWrapper

unsafe fn allocate(size: usize) -> *mut u8

Allocates memory from the OS.

Safety

Size must be greater than zero and page-aligned.

unsafe fn deallocate(ptr: *mut u8, size: usize) -> bool

Releases memory to the OS.

Safety

The ptr must be valid and size must match the allocated size.

unsafe fn make_guard(ptr: *mut u8, size: usize) -> bool

Installs a PROT_NONE / PAGE_NOACCESS guard region.

Delegates to crate::guard::do_make_guard which records the confirmed install through crate::recorders::record_guard_install.

unsafe fn page_reset(ptr: *mut u8, size: usize) -> bool

Drops the physical backing of an idle page range while keeping the virtual mapping committed.

Delegates to crate::reset::do_page_reset which records the confirmed reset through crate::recorders::record_page_reset.

unsafe fn decommit(ptr: *mut u8, size: usize) -> bool

Releases the commit charge / physical backing of a page-aligned range while keeping the reservation.

Delegates to crate::reset::do_decommit which records the confirmed decommit through crate::recorders::record_decommit.

const SUPPORTS_PAGE_RESET: bool = DefaultBackend::SUPPORTS_PAGE_RESET

Indicates whether the backend supports advisory page resetting.

const SUPPORTS_MAKE_GUARD: bool = DefaultBackend::SUPPORTS_MAKE_GUARD

Indicates whether the backend supports page protection guard installation.

const SUPPORTS_DECOMMIT: bool = DefaultBackend::SUPPORTS_DECOMMIT

Indicates whether the backend supports releasing memory commitment while keeping the reservation.

const ENABLE_CPU_CACHE: bool = DefaultBackend::ENABLE_CPU_CACHE

Indicates whether the backend enables the lock-free per-CPU block cache.

impl PolicySlotSelection<MemoryBackendWrapper> for StandardPolicy

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Runs f with access to the allocator cache selected for this policy.

unsafe fn with_allocator_unguarded<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Runs f with access to the selected policy cache without arming the re-entrancy gate.

fn get_allocator_ptr() -> *mut c_void

Returns the initialized allocator pointer for this policy’s TLS slot.

fn get_allocator_ptr_raw() -> *mut c_void

Returns the raw allocator pointer for this policy’s TLS slot without forcing lazy initialization.

impl PolicySlotSelection<MemoryBackendWrapper> for SecurePolicy

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Runs f with access to the allocator cache selected for this policy.

unsafe fn with_allocator_unguarded<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Runs f with access to the selected policy cache without arming the re-entrancy gate.

fn get_allocator_ptr() -> *mut c_void

Returns the initialized allocator pointer for this policy’s TLS slot.

fn get_allocator_ptr_raw() -> *mut c_void

Returns the raw allocator pointer for this policy’s TLS slot without forcing lazy initialization.

impl PolicySlotSelection<MemoryBackendWrapper> for HardenedPolicy

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Runs f with access to the allocator cache selected for this policy.

unsafe fn with_allocator_unguarded<R>( f: impl FnOnce(&mut ThreadAllocator<MemoryBackendWrapper>) -> R, ) -> Option<R>

Runs f with access to the selected policy cache without arming the re-entrancy gate.

fn get_allocator_ptr() -> *mut c_void

Returns the initialized allocator pointer for this policy’s TLS slot.

fn get_allocator_ptr_raw() -> *mut c_void

Returns the raw allocator pointer for this policy’s TLS slot without forcing lazy initialization.