Struct DeviceIdentity 

pub struct DeviceIdentity {
    pub name: String,
    pub fingerprint: String,
    pub physical: Option<PhysicalDevice>,
}

Available on crate feature cubecl only.

Who a device is, and what its compiled code is keyed to.

name and fingerprint answer different questions and must not be confused. name is for people: it names the physical part, and two machines holding the same part report the same name. fingerprint is for correctness: it is verbatim the string this runtime passes to compilation_store, which is what puts a compiled artifact out of reach of a machine that cannot run it.

Reporting the fingerprint here rather than recomputing it is the whole point: a backend derives it once and hands it to both consumers, so the identity a bundle is stamped with and the namespace its kernels live under cannot drift apart.

Fields

name: String

The device as it names itself — AMD Radeon 8060S Graphics, NVIDIA H100 PCIe. Distinct parts may share a name, so no capability and no compiled artifact may be keyed to it.

fingerprint: String

What this runtime compiles for — hip-kernel_gfx1151, ptx_sm90. Verbatim the compilation_store fingerprint, so a namespace read back out of a bundle compares against it directly.

physical: Option<PhysicalDevice>

The card behind the device, None for a device that is no card: a CPU, or a software rasterizer.

Trait Implementations

impl Clone for DeviceIdentity

fn clone(&self) -> DeviceIdentity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceIdentity

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

Formats the value using the given formatter.

impl Default for DeviceIdentity

fn default() -> DeviceIdentity

Returns the “default value” for a type.

impl Eq for DeviceIdentity

impl Hash for DeviceIdentity

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for DeviceIdentity

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DeviceIdentity