Struct scaphandre::sensors::Domain

pub struct Domain {
    pub id: u16,
    pub name: String,
    pub counter_uj_path: String,
    pub record_buffer: Vec<Record>,
    pub buffer_max_kbytes: u16,
}

Domain struct represents a part of a CPUSocket from the electricity consumption point of view.

Fields

id: u16

Numerical ID of the RAPL domain as indicated in /sys/class/powercap/intel-rapl* folders names

name: String

Name of the domain as found in /sys/class/powercap/intel-rapl:X:X/name

counter_uj_path: String

Path to the domain’s energy counter file, microjoules extracted

record_buffer: Vec<Record>

History of energy consumption measurements, stored as Record instances

buffer_max_kbytes: u16

Maximum size of record_buffer, in kilobytes

Implementations

impl Domain

pub fn read_counter_uj(&self) -> Result<String, Box<dyn Error>>

Reads content of this domain’s energy_uj file

pub fn read_record_uj(&self) -> Result<Record, Box<dyn Error>>

pub fn get_records_diff_power_microwatts(&self) -> Option<Record>

Returns a Record instance containing the power consumed between last and previous measurement, in microwatts.

Trait Implementations

impl Clone for Domain

fn clone(&self) -> Domain

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Domain

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

Formats the value using the given formatter.

impl Display for Domain

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

Formats the value using the given formatter.

impl RecordGenerator for Domain

fn refresh_record(&mut self)

Computes a measurement of energy comsumption for this CPU domain, stores a copy in self.record_buffer and returns it.

fn clean_old_records(&mut self)

Removes as many Record instances from self.record_buffer as needed for record_buffer to take less than ‘buffer_max_kbytes’ in memory

fn get_records_passive(&self) -> Vec<Record>

Returns a copy of self.record_buffer