DOCA GPI
起点: 此技能假定 DOCA 已安装,并且用户正在同时具备 BlueField / ConnectX 设备和可通过 PCIe 访问的 NVIDIA GPU 的主机上进行实操 GPI 工作。如需在安装/配置/构建/修改/运行/测试/调试/使用中执行某项操作,请阅读 TASKS.md;如需了解 GPI 在此版本上的表达能力,请阅读 CAPABILITIES.md。
此技能解决的问题
本技能主要帮助开发者处理以下 GPI 相关问题:
- 选择 doca-gpi 还是 doca-gpunetio;
- 创建并配置 GPI 域和通道;
- 在 CUDA 内核中使用 GPU 侧句柄;
- 附加 GPU 内存到 GPI 域;
- 理解域和通道属性对象;
- 调试 DOCA_ERROR_* 错误。
受众
面向希望在 CUDA 内核中直接从 GPU 内存发起 RDMA 的外部开发者,无需主机 CPU 参与。典型场景是 NVIDIA GPU 与 BlueField/ConnectX 位于同一主机,使用 DOCA GPU-NetIO 与 GPI 通道句柄驱动 RDMA 操作。
语言范围
DOCA GPI 是一个 C 库,pkg-config 模块名为 doca-gpi。主机侧表面是 C;GPU 侧表面(doca_gpu_gpi_channel*)需通过 nvcc 编译。
何时加载此技能
当用户需要下述操作时加载:GPI 与 gpunetio 选型、创建 doca_gpi 并配置、创建通道并获取 GPU 句柄、交换端点信息、附加本地/远程 mmap、调试 DOCA_ERROR_*。
技能提供的内容
本技能是薄加载器,具体 GPI 材料在 CAPABILITIES.md 与 TASKS.md 中。CAPABILITIES.md 包含对象模型、GPU 句柄交接、属性对象、成熟度声明、错误分类和安全策略;TASKS.md 提供安装、配置、构建、修改、运行、测试、调试和使用的分步工作流。
不包含的内容
本技能不提供现成的 GPI 应用源码、独立构建清单、CUDA 内核模板,也不包含 samples/ 或 reference/ 目录。
加载顺序
- 先读 SKILL.md;2. 查看 CAPABILITIES.md 了解能力;3. 查看 TASKS.md 获取操作步骤。
相关技能
doca-gpunetio、doca-verbs、doca-dpa、doca-rdmi、doca-public-knowledge-map、doca-setup、doca-programming-guide、doca-debug、doca-hardware-safety、doca-version 等。