GDBコマンド

ひとつ前へ　 WWWルートへ　 mad@mail.wind.ne.jp

GDBコマンド

数理設計研究所　玉置晴朗
2007/05/03

Index

コンパイル
起動
実行
停止
観察
内部変数
- コンビニエンス変数

ここの駄文よりも　日本語マニュアル群　を参照するほうがよっぽどいいんじゃないかな。
参考：GDB　デバッギング入門　RichardM.Stallman and RolandH.Pesch （株）コスモ・プラネット訳

コンパイル

g++のコマンドラインオプション -gstabsまたは -gstabs+ (pdf118)
形式が標準のままである場合、GDBにおけるほとんどのC＋＋サポートは機能しない　
9．1．1 ファイル名の拡張子による自動推測 (pdf109)
.c　→Cのソースファイル、　.C、.cc、.cxx、.cpp、.cp、.c++　→　C++のソースファイル

起動

>gdb program　　ごくあたりまえの起動方法

実行

r　省略形
run　プログラムの最初から実行する
- run arg1 arg2　引数を与えると、単体動作のときと同じように引数が渡される
  - set args　で引数を指定しておけば、runのみでも、その引数が渡される
  - path directory を指示すれば、ターゲットとGDBに、パスを環境の最初に追加できる
  - ｓhow paths　実行プログラムのサーチパス（path環境変数の設定）一覧を表示する (pdf39)
  - show environment[varname］起動時にユーザープログラムに与えられる環境変数varnameの値を表示。varnameを指定しなければ、ユーザープログラムに渡されるすべての環境変数の名前と値を表示
- run > outfile　実行中のstdoutをファイルに書き出すリダイレクションが使える、ただし制御端末は変更できない
- attach process-id　実行中のプロセスをデバッグすることができる・・・(pdf41)

停止

ブレークポイント break

該当行や関数の直前でプログラムが停止する

b　省略形
break function　関数の入り口に設定
break +offset、break -offset　停止箇所から、指定された行数だけ前または後にブレークポイントを設定
break linenum　カレントソースファイル内で指定された行にブレークポイントを設定する。カレントソースファイルとは、最後にソースコードが記述されたファイルのことである。(pdf48)
info breakpoints［n］、info break［n］、info vatchpoints［n］　観察

ブレークポイントの削除

clear function、clear filename:function
clear linenum、clear filename:linenum
delete [num1] [num2]...　num　が指定されていなければすべてのブレークポイントを削除する
d 省略形

ブレークポイントの無効化

enable、disable　引数は設定と同じ

停止したときのコマンド実行

commands [bnum]
command-list
end
停止すると、commands-endで囲まれた内部を実行する。クリアは中身無しのcommands-endを書けばよい(pdf59)

関数名がオーバーロードされているとき

break function(types)のような形式を使えば、使用する関数のバージョンを指定できる。このような形式を使用しない場合、GDBは、ブレークポイントの番号付きメニューを表示し、プロンプト＞でユーザーが選択するまで待機する。最初の2つの選択肢はつねに［0］cancelと［1］allである。1を入力するとすべての関数の各定義でブレークポイントが設定される。

現在のソースファイル以外では

break filename:linenum　ファイルfilename内のlinenumで指定された行にブレークポイントを設定
break filename：function　ファイルfilenameにある関数functionのエントリにブレークポイントを設定する

条件停止

break .... if condition
conditionで指定される条件式付きでブレークポイントを設定する。そのブレークポイントに到達するたびに条件式conditionが評価され、値が0でない場合、つまりconditionが真である場合に限り、プログラムが停止する。...部には、プログラムの停止箇所を指定する引数が入る（引数は省略可能）

一過性のブレーク

tbreak args　プログラムを1回だけ停止するブレークポイントを設定、args　はbreakと同じ

再開

継続実行

c　省略形
continue［ignore-count]　引数[ignore-count]fを使用すると、その箇所に設定されたブレークポイントを無視する回数を指定できる

次の1行を実行

s　省略形　（デバッグ情報があれば関数の中へ入っていく）
step [count]　ステップ動作を count 回実行する、ステップはソース行単位である
- デバッグ情報なしでコンパイルされた関数の実行中にstepコマンドを使用した場合、デバッグ情報を保持する関数が呼び出されるまでプログラムの実行が継続される。同様に、デバッグ情報なしでコンパイルされた関数に対してステップ実行が行われることもない。デバッグ情報のない関数に対してステップ実行を行うには、stepiコマンドを使用する。(pdf62)
n　省略形　（関数の中へ入っていかない）
next [count]　ネクストは現在のソースコードの行単位であり、関数呼び出しは１行として勘定される
finish　現在の関数の最後まで実行し、帰り引数を表示して停止する、return直前までである
until　for文などでそれらが終わるまで
マシン語単位では　stepi、nexti　がある

ウォッチポイント watch

観察

ソースコード

list　前回表示された行に後続する行を表示　デフォルトで10行
- set listsize count　デフォルト10行を変更、sbow listsize　現在の値を見る
list -　前回表示された行の前の行を表示
list linenum　カレントのソースファイルの行番号 linenumを中心に前後の行を表示
- list firstline, lastline
list function　関数function先頭を中心に前後の行を表示

ソースコードの検索

fo　省略形
forward-search regexp　または　search regexp
re　省略形
reverse-search regexp

アセンブラコード

disassemble　この特殊なコマンドは、特定範囲のメモリをマシン命令としてダンプする。デフォルトのメモリ範囲は、選択されたフレームのプログラムカウンタを囲む関数である（8086のみ？）

変数観察

p　省略形
print exp　ソース言語の形式でデータを表示する
- filename::var、funxtion::var、::var　スコープの限定(pdf89)
- p *array@len　ポインタarrayに続くlen個の変数
ptype exp　構造体やクラス宣言の形式

p の出力形式

p/x var　などといった形で使う、pと/の間にはスペースが要らない

x　16進整数
d　符号付き10進整数
u　符号無し10進整数
0　8進の整数表示
t　2進整数
a　16進絶対アドレスとして表示する他、もっとも近い先行シンボルからのオフセットアドレスとしても表示する。この形式を使用すると、未知のアドレスがどこにあるか（どの関数にあるか）を認識できる。
c　文字定数
s　文字列
f　浮動小数点

メモリ観察

x/nfu addr、x addr、x　メモリを観察する　nfuは省略可能、fuは順不同
例： x/8xb　buf　、　bufの中HEXで８個見せる
- n　規定値１　、uで指示した単位
- f　表示形式、規定値は16進
- u　メモリサイズの単位
  - b　バイト
  - h　2バイト
  - w　4バイト（規定値）
  - g　8バイト

自動表示

display exp　プログラムが停止するたびに表示される表現式のリストに表現式expを追加(pdf96)
display/fmt exp
display/fmt addr　　実際にはx/nfuを停止したときに実行するのと同じである
info display　状態表示
undisplay num　削除
disable num、enable num　不許可と許可

停止状態

info program　停止したときに状態を観察する
info breakpoints［n］、info break［n］、info vatchpoints［n］
info slgnals

コンビニエンス変数

$bpnum　ユーザが最後に設定したブレークポイント
show convenience

set
unset

コンパイル

-gstabsまたは -gstabs+

	短縮	フル	解説
実行	r	run arg1 arg2
停止

..end