Troubleshooting
Target Installation Fails
Error message: Another version of this product is already installed.
You see this error when Intel® Distribution for GDB* Target from previous Beta releases or Intel® Debugger for Heterogeneous Compute Target included in Intel® System Studio are installed on your system.
To avoid this error, remove previously installed packages using Add/Remove Programs on the Control Panel.
Unable to start debugging
Error message:
Unable to start debugging. Unexpected GDB output from command "-target-select remote <remote machine IP address>:1234". Remote communication error. Target disconnected.: No such file or directory.
Check whether in Tools > Options > Intel oneAPI > Intel® Distribution for GDB* **, the **Server field is set correctly.
Deployment errors
Error message:
There were deployment errors.Continue?
Check if the “Remote Debugger” is running on the target.
If the “Remote Debugger” is running and the error persists, please restart the target and try again.
WMI operation failed
If the following error message appears:
Unable to connect to remote target <target-name>: The RPC server is unavailable.
Or a pop-up “Windows* Management Instrumentation (WMI) operation failed” window is shown, disable the Remote User Account Control (UAC) by executing the following command in the console as Administrator:
reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f
Try to connect again.
Breakpoint Is Not Hit
No error messages are displayed but a breakpoint inside the kernel is not hit.
Check whether in Tools > Options > Intel oneAPI > Intel® Distribution for GDB*, the Enable Debugging field is set to True.
For OpenCL™ applications, verify the following:
-s flag in clBuildprogram defines the absolute path of the kernel source file.
The kernel source file is accessible on both host and target systems.
Debugging option is enabled for Intel Distribution for GDB with Enhanced GPU Offload. Refer to the setup instruction.
Intel Distribution for GDB may not have started and the default version is still running, which does not support GPU breakpoints. See step 2 under Cannot Connect to Target to perform a manual launch.
Unhandled Exception in igc64.so
You can get an unhandled exception coming from IGC at the runtime when the Debug information format is set. To resolve this issue, set Property pages > Linker > Pass additional options to device compilers to /Od.