Using CodeXLAnalyzer Command Line Interface to compile OpenCL Kernels

-h

View available options

CodeXLAnalyzer.exe  -h

-s

Specify the source language for the compilation. “cl” is the default which means that for OpenCL kernel compilation there is no need to specify the –s switch

CodeXLAnalyzer.exe  -s cl -l

-l [ --list-asics ]

List known ASIC targets.

CodeXLAnalyzer.exe  -l

--verbose         

 View supported ASICS with detailed marketing names

CodeXLAnalyzer.exe  -l --verbose         

--version          

 Print version string.

CodeXLAnalyzer.exe  --version         

-a [ --analysis ] arg

Path to output analysis file.  Requires --kernel.

CodeXLAnalyzer.exe foo.cl --kernel myKernel --analysis foo.csv

-c [ --asic ] arg   

Which ASIC to target.  Repeatable.

CodeXLAnalyzer.exe foo.cl --kernel myKernel -isa foo.isa --asic Bonaire

--list-kernels      

List the kernels functions available in the specify cl file

CodeXLAnalyzer foo.cl --list-kernels

--isa arg          

Path to output ISA disassembly file(s). This command requires compilation switches identifying the required kernel --kernel

CodeXLAnalyzer.exe foo.cl --kernel Foo --isa c:\files\Foo

Detailed explanation:

--kernel FooKernel: compile and get ISA for “Foo” kernel

--isa c:\files\Foo: specify the designated output location and prefix. This will creates files such as c:\files\Foo-Bonaire.amdisa, c:\files\Foo-Hawaii.amdisa, etc.

--il arg            

Path to output IL file(s).  Requires --kernel.

CodeXLAnalyzer foo.cl --kernel myKernel --il foo.il --asic Tahity

--debugil arg      

Path to output Debug IL file(s).

CodeXLAnalyzer foo.cl --kernel myKernel --debugil foo.debugil

--metadata arg      

Path to output Metadata file(s). Requires --kernel.

CodeXLAnalyzer foo.cl --kernel myKernel -- metadata foo.metadata

-b [ --binary ] arg  

Path to binary output file(s).

CodeXLAnalyzer foo.cl --kernel myKernel –b foo.bin

--suppress arg       

Section to omit from binary output.  Repeatable.

CodeXLAnalyzer foo.cl --kernel myKernel –suppress .source –b foo.bin

-k [ --kernel ] arg  

Kernel to analyze or make IL or ISA.

CodeXLAnalyzer foo.cl --kernel myKernel –b foo.bin

--OpenCLoption arg  

OpenCL compiler options.  Repeatable.

CodeXLAnalyzer foo.cl --kernel myKernel --isa foo.isa --OpenCLoption -cl-enable-mad --OpenCLoption -w

-D [ --define ] arg

 Define symbol or symbol=value.  Repeatable.

CodeXLAnalyzer foo.cl --kernel myKernel --isa foo.isa –D myDefine

--csv-separator arg

 Override to default separator for analysis items.

CodeXLAnalyzer foo.cl --kernel myKernel --analysis foo.csv –csv-separator #

--livereg arg

Path to the live register analysis output file (note that “--isa arg" must be used in conjunction with the --livereg switch for live register analysis to be performed, since the live register analysis engine works by analyzing the ISA disassembly).

Note: this is a beta feature of CodeXLAnalyzer CLI. You can find more info about it in the “Generating and Interpreting CodeXLAnalyzer CLI’s Live Register Analysis Report”

CodeXLAnalyzer –s cl –c Bonaire --kernel myKernel --isa foo.isa --livereg fooLiveRegFile.txt --il fooIl.il myClFile.cl