Struct CudaHostPinnedBackend 

pub struct CudaHostPinnedBackend;

A memory backend allocating CUDA page-locked (pinned) host memory.

allocate returns null on failure (driver unavailable, driver allocation failure, or registry full); there is no host fallback.

Trait Implementations

impl HasSegmentPool for CudaHostPinnedBackend

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<CudaHostPinnedBackend> for CudaHostPinnedBackend

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend>) -> 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 CudaHostPinnedBackend

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

Allocates CUDA-backed memory. Returns null on failure.

Safety

The size must be greater than zero and page-aligned.

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

Deallocates memory allocated by this backend.

Safety

The pointer must be valid and the size must match the allocation.

const SUPPORTS_PAGE_RESET: bool = false

Indicates whether the backend supports advisory page resetting.

const SUPPORTS_MAKE_GUARD: bool = false

Indicates whether the backend supports page protection guard installation.

const SUPPORTS_DECOMMIT: bool = false

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

const ENABLE_CPU_CACHE: bool = false

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

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

Asks the OS to drop the physical backing of a mapped page range while keeping the virtual address range reserved and accessible.

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

Marks a page-aligned range as an inaccessible guard region.

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

Releases the commit charge / physical backing of a page-aligned range while keeping the surrounding reservation intact, so the range can still be covered by the eventual deallocate of the base allocation.

impl PolicySlotSelection<CudaHostPinnedBackend> for StandardPolicy

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend> for SecurePolicy

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend> for HardenedPolicy

fn with_allocator<R>( f: impl FnOnce(&mut ThreadAllocator<CudaHostPinnedBackend>) -> 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<CudaHostPinnedBackend>) -> 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.