Struct DeviceInfo 

pub struct DeviceInfo {
    pub device: String,
    pub name: String,
    pub mem_bytes: u64,
    pub unified: bool,
    pub gflops: f64,
    pub available: bool,
}

A compute device present on a node, with its usable memory.

Fields

device: String

RLX device label (cpu, metal, cuda, ane/NPU, vulkan, …). Stored as its canonical string so NodeCaps stays plainly (de)serializable.

name: String

Human name (e.g. “Apple M4 Pro”, “NVIDIA RTX 3080 Ti”).

mem_bytes: u64

Dedicated device memory in bytes (0 / host-RAM for unified/iGPU).

unified: bool

True when the device shares host RAM (Apple unified, iGPU) — no separate VRAM ceiling, but it competes with the CPU stage for the same pool.

gflops: f64

Measured f32 matmul throughput on THIS device (GFLOP/s), 0 when the backend is not built in or the bench did not run.

Placement needs this per device, not per node: ranking a machine by its CPU tells you nothing about the 4090 it will actually run the stage on.

available: bool

True when the node’s own build can actually target this device.

The OS reporting a GPU and the binary being able to run on it are different facts: a build without the metal feature still sees an M4 Pro, but every Session::new(Metal) on it panics. Recording that here keeps the distinction visible — the alternative, leaving gflops at 0.0, reads to a planner as “present but infinitely slow” and to a human as a benchmark failure, when the real answer is “rebuild with --features metal”.

Implementations

impl DeviceInfo

pub fn parsed(&self) -> Option<Device>

Parsed device kind, or None when this coordinator does not recognise the label.

Worth distinguishing: nodes report whatever their own rlx build calls a device, so a cluster running mixed versions can send back a name this binary has never heard of. Collapsing that to Cpu — as Self::kind must, to keep its infallible signature — makes an unrecognised accelerator invisible: the planner skips it as though it were the host CPU and ignores its memory.

pub fn kind(&self) -> Device

Parsed device kind, falling back to CPU for an unrecognised label.

Prefer Self::parsed where “unrecognised” and “CPU” mean different things — which is most places.

pub fn is_recognized(&self) -> bool

True when this coordinator understands the reported device.

pub fn is_usable(&self) -> bool

True when a stage may be placed here: recognised by this coordinator and runnable by the node that reported it.

Trait Implementations

impl Clone for DeviceInfo

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DeviceInfo

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DeviceInfo

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DeviceInfo

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 DeviceInfo