Before You Begin

Visual Studio 2022
Visual Studio 2019
Visual Studio 2017

Determine your installation directory,
<install_dir>
:
If your compiler was installed in the default location by a root user or sudo user, the compiler will be installed under
/opt/intel/oneapi
. In this case,
<install_dir>
is
/opt/intel/oneapi
.
For non-root users, your home directory under
intel/oneapi
is used. In this case,
<install_dir>
will be
$HOME/intel/oneapi
.
For cluster or enterprise users, your admin team may have installed the compilers on a shared network file system. Check with your local admin staff for the location of installation (
<install_dir>
).
Source the environment-setting script for your shell:
bash:
source <install_dir>/setvars.sh intel64
csh/tcsh:
source <install_dir>/setvars.csh intel64
If you want to use the 32bit ia32 compiler instead of the default 64bit compiler, replace
intel64
in the source command above with
ia32
. For example:
bash:
source <install_dir>/setvars.sh ia32
csh/tcsh:
source <install_dir>/setvars.csh ia32

Compile and Execute SYCL Code

#include <CL/sycl.hpp>

int main() {
  class NEOGPUDeviceSelector : public cl::sycl::device_selector {
  public:
    int operator()(const cl::sycl::device &Device) const override {
      using namespace cl::sycl::info;

      const std::string DeviceName = Device.get_info<device::name>();
      const std::string DeviceVendor = Device.get_info<device::vendor>();

      return Device.is_gpu() && (DeviceName.find("HD Graphics NEO") != std::string::npos);
    }
  };

  NEOGPUDeviceSelector Selector;
  try {
    cl::sycl::queue Queue(Selector);
    cl::sycl::device Device(Selector);
  } catch (cl::sycl::invalid_parameter_error &E) {
    std::cout << E.what() << std::endl;
  }
}

Use the Command Line on Windows

Open a command prompt in Microsoft Visual Studio.
Invoke the compiler.
For C/C++ source files:
icx [options] file1 [file2...] [/link link_options]
For DPC++ source files:
dpcpp-cl [options] file1 [file2...] [/link link_options]
For DPC++ source files (Intel® oneAPI HPC Toolkit only):
icx -fsycl [options] file1 [file2...] [/link link_options]
To enable unnamed SYCL lambda kernel support with Intel® oneAPI HPC Toolkit, add the
-fsycl-unnamed-lambda
option.

For C/C++ source files:
icl [options] file1 [file2...] [/link link_options]

Use the Command Line on Linux

For C/C++ source files:
{icc|icpc} [options] file1 [file2...]

Use Microsoft Visual Studio on Windows

Create a Microsoft Visual C++ (MSVC) project or open an existing project.
In
Solution Explorer
, select the project(s) to build with the Intel® oneAPI DPC++/C++ Compiler.
Open
Project > Properties
.
In the left pane, expand the
Configuration Properties
category and select the
General
property page.
In the right pane change the
Platform Toolset
to the compiler you want to use:
For DPC++, select
Intel(R) oneAPI DPC++ Compiler
to invoke
dpcpp-cl
.
For C/C++, there are two toolsets.
Select
Intel C++ Compiler <major version>
(example 2021) to invoke
icx
.
Select
Intel C++ Compiler <major.minor>
(example 19.2) to invoke
icl
.
Alternatively, you can specify a compiler version as the toolset for all supported platforms and configurations of the selected project(s) by selecting
Project > Intel Compiler > Use Intel oneAPI DPC++/C++ Compiler
.
Rebuild, using either
Build > Project only > Rebuild
for a single project or
Build > Rebuild Solution
for a solution.

Select a project, then go to
Tools > Options > Intel Compilers and Libraries > <compiler> > Compilers
, where <compiler> values are
C++
or
DPC++
.
Use the
Selected Compiler
drop-down menu to select the appropriate version of the compiler.
Select
OK
.

Select your project in Microsoft Visual Studio.
Right-click and select
Intel Compiler > Use Visual C++
from the context menu.

Use the Eclipse* CDT on Linux

Start Eclipse
Select
Help > Install New Software
Select
Add
to open the Add Site dialog
Select
Archive
, browse to the directory
<install_dir>/compiler/<version>/linux/ide_support
, select the .zip file that starts with
com.intel.dpcpp.compiler
, then select
OK
Select the options beginning with Intel, select
Next
, then follow the installation instructions
When asked if you want to restart Eclipse*, select
Yes

Open Existing Project or Create New Project on Eclipse
Right click on
Project > Properties > C/C++ Build > Tool chain Editor
Select
Intel DPC++/C++ Compiler
from the right panel

Open Existing Project on Eclipse
Right click on
Project > Properties > C/C++ Build > Settings
Create or manage build configurations in the right panel

Next Steps

Use the latest oneAPI Code Samples and follow along with the Intel® oneAPI Training Resources.

Explore the
Intel® oneAPI
DPC++/C++
Compiler
Developer Guide and Reference on the Intel® Developer Zone.

Find More

Notices and Disclaimers