Struct HardwareState 

pub struct HardwareState {

    pub captured_at: u64,
    pub machine: MachineIdentity,
    pub gpu_temp_c: Option<f64>,
    pub chassis_temps_c: Option<Vec<ThermalZone>>,
    pub sm_clock_mhz: Option<f64>,
    pub sm_clock_max_mhz: Option<f64>,
    pub throttle_counters: ThrottleCounters,
    pub throttle_active: ThrottleActive,
    pub mem_available_kb: Option<u64>,
    pub mem_total_kb: Option<u64>,
    pub page_cache_kb: Option<u64>,
    pub gpu_compute_apps: Option<Vec<GpuComputeApp>>,
    pub cpu_governor: Option<String>,
    pub persistence_mode: Option<bool>,
    pub sources: Vec<String>,
}

2026-09-26: Everything the collector could read about the box at one instant. The executor captures it before a run and again when the run’s terminal frame is ready; HardwareStateDelta is the difference.

Fields

captured_at: u64

2026-09-26: Unix seconds; 0 when the system clock reads before the epoch.

machine: MachineIdentity

gpu_temp_c: Option<f64>

chassis_temps_c: Option<Vec<ThermalZone>>

2026-09-26: Every /sys/class/thermal zone whose temperature parsed, in zone-number order. None means the directory could not be read, not “this box has no zones”.

sm_clock_mhz: Option<f64>

sm_clock_max_mhz: Option<f64>

throttle_counters: ThrottleCounters

throttle_active: ThrottleActive

mem_available_kb: Option<u64>

2026-09-26: MemAvailable from /proc/meminfo, kB.

mem_total_kb: Option<u64>

page_cache_kb: Option<u64>

2026-09-26: Cached from /proc/meminfo, kB.

gpu_compute_apps: Option<Vec<GpuComputeApp>>

2026-09-26: The --query-compute-apps rows. When that query prints nothing or fails, Some(vec![]) if --list-gpus answers, else None. The precheck warns on None and accepts an empty list.

cpu_governor: Option<String>

persistence_mode: Option<bool>

sources: Vec<String>

2026-09-26: Which collectors answered, from "nvidia-smi", "procfs" and "sysfs". Empty means none did.

Implementations

impl HardwareState

pub fn collect() -> Self

2026-09-26: Read the local box; see super::collect. A source that fails leaves its fields unset rather than failing the capture.

pub fn foreign_compute_apps(&self) -> Option<usize>

2026-09-26: GPU compute processes other than this process, so a server running in this process is not counted and a separate server process is. None when the list could not be read. The precheck refuses a Speed run above super::policy::MAX_FOREIGN_COMPUTE_APPS.

pub fn hottest_chassis_c(&self) -> Option<f64>

2026-09-26: The hottest chassis zone; None when no zone was read.

pub fn clock_headroom(&self) -> Option<f64>

2026-09-26: Current SM clock as a fraction of the box’s own maximum; None when either is missing or the maximum is not positive.

Meaningful only under load: the idle GB10 fixture reads 208 of 3003 MHz (fixtures/gb10_query_gpu.csv).

pub fn one_line(&self) -> String

2026-09-26: One line for a run log.

Trait Implementations

impl Clone for HardwareState

fn clone(&self) -> HardwareState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HardwareState

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

Formats the value using the given formatter.

impl Default for HardwareState

fn default() -> HardwareState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HardwareState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for HardwareState

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

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 HardwareState