コンテンツにスキップ

Go/goコマンド/vet/framepointer

出典: フリー教科書『ウィキブックス(Wikibooks)』

go vet の framepointer アナライザ

[編集]

何を検出するか

[編集]

アセンブリコードで、フレームポインタを保存する前に上書き(clobber)してしまっているコードを検出します。

前提知識:フレームポインタとは

[編集]

フレームポインタ(FP、x86-64 では RBP レジスタ)は、現在の関数のスタックフレームの基点を指すレジスタです。

スタック(上位アドレス)
┌──────────────────┐
│         呼び出し元の RBP           │ ← 保存された旧フレームポインタ
├──────────────────┤ ← RBP(現在のフレームポインタ)
│           ローカル変数             │
│               ...                  │
├──────────────────┤ ← RSP(スタックポインタ)
└──────────────────┘
(下位アドレス)

フレームポインタは以下のために使われます。

  • デバッガがコールスタックを遡る
  • プロファイラ(pprof 等)がスタックトレースを取得する
  • パニック時のスタックトレース表示

関数呼び出しの正しい手順

[編集]
// 関数プロローグの正しい順序
PUSHQ BP        // 1. まず旧 RBP を保存
MOVQ  SP, BP    // 2. 現在の SP を RBP にセット
// ここから先でレジスタを自由に使える
// 関数エピローグ
POPQ BP         // 旧 RBP を復元
RET

検出されるパターン

[編集]

① 保存前に RBP を上書き

[編集]
TEXT ·Foo(SB), NOSPLIT, $0
    MOVQ AX, BP   // ⚠️ 保存前に RBP を破壊してしまっている
    PUSHQ BP      // 今さら保存しても古い値ではない
    MOVQ SP, BP
    ...

✅ 正しい順序:

TEXT ·Foo(SB), NOSPLIT, $0
    PUSHQ BP      // ✅ まず保存
    MOVQ SP, BP   // ✅ その後セット
    MOVQ AX, ...  // 他のレジスタを使う
    ...

何が起きるか

[編集]

フレームポインタが壊れると、コードの実行自体には影響しないことがほとんどです。しかしデバッグ・プロファイリング時に深刻な問題になります。

フレームポインタが壊れた状態で pprof を実行
        ↓
スタックトレースの巻き戻しに失敗
        ↓
コールスタックが途中で切れる / でたらめになる
        ↓
パフォーマンス問題の原因特定が困難になる

asmdecl との違い

[編集]
アナライザ 対象
asmdecl Go 宣言とアセンブリの引数・サイズの不整合
framepointer アセンブリ内のフレームポインタの操作順序

どちらもアセンブリの正確さを検査しますが、着目点が異なります。

まとめ

[編集]
チェック内容 具体例
保存前の RBP 上書き PUSHQ BP より先に MOVQ AX, BP

実行時エラーにならないぶん発見が難しく、pprof のスタックトレースがおかしいと気づいて初めて発覚するようなバグです。標準ライブラリや低レベルなランタイムコードを手書きアセンブリで書く際には framepointer アナライザが重要な安全網になります。