DPCT3001

Intel® DPC++ Compatibility Tool Developer Guide and Reference

Download PDF

ID 768918

Date 10/31/2024

Version

Public

Visible to Intel only — GUID: GUID-7BF3C7DD-BDE5-48A0-818D-C4EB2BC5432F

View Details

DPCT3001

Message

“<CMake common command>” is used to generate an output file by performing transformation on input file. You may need to update the name of the input and output file, as well as migrate the input file if the input file contains CUDA syntax.

Detailed Help

Suggestions to Fix

For example, the CMake command configure_file(<input> <output> options) with the “@ONLY” option replaces variables in <input> file that are explicitly marked with “@VAR@” format (see “@FOO_VERSION@” in the example code) with the value of VAR defined in CMake script(see “FOO_VERSION” in the CMake script), and then save out as <output> file.

For example, this original CUDA* code:

// src/bar.in.cu
__global__ void hello_kernel() {}

int main() {
    std::cout << "FOO version: @FOO_VERSION@" << std::endl;
    hello_kernel<<<1, 1>>>();
    cudaDeviceSynchronize();
    return 0;
}

And the CMake script for the original CUDA* code:

# src/CMakeLists.txt
set(FOO_VERSION 1.00)

configure_file(
    ${CMAKE_SOURCE_DIR}/bar.in.cu
    ${CMAKE_BINARY_DIR}/bar.cu
    @ONLY
)

result in the following migrated SYCL codes:

// build/bar.dp.cpp
void hello_kernel() {
}

int main() {
    std::cout << "FOO version: 1.00" << std::endl;  // Example replacement
    dpct::get_in_order_queue().parallel_for(
        sycl::nd_range<3>(sycl::range<3>(1, 1, 1), sycl::range<3>(1, 1, 1)),
        [=](sycl::nd_item<3> item_ct1) {
            hello_kernel();
        });
    dpct::get_current_device().queues_wait_and_throw();
    return 0;
}

# CMakeLists.txt
set(FOO_VERSION 1.00)
DPCT3001:1: "configure_file" is used to generate an output file by performing
transformation on input file. You may need to update the name of the input and
output file, as well as migrate the input file if the input file contains CUDA syntax
configure_file(
    ${CMAKE_SOURCE_DIR}/bar.in.dp.cpp
    ${CMAKE_BINARY_DIR}/bar.dp.cpp
    @ONLY
)

which need to be rewritten to:

// src/bar.in.dp.cpp
void hello_kernel() {
}

int main() {
    std::cout << "FOO version: @FOO_VERSION@" << std::endl;
    dpct::get_in_order_queue().parallel_for(
        sycl::nd_range<3>(sycl::range<3>(1, 1, 1), sycl::range<3>(1, 1, 1)),
        [=](sycl::nd_item<3> item_ct1) {
            hello_kernel();
        });
    dpct::get_current_device().queues_wait_and_throw();
    return 0;
}

and:

# src/CMakeLists.txt
set(FOO_VERSION 1.00)
configure_file(
    ${CMAKE_SOURCE_DIR}/bar.in.dp.cpp
    ${CMAKE_BINARY_DIR}/bar.dp.cpp
    @ONLY
)

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Intel® DPC++ Compatibility Tool Developer Guide and Reference

DPCT3001

Message

Detailed Help

Suggestions to Fix