Enum ArchTarget 

#[non_exhaustive]
pub enum ArchTarget {
    Gfx(GfxTarget),
    Sm(ComputeCapability),
    Xe(IntelArch),
    Apple(AppleFamily),
}

The architecture a prebuilt GPU artifact must target.

Each vendor names this differently but uses it the same way — to select a build the device can actually run — so one field carries whichever form applies. A GPU has at most one, which the type enforces.

use gpu_probe::{ArchTarget, GfxTarget};

let target = ArchTarget::Gfx(GfxTarget::new(10, 1, 3));
assert_eq!(target.to_string(), "gfx1013");
assert_eq!(target.gfx(), Some(GfxTarget::new(10, 1, 3)));
assert_eq!(target.sm(), None);

Deliberately not Ord: comparing an AMD target against an NVIDIA one has no meaning. Order within a vendor by matching out GfxTarget or ComputeCapability, both of which are ordered.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Gfx(GfxTarget)

AMD: the --offload-arch value a ROCm/HIP code object is built for.

Sm(ComputeCapability)

NVIDIA: the compute capability a CUDA artifact is built for.

Xe(IntelArch)

Intel: the GPU architecture family, from the PCI device id.

Apple(AppleFamily)

Apple: the Metal GPU family. A capability tier rather than a build target — see AppleFamily.

Implementations

impl ArchTarget

pub const fn gfx(self) -> Option<GfxTarget>

The AMD target, or None when this names another vendor’s.

pub const fn sm(self) -> Option<ComputeCapability>

The NVIDIA compute capability, or None when this names another vendor’s.

pub const fn xe(self) -> Option<IntelArch>

The Intel architecture family, or None when this names another vendor’s.

pub const fn apple(self) -> Option<AppleFamily>

The Apple GPU family, or None when this names another vendor’s.

Trait Implementations

impl Clone for ArchTarget

fn clone(&self) -> ArchTarget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ArchTarget

impl Debug for ArchTarget

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

Formats the value using the given formatter.

impl Display for ArchTarget

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

Renders in the form each vendor’s toolchain expects: gfx1013 for --offload-arch, sm_89 for CUDA.

impl Eq for ArchTarget

impl Hash for ArchTarget

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

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 ArchTarget

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ArchTarget