Go Wiki: heapdump13
其他版本的堆疊傾印格式
- Go 1.4: heapdump14
- Go 1.5 以上：heapdump15-through-heapdump17
簡介
Go 1.3 新增一個 runtime/debug.WriteHeapDump 函式，可將堆疊中的所有物件加上其他資訊（根、goroutine、完成處理常式等）寫入檔案。此檔案的格式在此指定。
詳細資料
檔案以字串「go1.3 heap dump\n」的位元組開頭。
檔案的其餘部分是一連串的記錄。記錄可以是數種不同的種類。記錄將包含下列基本型別
- uvarint - 64 位元無符號整數，編碼方式如 encoding/binary.{Put,Read}Uvarint
- 字串 - uvarint 編碼的長度，後接相同長度的資料位元組
- 布林值 - uvarint 編碼的 0 代表 false，1 代表 true
- 欄位清單 - 記憶體區域中包含指標的部分的說明。它包含重複成對的 uvarint，編碼欄位種類和欄位偏移量，後接清單結束標記。可能的種類為 1=Ptr、2=String、3=Slice、4=Iface 和 5=Eface。0=Eol 是清單結束標記。清單結束標記沒有對應的偏移量。
每筆記錄都以 uvarint 編碼的整數開頭，說明記錄的類型
- 0 = EOF
- 1 = 物件
- 2 = otherroot
- 3 = 類型
- 4 = goroutine
- 5 = 堆疊框架
- 6 = 傾印參數
- 7 = 已註冊的完成處理函式
- 8 = itab
- 9 = 作業系統執行緒
- 10 = 記憶體統計資料
- 11 = 排隊的完成處理函式
- 12 = 資料區段
- 13 = bss 區段
- 14 = defer 記錄
- 15 = panic 記錄
- 16 = 配置/釋放剖析記錄
- 17 = 配置堆疊追蹤範例
每筆記錄的剩餘欄位取決於類型，說明如下。
EOF
EOF 記錄沒有欄位，而且必須出現在最後。
物件
- uvarint：物件的位址
- uvarint：類型描述符的位址（或 0，如果未知）
- uvarint：物件的種類（0=一般 1=陣列 2=通道 127=保守掃描）
- 字串：物件的內容
對於陣列或通道種類，類型不可為零。
內容字串的大小是包含的 sizeclass 大小，而不是類型本身的大小。因此，內容大小可能會比類型大小大一些。對於陣列和通道類型來說，它可能會大很多。例如，具有 n 個元素的陣列的內容大小將大於或等於類型大小的 n 倍。
otherroot
- 字串：此根源自何處的文字描述
- uvarint：根指標
類型
- uvarint：類型描述符的位址
- uvarint：此類型物件的大小
- 字串：類型的名稱
- 布林值：包含此類型值的介面的資料欄位是否為指標
- 欄位清單：此類型物件中包含指標的欄位的種類和位置清單
goroutine (G)
- uvarint：描述符的位址
- uvarint：堆疊頂端的指標（目前執行的框架，又稱深度 0）
- uvarint：go 常式 ID
- uvarint：建立此 goroutine 的 go 陳述式的所在位置
- uvarint：狀態
- 布林值：是否為系統啟動的 Go 常式
- 布林值：是否為背景 Go 常式
- uvarint：go 常式上次開始等待的近似時間（自紀元以來的奈秒數）
- 字串：等待的原因文字說明
- uvarint：目前執行的框架的內容指標
- uvarint：os 執行緒描述符 (M) 的位址
- uvarint：頂端 defer 記錄
- uvarint：頂端 panic 記錄
可能的狀態
- 0 = 空閒
- 1 = 可執行
- 3 = 系統呼叫
- 4 = 等待
在所有情況下都必須存在等待欄位，但只有在狀態為「等待」時才有意義。
堆疊框架
- uvarint：堆疊指標（框架中最低位址）
- uvarint：堆疊深度（0 = 堆疊頂端）
- uvarint：子框架的堆疊指標（或為 0，表示沒有子框架）
- 字串：堆疊框架的內容
- uvarint：函式的進入 pc
- uvarint：函式的目前 pc
- uvarint：函式的繼續 pc（函式可能從此處繼續執行，若有）
- 字串：函式名稱
- fieldlist：此框架中包含指標的欄位的種類和偏移清單
傾印參數
- 布林值：大端序
- uvarint：指標大小（以位元組為單位）
- uvarint：通道標頭大小（以位元組為單位）
- uvarint：堆的起始位址
- uvarint：堆的結束位址
- uvarint：thechar = 架構指定符
- 字串：GOEXPERIMENT 環境變數值
- uvarint：runtime.ncpu
完成函式
- uvarint：具有完成函式的物件位址
- uvarint：指向描述完成函式的 FuncVal
- uvarint：完成函式進入點的 PC
- uvarint：完成函式引數類型
- uvarint：物件類型
此完成函式已向執行時期系統註冊，但它所引用的物件在最近一次 GC 時仍可存取，或是在最近一次 GC 之後才配置。
itab
- uvarint：Itab 位址
- 布林值：具有此 itab 的 Iface 的資料欄位是否為指標
作業系統執行緒 (M)
- uvarint：此作業系統執行緒描述符的位址
- uvarint：執行緒的 Go 內部 ID
- uvarint：作業系統的執行緒 ID
memstats
傾印 MemStats 的前 26 個欄位。所有欄位都使用 uvarint 傾印，但第 25 個欄位使用 256 個 uvarint 傾印。
queuedfinalizer
- uvarint：具有完成函式的物件位址
- uvarint：指向描述完成函式的 FuncVal
- uvarint：完成函式進入點的 PC
- uvarint：完成函式引數類型
- uvarint：物件類型
此完成函式已準備好執行 - 它所引用的物件不可存取。執行時期系統只是尚未執行它。
資料
- uvarint：資料區段起始位址
- 字串：資料區段的內容
- fieldlist：資料區段中包含指標欄位的種類和偏移量。
bss
格式與資料相同，但適用於 bss 區段。
defer
- uvarint：遞延記錄地址
- uvarint：包含的 goroutine
- uvarint：argp
- uvarint：pc
- uvarint：遞延的 FuncVal
- uvarint：遞延進入點的 PC
- uvarint：連結至下一個遞延記錄
panic
- uvarint：panic 記錄地址
- uvarint：包含的 goroutine
- uvarint：panic 參數 eface 的類型指標
- uvarint：panic 參數 eface 的資料欄位
- uvarint：指向目前正在執行的遞延記錄
- uvarint：連結至下一個 panic 記錄
配置/釋放剖析記錄
- uvarint：記錄識別碼
- uvarint：配置物件的大小
- uvarint：堆疊框架數目。針對每個框架
-
- 字串：函式名稱
-
- 字串：檔案名稱
-
- uvarint：行號
- uvarint：配置數目
- uvarint：釋放數目
配置範例記錄
- uvarint：物件的位址
- uvarint：配置/釋放剖析記錄識別碼
此內容為 Go Wiki 的一部分。