Rust系统信息工具库uu_uname使用指南

uu_uname是一个跨平台的Rust库和命令行工具，用于获取系统名称、版本和硬件信息，类似于Unix系统中的uname命令。

功能特性

• 跨平台支持（Linux, macOS, Windows等）
• 获取系统内核名称
• 获取系统主机名
• 获取内核版本
• 获取系统架构信息
• 提供命令行工具和库两种使用方式

安装方法

作为命令行工具安装

cargo install uu_uname

作为库添加到项目

在Cargo.toml中添加依赖：

[dependencies]
uu_uname = "0.0.4"  # 请使用最新版本

命令行使用

基本用法：

uu_uname [选项]

常用选项：

• -a, --all：显示所有信息
• -s, --kernel-name：显示内核名称
• -n, --nodename：显示网络节点主机名
• -r, --kernel-release：显示内核版本
• -v, --kernel-version：显示内核版本详细信息
• -m, --machine：显示机器硬件名称
• -p, --processor：显示处理器类型
• -i, --hardware-platform：显示硬件平台
• -o, --operating-system：显示操作系统名称

示例：

# 显示所有信息
uu_uname -a

# 只显示内核名称和版本
uu_uname -s -r

# 显示机器硬件名称
uu_uname -m

作为库使用示例

use uu_uname::Uname;

fn main() {
    // 获取系统信息
    let info = Uname::new().unwrap();
    
    // 打印所有信息
    println!("System information:");
    println!("Kernel name: {}", info.kernel_name());
    println!("Hostname: {}", info.nodename());
    println!("Kernel release: {}", info.kernel_release());
    println!("Kernel version: {}", info.kernel_version());
    println!("Machine: {}", info.machine());
    println!("Operating system: {}", info.operating_system());
    
    // 也可以直接格式化输出
    println!("\nFormatted output:");
    println!("{}", info);
}

高级用法

自定义输出格式

use uu_uname::{Uname, Format};

fn main() {
    let info = Uname::new().unwrap();
    
    // 创建自定义格式
    let format = Format {
        kernel_name: true,
        nodename: true,
        kernel_release: false,
        kernel_version: false,
        machine: true,
        operating_system: true,
        all: false,
    };
    
    // 按自定义格式输出
    println!("Custom output: {}", info.format(format));
}

错误处理

use uu_uname::Uname;

fn main() {
    match Uname::new() {
        Ok(info) => {
            println!("System info: {}", info);
        },
        Err(e) => {
            eprintln!("Failed to get system information: {}", e);
        }
    }
}

跨平台注意事项

不同平台返回的信息可能有所差异：

• Linux系统通常能提供所有信息
• macOS可能缺少部分字段
• Windows系统返回的信息格式与其他平台不同

完整示例demo

下面是一个完整的示例程序，展示了如何使用uu_uname库获取系统信息并进行格式化输出：

use uu_uname::{Uname, Format};

fn main() {
    // 获取系统信息并进行错误处理
    match Uname::new() {
        Ok(info) => {
            // 示例1：基本用法 - 打印所有系统信息
            println!("=== 基本系统信息 ===");
            println!("操作系统: {}", info.operating_system());
            println!("内核名称: {}", info.kernel_name());
            println!("主机名: {}", info.nodename());
            println!("内核版本: {}", info.kernel_release());
            println!("机器架构: {}", info.machine());
            
            // 示例2：直接格式化输出
            println!("\n=== 格式化输出 ===");
            println!("{}", info);
            
            // 示例3：自定义输出格式
            println!("\n=== 自定义输出 ===");
            let custom_format = Format {
                kernel_name: true,
                nodename: false,  // 不显示主机名
                kernel_release: true,
                kernel_version: false,
                machine: true,
                operating_system: false,
                all: false,
            };
            println!("精简信息: {}", info.format(custom_format));
            
            // 示例4：模拟uname -a的输出
            println!("\n=== 完整信息(uname -a样式) ===");
            let full_format = Format {
                all: true,  // 显示所有可用信息
                ..Default::default()
            };
            println!("{}", info.format(full_format));
        },
        Err(e) => {
            eprintln!("错误: 无法获取系统信息 - {}", e);
            std::process::exit(1);
        }
    }
}

总结

uu_uname是一个简单易用的系统信息工具，无论是作为命令行工具快速查看系统信息，还是作为库集成到Rust项目中，都能提供良好的跨平台支持。