Command Line Options Reference¶
This topic shows the command line options and their descriptions.
Command Line Options Reference¶
Option |
Description |
---|---|
|
Always create |
|
Insert comments explaining the generated code. Default: |
|
The directory path of the CUDA* header files. |
|
Use a C++17 class template argument deduction (CTAD) in your generated code. |
|
Additional argument to append to the migration command line, example:
|
|
Sets the range of formatting. The values are:
|
|
Sets the formatting style. The values are:
Example for the .clang-format file content: BasedOnStyle:
LLVM IndentWidth: 4
TabWidth: 4
UseTab: ForIndentation
|
|
Provides list of Intel® DPC++ Compatibility Tool specific options. |
|
The directory path for the root of the source tree that needs to be migrated. Only files under this root are migrated. Default:
Details: Any source within the directory specified by |
|
Keeps the original code in the comments of generated Data Parallel C++ (DPC++) files. Default: |
|
Do not use cl namespace ( |
|
Do not use a Don’t Repeat Yourself (DRY) pattern when functions from the
|
|
The directory path for root of generated files. A directory is created if
it does not exist. Default: The relative paths for the generated files are maintained, and the extension is changed as follows:
|
|
Redirects the |
|
Sets the output verbosity level:
|
|
The directory path for the compilation database ( |
|
Migrates/copies all files from the |
|
Prefix for the report file names. The full file name will have a suffix
derived from the |
|
Format of the reports:
|
|
Only reports are generated. No DPC++ code is generated. Default: |
|
Comma separated list of report types:
|
|
Stop migration and generation of reports if parsing errors happened. Default: |
|
Comma separated list of migration warnings to suppress. Valid warning IDs
range from 1000 to 1047. Hyphen-separated ranges are also allowed. For
example: |
|
Suppresses all migration warnings. Default: |
|
Generates kernels with the kernel name. Default: |
|
Sets the Unified Shared Memory (USM) level to use in source code generation:
|
|
The file path of |
|
Shows the version of the tool. |
Note
Specifying any of these options will trigger report generation.
--report-file-prefix
--report-type
--report-format
--report-only
Source Files¶
To work with source files use <source0> ...
to create paths
for your input source files. These paths can be found in the
compilation database.
Examples:
Migrate single source file:
dpct source.cpp
Migrate single source file with C++11 features:
dpct --extra-arg="-std=c++11" source.cpp
Migrate all files available in compilation database:
dpct -p=<path to location of compilation database file>
Migrate one file in compilation database:
dpct -p=<path to location of compilation database file> source.cpp