Struct Component

pub struct Component { /* private fields */ }

Available on crate feature dep_sysinfo only.

Getting a component temperature information.

use sysinfo::Components;

let components = Components::new_with_refreshed_list();
for component in &components {
    if let Some(temperature) = component.temperature() {
        println!("{} {temperature}°C", component.label());
    } else {
        println!("{} (unknown temperature)", component.label());
    }
}

Implementations

impl Component

pub fn temperature(&self) -> Option<f32>

Returns the temperature of the component (in celsius degree).

Linux

Returns f32::NAN if it failed to retrieve it.

use sysinfo::Components;

let components = Components::new_with_refreshed_list();
for component in &components {
    if let Some(temperature) = component.temperature() {
        println!("{temperature}°C");
    }
}

pub fn max(&self) -> Option<f32>

Returns the maximum temperature of the component (in celsius degree).

Note: if temperature is higher than the current max, max value will be updated on refresh.

Linux

May be computed by sysinfo from kernel. Returns f32::NAN if it failed to retrieve it.

use sysinfo::Components;

let components = Components::new_with_refreshed_list();
for component in &components {
    if let Some(max) = component.max() {
        println!("{max}°C");
    }
}

pub fn critical(&self) -> Option<f32>

Returns the highest temperature before the component halts (in celsius degree).

Linux

Critical threshold defined by chip or kernel.

use sysinfo::Components;

let components = Components::new_with_refreshed_list();
for component in &components {
    if let Some(critical) = component.critical() {
        println!("{critical}°C");
    }
}

pub fn label(&self) -> &str

Returns the label of the component.

Linux

Since components information is retrieved thanks to hwmon, the labels are generated as follows. Note: it may change and it was inspired by sensors own formatting.

name	label	device_model	id_sensor	Computed label by sysinfo
✓	✓	✓	✓	"{name} {label} {device_model} temp{id}"
✓	✓	✗	✓	"{name} {label} {id}"
✓	✗	✓	✓	"{name} {device_model}"
✓	✗	✗	✓	"{name} temp{id}"

use sysinfo::Components;

let components = Components::new_with_refreshed_list();
for component in &components {
    println!("{}", component.label());
}

pub fn refresh(&mut self)

Refreshes component.

use sysinfo::Components;

let mut components = Components::new_with_refreshed_list();
for component in components.iter_mut() {
    component.refresh();
}

Trait Implementations

impl Debug for Component

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

Formats the value using the given formatter.