xclbinutil ユーティリティでは、xclbin のコンテント情報を作成、変更、およびレポートできます。
次の表は、使用可能なコマンド オプションをリストしています。
| オプション | 説明 |
|---|---|
-h [ --help
]
|
ヘルプ メッセージを表示します。 |
-i [ --input
]<arg>
|
入力ファイル名を指定します。xclbin をメモリに読み込みます。 |
-o [ --output
]<arg>
|
出力ファイル名を指定します。メモリ xclbin イメージをファイルに書き込みます。 |
-v [ --verbose
]
|
詳細/デバッグ情報を表示します。 |
-q [ --quiet
]
|
レポート情報を最小限にします。 |
--migrate-forward
|
xclbin アーカイブを新規バイナリ形式に移行します。 |
--remove-section<arg>
|
削除するセクション名。 |
--add-section<arg>
|
追加するセクション名。フォーマットは <section>:<format>:<file> です。 |
--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-names
|
すべての可能性のあるセクション名をリストします (スタンドアロン オプション)。 |
--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