Basic Migration Options#
The following table lists command line options for basic migration.
Option |
Description |
---|---|
|
The directory path for the analysis scope of the source tree that needs
to be migrated. Default: the value of |
|
The directory path for the compilation database (compile_commands.json) for the files to be migrated. Paths and build options described in the project file are used to guide the migration. When no path is specified, a search for compile_commands.json is attempted through all parent directories of the first input source file. Same as -p. |
|
The directory path of the CUDA* header files. |
|
Specify additional arguments to append to the migration command line. The option accepts a comma-separated list of extra arguments and may be used multiple times in a command. For example: dpct xx.cu --extra-arg="-I /path, -I /path2" --extra-arg="-I /path/to/header"
Use the |
|
The directory path for the root of the source tree that needs to be migrated. Only files under this root are migrated. Default:
Details:
|
|
Excludes the specified directory or file from processing. |
|
Tells the tool to not perform an incremental migration. Default: |
|
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. By default, file extensions are changed as follows:
To limit file extension changes to |
|
Alias for |
|
Migrates or copies all files, except hidden, from the Details: If
|
|
Stop migration and generation of reports if parsing errors happened. Default: |
|
The directory path for the C++ project file |
|
Intercept build tool to generate a compilation database. |
|
Specifies the extension of migrated source file(s). The values are:
|