Struct TransferMatrix 

pub struct TransferMatrix { /* private fields */ }

Lookup table mapping (source_device, dest_device) pairs to the cheapest available TransferPath. Built once at registration time from each backend’s advertised outbound paths; consulted every time the DAG inserts an Op::Move / Op::Copy.

Implementations

impl TransferMatrix

pub fn path( &self, src: DeviceLocation, dst: DeviceLocation, ) -> Option<TransferPath>

Look up the registered path between two devices. Returns None if no direct path was advertised; the caller can fall back to host-staging via the universal HostStaging path.

pub fn path_or_staging( &self, src: DeviceLocation, dst: DeviceLocation, ) -> TransferPath

Same as Self::path but always returns a path: falls back to TransferPath::HostStaging (the universal fallback) when no direct advertised path exists. CPU is reachable from every backend through host-staging, so this never returns an error for practical use cases — though see Error::UnsupportedTransfer for the case when a backend can’t even host-stage.

pub fn entries( &self, ) -> impl Iterator<Item = (&(DeviceLocation, DeviceLocation), &TransferPath)>

All entries in the matrix.

Trait Implementations

impl Debug for TransferMatrix

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

Formats the value using the given formatter.

impl Default for TransferMatrix

fn default() -> Self

Returns the “default value” for a type.