Query API Mapping, Tool Warning, and Help Options#

The following tables list command line options to query API mapping support, manage warnings generated by the tool, and to display tool information.

Query API Mapping Options#

Option

Description

-query-api-mapping=<api>

Query functionally-compatible SYCL API to migrate CUDA API.

Tool Warning Options#

Option

Description

--output-file=<file>

Redirects the stdout/stderr output to <file> in the output directory specified by the --out-root option.

--output-verbosity=<value>

Sets the output verbosity level:

  • =detailed: ‘normal’ and messages about which file is being processed.

  • =diagnostics: ‘detailed’ and information about the detected conflicts and crashes (default).

  • =normal: ‘silent’ and warnings, errors, and notes from SYCLomatic.

  • =silent: Only messages from clang.

--suppress-warnings=<value>

A comma-separated list of migration warnings to suppress. Valid warning IDs range from 1000 to 1127. Hyphen-separated ranges are also allowed. For example: -suppress-warnings=1000-1010,1011.

--suppress-warnings-all

Suppresses all migration warnings. Default: off.

Help and Info Options#

Option

Description

--help

Display available options.

--helper-function-dir

Print the installation directory for helper function header files.

--version

Shows the version of the tool.