sysinfo 0.38.4

Library to get system information such as processes, CPUs, disks, components and networks
Documentation
// Take a look at the license at the top of the repository in the LICENSE file.

use crate::sys::utils::{
    get_sys_value_array, get_sys_value_by_name, get_sys_value_str, get_sys_value_str_by_name,
};
use crate::{Cpu, CpuRefreshKind};

use super::ffi;

use libc::c_long;

pub(crate) struct CpusWrapper {
    pub(crate) global_cpu_usage: f32,
    pub(crate) cpus: Vec<Cpu>,
    got_cpu_frequency: bool,
    // For the global CPU usage.
    global_cp_times: VecSwitcher,
    // For each CPU usage.
    cp_times: Vec<VecSwitcher>,
    nb_cpus: usize,
}

impl CpusWrapper {
    pub(crate) fn new() -> Self {
        unsafe {
            let nb_cpus = super::utils::get_nb_cpus();
            Self {
                global_cpu_usage: 0.,
                cpus: Vec::with_capacity(nb_cpus),
                got_cpu_frequency: false,
                global_cp_times: VecSwitcher::new(vec![0; ffi::CPUSTATES]),
                cp_times: std::iter::repeat_with(|| VecSwitcher::new(vec![0; ffi::CPUSTATES]))
                    .take(nb_cpus)
                    .collect(),
                nb_cpus,
            }
        }
    }

    pub(crate) fn refresh(&mut self, refresh_kind: CpuRefreshKind) {
        if self.cpus.is_empty() {
            // We get the CPU vendor ID in here.
            let vendor_id = unsafe {
                get_sys_value_str(&[libc::CTL_HW, ffi::HW_MODEL])
                    .unwrap_or_else(|| "<unknown>".to_owned())
            };
            let brand = get_sys_value_str_by_name(b"machdep.cpu_brand\0")
                .unwrap_or_else(|| "<unknown>".to_owned());

            for pos in 0..self.nb_cpus {
                self.cpus.push(Cpu {
                    inner: CpuInner::new(format!("cpu {pos}"), vendor_id.clone(), brand.clone(), 0),
                });
            }
            if refresh_kind.frequency() {
                unsafe {
                    get_cpu_frequencies(&mut self.cpus);
                }
                self.got_cpu_frequency = true;
            }
        } else if refresh_kind.frequency() && !self.got_cpu_frequency {
            unsafe {
                get_cpu_frequencies(&mut self.cpus);
            }
            self.got_cpu_frequency = true;
        }
        if refresh_kind.cpu_usage() {
            self.get_cpu_usage();
        }
    }

    fn get_cpu_usage(&mut self) {
        let global_cp_times = self.global_cp_times.get_mut();
        for (pos, (cpu, cp_times)) in self
            .cpus
            .iter_mut()
            .zip(self.cp_times.iter_mut())
            .enumerate()
        {
            unsafe {
                if !get_sys_value_array(
                    &[ffi::CTL_KERN, libc::KERN_CP_TIME, pos as _],
                    cp_times.get_mut(),
                ) {
                    sysinfo_debug!(
                        "wrong CPU time computation, skipping it. Likely invalid CPU usage result"
                    );
                    continue;
                }
            }

            cpu.inner.cpu_usage = cp_times.compute_cpu_usage();

            let new_cp_times = cp_times.get_new();
            global_cp_times[ffi::CP_USER] += new_cp_times[ffi::CP_USER];
            global_cp_times[ffi::CP_NICE] += new_cp_times[ffi::CP_NICE];
            global_cp_times[ffi::CP_SYS] += new_cp_times[ffi::CP_SYS];
            global_cp_times[ffi::CP_INTR] += new_cp_times[ffi::CP_INTR];
            global_cp_times[ffi::CP_IDLE] += new_cp_times[ffi::CP_IDLE];
        }
        for global_cp_time in global_cp_times {
            *global_cp_time /= self.cpus.len() as u64;
        }
        self.global_cpu_usage = self.global_cp_times.compute_cpu_usage();
    }
}

pub(crate) struct CpuInner {
    pub(crate) cpu_usage: f32,
    name: String,
    pub(crate) vendor_id: String,
    pub(crate) brand: String,
    pub(crate) frequency: u64,
}

impl CpuInner {
    pub(crate) fn new(name: String, vendor_id: String, brand: String, frequency: u64) -> Self {
        Self {
            cpu_usage: 0.,
            name,
            vendor_id,
            frequency,
            brand,
        }
    }

    pub(crate) fn cpu_usage(&self) -> f32 {
        self.cpu_usage
    }

    pub(crate) fn name(&self) -> &str {
        &self.name
    }

    pub(crate) fn frequency(&self) -> u64 {
        self.frequency
    }

    pub(crate) fn vendor_id(&self) -> &str {
        &self.vendor_id
    }

    pub(crate) fn brand(&self) -> &str {
        &self.brand
    }
}

pub(crate) fn physical_core_count() -> Option<usize> {
    let mut physical_core_count: u32 = 0;

    unsafe {
        if get_sys_value_by_name(b"hw.ncpu\0", &mut physical_core_count) {
            Some(physical_core_count as _)
        } else {
            None
        }
    }
}

// "newer" way to get CPU frequency.
unsafe fn get_cpu_frequencies_newer(cpus: &mut [Cpu]) -> bool {
    let mut freq: c_long = 0;

    for (cpu_nb, cpu) in cpus.iter_mut().enumerate() {
        unsafe {
            if !get_sys_value_by_name(
                format!("machdep.cpufreq.cpu{cpu_nb}.current\0").as_bytes(),
                &mut freq,
            ) {
                cpu.inner.frequency = 0;
                return false;
            }
            cpu.inner.frequency = freq as _;
        }
    }
    true
}

unsafe fn get_cpu_frequencies(cpus: &mut [Cpu]) {
    unsafe {
        if get_cpu_frequencies_newer(cpus) {
            // We got our frequencies, nothing more to be done.
            return;
        }
    }
    // Now we try our luck through legacy `sysctl` calls.
    const FREQ_SYSCTLS: &[(&[u8], u64)] = &[
        (b"machdep.est.frequency.current", 1),
        (b"machdep.powernow.frequency.current", 1),
        (b"machdep.intrepid.frequency.current", 1),
        (b"machdep.loongson.frequency.current", 1),
        (b"machdep.cpu.frequency.current", 1),
        (b"machdep.frequency.current", 1),
        (b"machdep.tsc_freq", 1000000),
    ];

    let mut freq: c_long = 0;
    for (freq_sysctl, scale) in FREQ_SYSCTLS {
        unsafe {
            if get_sys_value_by_name(freq_sysctl, &mut freq) {
                // Scaling to MHz.
                let freq = freq as u64 / *scale;
                for cpu in cpus {
                    cpu.inner.frequency = freq;
                }
                return;
            }
        }
    }
    sysinfo_debug!("failed to retrieve CPUs frequency");
}

/// This struct is used to switch between the "old" and "new" every time you use "get_mut".
#[derive(Debug)]
pub(crate) struct VecSwitcher {
    v1: Vec<u64>,
    v2: Vec<u64>,
    total: u64,
    first: bool,
}

impl VecSwitcher {
    fn new(v1: Vec<u64>) -> Self {
        let v2 = v1.clone();

        Self {
            v1,
            v2,
            total: 0,
            first: true,
        }
    }

    fn get_mut(&mut self) -> &mut [u64] {
        self.first = !self.first;
        if self.first {
            // It means that `v2` will be the "new".
            &mut self.v2
        } else {
            // It means that `v1` will be the "new".
            &mut self.v1
        }
    }

    fn get_old(&self) -> &[u64] {
        if self.first { &self.v1 } else { &self.v2 }
    }

    fn get_new(&self) -> &[u64] {
        if self.first { &self.v2 } else { &self.v1 }
    }

    fn compute_cpu_usage(&mut self) -> f32 {
        let new_cp_times = self.get_new();
        let old_cp_times = self.get_old();
        let new_total: u64 = new_cp_times.iter().sum();
        let mut total_time = new_total.saturating_sub(self.total);
        if total_time < 1 {
            total_time = 1;
        }
        let total = total_time as f32;

        let nice =
            new_cp_times[ffi::CP_NICE].saturating_sub(old_cp_times[ffi::CP_NICE]) as f32 / total;
        let user =
            new_cp_times[ffi::CP_USER].saturating_sub(old_cp_times[ffi::CP_USER]) as f32 / total;
        let kernel =
            new_cp_times[ffi::CP_SYS].saturating_sub(old_cp_times[ffi::CP_SYS]) as f32 / total;
        let intr =
            new_cp_times[ffi::CP_INTR].saturating_sub(old_cp_times[ffi::CP_INTR]) as f32 / total;

        self.total = new_total;

        (nice + user + kernel + intr) * 100.
    }
}