Visible to Intel only — GUID: GUID-091B57D5-5190-426E-A4E4-3C3052B3B136
DPCT1000
DPCT1001
DPCT1002
DPCT1003
DPCT1004
DPCT1005
DPCT1006
DPCT1007
DPCT1008
DPCT1009
DPCT1010
DPCT1011
DPCT1012
DPCT1013
DPCT1014
DPCT1015
DPCT1016
DPCT1017
DPCT1018
DPCT1019
DPCT1020
DPCT1021
DPCT1022
DPCT1023
DPCT1024
DPCT1025
DPCT1026
DPCT1027
DPCT1028
DPCT1029
DPCT1030
DPCT1031
DPCT1032
DPCT1033
DPCT1034
DPCT1035
DPCT1036
DPCT1037
DPCT1038
DPCT1039
DPCT1040
DPCT1041
DPCT1042
DPCT1043
DPCT1044
DPCT1045
DPCT1046
DPCT1047
DPCT1048
DPCT1049
DPCT1050
DPCT1051
DPCT1052
DPCT1053
DPCT1054
DPCT1055
DPCT1056
DPCT1057
DPCT1058
DPCT1059
DPCT1060
DPCT1061
DPCT1062
DPCT1063
DPCT1064
DPCT1065
DPCT1066
DPCT1067
DPCT1068
DPCT1069
DPCT1070
DPCT1071
DPCT1072
DPCT1073
DPCT1074
DPCT1075
DPCT1076
DPCT1077
DPCT1078
DPCT1079
DPCT1080
DPCT1081
DPCT1082
DPCT1083
DPCT1084
DPCT1085
DPCT1086
DPCT1087
DPCT1088
DPCT1089
DPCT1090
DPCT1091
DPCT1092
DPCT1093
DPCT1094
DPCT1095
DPCT1096
DPCT1097
DPCT1098
DPCT1099
DPCT1100
DPCT1101
DPCT1102
DPCT1103
DPCT1104
DPCT1106
Visible to Intel only — GUID: GUID-091B57D5-5190-426E-A4E4-3C3052B3B136
Migrate a Project on Windows*
Use the Command Line
Intel® DPC++ Compatibility Tool can be invoked at the command line.
If your project uses Microsoft Visual Studio*, you can use the --vcxprojfile option to point to the project that requires migration. Intel® DPC++ Compatibility Tool will migrate the files you provided as input files.
The following steps show how to migrate the Vector Add sample using Intel® DPC++ Compatibility Tool:
Get the Vector Add sample:
Use the oneapi-cli utility to select the sample from the Intel® DPC++ Compatibility Tool category.
Download the sample from GitHub*
Navigate to the root of the Vector Add sample.
The sample contains a single CUDA* file, vector_add.cu, located in the src folder.
From the root folder of the sample project, run Intel® DPC++ Compatibility Tool.
To migrate the single file src\vector_add.cu, which is part of vector-add.vcxproj, run:
dpct --vcxprojfile=vector-add.vcxproj --in-root=./ --out-root=output_proj src\vector_add.cu
Alternately, to migrate all relevant files found by the tool in vector-add.vcxproj, run:
dpct --vcxprojfile=vector-add.vcxproj --in-root=./ --out-root=output_proj
In both cases, the result of the migration is sent to the output_proj folder.
Use Microsoft Visual Studio*
You can use Intel® DPC++ Compatibility Tool within the Microsoft Visual Studio IDE to migrate your project to a SYCL project.
Step 1: Select an Existing Project and Start Migration
To select an existing project in Microsoft Visual Studio and start migration:
From the Extensions menu, select Browse Intel® oneAPI Samples
Select Rodinia NW DPCT from the Intel® DPC++ Compatibility Tool category.
Select the Project menu >Migrate Project to DPC++.
In the Select Project to Migrate dialog, click Browse.
Select the directory and the existing project file in the Open dialog.
Select the Configuration and Platform to migrate.
Click OK.
Step 2: Specify the Migration Configuration
After selecting an existing project, you will see the Migration Configuration dialog. These configurations have default values. You can specify the configurations, including the new project file name and directory, the --in-root argument, and the additional options for the migration.
The command line area is read-only and shows the command line that will be used to migrate the project.
The migration starts once you click OK.
Step 3: Verify the Source for Correctness
Verify the migration of the source code that uses variables declared using preprocessor directives. Inspect the migrated source code, address any DPCT warnings generated, and verify correctness of the new program.
Review Emitted Warnings for additional information about inserted warnings and comments.
For the most accurate and detailed instructions on addressing warnings, see the Addressing Warnings in the Migrated Code section of the sample README files.
Step 4: Check the Detailed Diagnostic Messages
To learn more about a diagnostic message, click the Help hyperlink in the Actions column, which is located in the table in the Intel® DPC++ Compatibility Tool view. Details about why the diagnostic message is generated and information on how to fix the issue are shown.
Specifying Options
You can set your preferences for Intel® DPC++ Compatibility Tool within Microsoft Visual Studio:
To always show warnings after migration:
Select Tools > Options > Intel® DPC++ Compatibility Tool > General.
Select True (the default) for the Always show warnings after migration option.
Click OK.
To enable opening code side-by-side:
Select Tools > Options > Intel® DPC++ Compatibility Tool > General.
Select True (the default) for the Enable opening code side-by-side option.
Click OK.
To select a version of the tool:
If you have multiple versions of Intel® DPC++ Compatibility Tool installed, you can select which version to use.
Select Tools > Options > Intel® DPC++ Compatibility Tool > Tools.
Use the drop-down menu from the step above to select the appropriate version of the tool.
Select the default options (optional).
Click OK.