扩展 LLDB 以调试跨 CPU 和 GPU 的应用
内容提要
Meta 为 LLDB 开发了厂商中立的加速器插件架构，用于调试跨 CPU 和 GPU 的应用。该架构将 CPU 与 GPU 视为独立调试目标，由 lldb-server 中的插件协调主机与设备调试，避免将不同架构强行合并为单一进程。插件将厂商设备调试 API 转换为 LLDB 已有概念，使客户端保持中立。框架支持实时与事后 GPU 调试，大部分通用基础设施已上游至 LLVM，目标是集成新硬件时只需编写厂商插件，而无需维护独立调试器。
延伸解读
为何不把 CPU 和 GPU 塞进同一个进程模型
文章指出，传统调试器默认一个进程对应一种架构、一套线程与内存视图，但 GPU 程序会打破这些假设：主机可能是 x86-64，内核却使用完全不同的指令集；CPU 线程有熟悉的寄存器上下文，GPU 却以锁步方式执行成组 lane；主机与设备指针可能指向不同地址空间，同一地址如 0x1000 在两边含义不同。强行合并会让寄存器、内存、断点、单步和停止事件都变成条件分支，因此该架构选择把 CPU 与 GPU 表示为两个独立 LLDB target，用边界代替隐藏差异。
插件边界放在 lldb-server 的实际意义
LLDB 通过 lldb-server 启动或附加程序并执行底层调试操作，客户端与服务器之间使用 GDB remote 协议通信。由于 lldb-server 已经控制原生进程，它也是与加速器运行时协调的合适位置。新插件接口让厂商后端把设备调试 API 翻译成 LLDB 已理解的进程、线程、寄存器、内存、模块和停止原因等概念，客户端因此保持厂商中立。文章强调，命令行、远程协议、符号处理和 IDE 集成的通用改进可惠及所有加速器，而硬件与驱动栈细节仍由各厂商负责。
一次跨 CPU/GPU 调试会话如何衔接
典型流程是：LLDB 连接 lldb-server 并发现可用加速器插件；插件请求在主机进程设置内部断点，用于识别 GPU 调试会话可开始的运行时事件；主机到达断点后，lldb-server 通知插件，插件初始化厂商调试 API 并准备加速器调试端点；LLDB 再为加速器创建第二个 target 并连接。文章中的 HIP 点积示例显示，GPU 模块加载后 pending 断点才解析出位置，开发者需用 target select 在 CPU 与 GPU target 之间切换，再查看 GPU 侧回溯。
适用范围与当前边界
该框架支持实时与事后 GPU 调试，GPU core-dump 插件使用共同基类，厂商实现提供设备特有的线程、寄存器、内存和模块状态。只有被调试应用使用受支持的 GPU 运行时，GPU 调试支持才会激活；纯 CPU 应用仍走原有原生调试路径，不产生运行时计算开销。文章还提到用 mock 加速器插件在没有专用硬件的情况下验证发现、断点协调、连接创建和基本设备状态。截至写作时，大部分通用框架已上游至 LLVM，剩余部分预计不久后上游。
Q&A
Meta 为什么要在 LLDB 中引入加速器插件架构？
因为现代 AI 应用常在 CPU 和 GPU 之间来回执行，传统调试器假设一个进程只有一种架构，难以处理 CPU 与 GPU 在指令集、寄存器、内存空间和执行模型上的差异。Meta 希望将共享调试器基础设施与硬件特定控制分离，让 LLDB 保持厂商中立，同时为硬件厂商提供实现设备特定行为的集中位置。
LLDB 的加速器插件架构是如何协调 CPU 和 GPU 调试的？
该架构将 CPU 和 GPU 表示为独立的 LLDB 目标，每个目标有自己的架构和调试进程。lldb-server 中的插件负责协调：LLDB 连接 lldb-server 发现可用插件，插件可在主机进程设置内部断点，当主机到达这些点时通知插件初始化厂商调试 API 并准备加速器调试端点，随后 LLDB 为加速器创建第二个目标并连接，设备线程、寄存器、内存等复用 LLDB 已有抽象。
这种插件架构对硬件厂商和 LLDB 客户端分别有什么好处？
对硬件厂商：插件将厂商设备调试 API 转换为 LLDB 已有概念（进程、线程、寄存器、内存、模块、停止原因），厂商只需实现设备特定细节，无需维护独立调试器。对 LLDB 客户端：保持厂商中立，命令行、远程协议、符号处理和 IDE 集成等通用改进可惠及所有加速器。
LLDB 加速器插件架构支持哪些调试场景？
支持实时 GPU 调试和事后 GPU 调试。实时调试通过插件在主机进程设置断点并初始化厂商 API 来连接设备；事后调试则通过 GPU core-dump 插件，使用共同基类进行 LLDB 集成，由厂商实现提供设备特定的线程、寄存器、内存和模块状态。
目前这个框架有多少已经上游到 LLVM？
截至文章写作时，大部分通用框架已上游至 LLVM，包括 lldb-server 插件接口、用于插件发现/初始化/运行时事件协调/GPU 连接创建的 GDB-remote 数据包、关联 CPU 与 GPU 调试进程并保持独立架构的支持、多地址空间支持，以及硬件无关的 mock 测试。剩余部分预计很快上游。
开发者使用这个架构调试 GPU 时，实际会话是什么样的？
以 HIP 向量点积示例为例：LLDB 中 target list 显示两个目标（主机 x86_64 和 GPU amdgcn），设置断点后继续运行，启动内核时断点解析，切换 target select 1 后可用 bt 查看 GPU 回溯。整个过程在一个 LLDB 会话中完成，但 CPU 和 GPU 目标保持独立。
