Struct Hardware 

pub struct Hardware {
    pub gpu: String,
    pub driver: String,
    pub sm_clock_mhz: Option<f64>,
    pub gpu_count: Option<u32>,
    pub source: String,
}

2026-09-26: A box’s fingerprint, as its serving endpoint reported it or as Hardware::probe read it.

Fields

gpu: String

2026-09-26: Device model, e.g. “NVIDIA GB10”, or pci:<vendor>:<device> from sysfs. Empty when unknown.

driver: String

2026-09-26: Driver version, e.g. “580.126.09”. Empty when unknown.

sm_clock_mhz: Option<f64>

2026-09-26: GPU clock in MHz at probe time: nvidia-smi’s clocks.sm, or the clock rocm-smi --showclocks reports. None for [N/A], an unparseable cell, and every sysfs reading.

gpu_count: Option<u32>

2026-09-26: How many GPUs the box exposed at probe time, counted from nvidia-smi -L (parse::gpu_count); gpu names only the first. None means unmeasured, never one: rocm-smi and sysfs leave it None, and it is left out of the JSON.

source: String

2026-09-26: Where the reading came from (“nvidia-smi”, “rocm-smi”, “sysfs”). Empty when unknown.

Implementations

impl Hardware

pub fn unknown() -> Self

pub fn gate_key(&self) -> String

2026-09-26: The box-class key a gate baseline is indexed by, e.g. "gb10": a class, not a host.

A name with a token in the SKU table (ids::hardware_id_from_gpu_name) gets that id, so "NVIDIA H100 80GB HBM3" is h100. Any other name is lowercased with nvidia and amd removed and only alphanumerics kept. An empty gpu, or a name that leaves nothing, gives "unknown", which no baseline defines; fetch_hardware returns Hardware::unknown on every error path without surfacing one.

pub fn is_unknown(&self) -> bool

2026-09-26: True when gpu, driver and sm_clock_mhz are all empty; gpu_count and source are not consulted.

pub fn one_line(&self) -> String

2026-09-26: One-line summary for reports, e.g. “NVIDIA GB10 · driver 580.126.09 · sm 208 MHz”; a GPU count above one follows the part as ×n.

pub fn probe() -> Self

2026-09-26: Probe the local box: nvidia-smi, then rocm-smi, then sysfs, returning the first that answers, or Hardware::unknown.

Trait Implementations

impl Clone for Hardware

fn clone(&self) -> Hardware

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hardware

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

Formats the value using the given formatter.

impl Default for Hardware

fn default() -> Hardware

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Hardware

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Hardware

fn eq(&self, other: &Hardware) -> 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 Serialize for Hardware

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Hardware