RadeonTop 技术文档

1. 安装指南

在开始使用 RadeonTop 之前，您需要确保系统中已经安装了以下依赖项：

• libdrm
• libncurses
• libpciaccess
• libxcb

如果您的系统是基于 Debian 或 Ubuntu 的，可以使用以下命令安装这些依赖项：

sudo apt-get update
sudo apt-get install libdrm-dev libncurses5-dev libpciaccess-dev libxcb1-dev

安装完依赖项之后，您可以从 RadeonTop 的源代码开始构建。

2. 项目的使用说明

RadeonTop 用于查看 GPU 利用率，包括总活动百分比和各个区块的使用情况。运行 RadeonTop 需要访问 /dev/dri/cardN 文件或 /dev/mem（需要 root 权限）。

要运行 RadeonTop，只需要在终端中输入以下命令：

./radeontop

RadeonTop 将自动选择第一个支持的 GPU。

如果您需要指定特定的总线地址（如 bus 0f），可以使用以下命令：

./radeontop -b 0f

如果希望将值输出到标准输出而不是显示 GUI，可以使用以下命令：

./radeontop -d -

要查看所有可用选项，可以运行：

./radeontop --help

3. 项目API使用文档

RadeonTop 主要是一个命令行工具，不提供传统意义上的 API。所有的功能都是通过命令行参数进行控制。以下是一些常用的命令行参数：

• -b <bus>：指定 GPU 的总线地址。
• -d：将输出重定向到标准输出。
• -h 或 --help：显示帮助信息。

4. 项目安装方式

要安装 RadeonTop，您需要从源代码开始构建。构建之前，请确保已经安装了所有必要的依赖项。

以下是一个基本的构建过程：

make

如果您需要自定义构建选项，可以使用以下变量：

• nls：启用翻译，默认开启。
• debug：启用调试符号，默认关闭。
• nostrip：禁用剥离，默认关闭。
• plain：不应用 -g 或 -s 选项。
• xcb：启用 libxcb 支持，默认开启。
• amdgpu：启用 amdgpu 使用报告，默认自动（需要 libdrm >= 2.4.63）。

例如，以下命令将构建带有 amdgpu 报告和 xcb 支持的 RadeonTop：

make amdgpu=1 xcb=1

构建完成后，您可以通过运行 ./radeontop 命令来启动 RadeonTop。