我与LLVM的旅程（GSoC'20最终评估）

我的 GSoC 项目结束了，这是我在过去三个月工作的一份报告。我的项目是为yaml2obj添加 DWARF 支持，特别是yaml2elf。原始提案在这里。

实施状态#

在我的导师 James 和其他社区成员的帮助下，我能够完成原始提案中的大部分里程碑。现在，该工具的可用性有了很大改善。以下是一些突出的功能。

* DWARF 节的InitialLength字段被替换为Format和Length。起初，我们必须硬编码InitialLength字段以指示工具发出适当的 DWARF64 或 DWARF32 节，例如：

## DWARF32节。
InitialLength:
  TotalLength32: 0x1234

## DWARF64节。
InitialLength:
  TotalLength32: 0xffffffff
  TotalLength64: 0x1234

现在，yaml2obj默认发出 DWARF32 节，Length字段可以省略，yaml2obj会为我们计算它（解决此问题的补丁：D82622, D85880, D81063, D84008, D86590, D84911）。

## DWARF32节。
## Format和Length字段可以省略。
## 我们不需要关心它们。

## DWARF64节。
Format: DWARF64 ## 我们只需要指定Format字段。

* yaml2obj支持发出多个缩写表。 yaml2obj之前只支持发出一个缩写表，多个编译单元必须共享同一个缩写表，在D86194和D83116之前。现在，yaml2obj能够发出多个缩写表，编译单元可以链接到其中的任何一个。我们为缩写表添加了一个可选字段ID，为编译单元添加了一个可选字段AbbrevTableID。编译单元可以使用AbbrevTableID链接具有相同ID的缩写表。然而，编译单元的AbbrOffset字段对应于debug_abbrev_offset字段仍然需要指定。如果未来D86614能够被接受，我们就不需要再计算和指定它了！

debug_abbrev:
  - ID: 0
    Table:
      ...
  - ID: 1
    Table:
      ...
debug_info:
  - ...
    AbbrevTableID: 1 ## 引用第二个缩写表。
  - ...
    AbbrevTableID: 0 ## 引用第一个缩写表。

* 支持更多 DWARF 节。 yaml2obj新支持debug_rnglists、debug_loclists、debug_addr和debug_str_offsets节。有关更多信息，请查看D83624、D84234、D81541和D83853！

* DWARF 支持已添加到elf2yaml并在macho2yaml中改进。起初，macho2yaml的输出很嘈杂。它将 DWARF 节输出两次，一次在Sections:条目中，一次在DWARF:条目中，例如：

## debug_str节的内容被输出两次！
Sections:
  - sectname: __debug_str
    ...
    content: 6D61696E00 ## "main\0"
DWARF:
  debug_str:
    - main

在D85506之后，如果 DWARF 解析器无法将 DWARF 节解析到DWARF:条目中，obj2yaml将以原始内容节的形式输出它们，否则，它们将在DWARF:条目中作为结构化 DWARF 节呈现。此外，D85094为elf2yaml添加了 DWARF 支持。尽管它仅支持输出debug_aranges节，但我们可以在未来轻松扩展它。

未完成的任务#

* 允许用户以高级别描述 DIE。在我的原始提案中，我们计划使yaml2obj支持以高级别描述 DIE。然而，yaml2obj当时不支持发出多个缩写表，我花了一些时间使其能够发出多个缩写表并链接编译单元。我不会离开社区，我会在未来改进它。

我在 Phabricator 上的用户名是@Higuoxing。如果您在编写 DWARF 测试用例时遇到困难或发现错误，请随时联系我。我很乐意提供帮助！

致谢#

我想对 @jhenderson（James Henderson）在这个项目中指导我表示衷心的感谢。此外，我还要感谢 @grimar（George Rimar）、@MaskRay（Fangrui Song）、@labath（Pavel Labath）、@dblaikie（David Blaikie）、@aprantl（Adrian Prantl）和 @probinson（Paul Robinson）对我的补丁进行审查，耐心回答我的问题并对我的提案留下评论！