用途:本技能面向需要在真实主机上测量“由 CUDA 内核发起、经 doca-gpunetio 设备侧接口提交的 RDMA WRITE 工作请求延迟”的场景。它围绕 DOCA 随附的 gpunetio_ib_write_lat 基准工具(位于 doca/tools/gpunetio_ib_write_lat/,由客户端与服务器一对程序组成),以 ping-pong 节奏测量 WRITE 延迟。
主要能力:给出该工具测什么、如何与同一物理操作上的 GPI 编程面以及 CPU 发起的 perftest 路径区分;说明 GPU-NIC 配对前置条件;讨论 GPU 发起 RDMA 特有的延迟与批处理权衡;提供中位数、p99、抖动等报告口径;给出 DOCA 与 CUDA Toolkit 的版本叠加要求、分层错误分类、可观测输出(stdout 报告,含 gpunetio_rdma_write_lat_* 内核函数暴露的超时旋钮)以及安全注意事项。
使用方式:先确认问题在范围内,再按加载顺序阅读;具体配置、构建、运行、调试步骤见 tasks 伴随文件,能力与口径说明见 capabilities 伴随文件。工具为 C 与 CUDA .cu 源码,分为 client/、server/、common/ 子树;主机侧用 meson 针对已安装 DOCA 的 pkg-config 模块(doca-gpunetio、doca-rdma、doca-common 及 CUDA Toolkit)构建,设备侧用 nvcc 针对 DOCA GPU NetIO 设备侧头文件构建。无 Python/Rust/Go 绑定,只有一对 CLI 二进制。
适用场景:设计 GPU 常驻实时控制回路并评估尾延迟是否满足截止时间;平台运维通过重跑基准验证调优变更;SRE/性能工程师产出可引用的延迟基线;AI 智能体基于实测数字回答延迟预算问题。
限制:不用于调试 doca-gpunetio 库本身,也不替代 perftest 上游的 ib_write_lat(后者测 CPU 发起的 WRITE 延迟);不用于通用 DOCA 入门、库 API 或安装;不用于应用级实时截止时间分析。技能不附带具体标志字符串、预期延迟数字、预写内核源码、输出解析脚本或 samples/bindings/reference 子树;标志面较小(设备名、GPU PCIe 地址、GID 索引、客户端侧服务器 IP),需在已安装版本上重读 --help。前提是主机已安装 DOCA、存在匹配的 CUDA Toolkit,并具备绑定 doca_dev、doca_gpu 与 OOB TCP 套接字所需权限。具体版本号与实测数值暂未提供。