20.3. DDBを使ったオンラインカーネルデバッグ

kgdb は非常に高レベルのユーザインタフェースを提 供するオフラインデバッガですが, いくつかのことはできません. (できないことの中で)極めて重要なことはカーネルコードへのブレークポイ ントの設定とシングルステップ実行です.

カーネルの低レベルデバッグが必要であれば, DDBと呼ばれる on-lineデバッ ガが使えます. ブレークポイントの設定, シングルステップのカーネルの実 行, 変数の検査と変更などができます. ただし,これはカーネルのソースファ イルにアクセスすることはできません. kgdbのようにすべてのデ バッグ情報にはアクセスできず, globalと staticのシンボルにアクセス することができるだけです.

カーネルに DDBを含めるためにはコンフィグファイルに次のようなオプショ ンを加えて,

        options DDB

再構築をおこないます. ( FreeBSDのカーネルの設定の詳細については FreeBSDカーネルのコンフィグレーションを参照してくださ い. もしブートブロックが古いバージョンですと, デバッガのシンボルが完 全にはロードされないかもしれませんので注意してください. DDBシンボル がロードされるようにブートブロックを最新の物にアップデートしてくださ い)

DDB カーネルの実行において, DDBに入るいくつかの方法があります. 最初 の, 最も早い方法はブートプロンプトが出ている時に-dのブート フラグをタイプすることです. カーネルはデバッグモードで起動し, デバ イスのプローブ以前に DDBに入ります. したがって, デバイスのプローブ/初期 設定ファンクションのデバッグができます.

2つ目のシナリオはキーボードのホットキーで, 通常は Ctrl-Alt-ESCです. syscons ではホットキーは再設定することができ, 配付されているいくつかの キーマッピングでは別のキーに再設定されていますので確認しておいてください. シリアルラインの BREAKを使って シリアルコンソールから DDBへ入ることを可 能にするオプションもあります (カーネルコンフィグレーションファイルの ``options BREAK_TO_DEBUGGER''). これは 多くのつまらないシリ アルアダプタが, 例えばケーブルを引き抜いた時に BREAK状態を意味もなく 作り出してしまうのでデフォルトでは無効になっています.

3つ目は, DDBを使うようになっているカーネルがパニック状態になると DDB へ入るというものです. このため, 無人運転するマシンのカーネルにDDBを 入れるのは賢明ではありません.

DDBのコマンドはおおまかには gdb のいくつかのコマンドと似て います。おそらく最初にブレークポイントを設定する必要があるでしょう。

  b function-name
  b address

数値はデフォルトでは16進数で, シンボル名とはまったく異ります. 16進数で a-f の文字で始まる場合は, 先頭に 0xをつける必要があります(それ以外の数字の場合はどちらでもか まいません). function-name + 0x103のような単純な式を使うこ とができます.

割り込みされたカーネルから処理を続行するためには,

  c

  trace

DDB にホットキーで入った場合は, カーネルはその (ホットキーの) 割り込み の処理を行っていますのでスタックトレースはあまり役にたたないことに注 意してください.

ブレークポイントを削除したい場合は,

  del
  del address-expression

  show b

  s

  n

Note: これは gdb の `next' 命令とは異ります. gdbの `finish'命令と似ています.

メモリ上のデータを調べるには (例として) 次のようにします.

  x/wx 0xf0133fe0,40
  x/hd db_symtab_space
  x/bc termbuf,10
  x/s stringbuf

  x ,10

  x/ia foofunc,10

メモリの内容を変更するには writeコマンドを使います.

  w/b termbuf 0xa 0xb 0
  w/w 0xf0010030 0 0

現在のレジスタ群の内容を知りたい場合は

  show reg

  p $eax

  set $eax new-value

DDBからカーネルの関数を呼び出す必要がある場合は, 単に

  call func(arg1, arg2, ...)

動いているプロセスの ps(1)スタイルの概要は

  ps

カーネルの失敗の原因の調査が終わったらリブートすべきです. それまでの 不具合によりカーネルのすべての部分が期待するような動作をしているわけ ではないということを忘れないでください. 以下のうちいずれかの方法でシ ステムのシャットダウンおよびリブートを行ってください.

  call diediedie()

カーネルをコアダンプしてリブートしますので, 後で kgdbによってコアの高 レベル解析をすることができます. このコマンドは通常 `continue'命令にエイリアスされています. `panic'にエイリアスされている

  call boot(0)

  call cpu_reset()

短いコマンドの要約は

  help