The xclbinutil utility can create, modify,
and report xclbin content information.
The available command options are shown in the following table.
| Option | Description |
|---|---|
-h [ --help
]
|
Print help messages. |
-i [ --input
]<arg>
|
Input file name. Reads xclbin into memory. |
-o [ --output
]<arg>
|
Output file name. Writes in memory xclbin image to a file. |
-v [ --verbose
]
|
Display verbose/debug information |
-q [ --quiet
]
|
Minimize reporting information. |
--migrate-forward
|
Migrate the xclbin archive forward to the new binary format. |
--remove-section<arg>
|
Section name to remove. |
--add-section<arg>
|
Section name to add. Format: <section>:<format>:<file>
|
--dump-section<arg>
|
Section to dump. Format: <section>:<format>:<file>
|
--replace-section<arg>
|
Section to replace. |
--key-value<arg>
|
Key value pairs. Format: [USER|SYS]:<key>:<value>
|
--remove-key<arg>
|
Removes the given user key from the xclbin archive. |
--add-signature<arg>
|
Adds a user defined signature to the given xclbin image. |
--remove-signature
|
Removes the signature from the xclbin image. |
--get-signature
|
Returns the user defined signature (if set) of the xclbin image. |
--info
|
Report accelerator binary content. Including: generation and packaging data, kernel signatures, connectivity, clocks, sections, etc |
--list-names
|
List all possible section names (standalone option). |
--version
|
Version of this executable. |
--force
|
Forces a file overwrite. |
The following are various use examples of the tool.
- Reporting xclbin information
-
xclbinutil --info --input binary_container_1.xclbin
- Extracting the bitstream image
-
xclbinutil --dump-section BITSTREAM:RAW:bitstream.bit --input binary_container_1.xclbin - Extracting the build metadata
-
xclbinutil --dump-section BUILD_METADATA:HTML:buildMetadata.json --input binary_container_1.xclbin - Removing a section
-
xclbinutil --remove-section BITSTREAM --input binary_container_1.xclbin --output binary_container_modified.xclbin
For most users, details about the contents and how the xclbin was created is desired. This information can be obtained through
the --info option and reports information on the
xclbin, hardware platform, clocks, memory
configuration, kernel, and how the xclbin was
generated.
The output of the xclbinutil command
using the --info option is shown below divided into
sections.
xclbinutil -i binary_container_1.xclbin --info