Linux RDMA命令行工具使用手册

[1. 概述](#1. 概述)
[2. 安装与验证](#2. 安装与验证)
[3. 基本语法](#3. 基本语法)
[4. 全局选项](#4. 全局选项)
[5. 设备管理 (rdma dev)](#5. 设备管理 (rdma dev))
[6. 链路管理 (rdma link)](#6. 链路管理 (rdma link))
[7. 资源追踪 (rdma resource)](#7. 资源追踪 (rdma resource))
[8. 系统配置 (rdma system)](#8. 系统配置 (rdma system))
[9. 统计与计数器 (rdma statistic)](#9. 统计与计数器 (rdma statistic))
[10. 事件监控 (rdma monitor)](#10. 事件监控 (rdma monitor))
[11. 实战场景](#11. 实战场景)
[12. 故障排查](#12. 故障排查)
[13. 快速参考](#13. 快速参考)
[14. 相关资源](#14. 相关资源)

1. 概述

rdma 是 Linux 系统中用于管理 RDMA（Remote Direct Memory Access，远程直接内存访问） 子系统的命令行工具。RDMA 是一种高性能网络通信技术，允许应用程序直接在远程系统的内存中进行读写操作，绕过操作系统内核和 CPU，从而实现极低延迟、高吞吐量、低 CPU 占用的网络通信。

1.1 应用场景

场景	说明
高性能计算 (HPC)	MPI 通信、大规模并行计算集群
数据中心存储	NVMe over Fabrics、iSER (iSCSI over RDMA)
分布式数据库	低延迟节点间通信
金融交易系统	微秒级交易传输
虚拟化与容器	SR-IOV RDMA 直通、网络命名空间隔离

1.2 支持的 RDMA 技术

InfiniBand (IB): 专用的 RDMA 网络，高带宽低延迟
RoCE (RDMA over Converged Ethernet): 在以太网上运行 RDMA
iWARP: 在 TCP/IP 上运行 RDMA

1.3 命令结构

rdma 工具包含以下六个主要子命令：

子命令	功能
`rdma dev`	设备管理（重命名、命名空间、中断调解）
`rdma link`	链路管理（查看状态、创建/删除软 RDMA）
`rdma resource`	资源追踪（QP、CQ、MR、PD 等）
`rdma system`	系统配置（命名空间模式、特权 QKEY）
`rdma statistic`	统计与计数器管理
`rdma monitor`	事件监控

2. 安装与验证

2.1 安装

rdma 工具包含在 iproute2 软件包中，大多数 Linux 发行版已预装：

bash 复制代码

# Debian/Ubuntu
sudo apt install iproute2

# RHEL/CentOS/Fedora
sudo dnf install iproute

# Arch Linux
sudo pacman -S iproute2

2.2 验证安装

bash 复制代码

rdma -V

2.3 加载内核模块

bash 复制代码

# 检查内核模块是否加载
lsmod | grep -E "ib_core|mlx5_ib|rdma_rxe|siw"

# 加载必要的内核模块
sudo modprobe ib_core
sudo modprobe rdma_rxe    # 软件 RoCE
sudo modprobe siw         # 软件 iWARP

3. 基本语法

bash 复制代码

rdma [ OPTIONS ] OBJECT { COMMAND | help }
rdma [ -force ] -batch filename

参数说明：

OBJECT: 指定要操作的对象类型（dev、link、resource、system、statistic、monitor）
COMMAND: 指定要执行的操作（show、set、add、delete、bind、unbind 等）
help: 打印该对象的可用命令列表和参数语法

对象缩写： 所有对象名称支持缩写匹配，例如 stats 可缩写为 stat 或 s。

默认命令： 如果未指定 COMMAND，将执行默认命令（通常为 show 或 list）。

4. 全局选项

以下选项适用于所有 rdma 子命令：

选项	完整形式	说明
`-V`	`-Version`	打印 rdma 工具版本号并退出
`-d`	`--details`	输出详细信息；重复使用（`-dd`）可包含驱动级详情
`-r`	`--raw`	以原始格式输出驱动级详细信息
`-j`	`--json`	以 JSON 格式输出
`-p`	`--pretty`	与 `-j` 组合使用，生成格式化（美化）的 JSON 输出
`-o`	`-oneline`	每条记录输出为一行，用 `\` 替换换行符
`-b`	`-batch <FILE>`	从文件或标准输入读取命令并逐条执行
`-force`	`-force`	批处理模式下遇到错误不终止执行

4.1 输出格式示例

bash 复制代码

# 查看详细设备信息
rdma -d dev show

# 以 JSON 格式输出
rdma -j dev show

# 以美化的 JSON 格式输出（便于阅读）
rdma -jp dev show

# 单行输出（便于脚本处理）
rdma -o link show

# 查看驱动级原始数据
rdma -r resource show qp

4.2 批处理模式

bash 复制代码

# 从文件执行命令
rdma -batch commands.txt

# 从标准输入执行
echo "dev show" | rdma -batch -

# 忽略错误继续执行
rdma -force -batch commands.txt

批处理文件示例（commands.txt）：

复制代码

dev show
link show
resource show
system show
statistic show

5. 设备管理 (rdma dev)

rdma dev 用于查看和管理 RDMA 设备的基本属性。

5.1 查看设备信息

语法：

bash 复制代码

rdma dev show [ DEV ]

参数：

参数	说明
`DEV`	指定要查看的设备名。省略则列出所有设备

示例：

bash 复制代码

# 列出所有 RDMA 设备
rdma dev show

# 查看指定设备信息
rdma dev show mlx5_3

# 以详细信息模式查看
rdma -d dev show mlx5_3

输出示例：

复制代码

link mlx5_3/1 state ACTIVE physical_state LINK_UP netdev ens3f0
link mlx5_4/1 state ACTIVE physical_state LINK_UP netdev ens3f1

5.2 重命名设备

语法：

bash 复制代码

rdma dev set DEV name NEWNAME

示例：

bash 复制代码

rdma dev set mlx5_3 name rdma_0

5.3 设置网络命名空间

语法：

bash 复制代码

rdma dev set DEV netns NSNAME

示例：

bash 复制代码

# 将 RDMA 设备移动到指定命名空间
rdma dev set mlx5_3 netns foo

注意： 需要先通过 ip 命令创建网络命名空间。

5.4 自适应中断调解

语法：

bash 复制代码

rdma dev set DEV adaptive-moderation [on|off]

说明： 控制 RDMA 设备的自适应中断调解功能。此设置对设备全局生效，但值会在每个 CQ（完成队列）上体现。

示例：

bash 复制代码

# 开启自适应中断调解
rdma dev set mlx5_3 adaptive-moderation on

# 关闭自适应中断调解
rdma dev set mlx5_3 adaptive-moderation off

6. 链路管理 (rdma link)

rdma link 用于查看 RDMA 端口/链路状态，以及创建和删除软件实现的 RDMA 链路。

6.1 查看链路状态

语法：

bash 复制代码

rdma link show [ DEV/PORT_INDEX ]

参数：

参数	说明
`DEV/PORT_INDEX`	格式为 `设备名/端口号`，省略则列出所有链路

示例：

bash 复制代码

# 列出所有 RDMA 链路
rdma link show

# 查看指定链路
rdma link show mlx5_2/1

输出示例：

复制代码

link mlx5_2/1 state ACTIVE physical_state LINK_UP netdev ens3f0
link mlx5_4/1 state ACTIVE physical_state LINK_UP netdev ens3f1

输出字段说明：

state: 链路状态（ACTIVE/DOWN/INIT 等）
physical_state: 物理状态（LINK_UP/POLLING/DISABLED 等）
netdev: 对应的网络设备名

6.2 创建软件 RDMA 链路

语法：

bash 复制代码

rdma link add NAME type TYPE netdev NETDEV

参数：

参数	说明
`NAME`	新建链路的名称
`TYPE`	RDMA 类型：`rxe`（Soft RoCE）或 `siw`（Soft iWARP）
`NETDEV`	绑定的底层网络设备

示例：

bash 复制代码

# 在 eth0 上创建 Soft RoCE 链路
rdma link add rxe_eth0 type rxe netdev eth0

# 在 ens5 上创建 Soft iWARP 链路
rdma link add siw_ens5 type siw netdev ens5

说明： 软件 RDMA（rxe/siw）不需要专用 RDMA 网卡（如 Mellanox ConnectX），可以在普通以太网卡上实现 RDMA 功能，适用于开发和测试环境。

6.3 删除 RDMA 链路

语法：

bash 复制代码

rdma link delete NAME

示例：

bash 复制代码

rdma link delete rxe_eth0

7. 资源追踪 (rdma resource)

rdma resource 用于追踪和管理 RDMA 子系统中各类资源的分配和使用情况。

7.1 支持的资源类型

资源类型	说明
`qp`	Queue Pair（队列对）--- RDMA 通信的基本端点
`cq`	Completion Queue（完成队列）--- 用于通知操作完成
`mr`	Memory Region（内存区域）--- RDMA 注册的内存区域
`pd`	Protection Domain（保护域）--- 安全隔离域
`cm_id`	Connection Manager ID --- RDMA 连接管理标识
`ctx`	Context（上下文）--- 设备上下文

7.2 查看资源使用情况

语法：

bash 复制代码

rdma resource show [ DEV/PORT_INDEX ]
rdma resource show TYPE [ FILTER ]

参数：

参数	说明
`DEV/PORT_INDEX`	指定设备和端口，省略则显示所有设备摘要
`TYPE`	资源类型（qp、cq、mr、pd、cm_id、ctx）
`FILTER`	过滤器（见下表）

示例：

bash 复制代码

# 显示所有设备的资源摘要
rdma resource show

# 显示指定设备的资源
rdma resource show mlx5_2

# 查看指定设备的所有 QP
rdma resource show qp link mlx5_4

# 查看指定端口的 QP
rdma resource show qp link mlx5_4/1

# 查看尚未分配端口的 QP
rdma resource show qp link mlx5_4/-

# 详细视图（含驱动级信息）
rdma resource show qp link mlx5_4/- -d
rdma resource show qp link mlx5_4/- -dd

# 按 Local QPN 范围筛选
rdma resource show qp link mlx5_4/1 lqpn 0-6

# 以原始格式查看驱动详情
rdma resource show qp link mlx5_4/1 lqpn 6 -r

7.3 资源过滤器

资源类型	可用过滤器
`qp`	`lqpn`（Local QP Number）、`pid`（进程 ID）、`qp-type`（QP 类型）
`cq`	`pid`、`cqn`
`mr`	`mrn`（MR Number）、`pid`
`pd`	`pdn`、`pid`
`cm_id`	`dst-port`、`src-addr`、`pid`
`ctx`	`ctxn`、`pid`

过滤器使用示例：

bash 复制代码

# 查看目标端口为 7174 的 CM_ID
rdma resource show cm_id dst-port 7174

# 查看绑定到本地 IP 172.16.0.100 的 CM_ID
rdma resource show cm_id src-addr 172.16.0.100

# 查看属于 PID 30489 的 CQ
rdma resource show cq pid 30489

# 查看索引为 1 的上下文
rdma resource show ctx ctxn 1

# 查看特定 QP 类型的资源
rdma resource show qp qp-type RC

8. 系统配置 (rdma system)

rdma system 用于查看和配置 RDMA 子系统级别的全局参数。

8.1 查看子系统状态

语法：

bash 复制代码

rdma system show

示例：

bash 复制代码

rdma system show

输出示例：

复制代码

netns shared
privileged-qkey off
copy-on-fork on

输出字段说明：

netns: 网络命名空间模式（shared/exclusive）
privileged-qkey: 特权 QKEY 状态（on/off）
copy-on-fork: fork 时是否复制 RDMA 资源

8.2 设置网络命名空间模式

语法：

bash 复制代码

rdma system set netns MODE

参数：

模式	说明
`exclusive`（独占）	RDMA 设备仅在单一网络命名空间中可见，实现设备隔离
`shared`（共享）	RDMA 设备在所有网络命名空间中共享可见

示例：

bash 复制代码

# 设为独占模式（需在创建命名空间之前设置）
rdma system set netns exclusive

# 设为共享模式
rdma system set netns shared

重要注意事项：

如果要使用独占模式，必须在创建任何网络命名空间之前设置
如果已存在活跃的网络命名空间且有 RDMA 设备，从 shared 切换到 exclusive 会返回 EBUSY 错误
建议在有活跃 RDMA 流量时不要更改子系统模式

8.3 设置特权 QKEY

语法：

bash 复制代码

rdma system set privileged-qkey STATE

参数：

状态	说明
`on`	允许非特权用户指定受控 QKEY
`off`	不允许非特权用户指定受控 QKEY

示例：

bash 复制代码

# 允许非特权用户设置受控 QKEY
rdma system set privileged-qkey on

# 禁止非特权用户设置受控 QKEY
rdma system set privileged-qkey off

9. 统计与计数器 (rdma statistic)

rdma statistic 是 RDMA 工具中功能最丰富的子命令之一，用于配置和管理 RDMA 统计计数器。

9.1 基本语法

bash 复制代码

rdma statistic [ OBJECT ] show [ link DEV/PORT_INDEX [ FILTER_NAME FILTER_VALUE ] ]
rdma statistic OBJECT mode [ supported ] [ link DEV/PORT_INDEX ]
rdma statistic OBJECT set COUNTER_SCOPE [ DEV/PORT_INDEX ] auto { CRITERIA | off } [ optional-counters on/off ]
rdma statistic OBJECT bind COUNTER_SCOPE [ DEV/PORT_INDEX ] [ OBJECT-ID ] [ COUNTER-ID ]
rdma statistic OBJECT unbind COUNTER_SCOPE [ DEV/PORT_INDEX ] [ COUNTER-ID ] [ OBJECT-ID ]

9.2 参数说明

参数	可选值	说明
`OBJECT`	`qp`、`mr`	统计对象类型
`COUNTER_SCOPE`	`link`、`dev`	计数器作用域（链路级或设备级）
`CRITERIA`	`type`、`pid`、`type,pid`	自动模式的分组标准
`FILTER_NAME`	`cntn`、`lqpn`、`pid`、`qp-type`	显示过滤器

9.3 查看统计数据

bash 复制代码

# 显示所有 RDMA 设备的默认计数器
rdma statistic show

# 显示指定端口的默认计数器
rdma statistic show link mlx5_2/1

# 显示所有 QP 的计数器
rdma statistic qp show

# 显示指定端口的 QP 计数器
rdma statistic qp show link mlx5_2/1

# 按 PID 过滤
rdma statistic qp show link mlx5_2 pid 30489

# 按 QP 类型过滤（如 UD 类型）
rdma statistic qp show link mlx5_2 qp-type UD

9.4 自动模式配置

自动模式下，属于同一类别的对象会被自动绑定到同一个计数器集合。

bash 复制代码

# 按 QP 类型自动分组
rdma statistic qp set link mlx5_2/1 auto type on

# 按 PID 自动分组
rdma statistic qp set link mlx5_2/1 auto pid on

# 按 PID + 类型组合分组
rdma statistic qp set link mlx5_2/1 auto pid,type on

# 自动分组并同时绑定可选计数器
rdma statistic qp set link mlx5_2/1 auto type on optional-counters on

# 关闭自动模式
rdma statistic qp set link mlx5_2/1 auto off

注意： off 会全局关闭所有自动模式。关闭后已分配的计数器仍可手动访问。自动模式不适用于 MR 对象。

9.5 手动绑定/解绑

bash 复制代码

# 为指定 QP 分配新计数器并绑定
rdma statistic qp bind link mlx5_2/1 lqpn 178

# 将指定 QP 绑定到已有计数器
rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178

# 解绑指定计数器上的所有 QP（之后内核会自动释放该计数器）
rdma statistic qp unbind link mlx5_2/1 cntn 4

注意： 手动绑定/解绑不适用于 MR 对象。

9.6 查看计数器模式

bash 复制代码

# 列出所有设备的当前计数器模式
rdma statistic qp mode

# 列出指定设备端口的计数器模式
rdma statistic qp mode link mlx5_2/1

9.7 可选计数器管理

可选计数器是驱动特有的，不同硬件支持不同的可选计数器。

bash 复制代码

# 查看指定链路已启用的可选计数器
rdma statistic mode link mlx5_2/1

# 查看指定链路支持的所有可选计数器
rdma statistic mode supported link mlx5_2/1

# 启用指定的可选计数器（未列出的将被禁用）
rdma statistic set link mlx5_2/1 optional-counters cc_rx_ce_pkts,cc_rx_cnp_pkts

# 禁用所有可选计数器
rdma statistic unset link mlx5_2/1 optional-counters

9.8 MR 统计

bash 复制代码

# 列出所有已分配的 MR 及其计数器
rdma statistic show mr

# 查看特定 MR 的统计数据
rdma statistic show mr mrn 6

10. 事件监控 (rdma monitor)

rdma monitor 用于实时监控 RDMA 子系统事件。

10.1 基本语法

bash 复制代码

rdma monitor

10.2 使用示例

bash 复制代码

# 启动事件监控
rdma monitor

监控的事件类型：

设备添加/删除
链路状态变化
端口状态变化
资源分配/释放
计数器绑定/解绑

11. 实战场景

11.1 场景一：部署 RoCE 网络

bash 复制代码

# 1. 检查 RDMA 设备
rdma dev show

# 2. 查看链路状态
rdma link show

# 3. 创建 Soft RoCE 链路（如果没有硬件 RDMA）
rdma link add rxe_eth0 type rxe netdev eth0

# 4. 验证链路状态
rdma link show rxe_eth0/1

# 5. 查看资源使用情况
rdma resource show

11.2 场景二：网络命名空间隔离

bash 复制代码

# 1. 创建网络命名空间
ip netns add ns1

# 2. 设置 RDMA 系统为独占模式（需在创建命名空间之前）
rdma system set netns exclusive

# 3. 将 RDMA 设备移动到命名空间
rdma dev set mlx5_3 netns ns1

# 4. 在命名空间内查看设备
ip netns exec ns1 rdma dev show

11.3 场景三：性能监控与调优

bash 复制代码

# 1. 启用自动统计模式
rdma statistic qp set link mlx5_2/1 auto type on

# 2. 查看支持的可选计数器
rdma statistic mode supported link mlx5_2/1

# 3. 启用特定计数器
rdma statistic set link mlx5_2/1 optional-counters cc_rx_ce_pkts,cc_rx_cnp_pkts

# 4. 监控统计数据
rdma statistic qp show link mlx5_2/1

# 5. 按进程 ID 过滤
rdma statistic qp show link mlx5_2 pid 30489

11.4 场景四：资源泄漏排查

bash 复制代码

# 1. 查看所有 QP 资源
rdma resource show qp

# 2. 按进程 ID 过滤
rdma resource show qp pid 30489

# 3. 查看详细驱动信息
rdma resource show qp link mlx5_4/1 -dd

# 4. 查看 CM_ID 资源（排查连接泄漏）
rdma resource show cm_id

# 5. 按目标端口过滤
rdma resource show cm_id dst-port 7174

11.5 场景五：脚本化运维

bash 复制代码

#!/bin/bash
# rdma_check.sh - RDMA 健康检查脚本

echo "=== RDMA 设备状态 ==="
rdma dev show

echo -e "\n=== 链路状态 ==="
rdma link show

echo -e "\n=== 系统配置 ==="
rdma system show

echo -e "\n=== 资源使用摘要 ==="
rdma resource show

echo -e "\n=== 统计计数器 ==="
rdma statistic show

# 检查是否有 DOWN 状态的链路
if rdma link show | grep -q "state DOWN"; then
    echo -e "\n⚠️  警告：检测到 DOWN 状态的链路"
    rdma link show | grep "state DOWN"
fi

12. 故障排查

12.1 查看不到 RDMA 设备

症状： rdma dev show 无输出或报错

排查步骤：

bash 复制代码

# 1. 检查内核模块是否加载
lsmod | grep -E "ib_core|mlx5_ib|rdma_rxe|siw"

# 2. 加载必要的内核模块
sudo modprobe ib_core
sudo modprobe rdma_rxe    # 软件 RoCE
sudo modprobe siw         # 软件 iWARP

# 3. 检查硬件驱动
lspci | grep -i infiniband
lspci | grep -i ethernet

# 4. 查看内核日志
dmesg | grep -i rdma
dmesg | grep -i mlx5

12.2 创建软件 RDMA 链路失败

症状： rdma link add 报错

排查步骤：

bash 复制代码

# 1. 确认目标网络接口存在
ip link show eth0

# 2. 检查是否已绑定其他 RDMA 设备
rdma link show

# 3. 检查内核模块
lsmod | grep -E "rdma_rxe|siw"

# 4. 查看内核日志
dmesg | tail -20

12.3 网络命名空间切换报 EBUSY

症状： rdma system set netns exclusive 返回 EBUSY 错误

原因： 已存在活跃的网络命名空间且有 RDMA 设备

解决方案：

bash 复制代码

# 1. 查看所有网络命名空间
ip netns list

# 2. 删除不需要的命名空间（谨慎操作）
ip netns delete <namespace_name>

# 3. 或者在系统启动早期设置独占模式
# 在 /etc/rc.local 或 systemd 服务中添加：
rdma system set netns exclusive

12.4 资源泄漏

症状： QP/CQ/MR 资源持续增长

排查步骤：

bash 复制代码

# 1. 查看所有资源
rdma resource show

# 2. 按进程 ID 过滤
rdma resource show qp pid <PID>

# 3. 查看详细信息
rdma resource show qp -dd

# 4. 检查 CM_ID 连接
rdma resource show cm_id

# 5. 重启可疑进程或检查应用程序是否正确释放资源

12.5 统计计数器无法启用

症状： rdma statistic set 报错

排查步骤：

bash 复制代码

# 1. 查看支持的可选计数器
rdma statistic mode supported link mlx5_2/1

# 2. 确认驱动支持该计数器
# 3. 检查当前计数器模式
rdma statistic qp mode link mlx5_2/1

# 4. 尝试关闭自动模式后手动绑定
rdma statistic qp set link mlx5_2/1 auto off
rdma statistic qp bind link mlx5_2/1 lqpn 178

13. 快速参考

13.1 命令速查表

复制代码

┌─────────────────────────────────────────────────────────────────┐
│                    RDMA 命令速查                                  │
├─────────────────────────────────────────────────────────────────┤
│  基本信息                                                        │
│  rdma -V                    版本信息                              │
│  rdma dev show              列出所有设备                          │
│  rdma link show             列出所有链路                          │
│  rdma resource show         资源使用摘要                          │
│  rdma system show           子系统状态                            │
│  rdma statistic show        默认计数器状态                         │
├─────────────────────────────────────────────────────────────────┤
│  常用操作                                                        │
│  rdma link add rxe0 type rxe netdev eth0    创建 Soft RoCE       │
│  rdma link delete rxe0                      删除链路             │
│  rdma dev set mlx5_3 name rdma_0            重命名设备           │
│  rdma system set netns exclusive            独占命名空间          │
├─────────────────────────────────────────────────────────────────┤
│  统计与调试                                                      │
│  rdma statistic qp show link mlx5_2/1       QP 统计              │
│  rdma statistic qp set link mlx5_2/1 auto type on   自动统计     │
│  rdma res show qp link mlx5_4/1 lqpn 0-6    按 QPN 过滤资源     │
│  rdma -jp dev show                          JSON 美化输出         │
└─────────────────────────────────────────────────────────────────┘

13.2 常用输出格式

场景	命令
脚本友好	`rdma -j dev show
紧凑输出	`rdma -o link show`
完整调试	`rdma -dd dev show`
驱动详情	`rdma -r resource show qp`

13.3 资源过滤器速查

资源	过滤器	示例
QP	`lqpn`	`rdma res show qp lqpn 100`
QP	`pid`	`rdma res show qp pid 30489`
QP	`qp-type`	`rdma res show qp qp-type RC`
CQ	`pid`	`rdma res show cq pid 30489`
MR	`mrn`	`rdma res show mr mrn 6`
CM_ID	`dst-port`	`rdma res show cm_id dst-port 7174`
CM_ID	`src-addr`	`rdma res show cm_id src-addr 172.16.0.100`

14. 相关资源

14.1 相关命令

命令	说明
`ibstat` / `ibstatus`	InfiniBand 设备状态查询
`ibv_devices`	列出 IB verbs 设备
`ibv_devinfo`	显示 IB 设备详细信息
`ip link`	网络接口管理（与 RDMA 链路配合使用）
`rdma-monitor`	RDMA 事件实时监控

14.2 内核模块

模块	说明
`ib_core`	RDMA/IB 核心模块
`rdma_rxe`	软件 RoCE 驱动
`siw`	软件 iWARP 驱动
`mlx5_ib`	Mellanox ConnectX-5/6 IB 驱动
`mlx4_ib`	Mellanox ConnectX-3 IB 驱动

14.3 参考文档

rdma(8): man 8 rdma
rdma-dev(8): man 8 rdma-dev
rdma-link(8): man 8 rdma-link
rdma-resource(8): man 8 rdma-resource
rdma-system(8): man 8 rdma-system
rdma-statistic(8): man 8 rdma-statistic
rdma-monitor(8): man 8 rdma-monitor
network_namespaces(7): man 7 network_namespaces

14.4 项目与反馈

所属项目: iproute2
项目主页: http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2
源码仓库: https://git.kernel.org/pub/scm/network/iproute2/iproute2.git
Bug 报告: linux-rdma@vger.kernel.org

文档版本: 1.0

最后更新: 2026-09-09

作者: 基于 Linux man pages (rdma 系列) 整理

许可证: 本文档遵循 Linux man pages 原始许可证

Linux RDMA命令行工具使用手册

目录

1. 概述

1.1 应用场景

1.2 支持的 RDMA 技术

1.3 命令结构

2. 安装与验证

2.1 安装

2.2 验证安装

2.3 加载内核模块

3. 基本语法

4. 全局选项

4.1 输出格式示例

4.2 批处理模式

5. 设备管理 (rdma dev)

5.1 查看设备信息

5.2 重命名设备

5.3 设置网络命名空间

5.4 自适应中断调解

6. 链路管理 (rdma link)

6.1 查看链路状态

6.2 创建软件 RDMA 链路

6.3 删除 RDMA 链路

7. 资源追踪 (rdma resource)

7.1 支持的资源类型

7.2 查看资源使用情况

7.3 资源过滤器

8. 系统配置 (rdma system)

8.1 查看子系统状态

8.2 设置网络命名空间模式

8.3 设置特权 QKEY

9. 统计与计数器 (rdma statistic)

9.1 基本语法

9.2 参数说明

9.3 查看统计数据

9.4 自动模式配置

9.5 手动绑定/解绑

9.6 查看计数器模式

9.7 可选计数器管理

9.8 MR 统计

10. 事件监控 (rdma monitor)

10.1 基本语法

10.2 使用示例

11. 实战场景

11.1 场景一：部署 RoCE 网络

11.2 场景二：网络命名空间隔离

11.3 场景三：性能监控与调优

11.4 场景四：资源泄漏排查

11.5 场景五：脚本化运维

12. 故障排查

12.1 查看不到 RDMA 设备

12.2 创建软件 RDMA 链路失败

12.3 网络命名空间切换报 EBUSY

12.4 资源泄漏

12.5 统计计数器无法启用

13. 快速参考

13.1 命令速查表

13.2 常用输出格式

13.3 资源过滤器速查

14. 相关资源

14.1 相关命令

14.2 内核模块

14.3 参考文档

14.4 项目与反馈