Struct NumaBuffer 

pub struct NumaBuffer { /* private fields */ }

Host-side descriptor for a host allocation bound to a NUMA node.

Records the bound node and the byte footprint. This models the result of a numa_alloc_onnode(byte_size, node) followed by cuMemHostRegister; the descriptor carries the accounting that callers use to verify locality without owning a real pointer here.

Implementations

impl NumaBuffer

pub fn on_node( topology: &NumaTopology, node: usize, byte_size: usize, ) -> CudaResult<Self>

Plans a NUMA-bound host allocation of byte_size bytes on node.

Errors

• CudaError::InvalidValue if byte_size is zero or node is not a valid index in topology.

pub fn closest_to_gpu( topology: &NumaTopology, gpu_home_node: usize, byte_size: usize, ) -> CudaResult<Self>

Plans a host allocation bound to the node closest to a GPU whose home node is gpu_home_node.

Errors

Forwards errors from closest_node_to_gpu and the byte-size / node-range checks.

pub fn node(&self) -> usize

The NUMA node this allocation is bound to.

pub fn byte_size(&self) -> usize

The byte footprint of the allocation.

pub fn is_local_to(&self, access_node: usize) -> bool

Returns true if this allocation is local to access_node (i.e. the accessing node is the bound node).

pub fn access_distance( &self, topology: &NumaTopology, access_node: usize, ) -> Option<u8>

Returns the NUMA distance an access from access_node would incur, according to topology.

Returns None if access_node is out of range for topology.

Trait Implementations

impl Clone for NumaBuffer

fn clone(&self) -> NumaBuffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for NumaBuffer

impl Debug for NumaBuffer

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

Formats the value using the given formatter.

impl Display for NumaBuffer

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

Formats the value using the given formatter.

impl Eq for NumaBuffer

impl PartialEq for NumaBuffer

fn eq(&self, other: &NumaBuffer) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for NumaBuffer