用途:面向从主机侧调用 DOCA PCC 库的开发者,用于在 BlueField DPU 上部署自定义可编程拥塞控制(PCC)算法。算法本体是运行在 DPA 处理器上的代码,由 dpacc 编译成镜像,主机侧通过 doca_pcc_* API 加载、挂载到承载 RDMA/RoCE 流量的端口并参数化。
主要能力:初始化 doca_pcc 上下文;加载 dpacc 产出的 PCC 算法镜像(doca_pcc_app);将算法挂载到指定 BlueField 端口;通过 doca_pcc_cap_* 查询当前设备与固件是否支持自定义 PCC;对 doca_pcc_* 返回的 DOCA_ERROR_* 做分层定位(固件未开启自定义 PCC 槽位、设备不支持、镜像不兼容、doca_dev 权限不足等)。
使用方式:技能本身是轻量入口,实质内容在 CAPABILITIES.md(能力矩阵、双端程序模型、前置条件、错误分类、安全策略)与 TASKS.md(configure、build、modify、run、test、debug 六类工作流)。示例代码位于 /opt/mellanox/doca/samples/doca_pcc/,建议基于官方样例做最小改动。
适用场景:主机侧自定义 PCC 算法的部署、能力探测、参数化、启动与排错;非 C 语言的主机侧绑定也可参考其前置条件与能力发现规则。
限制:不覆盖 DOCA 或 dpacc 的安装、固件配置(走 doca-setup);不涉及 DPA 侧算法本身的编写(走公开 DOCA PCC 编程指南与 doca-dpa);不包含默认出厂 PCC 算法(仅固件配置);不包含 pcc_counters 诊断 CLI(属 DOCA Tools)。技能不提供现成算法源码、构建清单或样例子树,也不定义具体拥塞控制算法。