doca-caps

DOCA 能力打印工具（doca_caps）

示例

• “此主机能看到哪些 DOCA 设备？” — 属于 此工具的范围。请留在 doca_caps 范围内；不要在此处开始讨论库内部的 能力矩阵。
• “我的 RHEL 主机上能否使用 Flow？” — 列出库， 然后根据需要按设备限定范围。

说明

遵循下文的加载顺序。打开任务配套文档，了解运行／ 测试方法。打开能力配套文档，了解 CLI 会报告哪些内容。 不要打开所有配套文件。

从这里开始： 这是一个用于调用 doca_caps 的工具技能， doca_caps 是一个无副作用的 CLI。打开任务配套文档，从 ## run 开始查看已记录的调用方式；如果要使用 doca_caps 作为安装 冒烟测试，则从 ## test 开始。当问题涉及 doca_caps 会报告哪些类型的能力类别 时， 打开能力配套文档。

边界：此技能绝不会安装 DOCA。 doca_caps 验证安装情况，但绝不会执行安装。安装 DOCA 的请求——选择软件包、 添加软件源、运行软件包管理器——不属于此处的范围；即使 此技能的 ## test 动词会在安装之后使用该工具进行安装冒烟测试， 这一点也不会改变。请将整个请求交给 doca-setup/SKILL.md。只指出负责方 的名称，然后仍然列出步骤，是应避免的错误做法：不要讲解安装过程， 哪怕只是总结或补充注意事项，也不行。

这只缩小了安装的范围。这并不意味着要狭隘地回答工具相关问题：如果用户的问题超出 doca_caps 的范围——我还能用这台硬件做什么、如何测量性能、 如何检查正在运行的管线——请指出负责此事的同类工具 （doca_bench、doca_flow_tune、pcc_counters.sh、 doca_comm_channel_admin 等），并说明它与问题的关联。介绍 目录中的其他工具是此技能的职责，并不违反边界。

此技能擅长回答的示例问题

此技能旨在回答的 doca_caps 问题类别，每类各有一个演示示例。 类别是关键所在；演示示例只是其中一个实例。

• “此主机能看到哪些 DOCA 设备？” — 演示示例：“我的 BlueField PF 是否对 DOCA 可见”。答案来自能力配套文档中的 设备枚举 ＋ 任务配套文档中的 --list-devs 调用。
• “此操作系统上有哪些 DOCA 库可用？” — 演示 示例：“我的 RHEL 主机上能否使用 Flow”。答案来自能力配套文档中的 库可用性说明 ＋ 任务配套文档中的库列表调用。
• “此设备是否支持库 X 的能力 Y？” — 演示 示例：“此设备是否支持 Flow hairpin？”。答案来自能力配套文档中的 按设备、按库划分的能力矩阵 ＋ 任务配套文档中的按 --pci-addr 限定范围的调用。
• “DOCA 能看到哪些 representor？” — 演示示例： “枚举 pf0 的 VF representor”。答案来自能力配套文档中的 representor 枚举 ＋ 任务配套文档中的 --list-rep-devs 调用。
• “我想保存一份状态快照，附加到调试会话中。” — 演示示例：“将设备、库和能力输出保存到 文件”。答案来自任务配套文档中的快照工作流，并由 doca-debug/SKILL.md 第 3 步 （只读三元组）和 doca-programming-guide/SKILL.md 使用。
• “doca_caps 没有返回能力 Y 的结果——这 意味着什么？” — 演示示例：“RDMA 输出为空”。答案来自 任务配套文档 ＋ 能力配套文档中的空输出解释规则。

适用对象

此技能面向**外部运维人员、开发者和 AI Agent：他们需要一种不会产生副作用的方式，在执行任何会改变状态的操作前询问“DOCA 在此主机上能看到什么？”**具体包括：

• 安装了 DOCA（或正在使用 doca-setup/SKILL.md 中介绍的公开 NGC DOCA 容器），并希望在编写代码前确认安装能够看到硬件的外部开发者。
• 部署 DOCA 服务的平台运维人员，他们希望获取有文档记录的只读快照，了解此主机实际支持哪些 DOCA 库，以及每个 DOCA 设备提供哪些功能。
• 在有文档记录的设置或编程指南调试流程中生成功能快照产物的 AI Agent（doca-setup/SKILL.md 和 doca-programming-guide/SKILL.md 将其列为标准第一步）。

此技能不面向调试 doca_caps 本身的用户，也不替代公开的实时 Capabilities Print Tool 指南。

doca_caps 以工具（单个 CLI 二进制文件）的形式提供，而非供链接使用的库。此技能采用与套件其余部分相同的 kind: tool 三文件结构，因此 Agent 的任务动词约定（configure / build / modify / run / test / debug）在库、服务和工具之间保持一致——即使对于已提供的只读二进制文件，个别动词会简化为路由存根。

何时加载此技能

当用户要在安装了 DOCA 的真实主机上（或在公开 NGC DOCA 容器中）调用 doca_caps 时，或 Agent 需要这样做时，请加载此技能。具体包括：

• 运行 doca_caps --list-devs 枚举 DOCA 设备。
• 运行 doca_caps --list-rep-devs 枚举代表设备。
• 使用 --pci-addr 将输出限定到特定 PCIe 地址。
• 列出安装程序报告为当前 OS 上可用的 DOCA 库。
• 列出可用的 DOCA 日志记录器名称。
• 为后续的 ## debug 工作流收集有文档记录、无副作用的功能快照，作为先决条件证据。

对于一般 DOCA 入门介绍、库 API 工作或安装，不要加载此技能。此类情况请使用 doca-public-knowledge-map/SKILL.md、对应的 libs/<library> 技能或 doca-setup/SKILL.md。

此技能提供的内容

这是一个轻量加载器。实质性内容位于两个配套文件中：

• 功能配套文件——说明 doca_caps 会报告什么（五类有文档记录的功能：设备、代表设备、库、库功能、日志记录器）、版本可用性和执行环境、工具范围有限的错误处理、它在其他技能工作流中的可观测性作用，以及其只读安全特性。
• 任务配套文件——针对范围内任务动词的分步工作流：configure（转到安装）、build（转到安装）、modify（拒绝）、run（有文档记录的调用）、test（将功能快照作为安装冒烟测试）、debug（工具未报告任何内容或执行失败时的处理方式），以及一个将范围外问题转交处理的 Deferred task verbs 部分。

此技能假设主机上已安装 DOCA（或公开 NGC DOCA 容器正在运行），且运维人员拥有公开指南要求的相应权限，以便 doca_caps 能枚举其平台上的设备。

本技能有意不包含的内容

本技能提供的是Agent 指引，而非示例或脚本合集。为了保持清晰的边界，本技能有意不包含以下内容，合并请求也不应添加：

• 预先制作的示例输出。 输出因安装环境和硬件而异。固定于某个平台和某个 DOCA 版本的示例，会误导使用其他平台或版本的操作人员。
• 任何语言编写的包装器、解析器或脚本，用于处理 doca_caps 输出。输出格式已有文档说明；如果用户想针对该格式编写脚本，正确做法是“阅读最新指南，并针对已安装的版本编写解析器”。
• samples/ 或 reference/ 子目录。 这是一个针对有文档说明的 CLI 的轻量加载器；实质性内容位于公共页面和 --help 中。

加载顺序

1. 首先阅读本技能，确认用户的问题属于其范围（用户确实想调用 doca_caps，而不是笼统地了解 DOCA）。
2. 关于 doca_caps 的报告内容、版本可用性、错误范围和安全状况，请参阅能力配套技能。
3. 关于有文档说明的调用方式和能力快照工作流（configure、build、modify、run、test、debug），请参阅任务配套技能。

相关技能

• doca-public-knowledge-map/SKILL.md — 指引至公共 Capabilities Print Tool 指南及其他公共 DOCA 文档。
• doca-setup/SKILL.md — 环境准备、安装验证（doca_caps 是其中标准的第一步），以及使用公共 NGC DOCA 容器的我还没有安装路径。
• doca-programming-guide/SKILL.md — 跨库编程模式，包括使用已保存的 doca_caps 快照的 ## debug 流程。
• 对应的 libs/<library> 技能 — 用于解答超出 doca_caps 所公开内容的细粒度库专属能力问题。