Intel Xe GPU debugging

Linaro DDT supports a number of GPU compilers that target Intel Xe GPU devices:

• Intel oneAPI DPC++/C++ Compiler (SYCL kernels and OpenMP target offload)

• Intel Fortran Compiler (OpenMP target offload)

Intel Xe GPU Debugging requires gdb-oneapi and gdbserver-ze to be available in your environment, which are typically installed by the Intel oneAPI toolkit.

Note

You must ensure that your environment is configured to enable Intel Xe GPU Debugging, in particular you must use a GPU driver that supports debugging. Additionally, if you are debugging by attaching to a running process, you need to make sure the program was run with the environment variable ZET_ENABLE_PROGRAM_DEBUGGING=1 set.

Your system administrator might already have configured these required settings for you.

For further guidance on how to configure your environment for debugging, see the Intel documentation GPU Debugging and Get Started with Intel Distribution for GDB.

• Intel Xe licensing
• Prepare to debug Intel Xe code
  • Intel oneAPI DPC++/C++ Compiler
  • Intel Fortran Compiler
• Launch the program
• Attach to running Intel Xe GPU programs
  • Remote Attach
• Intel Xe GPU Breakpoints
  • Divergent Execution
  • Conditional Breakpoints
• Intel Xe GPU Thread Details
• Known issues and limitations
  • Environment
  • Limitations