xclbinutil 实用工具可以创建、修改和报告 xclbin 内容信息。
可用命令如下图所示。
| 选项 | 描述 |
|---|---|
-h [ --help
]
|
打印帮助消息。 |
-i [ --input
]<arg>
|
输入文件名。将 xclbin 读入存储器。 |
-o [ --output
]<arg>
|
输出文件名。将存储器 xclbin 镜像写入文件。 |
--target
<arg>
|
此镜像的目标流程。有效值包括：hw、hw_emu 和 sw_emu。 |
----private-key
<arg>
|
签署 xclbin 镜像时使用的专用密钥。 |
--ceritifcate
<arg>
|
用于签署和确认 xclbin 镜像的证书。 |
--digest-algorithm
<arg>
|
摘要算法。默认值：sha512
|
--validate-signature
|
确认给定 xclbin 存档的特征符。 |
-v [ --verbose
]
|
显示详细的调试信息 |
-q [ --quiet
]
|
最大程度减少报告信息。 |
--migrate-forward
|
将 xclbin 存档迁移至新的二进制格式。 |
--add-section
<arg>
|
要添加到 xclbin 镜像中的节的名称。格式：<section>:<format>:<file>
|
--add-replace-section
<arg>
|
替换现有的节，或者添加 xclbin 镜像的节（如果不存在）。格式：<section>:<format>:<file>
|
--add-merge-section
<arg>
|
添加节（如果不存在）或者将内容与现有的节合并。格式：<section>:<format>:<file>
|
--remove-section<arg>
|
要从 xclbin 镜像中移除的节的名称。 |
--dump-section<arg>
|
要转储的节。格式：<section>:<format>:<file>
|
--replace-section<arg>
|
要替换的节。 |
--key-value<arg>
|
键值对。格式：[USER|SYS]:<key>:<value>
|
--remove-key<arg>
|
从 xclbin 存档移除给定的用户密钥。 |
--add-signature<arg>
|
将用户定义的特征符添加到给定的 xclbin 镜像。 |
--remove-signature
|
从 xclbin 镜像中移除特征符。 |
--get-signature
|
返回 xclbin 镜像中的用户定义的特征符（如已设置）。 |
--info
|
报告加速器二进制内容。包括：生成和封装数据、内核特征符、连接、时钟、节等 |
--list-sections
|
列出所有可能的节名称（独立选项）。 |
--version
|
此可执行文件的版本。 |
--force
|
强制执行文件覆盖。 |
以下为该工具的各种用例。
- 报告 xclbin 信息
-
xclbinutil --info --input binary_container_1.xclbin
- 抽取比特流镜像
-
xclbinutil --dump-section BITSTREAM:RAW:bitstream.bit --input binary_container_1.xclbin - 抽取构建元数据
-
xclbinutil --dump-section BUILD_METADATA:HTML:buildMetadata.json --input binary_container_1.xclbin - 移除节
-
xclbinutil --remove-section BITSTREAM --input binary_container_1.xclbin --output binary_container_modified.xclbin
对于大部分用户，都需要有关内容以及创建 xclbin 的方式的信息。此信息可通过 --info 选项获取，可用于报告有关 xclbin、硬件平台、时钟、存储器配置、内核与 xclbin 生成方式的信息。
以下分多个部分显示了使用 --info 选项时 xclbinutil 命令的输出。
xclbinutil -i binary_container_1.xclbin --info