`sys-proctable` 项目技术文档

以下是对 sys-proctable 项目的详细介绍和使用指南，帮助用户更好地安装、使用和理解该项目。

1. 安装指南

首先，确保你的系统满足以下先决条件：

• ffi
• rspec (仅限开发使用)
• rake (仅限开发使用)
• rubocop (仅限开发使用)

sys-proctable 支持以下平台：

• Windows 2000 或更高版本
• Linux 2.6+
• FreeBSD
• DragonflyBSD
• Solaris 8+
• OS X 10.7+
• AIX 5.3+

安装 sys-proctable 的最简单方式是使用以下命令：

gem install sys-proctable

对于版本 1.1.5 或更早版本，在某些情况下可能需要指定平台。例如：

gem install sys-proctable --platform mswin32 # Windows
gem install sys-proctable --platform sunos   # Solaris
gem install sys-proctable --platform linux   # Linux
gem install sys-proctable --platform freebsd # FreeBSD
gem install sys-proctable --platform darwin  # OS X

为了添加可信证书，使用以下命令：

gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/sys-proctable/main/certs/djberg96_pub.pem)

2. 项目的使用说明

sys-proctable 是一个 Ruby 接口，用于收集进程信息。以下是如何使用该项目的示例：

require 'sys/proctable'
include Sys

# 获取所有进程信息
ProcTable.ps{ |p|
  puts p.pid.to_s
  puts p.comm
  # ...
}

# 获取指定进程信息
s = ProcTable.ps(pid: 2123)
puts s.pid.to_s
puts s.comm
# ...

# 将结果作为 ProcTableStructs 数组返回
a = ProcTable.ps
a.each do |p|
  puts p.pid
  # ...
end

不同平台支持不同的选项。例如，在 Linux 上，你可以这样做以跳过收集 smaps 信息：

Sys::ProcTable.ps(smaps: false)

Windows 用户可以发送主机名以从不同的主机获取进程信息，这依赖于 WMI 服务正在运行。

Sys::ProcTable.ps(host: some_host)

3. 项目API使用文档

sys-proctable 提供了以下 API 用于获取进程信息：

• ProcTable.ps: 获取进程信息。可以接受多个选项来限制或修改返回的信息。

4. 项目安装方式

项目可以通过 Ruby 的宝石包管理器（gem）安装。请参考上述安装指南中的命令进行操作。

---

此文档提供了对 sys-proctable 项目的简要概述，详细文档和平台特定信息可以在项目的 doc 目录下找到。