sysinfo

sysinfo 是一个用于获取系统信息的 crate。

支持的操作系统

目前支持以下操作系统（按字母顺序排列）：

• 安卓
• FreeBSD
• iOS
• Linux
• macOS
• 树莓派
• Windows

你仍然可以在不支持的操作系统上使用 sysinfo，它只会什么都不做并始终返回空值。你可以通过检查 [IS_SUPPORTED_SYSTEM] 常量直接在程序中检查是否支持某个操作系统。

支持的最低 rustc 版本是 1.74。

使用方法

如果你想从旧版本迁移，不妨查看 CHANGELOG 和 迁移指南。

⚠️ 在尝试读取不同结构体的信息之前，你需要更新它们以获取最新信息，因为对于大多数情况，它是基于当前值和旧值之间的差异工作的。

这就是为什么保留同一个 [System] 实例比多次重新创建它要好得多。

你可以在 examples 文件夹中找到一个示例。你可以通过 cargo run --example simple 运行它。

否则，这里有一个简短的代码示例：

use sysinfo::{
    Components, Disks, Networks, System,
};

// 请注意，我们使用 "new_all" 来确保填充所有 CPU 和进程列表！
let mut sys = System::new_all();

// 首先我们更新 `System` 结构体的所有信息。
sys.refresh_all();

println!("=> 系统：");
// RAM 和交换分区信息：
println!("总内存：{} 字节", sys.total_memory());
println!("已用内存：{} 字节", sys.used_memory());
println!("总交换分区：{} 字节", sys.total_swap());
println!("已用交换分区：{} 字节", sys.used_swap());

// 显示系统信息：
println!("系统名称：{:?}", System::name());
println!("系统内核版本：{:?}", System::kernel_version());
println!("系统操作系统版本：{:?}", System::os_version());
println!("系统主机名：{:?}", System::host_name());

// CPU 数量：
println!("CPU 数量：{}", sys.cpus().len());

// 显示进程 ID、名称和磁盘使用情况：
for (pid, process) in sys.processes() {
    println!("[{pid}] {:?} {:?}", process.name(), process.disk_usage());
}

// 我们显示所有磁盘的信息：
println!("=> 磁盘：");
let disks = Disks::new_with_refreshed_list();
for disk in &disks {
    println!("{disk:?}");
}

// 网络接口名称、总接收数据和总发送数据：
let networks = Networks::new_with_refreshed_list();
println!("=> 网络：");
for (interface_name, data) in &networks {
    println!(
        "{interface_name}：{} B（下载）/ {} B（上传）",
        data.total_received(),
        data.total_transmitted(),
    );
    // 如果你想要自上次调用 `Networks::refresh` 以来接收/发送的数据量，
    // 使用 `received`/`transmitted`。
}

// 组件温度：
let components = Components::new_with_refreshed_list();
println!("=> 组件：");
for component in &components {
    println!("{component:?}");
}

请记住，要获取一些最新信息，你需要调用相应的 refresh 方法。例如，对于 CPU 使用率：

use sysinfo::System;

let mut sys = System::new();

loop {
    sys.refresh_cpu_usage(); // 刷新 CPU 使用率。
    for cpu in sys.cpus() {
        print!("{}% ", cpu.cpu_usage());
    }
    // 休眠一段时间，让系统运行足够长的时间以获得有用的信息。
    std::thread::sleep(sysinfo::MINIMUM_CPU_UPDATE_INTERVAL);
}

默认情况下，sysinfo 使用多线程。但是，这可能会增加某些平台（如 macOS）的内存使用。可以通过在 Cargo.toml 中设置 default-features = false（这会禁用 multithread cargo 特性）来禁用此行为。

最佳实践 / 性能提示

大多数情况下，你不需要 sysinfo 提供的所有信息，而只需要其中的一部分。在这种情况下，建议只使用 refresh_specifics(...) 方法获取你需要的内容，以获得更好的性能。

另一个经常遇到的问题：除非你知道自己在做什么，否则几乎总是最好实例化 System 结构体一次，并在整个程序中使用这个实例。原因是因为许多信息需要之前的测量才能计算（例如 CPU 使用率）。另一个例子说明为什么这样做更好：如果你想列出所有正在运行的进程，sysinfo 需要为 Process 结构体列表分配所有内存，这在第一次运行时需要相当长的时间。

如果你的程序需要使用大量文件描述符，最好使用：

sysinfo::set_open_files_limit(0);

因为 sysinfo 保持一定数量的文件描述符打开，以在某些目标上刷新进程时获得更好的性能。

在树莓派上运行

在树莓派上构建可能会有困难。一个好的解决方法是交叉编译，然后将可执行文件发送到你的树莓派。

首先安装 arm 工具链，例如在 Ubuntu 上：

> sudo apt-get install gcc-multilib-arm-linux-gnueabihf

然后配置 cargo 使用相应的工具链：

cat << EOF > ~/.cargo/config
[target.armv7-unknown-linux-gnueabihf]
linker = "arm-linux-gnueabihf-gcc"
EOF

最后，进行交叉编译：

rustup target add armv7-unknown-linux-gnueabihf
cargo build --target=armv7-unknown-linux-gnueabihf

Docker 上的 Linux 和 Windows 子系统 Linux（WSL）

虚拟 Linux 系统，如通过 Docker 和 Windows 子系统 Linux（WSL）运行的系统，不会通过 /sys/class/hwmon 或 /sys/class/thermal 接收主机硬件信息。因此，在虚拟系统上使用此库查询组件可能会返回无结果（或意外结果）。

在 macOS 或 iOS 沙盒/应用商店内运行的二进制文件中使用

苹果对通过应用商店分发的二进制文件可以链接的 API 有限制。默认情况下，sysinfo 与这些限制不兼容。你可以使用 apple-app-store 特性标志来禁用 Apple 禁止的功能。这也会启用 apple-sandbox 特性。对于在应用商店之外使用沙盒的应用程序，可以单独使用 apple-sandbox 特性来避免在运行时造成策略违反。

工作原理

我写了一篇博客文章，你可以在这里找到，解释了 sysinfo 如何在不同系统上提取信息。

C 接口

可以直接从 C 语言使用这个 crate。查看 Makefile 和 examples/simple.c 文件。

要构建 C 示例，只需运行：

> make
> ./simple
# 如果需要：
> LD_LIBRARY_PATH=target/debug/ ./simple

基准测试

你可以通过以下方式在本地运行基准测试（需要 rust nightly 版本）：

> cargo bench

捐赠

如果你欣赏我的工作并想支持我，你可以通过 github sponsors 或 patreon 进行捐赠。