Tutorial

  • 2022.3
  • 09/08/2022
  • Public Content

Debugging an OpenCL™ Application

Tutorial: Debugging with Intel® Distribution for GDB*
To debug OpenCL™ applications with Intel® Distribution for GDB*, make sure you use the following flags when calling the
clBuildProgram
function:
  • -g -cl-opt-disable
    to enable the debug information and disable optimizations inside the kernel
  • -s <full_path_to_kernel.cl>
    to point to the kernel source file.
    This allows you to set a breakpoint in the following format:
    breakpoint kernel.cl:<line number>
    .
Launch the debugger as follows:
gdb-oneapi <application>
To start debugging, you must set a pending breakpoint because the kernel source file is not known to the debugger yet:
set breakpoint pending on
break kernel.cl:<line number>
run
At runtime, the kernel sources are loaded to the debugger and the breakpoint is hit, both for CPU and GPU offloads.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.