kernelinfo Utility - 2023.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 English

The kernelinfo utility extracts and displays information from Xilinx object (XO) files which can be used during host code development. This information includes hardware function names, arguments, offsets, and port data.

The following command options are available:

Table 1. kernelinfo Commands
Option Description
-h [ --help ] Print help message.
-x [ --xo_path ] <arg> Absolute path to file including file name and .xo extension.
-l [ --log ] <arg> By default, information is displayed on the screen. Otherwise, you can use the --log option to output the information as a file.
-j [ --json ] Output the file in JSON format.
[input_file] XO file. Specify the XO file positionally or use the --xo_path option.
[output_file] Output from AMD OpenCL Compiler. Specify the output file positionally, or use the --log option.

To run the kernelinfo utility, enter the following in a Linux terminal:

kernelinfo <filename.o>

The output is divided into three sections:

  • Kernel Definitions
  • Arguments
  • Ports

The report generated by the following command is reviewed to help better understand the report content. The report is broken down into specific sections for better understandability.

kernelinfo krnl_vadd.xo

Where krnl_vadd.xo is a compiled kernel.