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