如何使用OneAPI内置Intel GDB调试GPU offload的DPC++程序并切换inferior与线程

前置准备 #

• 完成OneAPI Basekit环境初始化：执行环境初始化脚本后确认能调用gdb-oneapi命令，该命令内置了DPC++异构调试、GPU设备指令解析的扩展能力，系统默认的原生GDB不支持设备端代码调试
• 编译示例程序时必须开启调试符号、关闭优化，参考编译命令：
  dpcpp -g -O0 -fno-sycl-unnamed-lambda 示例代码文件.cpp -o 可执行程序名
  说明：-O0避免内核代码被编译器重排导致断点位置偏移；-fno-sycl-unnamed-lambda为匿名内核lambda生成稳定符号名，方便定位设备端代码

启动调试 #

直接通过Intel GDB加载编译好的可执行文件：
gdb-oneapi ./可执行程序名

GPU内核调试操作步骤 #

1. 先在主机端的q.submit代码块位置打主机断点，启动程序运行，完成SYCL队列初始化、设备匹配流程，让程序停在准备提交内核的位置
2. 程序停在主机断点后，直接在内核代码行打设备断点即可——比如示例中标注// breakpoint-here的代码行，输入break 文件名:行号，Intel GDB会自动识别该代码属于GPU侧内核，将断点下发到GPU设备端
3. 继续执行程序，当内核被offload到GPU执行时，断点会自动命中。此时即可像调试CPU代码一样单步执行next/step，查看index、访问器变量、分支判断逻辑的执行结果，逐行验证then-branch、else-branch的运行是否符合预期

不同Inferior与线程的切换方法 #

异构调试场景下，Intel GDB会将主机CPU线程、GPU上的每一个工作项都映射为独立的调试线程上下文，多设备并行的场景下会生成对应的独立inferior实例：

• 查看全量调试上下文：
  • 输入info threads列出所有线程ID、对应执行位置
  • 输入info inferiors列出所有独立的进程组实例（对应不同设备的调试上下文）
• 上下文切换命令：
  • 在线程间切换：输入thread <目标线程ID>，即可在不同GPU工作项、主机CPU线程间切换。比如示例中长度为64的parallel_for会对应64个设备线程，切换到对应线程即可查看对应下标的index取值：切到id0为偶数的线程，就能看到代码走入result = result + 50的then分支；切到id0为奇数的线程，就能看到代码走入result = -1的else分支
  • 在inferior间切换：输入inferior <目标inferior ID>，即可在不同设备对应的独立调试进程组之间切换
• 辅助调试操作：
  • 输入set scheduler-locking on锁定当前调试焦点，避免其他工作项在单步调试时被调度执行干扰当前调试流程
  • 输入info foci快速定位当前所有调试焦点的位置，不用翻找全量线程列表

常见问题排查 #

• 如果GPU端断点未命中，优先检查编译参数是否开启了高优化等级、是否缺失调试符号、是否未给匿名lambda生成稳定符号
• 调试过程中如果需要批量查看所有工作项的变量值，可使用thread apply all <查询命令>批量执行，无需逐线程切换

内容的提问来源于stack exchange，提问作者AlekhyaV - Intel