我與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 的縮寫表。然而，對應於 debug_abbrev_offset 欄位的編譯單元的 AbbrOffset 欄位仍然需要指定。如果 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 區段，但我們未來可以輕鬆擴展它。

未完成的任務#

* 允許用戶以高級別描述 DIEs。在我的原始提案中，我們計劃讓 yaml2obj 支持以高級別描述 DIEs。然而，當時 yaml2obj 不支持發出多個縮寫表，我花了一些時間使其能夠發出多個縮寫表並將編譯單元與它們鏈接。我不打算離開社區，未來我會改進它。

我在 Phabricator 上的用戶名是 @Higuoxing。如果您在編寫 YAML 中的 DWARF 測試用例時遇到困難或遇到錯誤，請隨時聯繫我。我很樂意提供幫助！

感謝#

我想對 @jhenderson (James Henderson) 表達我誠摯的感謝，感謝他在這個項目中對我的指導。此外，我還想感謝 @grimar (George Rimar)、@MaskRay (Fangrui Song)、@labath (Pavel Labath)、@dblaikie (David Blaikie)、@aprantl (Adrian Prantl) 和 @probinson (Paul Robinson) 評審我的補丁，耐心回答我的問題並對我的提案留下評論！