Rust系统进程信息库darwin-libproc-sys使用指南

简介

darwin-libproc-sys是一个Rust库，提供了对macOS系统libproc库的绑定，允许开发者在macOS平台下高效获取进程状态和系统调用信息。这个库特别适合需要监控或管理系统进程的应用程序开发。

主要功能

• 获取进程列表
• 查询进程信息（名称、PID、状态等）
• 获取进程路径
• 查询线程信息
• 获取系统调用信息

安装

在Cargo.toml中添加依赖：

[dependencies]
darwin-libproc-sys = "0.1"

基本使用方法

1. 获取所有进程ID

use darwin_libproc_sys::proc;

fn main() {
    let pids = proc::listpids(proc::ProcType::ProcAllPIDS, 0).unwrap();
    println!("Running processes: {:?}", pids);
}

2. 获取进程信息

use darwin_libproc_sys::proc;

fn main() {
    let pid = 1234; // 替换为你想查询的PID
    let info = proc::pidinfo::<proc::ProcTaskAllInfo>(pid, 0).unwrap();
    println!("Process {} info: {:?}", pid, info);
}

3. 获取进程路径

use darwin_libproc_sys::proc;

fn main() {
    let pid = 1234; // 替换为你想查询的PID
    let path = proc::pidpath(pid).unwrap();
    println!("Process {} path: {}", pid, path);
}

4. 获取进程名称

use darwin_libproc_sys::proc;

fn main() {
    let pid = 1234; // 替换为你想查询的PID
    let name = proc::name(pid).unwrap();
    println!("Process {} name: {}", pid, name);
}

高级用法

获取线程信息

use darwin_libproc_sys::proc;

fn main() {
    let pid = 1234; // 替换为你想查询的PID
    let threads = proc::listpidthreads(pid).unwrap();
    println!("Threads for process {}: {:?}", pid, threads);
    
    for tid in threads {
        let thread_info = proc::threadinfo(pid, tid).unwrap();
        println!("Thread {} info: {:?}", tid, thread_info);
    }
}

监控进程状态变化

use darwin_libproc_sys::proc;
use std::thread;
use std::time::Duration;

fn monitor_process(pid: i32) {
    loop {
        match proc::pidinfo::<proc::ProcTaskAllInfo>(pid, 0) {
            Ok(info) => {
                println!("Process {} status: {:?}", pid, info.pbsd.pbi_status);
            },
            Err(e) => {
                println!("Error or process ended: {}", e);
                break;
            }
        }
        thread::sleep(Duration::from_secs(1));
    }
}

完整示例Demo

以下是一个结合多个功能的完整示例，演示如何监控特定进程的状态变化：

use darwin_libproc_sys::proc;
use std::thread;
use std::time::Duration;

fn main() {
    // 获取当前所有进程列表
    let all_pids = proc::listpids(proc::ProcType::ProcAllPIDS, 0).unwrap();
    println!("当前系统进程数: {}", all_pids.len());

    // 获取第一个进程的详细信息作为示例
    if let Some(&pid) = all_pids.first() {
        println!("\n监控进程 {} 的详细信息:", pid);
        
        // 获取并显示进程名称
        if let Ok(name) = proc::name(pid) {
            println!("进程名称: {}", name);
        }
        
        // 获取并显示进程路径
        if let Ok(path) = proc::pidpath(pid) {
            println!("进程路径: {}", path);
        }
        
        // 获取并显示进程完整信息
        if let Ok(info) = proc::pidinfo::<proc::ProcTaskAllInfo>(pid, 0) {
            println!("进程状态: {:?}", info.pbsd.pbi_status);
            println!("进程优先级: {}", info.ptinfo.pti_priority);
        }
        
        // 监控进程状态变化
        println!("\n开始监控进程状态变化...");
        monitor_process(pid);
    }
}

fn monitor_process(pid: i32) {
    let mut prev_status = None;
    
    loop {
        match proc::pidinfo::<proc::ProcTaskAllInfo>(pid, 0) {
            Ok(info) => {
                // 只在状态变化时打印
                if prev_status != Some(info.pbsd.pbi_status) {
                    println!("[PID {}] 状态变化: {:?}", pid, info.pbsd.pbi_status);
                    prev_status = Some(info.pbsd.pbi_status);
                }
            },
            Err(e) => {
                println!("错误或进程已结束: {}", e);
                break;
            }
        }
        thread::sleep(Duration::from_secs(1));
    }
}

注意事项

1. 需要macOS系统支持
2. 某些操作可能需要root权限
3. 错误处理很重要，因为进程可能在任何时候终止
4. 频繁查询可能会影响系统性能

性能建议

• 批量获取信息而不是单个查询
• 缓存不常变化的信息
• 合理设置轮询间隔

这个库为macOS系统进程监控和管理提供了强大的底层支持，可以用于开发系统监控工具、调试工具或任务管理器等应用。