Visible to Intel only — GUID: GUID-68B40EC9-995A-4F80-8168-1C75F35ADD91
Legal Information
Getting Help and Support
Introducing the Intel® SDK for OpenCL™ Applications
What's New in This Release
Which Version of the Intel® SDK for OpenCL™ Applications Should I Use?
Intel® Code Builder for OpenCL™ API Plug-in for Microsoft Visual Studio*
Intel® Code Builder for OpenCL™ API Plug-in for Eclipse*
Debugging OpenCL™ Kernels on GPU
Intel® SDK for OpenCL™ Applications Standalone Version
OpenCL™ 2.1 Development Environment
Intel® FPGA Emulation Platform for OpenCL™ Getting Started Guide
Troubleshooting Intel® SDK for OpenCL™ Applications Issues
Configuring Microsoft Visual Studio* IDE
Converting an Existing Project into an OpenCL™ Project
OpenCL™ New Project Wizard
Building an OpenCL™ Project
Using OpenCL™ Build Properties
Selecting a Target OpenCL™ Device
Generating and Viewing Assembly Code
Generating and Viewing LLVM Code
Generating Intermediate Program Binaries with Intel® Code Builder for OpenCL™ API Plug-in
Configuring OpenCL™ Build Options
Visible to Intel only — GUID: GUID-68B40EC9-995A-4F80-8168-1C75F35ADD91
Installing Intel® SDK for OpenCL™ Applications - GPU Kernel Debugger for Linux*
This topic provides a walkthrough for the installation of the Intel® SDK for OpenCL™ Applications - GPU Kernel Debugger on a Linux* machine.
Supported OSes and Prerequisites
Intel SDK for OpenCL Applications - GPU Kernel Debugger can be installed and run on the following Linux* operating systems:
CentOS* 7.2 or higher
Ubuntu* 14.04
Ubuntu* 16.04
NOTE:
GPU Kernel Debugger currently does not support a Yocto* operating system on a Intel® Processor formerly known as Broxton.
NOTE:
For CentOS users, sudo -E yum update upgrades the system from 7.1 to 7.2.
Host Machine
As a host machine you can use any machine with an Intel® CPU running a Linux OS.
Target Machine
A machine with 6th, 7th, or 8th Generation Intel® Core™ Processors running a Linux OS with the OpenCL™ 2.0 GPU graphics driver (SRB5.0) installed. To install the driver using the installation script, see https://software.intel.com/en-us/articles/sdk-for-opencl-gsg. For manual downloading and installation instructions, refer to the https://software.intel.com/en-us/articles/opencl-drivers#latest_linux_driver section.
If you are building on CentOS* machine, please use make rpm-pkg instead of make binrpm-pkg when building the Linux kernel, and make sure to install the Linux headers RPM.
Make sure the dkms package is installed. Use the following command to install:
- On Debian*: sudo apt-get install dkms
- On CentOS*: sudo yum install epel-release dkms
Using Target Machine as Host
On Linux, the host and target machine can be the same machine if you use one of these option:
- You have a discrete Graphics Card used for rendering the Desktop and the UI
- You connect remotely to the host machine.
This section describes the process assuming the second option, i.e. you can connect remotely to the host machine.
So for example, you may start a remote SSH (e.g. PuTTY) from your laptop to your development machine (onto which the SDK is installed), and launch gdb, gdbserver-igfx and your host application via the SSH session.
The example presented in this section uses three PuTTY windows and two separate machines:
- A Windows* development machine
- A Linux host and target machine
The Windows development machine is used for the remote SSH sessions, but you can also start a remote SSH session through a Linux machine.
Sample Application
Download the Median Filter sample, which will be used for the debugging demonstration.
The sample is part of the "Code Samples" suite available on Code Samples page: https://software.intel.com/en-us/intel-opencl-support/code-samples.
Installing Intel® SDK for OpenCL™ - Kernel Debugger
To install the Intel SDK for OpenCL Applications - GPU Kernel Debugger for Linux from an Intel SDK for OpenCL Applications release package, follow the steps below:
- Unpack the installer package and launch:
tar zxvf intel_sdk_for_opencl_2017.0.0.2441_x64.tgz cd intel_sdk_for_opencl_2017.0.0.2441_x64 sudo ./install.sh
- Accept the EULA and follow the wizard instructions.
- When the installation is complete, the following message is shown:
Step 5 of 5 | Complete -------------------------------------------------------------------------------- Thank you for installing and for using the Intel(R) SDK for OpenCL(TM) Applications 2017 for Linux*. -------------------------------------------------------------------------------- Press "Enter" key to quit: