上一篇《手動解析 CrashLog 之——方法篇》講的是手動還原崩潰堆疊的操作步驟,這一篇想往下一層挖:dwarfdump、atos 這些工具,究竟是如何從符號表檔案裡把「崩潰位置」這條資訊取出來的?要回答這個問題,得先從 .dSYM 說起。
.dSYM 並不是什麼神秘的私有格式,它本質上是一個檔案目錄,裡頭真正承載調試資訊的檔案採用 DWARF 格式,而這些內容原本是嵌在 Mach-O 裡的,只是被「抽」了出來。關於蘋果為什麼要這樣設計,可以參考蘋果工程師寫的《Apple's "Lazy" DWARF Scheme》一文。
平時我們編譯(Build)或歸檔(Archive)時,Xcode 已經順手把 .dSYM 產好了。當然,如果你偏不想要,也可以透過調整若干 Build Settings 把這個行為關掉。
另一條路是拿 Xcode 自帶的 dsymutil,直接從已編譯產物中的 Mach-O 檔案把符號表剝出來:
$ /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/dsymutil \
/Users/wangzz/Library/Developer/Xcode/DerivedData/YourApp-cqvijavqbptjyhbwewgpdmzbmwzk/Build/Products/Debug-iphonesimulator/YourApp.app/YourApp \
-o YourApp.dSYM
其實 Xcode 在後台做的也是同一件事——它並沒有什麼獨門秘方。
DWARF(Debugging With Arbitrary Record Formats)是 ELF、Mach-O 這類可執行檔格式中,用來存放與處理調試資訊的通用標準;.dSYM 裡真正有料的,就是 DWARF 檔案。DWARF 把不同類別的資訊分門別類放進各自的 section(節)中,在 ELF 裡這些 section 名稱一律以「.debug_」開頭:
| Section 名稱 | 內容說明 |
|---|---|
| .debug_abbrev | .debug_info 中所使用的縮寫定義 |
| .debug_aranges | 記憶體位址與編譯單元之間的對應關係 |
| .debug_frame | 呼叫堆疊資訊(Call Frame Information) |
| .debug_info | DWARF 的核心資料,由一顆顆 DIE 組成 |
| .debug_line | 行號程式(Line Number Program) |
| .debug_loc | 巨集描述資訊 |
| .debug_macinfo | 供全域物件與函式查詢的對照表 |
| .debug_pubnames | 供全域物件與函式查詢的對照表 |
| .debug_pubtypes | 供全域型別查詢的對照表 |
| .debug_ranges | DIE 所引用的位址範圍 |
| .debug_str | .debug_info 使用的字串表 |
Mach-O 在命名上略有不同,它把名稱開頭的「.」換成了「_」,也就是說 .debug_info 在 Mach-O 中會變成 _debug_info。
DWARF 中的資訊壓縮程度相當高,人眼無法直接閱讀,這時就要靠 dwarfdump 把它翻成人話。前面列的那麼多 section,其實定位一行崩潰程式碼只需要兩個就夠了:.debug_info 與 .debug_line。由於輸出量可觀,實務上我們通常把結果導向檔案方便翻查:
$ dwarfdump -e --debug-info YourPath/YourApp.dSYM/Contents/Resources/DWARF > info-e.txt
$ dwarfdump -e --debug-line YourPath/YourApp.dSYM/Contents/Resources/DWARF > line-e.txt
參數 -e 的作用是讓輸出更貼近人類閱讀習慣;其他 section 的抽取方式大同小異,細節查 dwarfdump 的說明即可。
上一篇已經示範過如何把執行期的崩潰位址換算成符號表中的相對位址,這裡直接沿用當時的結果:0x52846。接下來就以這個值為線索,看看工具們做了哪些事。
第一步:在 .debug_info 中找出所屬的 DIE
.debug_info 最基本的描述單位叫 DIE(Debug Information Entry,細節可查 DWARF 官方文件)。工具首先要找出「位址範圍涵蓋 0x52846」的那顆 DIE。為了說明方便,這裡直接把 info-e.txt 中對應的 DIE 節錄出來:
0x00062112: function [99] * low pc( 0x000502e0 ) high pc( 0x00053730 ) frame base( r7 ) object pointer( {0x0006212a} ) name( "-[OBDFirstConnectViewController showOilPricePickerView]" ) decl file( "/YourSourcePath/OBDFirstConnectViewController.m" ) decl line( 870 ) prototyped( 0x01 ) APPLE instruction set architecture( 0x01 )
讀懂這段輸出,資訊就很清楚了:這個 DIE 描述的是方法 -[OBDFirstConnectViewController showOilPricePickerView],它佔用的位址區間是 0x000502e0–0x00053730,而我們的目標位址 0x52846 正好落在其中。因此可以判定:崩潰發生在這個方法的某一行裡。
要補充的是,實作上不會有人用眼睛去翻,而是靠一套搜尋(通常是區間查詢)機制,在大量 DIE 中找出位址範圍覆蓋目標值的那一顆。
光是這顆 DIE,我們已經能收穫:
崩潰所在檔案:/YourSourcePath/OBDFirstConnectViewController.m 崩潰所在方法:-[OBDFirstConnectViewController showOilPricePickerView] 方法在檔案中的宣告行號:870
第二步:靠 .debug_line 鎖定精確行號
只知道「哪個方法」還不夠,我們要的是「哪一行」。這時就輪到 .debug_line 上場了。它以每個方法為一個區塊,記錄了該方法內每一行程式碼對應的符號表位址。
既然已從 .debug_info 得知方法的起訖位址是 0x000502e0 起,那麼拿起始位址到 line-e.txt 裡搜尋,就能直接定位到這個方法的行號對照表:
0x00000000000502e0 870 /YourSourcePath/OBDFirstConnectViewController.m 0x00000000000502e0 0 0x00000000000502f0 872 0x000000000005033c 873 0x0000000000050374 874 0x000000000005039e 875 0x00000000000503c8 876 ... 0x0000000000052812 880 0x000000000005283e 881 0x0000000000052846 882 0x00000000000528c8 883 ...
這段列表的第一列標明了該方法的起始位址、行號與檔案路徑;後續每一列則是「位址 → 行號」的映射。拿 0x52846 一比對,答案就出來了:第 882 行。
崩潰所在檔案:/YourSourcePath/OBDFirstConnectViewController.m 崩潰所在方法:-[OBDFirstConnectViewController showOilPricePickerView] 方法宣告行號:870 崩潰實際行號:882
把整個流程串起來看,dwarfdump 與 atos 做的事其實很樸素:先用 .debug_info 把位址縮小到某個函式,再用 .debug_line 把位址對應到確切行號。之所以平時我們不需要手動做這些,是因為工具把兩個步驟都封裝好了——但理解底層在做什麼,在遇到符號表缺失、位址錯位、靜態庫未保留 dSYM 這類棘手狀況時,才知道該往哪裡找問題。
以上為個人在工作與學習中的整理,若有理解上的錯誤,歡迎指正。
《Apple's "Lazy" DWARF Scheme》
《Introduction to the DWARF Debugging Format》