Basic Migration Options

Intel® DPC++ Compatibility Tool Developer Guide and Reference

Download PDF

ID 768918

Date 10/31/2024

Version

Public

Visible to Intel only — GUID: GUID-A387670F-90F0-4E43-A360-EB1F4D7355D9

Basic Migration Options

The following table lists command line options for basic migration.

Option	Description
`--analysis-scope-path=<dir>`	The directory path for the analysis scope of the source tree that needs to be migrated. Default: the value of `--in-root`.
`--compilation-database=<dir>`	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.
`--cuda-include-path=<dir>`	The directory path of the CUDA* header files.
`--extra-arg=<string>`	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 `dpct -- -help` command to find options that can be passed as extra arguments for the migration command.
`--in-root=<dir>`	The directory path for the root of the source tree that needs to be migrated. Only files under this root are migrated. Default: The current directory, if the input source files are not provided. The directory of the first input source file, if the input source files are provided. Details: Any source within the directory specified by `--in-root` (at any nesting level) may be migrated. Any header file within the directory specified by `--in-root` (at any nesting level) that is included by the source or header file which is being migrated, is also migrated. Files from outside the `--in-root` directory will not be migrated even if they are included by any of the program source files.
`--in-root-exclude=<dir\|file>`	Exclude the specified directory or file from processing.
`--no-incremental-migration`	Tell the tool to not perform an incremental migration. Default: `off` (incremental migration happens).
`--out-root=<dir>`	The directory path for root of generated files. A directory is created if it does not exist. Default: `dpct_output`. The relative paths for the generated files are maintained. By default, file extensions are changed as follows: `.cu → .dp.cpp` `.cpp → .cpp.dp.cpp` `.cc → .cc.dp.cpp` `.cxx → .cxx.dp.cpp` `.C → .C.dp.cpp` `.cuh → .dp.hpp` `.h .hpp *.hxx` → extensions are kept the same To limit file extension changes to `.cu` and `.cuh` files only, use the `--change-cuda-files-extension-only` option.
`-p`	Alias for `--compilation-database`.
`--process-all`	Migrate or copy all files, except hidden, from the `--in-root` directory to the `--out-root` directory. The `--in-root` option should be explicitly specified. Default: `off`. Details: If `--process-all` and `--in-root` options are specified, but no input files are provided, the tool migrates or copies all files, except hidden, from the `--in-root` directory to the output directory. If there is a compilation database: Files from the compilation database are migrated with the options specified in the compilation database Files with the `.cu` extension that are not listed in the compilation database are migrated as standalone Remaining files are copied to the `–out-root` directory If there is no compilation database: Files with the `.cu` extension are migrated as standalone Remaining files are copied to the `-out-root` directory `--process-all` is ignored if input files are provided on the command line.
`--stop-on-parse-err`	Stop migration and generation of reports if parsing errors happened. Default: `off`.
`--vcxprojfile=<file>`	The directory path for the C++ project file `vcxproj` of the Visual Studio project to migrate. Paths and build options described in the project file are used to guide the migration.
`--intercept-build`	Intercept build tool to generate a compilation database.
`--sycl-file-extension=<value>`	Specify the extension of migrated source file(s). The values are: `=dp-cpp`: Use extension ‘.dp.cpp’ and ‘.dp.hpp’ (default). `=sycl-cpp`: Use extension ‘.sycl.cpp’ and ‘.sycl.hpp’. `=cpp`: Use extension ‘.cpp’ and ‘.hpp’.