Set up the machine for debugging#

Graphics driver#

Install drivers using the following guides:

The user should be in the “video” group (on Ubuntu* 18, Fedora* 30, and SLES* 15 SP1) or “render” group (on Ubuntu* 19 and higher, CentOS* 8, and Fedora* 31). An administrator with sudo or root privileges can change the group owner of /dev/dri/renderD* and /dev/dri/card* to a group ID used by your user base:

sudo usermod -a -G video <username>

NEO driver#

NEO driver 21.15.19533 or higher is required to make the debugger work correctly.

  1. Download the driver from GitHub.

  2. Install the NEO driver on the system or locally.

    • To install the driver on the system, use the command:

      sudo dpkg -i *.deb
      
    • To install the driver locally:

      1. Add the path to NEO files in LD_LIBRARY_PATH:

        cd /path/to/my/neo
        for file in `ls *.deb`; do dpkg -x $file .; done
        export MY_ACTIVE_NEO=/path/to/my/neo/usr/local/lib
        export LD_LIBRARY_PATH=${MY_ACTIVE_NEO}:${MY_ACTIVE_NEO}/intel-opencl:$LD_LIBRARY_PATH
        
      2. Add environment variables to change the behavior of the Installable Client Driver (ICD).

        ICD uses the system implementation for OpenCL™ by default. To install the driver locally, add all needed from “/etc/OpenCL/vendors/” and custom to OCL_ICD_FILENAMES. To overwrite the default behavior, use export OCL_ICD_VENDORS=:

        export OCL_ICD_FILENAMES=/path/to/my/neo/usr/local/lib/intel-opencl/libigdrcl.so:/optional/from/vendors/libintelocl.so
        export OCL_ICD_VENDORS=
        

See also:

Debug companion driver (DCD)#

  1. To install the DCD from oneAPI into the system, use the following command:

    sudo dpkg -i /path/to/oneapi/debugger/latest/igfxdcd-*-Linux.deb
    
  2. Activate the driver:

    sudo modinfo igfxdcd
    

Remove the driver from the system if you want to install a different version:

sudo dpkg -r igfxdcd

If you are installing DCD for the first time, create keys. For details, see the link at the end of this page.

See also: