开发者通过 GSoC 2026 为 LLDB 添加 Fortran 原生支持
来源标题:Adding Fortran Support to LLDB (GSoC 2026)
LLDB 目前仅能通过原始行表解析基本断点,缺乏对 Fortran 的原生支持。该项目为 LLDB 引入 Fortran 原生支持,为构建功能完整的 Flang 调试器奠定基础。完整实现已可在个人分支获取并编译测试,但部分功能尚未合入 LLVM 主分支。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
尽管 Flang 已经日趋成熟,但其周边的开发者工具却一直滞后,尤其是缺少一个专用的调试器。LLDB 缺少对 Fortran 的原生支持,只能通过原始的行表来解析基本断点。本项目为 LLDB 增加了对 Fortran 的支持,并为构建一个功能完备的、由 Flang 支持的调试器奠定了基础。
具体而言,本工作引入了对以下内容的原生支持:
由于这一规模的项目上游化流程仍在进行中,并非所有功能都已合并到 LLVM 主分支。不过,任何人均可获取一份可用的实现进行测试。你可以查看完整的改动集,克隆代码,并从我个人的分支自行编译。
如需了解本项目集成工作的最新进展,可以关注跟踪 issue。
要向 LLDB 添加一门新语言,需要让它学会如何从编译后的二进制文件中提取、表示和显示值。这依赖于三个核心组件:
关于如何向 LLDB 添加新语言的更多细节,请参阅官方文档。
在向 LLVM 提出任何重大改动之前,首先需要经过 RFC 流程。简而言之,就是撰写一份提案,概述改动内容、动机、整体架构以及待解决的问题。随后收集反馈,如果达成共识,改动即被接受并可以上游化。
我的 RFC 达成共识用了大约两个月,因为这是一个重要的新功能,但这个过程让我学到了很多关于如何表达想法以及与其他开发者互动的经验。
我们在 RFC 中达成的最重要决定包括:
在 GSoC 的大部分时间里,开发工作在我的个人 LLVM fork 上进行,同时等待社区对 RFC 达成共识。达成共识后,工作重心转向将改动拆分为小而可增量测试、便于维护者审查的 pull request。
为确保长期稳定、不发生回归,该实现利用了 LLDB 基于 lit 的测试基础设施,覆盖两个不同层面:
单元测试(C++):新增三个测试套件,用于隔离测试核心组件:
API 测试(Python / SB API):使用 LLDB 的 Scripting Bridge API 进行端到端集成测试。这些测试会编译示例 Fortran 程序、启动调试会话,并验证插件、DWARF 解析器和类型系统能够正确通信,从而检查变量并打印输出。
关于 LLDB 测试标准的更多细节,请参阅官方测试文档。
对于 API 测试,LLDB 需要编译示例 Fortran 程序。该补丁更新了 LLDB 的测试运行器,使其能够自动检测已安装的 Fortran 编译器,并据此有条件地启用 Fortran 测试套件。
PR #208298
在添加实际语言功能之前,LLDB 需要大量样板代码来满足其内部接口,尤其是 TypeSystem,它仅仅为了通过编译就需要众多存根方法。为了让补丁保持增量、易于审查,这一初始脚手架被拆分为三个最小化的 PR,其中不包含任何实际功能逻辑(除了注册语言插件本身):
Fortran 中的基本类型包括 INTEGER、REAL、LOGICAL 和 COMPLEX,它们都由 DW_TAG_base_type 这个 DWARF 标签描述。
TypeSystemFortran 负责管理 LLDB 中所有 Fortran 类型的生命周期和表示:
在 TypeSystemFortran 中添加对基本类型的支持 PR #218269
DWARFASTParserFortran 在编译器生成的原始调试符号与 LLDB 的内部类型系统之间架起桥梁:
为了表示 Fortran 函数和子程序,TypeSystemFortran 跟踪三个关键要素:
当遇到 Fortran 函数或子程序时,DWARFASTParserFortran 负责两项主要任务:
为了让变量值能够正确打印,TypeSystem 需要提供关于如何显示这些值的信息,例如其编码和格式化方式,同时实现 DumpTypeValue,以便将值格式化并输出到流中。
有了这一改动,frame variable 便能以可预期的方式打印变量:
(lldb) frame variable num_real (REAL) num_real = 2.71828175 (lldb) frame variable num_int (INTEGER) num_int = 152 (lldb) frame variable num_logical (LOGICAL) num_logical = true (lldb) frame variable z1
TypeSystemFortran 将复数格式化为 (实部, 虚部),以匹配 Fortran 的打印方式
(COMPLEX(KIND=8)) z1 = (3, 4)
有了这一改动,也相应添加了 API 测试,因为在此之前输出无法被测试。
与非数组类型关联的指针与类 C 语言类似。因此处理它们只需要指针所指向的类型(pointee type)。
TypeSystem 根据 pointee type 创建指针类型,也能从指针类型获取 pointee type,反之亦然。
DW_TAG_pointer_type 以子元素的形式持有对 pointee type 的引用,因此 pointee type 会借助该引用递归解析,并传递给 TypeSystem。
(lldb) frame variable target_val (INTEGER) _QFEtarget_val = 42 (lldb) frame variable int_ptr (INTEGER *) _QFEint_ptr = 0x000055555563d1e8 (lldb) frame variable &target_val (INTEGER *) &_QFEtarget_val = 0x000055555563d1e8 (lldb) frame variable func_ptr (INTEGER <unnamed function>(INTEGER * ) *) _QFEfunc_ptr = 0x0000555555556740 (lldb) image lookup -a 0x0000555555556740 Address: pointers[0x0000000000002740] (pointers.PT_LOAD[1]..text + 896) Summary: pointers`square at pointers.f90:24
关于输出的说明:变量显示时带有经过名称修饰(mangled)的名字,因为 LLDB 无法访问 Flang 的 demangler。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。