narsil 0.5.0

A terminal-based system resource monitor — GPU-aware, Braille charts, per-char label inversion
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

// Copyright (C) 2026 Raimo Geisel
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.

//! GPU monitoring data types and vendor dispatch.
//!
//! [`GpuEntry`] is vendor-agnostic. Actual collection is performed by the
//! [`amd`] sub-module (via sysfs), [`intel`] sub-module (via i915/xe sysfs on Linux,
//! DXGI on Windows), and, when the `nvidia` feature is enabled,
//! by the `nvidia` sub-module (via NVML).

#[cfg(target_os = "linux")]
pub mod amd;

#[cfg(target_os = "linux")]
pub mod intel;

#[cfg(target_os = "windows")]
pub mod windows_amd;

#[cfg(target_os = "windows")]
pub mod windows_intel;

#[cfg(target_os = "macos")]
pub mod macos_intel;

#[cfg(feature = "nvidia")]
pub mod nvidia;

use super::HISTORY_LEN;

/// Vendor-agnostic snapshot of a single GPU.
#[derive(Debug)]
pub struct GpuEntry {
    /// Human-readable display name (e.g. `"AMD Radeon RX 7900 XTX"`).
    pub name: String,
    /// 3D/compute engine load (0.0–100.0 %).
    pub utilization: f32,
    /// Memory currently allocated, in bytes.
    pub mem_used: u64,
    /// Total available memory, in bytes.
    pub mem_total: u64,
    /// When `true` the memory figures come from the GTT pool (shared system
    /// RAM used by an AMD APU) rather than dedicated on-board VRAM.
    pub mem_is_gtt: bool,
    /// Die temperature in °C, if the driver exposes it.
    pub temperature: Option<u32>,
    /// Power draw in watts, if the driver exposes it.
    pub power_watts: Option<f32>,
    /// 60-sample rolling history of [`utilization`][GpuEntry::utilization].
    pub util_history: Vec<f32>,
    /// 60-sample rolling history of memory utilisation percentage.
    pub mem_history: Vec<f32>,
}

impl GpuEntry {
    /// Creates a zeroed [`GpuEntry`] with the given display `name`.
    pub fn new(name: String) -> Self {
        Self {
            name,
            utilization: 0.0,
            mem_used: 0,
            mem_total: 0,
            mem_is_gtt: false,
            temperature: None,
            power_watts: None,
            util_history: vec![0.0; HISTORY_LEN],
            mem_history: vec![0.0; HISTORY_LEN],
        }
    }
}