Description of Configuration Files

Format of counter configuration file (argument passed to --counterfile)

To specify a set of performance counters to enable when profiling from the command line, pass the name of a configuration file to the --counterfile option. You can generate a counter configuration file from within the Visual Studio client by using the "Save Counters" button on the GPU Profile: Performance Counters page of the Project Settings dialog. The format of this configuration file is one counter name per line. Counter names are case-sensitive. An example of the contents of this file is given below.

Format of kernel list configuration file (argument passed to --kernellistfile)

To specify a set of kernels to profile when collecting performance counters from the command line, pass the name of a configuration file to the --kernellistfile  option. The format of this configuration file is one kernel name per line. Kernel names are case-sensitive.  When specified, any kernels dispatched by the application that are not contained in the kernel list configuration file will not be profiled.  An example of the contents of this file is given below.

Format of API rules configuration file (argument passed to --apirulesfile)

To specify a set of rules to use when generating the summary pages from a trace file when using the command line, pass the name of a configuration file to the --apirulesfile option. The format of this file is one rule per line in the NAME=VALUE format. An example of the contents of this file is given below. Note that the "VALUE" can be either "True" or "False".

Format of API filter configuration file (argument passed to --apifilterfile)

To ignore a set of APIs when collecting an API trace using the command line, pass the name of a configuration file to the --apifilterfile option. The format of this file is one API name per line. An example of the contents of this file  for an OpenCL™ is given below.

Format of environment variable file (argument passed to --envvarfile)

To specify a set of environment variables to be defined for the application being profiled, pass the name of a configuration file to the --envvarfile option. The format of this file is one environment variable per line in the NAME=VALUE format. An example of the contents of this file is given below.

Format of occupancy display configuration file (argument passed to --occupancydisplay)

To generate a Kernel Occupancy HTML display file using the command line, pass the name of a configuration file to the --occupancydisplay option. The format of this configuration file is one parameter per line in the NAME=VALUE format. An example of the contents of this file is given below. The "VALUES" are taken from a generated .occupancy file for a particular kernel.