dbx
デバッガは,コマンド行プログラムです。
これは,ソース・コード・レベルおよび機械語コード・レベルのプログラム・デバッグ用のツールであり,C 言語,Fortran,Pascal,アセンブリ言語で使用することができます。
dbx
を起動した後に,dbx
コマンドを入力して実行の制御およびトレース,変数および式の値の表示,ソース・ファイルの表示および編集を行うことができます。
代替デバッガの
ladebug
デバッガは,コマンド行およびグラフィカル・ユーザ・インタフェース (GUI) の両方を提供しています。
dbx
でサポートされていない言語をいくつかサポートするとともに,ladebug
デバッガではマルチスレッド・プログラムのデバッグ機能をサポートしています。
ladebug
についての詳細は,『Ladebug Debugger Manual』または
ladebug(1)
この章では,次の項目について説明を行います。
デバッグの一般的な留意事項 (5.1 節)
dbx
デバッガの実行 (5.2 節)
dbx
コマンドの使用方法 (5.3 節)
dbx
モニタが提供するオプションによる
dbx
コマンドの入力 (5.4 節)
dbx
の制御 (5.5 節)
ソース・コードと機械語コードの確認 (5.6 節)
デバッグ中のプログラムの実行の制御 (5.7 節)
ブレークポイントの設定 (5.8 節)
プログラムの状態の確認 (5.9 節)
複数のコア・ファイルの保存 (5.10 節)
実行中のプロセスのデバッグ (5.11 節)
マルチスレッド・プロセスのデバッグ (5.12 節)
複数の非同期プロセスのデバッグ (5.13 節)
この章全体の例で参照されている C のサンプル・プログラム
sam.c
(5.14 節)
dbx
コマンド行オプション,dbx
コマンド,変数などについての詳しい説明は,
dbx(1)
Visual Threads (「Associated Products Volume 1」CD-ROM で提供) を使用しても,論理および性能上の問題がないかどうかについて,マルチスレッド・アプリケーションを分析することができます。 Visual Threads は,POSIX Threads Library アプリケーションおよび Java アプリケーションで使用することができます。
この章の例ではサンプル・プログラム
sam
を引用します。
C 言語のソース・プログラム
sam.c
は,例 5-1
に示してあります。
この章のコマンド定義では,本書のまえがきで説明した表記法のほかに,表 5-1で説明するキーワードを使用します。
大文字の特定語は,特定の規則が適用される変数を示します。
表 5-1: コマンド構文の記述に使用されるキーワード
| キーワード | 値 |
ADDRESS |
マシン・アドレスを指定する任意の式。 |
COMMAND_LIST |
セミコロンで区切られた 1 つまたは複数のコマンド。 |
DIR |
ディレクトリ名。 |
EXP |
dbx
コマンドのプログラム変数名を含む任意の式。
式には
($listwindow
+
2)
のように
dbx
変数を指定することができる。
式で変数名
in,to,または
at
を使用する場合は,カッコで囲む必要がある。
カッコで囲まなければ,これらの語はデバッガ・キーワードとみなされる。 |
FILE |
ファイル名。 |
INT |
整数値。 |
LINE |
ソース・コードの行番号。 |
NAME |
dbx
コマンドの名前。 |
PROCEDURE |
スタック上にあるプロシージャ名またはアクティブ化レベル。 |
REGEXP |
正規表現の文字列。
ed(1) |
SIGNAL |
システム・シグナル。
signal(2) |
STRING |
任意の ASCII 文字列。 |
VAR |
有効なプログラム変数または定義済みの
dbx
変数。
表 5-8
を参照。
機械語レベルのデバッグでは,VAR
にはアドレスも指定可。
5.3.2 項で説明するように,二重の名前を使用してプログラム変数を指定しなければならない。 |
コマンドに大文字を使用する例を次に示します。
(dbx) stop VAR in PROCEDURE if EXP
例のように,stop,in,および
if
を入力します。
表 5-1
の定義に従って,VAR,PROCEDURE,および
EXP
に値を入力してください。
注意
特定の
dbxコマンドを拡張して非同期セッションの制御を行うことを含め,複数の非同期プロセスのデバッグについては,5.13 節で説明しています。
この節では,dbx
デバッガおよびデバッグの概念のいくつかを説明します。
また,デバッグ・セッションを実行する方法については,セッションを開始できる状況,エラーを取り除く方法,および起こしやすいエラーを回避する方法を含めて説明します。
プログラマの経験が十分ある場合は,この節を無視しても構いません。
5.1.1 ソース・レベルのデバッガを使用する理由
dbx
デバッガを使用すると,ソース・コード・レベルまたは機械語コード・レベルで,ターゲット・プログラムの問題をトレースすることができます。
dbx
を使用して,プログラムの制御フロー,変数,およびメモリ位置を監視しながらプログラムの実行を制御します。
また,他の人が書いたプログラムを理解するために,dbx
を使用して,そのプログラムのロジックおよび制御フローをトレースすることができます。
5.1.2 アクティブ化レベル
アクティブ化レベルは,スタックで現在アクティブな範囲で,通常はアクティブなプロシージャです。
アクティブ化スタックとは,通常
main()
という最初のプログラムから始まる呼び出しのリストです。
一番最後に呼び出されたプロシージャまたはブロックには 0 の番号が付けられます。
次に呼び出されたプロシージャには 1 の番号が付けられます。
最後のアクティブ化レベルは,常にメイン・プロシージャ,つまりプログラム全体を制御するプロシージャになります。
アクティブ化レベルはまた,プロシージャ内のローカル変数を定義するブロックで構成することもできます。
スタック・トレースを行う際 (where
および
tstack
デバッガ・コマンドを参照) およびアクティブ化スタック内を移動する際 (up,down,および
func
デバッガ・コマンドを参照) にアクティブ化レベルが表示されます。
以下に,where
コマンドでスタックをトレースした例を示します。
> 0 prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04] [1] 1 main(argc = 2, argv = 0x11ffffe08) ["sam.c":45, 0x120000bac] [2] | | | | | | | | | | | [8] | | | | [7] | | | [6] | | [5] | [4] [3]
最後に呼び出されたプロシージャは
prnt
です。
prnt
のアクティブ化レベルは
0
なので,この関数はスタックの最上位にあります。
[例に戻る]
メイン・プログラムは
main
です。
[例に戻る]
アクティブ化レベル番号
>
は,現在調査中のアクティブ化レベルを示します。
[例に戻る]
プロシージャ名 [例に戻る]
プロシージャの引数 [例に戻る]
ソース・ファイル名 [例に戻る]
現在の行番号 [例に戻る]
現在のプログラム・カウンタ [例に戻る]
dbx
デバッガは,実行時エラーだけを検出するため,デバッグ・セッションを開始する前に,コンパイラ・エラーを訂正する必要があります。
実行時エラーとは,プログラムが,コア・ファイルを作成してしまうような実行中の障害,または不正な実行結果の作成につながるものです。
実行時に異常終了するプログラムをデバッグする方法と,終了まで実行はするが,不正な実行結果を出力するプログラムをデバッグする方法は異なります。
不正な実行結果を作成するプログラムをデバッグする方法については,5.1.4 項を参照してください。
実行時にプログラムが異常終了する場合には,1 行ずつデバッグするのではなく,次の方法を使用してデバッグ・セッションを開始すると,通常は時間を節約することができます。
dbx
からプログラムを呼び出す。
where
コマンドを使用してスタック・トレースを行い,障害の位置を特定する。
注意
オブジェクト・ファイルからシンボル・テーブルの情報を削除していない場合は,当該プログラムが
-gデバッグ・オプションでコンパイルされていなくても,スタック・トレースを行うことができます。
stop
あるいは
stopi
コマンドを使用してブレークポイントを設定し,エラーを分離する。
print
コマンドを使用して変数の値を表示し,変数に不正な値が割り当てられた箇所を調べる。
この時点でまだエラーを発見できない場合には,この章で説明している他の
dbx
コマンドを使用してください。
5.1.4 不正の出力結果の原因分析
プログラムが終了まで実行しても,不正な値または出力が生成される場合には,次の手順に従ってください。
問題が発生していると考えられる位置,たとえば不正な値または出力のデータを生成する箇所のコードにブレークポイントを設定する。
プログラムを実行する。
where
コマンドを使用して,スタック・トレースを行う。
print
コマンドを使用して,問題があると考えられる変数の値を表示する。
問題が発見されるまで,手順 1 以降を繰り返す。
異常終了や不正な結果を出力しないプログラムでも,正常に動作していない場合があります。 たとえば次のような場合です。
プログラムの実行速度がひじょうに遅い。
サーバの応答が停止した。
また,プログラムが無限ループに入ることもあります。
このような場合,プログラムの実行を停止せずに状態を調べることができます。
coredump
コマンドを使用すると,実行中のプロセスのコア・スナップショットを作成できます。
省略時,コア・スナップショット・ファイルは現行ディレクトリに作成され,名前は
corefile
になります。
dbx
を使用すると,5.2.3 項
での説明どおりにコア・スナップショットを調べることができます。
詳細は
coredump(1)5.1.6 障害の回避
デバッガですべての問題が解決されるとは限りません。 たとえば,プログラムに論理エラーがある場合には,デバッガは問題の発見には利用できますが,解決はできません。 デバッガにより表示される情報が混乱していたり間違っているような場合には,次のような処理でその状況を訂正することができます。
ソース・コード行を分離可能な箇所,たとえば,if
条件の後などで論理単位に分離する。
デバッガは,同じ行に複数のソース文が記述されていると認識することができません。
実行可能ファイル・コードが欠落しているように思われても,インクルード・ファイルに含まれている可能性がある。
デバッガは,インクルード・ファイルをファイルでなく単一の行であると見なします。 このコードをデバッグする場合には,インクルード・ファイルから削除してプログラムの一部としてコンパイルします。
ソース・コードを変更した後は,必ず再コンパイルする。
再コンパイルしていなければ,デバッガに表示したソース・コードが実行可能ファイル・コードと一致しません。 ソース・ファイルが実行可能ファイルより新しい場合,デバッガは警告メッセージを表示します。
Ctrl/Z を押してデバッガを終了した後に,同じデバッグ・セッションを再開する場合には,デバッガはセッションの開始時に指定したものと同じオブジェクト・モジュールに対する処理を続行する。
これは,デバッガを停止してコード内の問題を修正し,再コンパイルした後,デバッグ・セッションを再開した場合に,デバッガが読み込むオブジェクト・モジュールには,変更が反映されていないことを意味します。 新しいセッションを開始する必要があります。
同様に,あるウィンドウでプログラムのデバッグを実行している場合に,他のウィンドウでそのプログラムを編集して再コンパイルしても,dbx
はこの変更を認識しません。
プログラムの変更を
dbx
に認識させるには,変更のたびに
dbx
を終了してから再起動してください。
dbx
キーワードと同じ名前が含まれる式を表示するためにコマンドを入力する場合には,その式をカッコで囲まなければならない。
たとえば,playback
および
record
コマンドのキーワードである
output
の値を表示するには,次のように指定しなければなりません。
詳細については5.9.4 項を参照してください。
(dbx) print (output)
デバッガが変数または実行可能ファイル・コードのいずれも表示しない場合には,プログラムをコンパイルしたときに
-g
オプションを使用したかどうかを確認する。
dbx
を呼び出す前に,デバッグ用にプログラムをコンパイルする必要があります。
デバッガ起動時に各
dbx
コマンドを実行する
dbx
初期化ファイルを作成することもできます。
5.2.1 デバッグ用プログラムのコンパイル
デバッガ用にプログラムの準備をするには,コンパイル時に
-g
オプションを指定します。
このオプションにより,シンボル・テーブル情報が
dbx
プログラムに読み込まれ,最適化レベルを
-O0
に設定します。
dbx
デバッガは,この情報を使用してソース行をリストします。
別の最適化レベル (-O2
など) を使用すると,最適化プログラムは,プログラム内の制御フローを変更はしませんが,演算命令を移動し,オブジェクト・コードとソース・コードが一致しなくなることがあります。
これらの変更されたコード・シーケンスは,デバッガを使用する場合に混乱を招く可能性があります。
-g
オプションを付けずにコンパイルしたコードで,限定されたデバッグを実行することができます。
たとえば,次のコマンドは,デバッグ用に再コンパイルしなくても,正常に動作します。
stop in PROCEDURE
stepi
cont
conti
(ADDRESS)/<COUNT>
<MODE>
tracei
このコードで限定されたデバッグを実行することはできますが,-g
を使用してプログラムを再コンパイルする方が有効です。
-g
オプションを付けないでオブジェクト・ファイルをコンパイルしても,デバッガは警告を出さないことに注意してください。
完全なシンボル・テーブル情報が利用できるのは,すべてのモジュールが
-g
オプションを付けてコンパイルされているプログラムだけです。
そうでないプログラムの場合は,-g
オプションを付けてコンパイルされたモジュールで参照されているか,または定義されているシンボルに関するシンボル・テーブル情報しか利用できません。
注意
ブレークポイントを設定するシェアード・ライブラリ・アプリケーションのルーチンはすべて,
-gオプションを使用してコンパイルする必要があります。-gオプションを指定しない場合には,dbxにブレークポイントを設定するのに必要なシンボル・テーブルの情報が生成されないため,dbxは,アプリケーションを停止することができません。
各
dbx
セッションの初めに,通常入力するコマンドを含む
dbx
初期化ファイルを作成することができます。
たとえば,そのファイルには,次のようにコマンドを指定することができます。
set $page = 5 set $lines = 20 set $prompt = "DBX> " alias du dump
初期化ファイルには,.dbxinit
という名前を付けなければなりません。
デバッガを実行するたびに,dbx
は,.dbxinit
にあるコマンド群を実行します。
dbx
デバッガは,初めに現在のディレクトリで,次に
$HOME
環境変数に割り当てられたディレクトリであるホーム・ディレクトリで,.dbxinit
を探します。
5.2.3 dbx の起動と終了
dbx
コマンドおよび必要なパラメータを入力して,シェル・コマンド行から
dbx
を実行してください。
実行後に,dbx
は,現在の関数をプログラムの最初のプロシージャに設定します。
dbx
コマンドの構文は,次のとおりです。
dbx
[ options ] [ objectfile [ corefile ] ]
dbx
コマンド行がサポートするオプションについては,表 5-2
を参照してください。
デバッグ対象のプログラムの実行可能ファイル名を指定します。
objectfile
が指定されない場合,dbx
は,省略時の設定
a.outを使用します。
プログラムの実行が異常終了した場合や,
coredump(1)dbx
はプログラムの異常終了またはスナップショットの記録された位置を特定します。
dbx
コマンドを使用すると,その時点でのプログラムの状態が判断できます。
コア・ダンプ・ファイルはすべて,省略時には
core
という名前です。
システムまたはアプリケーションのレベルでコア・ファイルの命名を有効にする方法については,5.10 節
を参照してください。
dbx
で指定可能な引数の最大数は 1000 です。
ただし,使用しているマシンのシステム制限により,この数は削減されていることがあります。
表 5-2: dbx コマンド・オプション
| オプション | 機能 |
-cfilename |
.dbxinit
ファイル以外の初期化コマンド・ファイルを選択する。 |
-Idirname |
指定したディレクトリでソース・ファイルを探すように
dbx
に指示する。
複数のディレクトリを指定するには,それぞれのディレクトリに
-I
を使用しなければならない。
dbx
の実行時に
-I
を指定しないと,デバッガは,現在のディレクトリおよびオブジェクト・ファイルのディレクトリでソース・ファイルを探す。
use
コマンドを使用して,ディレクトリを変更することができる。
5.6.1 項を参照。 |
-i |
対話型モードで
dbx
を実行する。
このオプションを付けると,デバッガが番号記号 ( # ) で始まるソース行をコメントとして扱わないようになる。 |
-k |
メモリ・アドレスをマップする。 このオプションは,カーネルのデバッグに有効である。 カーネルのデバッグについての詳細は,『Kernel Debugging』を参照。 |
-module_path |
dbx
がシェアード・ライブラリ (またはロード可能カーネル・モジュール) を検索するディレクトリ・パスを指定する。
このオプションは,たとえば,コア・ダンプ (またはカーネル・クラッシュ・ダンプ) をデバッグしていて,そのダンプが発生したときに実行していたシェアード・ライブラリ (またはモジュール) のバージョンが別の場所に移動している場合などに有用である。
カーネルのデバッグについての詳細は,『Kernel Debugging』を参照。 |
-module_verbose |
シェアード・ライブラリのロード時に
dbx
がそのパス (または,カーネルをデバッグしている場合は,ロード可能モジュール) をプリントするようにする。
省略時の設定では,dbx
はパスをプリントしない。
カーネルのデバッグについの詳細は,『Kernel Debugging』を参照。 |
-pid
process-id |
dbx
を現在実行中のプロセスにアタッチする。 |
-r |
コマンド行で指定するオブジェクト・ファイルをただちに実行する。
プログラムの実行がエラーで終了した場合には,dbx
は,そのエラーを説明するメッセージを表示する。
次に,デバッガを実行するか,またはそのプログラムに関する処理を終了させることができる。
-r
オプションを指定し,標準入力が端末でない場合,dbx
デバッガは,/dev/tty
から読み取りを行う。
プログラムが正常終了した場合には,dbx
は入力を求める。 |
次の例では,オプションを付けずに
dbx
を実行します。
オブジェクト・ファイル名が指定されていないため,dbx
は,ファイル名の入力を求めます。
この場合は,sam
を使用して応答します。
省略時のデバッガのプロンプトは,(dbx)
です。
% dbx
enter object file name (default is 'a.out'): sam
dbx version 3.12
Type 'help' for help.
main: 23 if (argc < 2) {
(dbx)
デバッグセッションを終了する場合は,quit
コマンドを使用します (簡略形の
q
コマンドも使用できます)。
quit
コマンドには引数は不要です。
5.3 dbx コマンドの使用方法
入力行には,10,240 までの文字を入力することができます。
行が長い場合は,バックスラッシュ (\) を入力してからその後に続けます。
行が長すぎると,dbx
は,エラー・メッセージを表示します。
最大の文字列の長さも,10,240 です。
次の各項では,変数名の修飾,dbx
の式と優先順位,および
dbx
のデータ型と定数について説明します。
5.3.1 変数名の修飾
dbx
の変数は,ファイル,プロシージャ,ブロック,または構造体で修飾します。
print
などのコマンドを使用して変数の値を表示する場合,dbx
は,たとえば,2 つ以上のプロシージャに同じ名前の変数がある場合など,変数の有効範囲が曖昧である可能性があると,その有効範囲を表示します。
その有効範囲が間違っている場合は,次のようにピリオドで区切って,変数の有効範囲のすべてを指定することができます。
sam.main.i | | | | | [3] | [2] [1]
dbx
デバッガは,C 言語の式演算子を認識します。
また,これらの演算子は,他のサポート言語のデバッグにも使用されます。
dbx
では,Fortran の場合も配列の添字に [ ] を使用します。
標準の C 演算子に加えて,表 5-3
に示すように,dbx
は # 記号も演算子として使用します。
表 5-3: dbx の # 式演算子
| 演算子 | 構文の説明 |
("FILE" #EXP) |
FILE
に指定されたファイル内の
#EXP
で指定される行番号を使用する。 |
(PROCEDURE #EXP) |
PROCEDURE
に指定されたプロシージャ内の
#EXP
で指定される相対行番号を使用する。 |
(#EXP) |
(#EXP)で指定される行のアドレスを返す。 |
各演算子の優先順位は,C 言語における優先順位に従います。
表 5-4
に,dbx
が認識する言語演算子を優先順位の高い順に示します。
表 5-4: C の式演算子
| 単項 | &,
+,
-,
*
(ポインタ),
#,
sizeof()
[脚注 2]
, ~,
/,
(type),
(type *) |
| 2 項 | <<,
>>,
",
!,
==,
!=,
<=,
>=,
<,
>,
&,
&&,
|,
||,
+,
-,
*,/
[脚注 3]
, %,
[],
-> |
表 5-5
に,dbx
コマンドが使用できる組み込みデータ型をリストします。
表 5-5: 組み込みデータ型
| データ型 | 説明 | データ型 | 説明 | |
$address |
ポインタ | $real |
倍精度実数 | |
$boolean |
ブール | $short |
16 ビット整数 | |
$char |
文字 | $signed |
符号付き整数 | |
$double |
倍精度実数 | $uchar |
符号なし文字 | |
$float |
単精度実数 | $unsigned |
符号なし整数 | |
$integer |
符号付き整数 | $void |
空 |
型強制のための組み込みデータ型を使用して,たとえば,変数の宣言で指定した型以外の型で変数の値を表示することができます。
dbx
デバッガは C 言語のデータ型を理解しているため,ドル記号 ($) を付けなくてもデータ型を参照できます。
dbx
への入力として受け入れ可能な定数の型を表 5-6
に示します。
定数は,省略時の設定では,10 進数の値として
dbx
の出力に表示されます。
表 5-6: 入力可能な定数
| 定数 | 説明 |
false |
0 |
true |
非ゼロ |
nil |
0 |
0xnumber |
16 進数 |
0tnumber |
10 進数 |
0number |
8 進数 |
| number | 10 進数 |
number.[number][e|E][+|-]EXP |
浮動小数点 |
注意
浮動小数点以外のオーバフローでは,右端の数字を使用します。 浮動小数点のオーバフローでは,仮数の左端,また,指数は,最上位または最下位のいずれか可能な方が使用されます。
$octin変数は,省略時の入力を 8 進数に変更します。$hexin変数は,省略時の入力を 16 進数に変更します。 5.5.2 項を参照してください。
$octints変数は,省略時の出力を 8 進数に変更します。$hexints変数は,省略時の出力を 16 進数に変更します。 5.5.2 項を参照してください。
dbx
デバッガでは,コマンド・ヒストリ,コマンド行編集,およびシンボル名の補完が可能です。
また,dbx
デバッガでは,入力行に複数のコマンドを使用することができます。
これらの機能を使用すると,必要な入力数を減らしたり,前に実行したコマンドを繰り返すことができます。
5.4.1 dbx コマンドの繰り返し
dbx
デバッガは,コマンドのヒストリを記憶して,再入力しなくてもデバッガ・コマンドを繰り返し入力できるようにします。
これらのコマンドは,history
コマンドを使用して表示することができます。
$lines
変数は,記憶するヒストリ行の数を制御します。
省略時の設定は,20 コマンドです。
set
コマンドを使用して,$lines
変数を変更することができます。
5.5.1 項を参照してください。
コマンドを繰り返すには,[Return]
キー,または感嘆符 (!) コマンドの 1 つを使用します。
次の表に,history
コマンドの形式を示します。
historyヒストリ・リストのコマンド群を表示する。
最後に入力したコマンドを繰り返す。
この機能は,$repeatmode
変数を 0 に設定するとオフになる。
5.5.1 項を参照。
!string指定した文字列で始まるコマンドで最新のものを繰り返す。
!integer指定した整数に対応するコマンドを繰り返す。
!-integer最後に入力したコマンドから数えて,指定した数 (integer) だけ前に実行したコマンドを繰り返す。
次の例では,ヒストリ・リストを表示した後,リストの 12 番目のコマンドを再実行しています。
(dbx) history 10 print x 11 print y 12 print z (dbx) !12 (!12 = print z) 123 (dbx)
dbx
デバッガには,コマンド行編集のためのコマンドが備わっています。
これらのコマンドを使用すると,コマンド全部を再入力せずにタイプ・ミスを訂正することができます。
コマンド行の編集を使用可能にするには,dbx
を呼び出す前に,EDITOR,EDITMODE,または
LINEEDIT
環境変数を設定します。
C シェルの場合に
LINEEDIT
を設定するには,次のコマンドを入力します。
% setenv LINEEDIT
Bourn シェルあるいは Korn シェルの場合は,次のコマンドを入力します。
% export LINEEDIT
このデバッガでは,コマンド行編集で次のモードが使用できます。
環境変数
LINEEDIT
が設定されていないときに,環境変数
EDITMODE
または
EDITOR
のいずれかに最後が
vi
のパスが含まれている場合,デバッガは,Korn シェルの
vi
モードに似たコマンド行編集モードを使用します。
このモードでは,次の編集キーが認識されます。
$ + - 0 A B C D E F I R S W X ^ a b c d e f h i j k l r s w x ~ Ctrl/D Ctrl/H Ctrl/J Ctrl/L Ctrl/M Ctrl/V
詳細については,
ksh(1)
環境変数
LINEEDIT
が,空文字列を含め,任意の値に設定されているか,または
LINEEDIT
が設定されていないとき,環境変数
EDITMODE
または
EDITOR
に
emacs
で終わるパスが含まれている場合には,デバッガは Korn シェルの
emacs
モードに似たコマンド行編集モードを使用します。
このモードは,LINEEDIT,EDITOR,または
EDITMODE
のいずれにより使用が可能になっているかによって,動作が若干異なります。
表 5-7
に,emacs
モードのコマンド行編集コマンドを示します。
表 5-7: emacs モードの dbx コマンド行編集コマンド
| コマンド | 機能 |
| Ctrl/A | コマンド行の行頭にカーソルを移動する。 |
| Ctrl/B | カーソルを 1 文字前に移動する。 |
| Ctrl/C | 行を消去する。 |
| Ctrl/D | カーソルの位置にある文字を削除する。 |
| Ctrl/E | 行末へカーソルを移動する。 |
| Ctrl/F | カーソルを 1 文字後に移動する。 |
| Ctrl/H | カーソルの直前の文字を削除する。 |
| Ctrl/J | その行を実行する。 |
| Ctrl/K | (EDITOR
または
EDITMODE
によって使用が可能になっている場合) カーソル位置から行末までを削除する。
現在のカーソル位置より小さい値の数値パラメータがその前に指定されている場合は,当該位置からカーソルまでを削除する。
現在のカーソル位置より大きな値の数値パラメータがその前に指定されている場合は,カーソル位置から当該位置までを削除する。 |
Ctrl/K
char |
(LINEEDIT
によって使用が可能になっている場合)
char
で指定した文字上にあるカーソルまでの文字を削除する。 |
| Ctrl/L | 現在の行を再表示する。 |
| Ctrl/M | その行を実行する。 |
| Ctrl/N | ヒストリ・リストの中の 1 行先に移動する。 |
| Ctrl/P | ヒストリ・リストの中の 1 行後に移動する。 |
Ctrl/R
char |
指定した文字を現在の行の中で探索する。 |
| Ctrl/T | カーソルの直前の 2 文字を入れ替える。 |
| Ctrl/U | 次の文字を 4 回繰り返す。 |
| Ctrl/W | 現在の行全体を削除する。 |
| Ctrl/Y | Ctrl/K で削除したテキストをカーソルの直前に挿入する。 |
| Ctrl/Z | ファイル名またはシンボル名を補完する。 |
| Escape | ファイル名またはシンボル名を補完する。 |
| 下向き矢印 | ヒストリ・リストの中の 1 行先に移動する。 |
| 上向き矢印 | ヒストリ・リストの中の 1 行後に移動する。 |
| 左向き矢印 | カーソルを 1 文字前に移動する。 |
| 右向き矢印 | カーソルを 1 文字後に移動する。 |
セミコロン (;) を区切り記号として使用して,コマンド行に複数のコマンドを入力することができます。
この機能は,when
コマンドを使用している場合に有効です。
5.8.4 項を参照してください。
1 つのコマンド行に 2 つのコマンドがある例を次に示します。 最初のコマンドでプログラムを停止させ,2 つ目のコマンドでそれを再実行しています。
(dbx) stop at 40; rerun [2] stop at "sam.c":40 [2] stopped at [main:40 ,0x120000b40] i=strlen(line1.string); (dbx)
dbx
デバッガを使用して,シンボル名を補完することができます。
名前の一部を指定して Ctrl/Z を押すと,dbx
は,固有の接頭語で始まる名前を補完します。
見つかった名前が 1 つの場合,dbx
はその名前を補完して再表示します。
2 つ以上の名前が見つかった場合には,一致するすべてのシンボル名が表示され,その 1 つを選択することができます。
シンボル名の補完を使用可能にするには,5.4.2 項で説明する方法でコマンド行編集を使用可能に設定する必要があります。
次の例では,英字
i
で始まるすべての名前を表示しています。
(dbx) i [Ctrl/Z] ioctl.ioctl .ioctl isatty.isatty .isatty i int [1] (dbx) i [2]
データ型およびライブラリのシンボルが含まれている可能性があります。 [例に戻る]
指定の文字で始まるすべての名前をリストした後,別の文字の指定および再探索ができるように,dbx
はプロンプトとともに事前に指定された文字列を再表示します。
[例に戻る]
(dbx) print file [Ctrl/Z] (dbx) print file_header_ptr 0x124ac (dbx)
dbx
デバッガには,dbx
変数の設定および削除,別名の作成および削除,サブシェルの起動,状態リスト項目の検査および削除,アプリケーションに関連するオブジェクト・ファイル・リストの表示,入力の記録および再生のためのコマンドが用意されています。
5.5.1 変数の設定および削除
set
コマンドは,dbx
変数の定義,既存の
dbx
変数値の変更,dbx
定義済み変数のリストの表示などを行います。
unset
コマンドは,dbx
変数を削除します。
プログラム変数およびデバッガ変数の値を表示するには,print
コマンドを表示します。
dbx
の定義済み変数については,表 5-8
を参照してください。
プログラム変数と同じ名前でデバッガ変数を定義することはできません。
set
および
unset
コマンドの形式は次のとおりです。
setdbx
の定義済み変数のリストを表示する。
set VAR = EXP変数に新しい値を割り当てるか,または新しい変数を定義する。
unset VARdbx
変数の値を設定解除する。
次の例は,set
および
unset
コマンドの使用例を示しています。
(dbx) set [1] $listwindow 10 $datacache 1 $main "main" $pagewindow 22 test 5 $page 1 $maxstrlen 128 $cursrcline 24 more (n if no)? n (dbx) set test = 12 [2] (dbx) set $listwindow 10 $datacache 1 $main "main" $pagewindow 22 test 12 $page 1 $maxstrlen 128 $cursrcline 24 more (n if no)? n (dbx) unset test [3] (dbx) set $listwindow 10 $datacache 1 $main "main" $pagewindow 22 $page 1 $maxstrlen 128 $cursrcline 24 more (n if no)? n (dbx)
表 5-8
に定義済みの
dbx
の変数を示します。
「タイプ」欄の I は整変数,B はブール変数,S は文字変数を示します。
テストは可能であるが変更できない変数は R で示します。
表 5-8: 定義済みの dbx 変数
| タイプ | 変数名 | 省略時の値 | 説明 |
| S | $addrfmt |
"0x%lx" |
アドレスのフォーマットを指定する。
この変数は,C 言語の
printf
文でフォーマットできるものであればいずれにも設定することができる。 |
| B | $assignverify |
1 | 変数に値を割り当てる場合に新しい値を表示するかどうかを指定する。 |
| B | $asynch_interface |
0 | 複数の非同期プロセスを制御するように
dbx
を構成する (または,できる) かどうかを制御する。
プロセスがアタッチされると 1 だけ増加され,プロセスが終了するかデタッチされると 1 だけ減少される。
ユーザによる設定も可能。
0 または負の値が設定された場合,非同期的デバッグは使用不能になる。 |
| B | $break_during_step |
0 | step/stepi,
next/nexti,
call,
return
などの処理中にブレークポイントをチェックするかどうかを制御する。 |
| B | $casesense |
0 | ソース探索および変数で大文字と小文字を区別するかどうかを指定する。 0 以外の値は区別することを意味し,0 は区別しないことを表す。 |
| I R | $curevent |
0 | status
コマンドによって最後に報告されたイベント番号を表示する。 |
| I R | $curline |
0 | ソース・コードの現在の行を表示する。 |
| I R | $curpc |
- | 現在のアドレスを表示する。
wi
および
li
の別名で使用する。 |
| I R | $cursrcline |
1 | 表示された最後の行の行番号に 1 を加えたものを表示する。 |
| B | $datacache |
1 | データ領域から情報をキャッシュして,dbx
が 1 度だけデータ領域を確認すればすむようにする。
オペレーティング・システムをデバッグする場合には,この変数を 0 に設定する。
他のシステムをデバッグする場合は,非ゼロ値に設定する。 |
| S R | $defaultin |
ヌル文字列 | record
input
コマンドを使用する場合に,dbx
が情報を格納するために使用するファイル名を表示する。 |
| S R | $defaultout |
ヌル文字列 | record
output
コマンドを使用する場合に,dbx
が情報を格納するために使用するファイル名を表示する。 |
| B | $dispix |
0 | 1 の場合,pixie
モードでデバッグする際に実命令のみを表示する。 |
| B | $hexchars |
未定義 | 非ゼロ値は,文字が 16 進数で表示されることを示す。 |
| B | $hexin |
未定義 | 非ゼロ値は,入力された定数が 16 進数であることを示す。 |
| B | $hexints |
未定義 | 非ゼロ値は,出力される定数が 16 進数で表示されることを示す。 16 進数の設定は 8 進数に優先する。 |
| B | $hexstrings |
未定義 | 非ゼロ値に設定すると,文字列が 16 進数で表示される。 ゼロの場合は,文字列は 16 進数ではなく文字で表示される。 |
| I R | $historyevent |
なし | 現在のヒストリ番号を表示する。 |
| I | $lines |
20 | dbx
ヒストリ・リストのサイズを指定する。 |
| I | $listwindow |
$pagewindow/2 |
list
コマンドが表示する行の数を指定する。 |
| S | $main |
"main" |
実行が開始されるプロシージャの名前を指定する。
dbx
は,特に指定しない限り,main()
で開始される。 |
| I | $maxstrlen |
128 | dbx
が文字列のポインタに対してプリントする,文字列の最大文字数を指定する。 |
| S | $module_path
|
ヌル文字列 | dbx
がシェアード・ライブラリ (またはロード可能カーネル・モジュール) を検索するディレクトリ・パスを指定する。
この変数は,たとえば,コア・ダンプ (またはカーネル・クラッシュ・ダンプ) をデバッグしていて,そのダンプが発生したときに実行されていたシェアード・ライブラリ (またはモジュール) のバージョンが別の場所に移動されている場合に有用。
カーネルのデバッグについての詳細は,『Kernel Debugging』を参照。 |
| I | $module_verbose
|
0 | ゼロ以外の値に設定されていると,シェアード・ライブラリのロード時に,dbx
はシェアード・ライブラリ (または,カーネルのデバッグ時にはロード可能モジュール) の位置をプリントする。
省略時の設定,あるいは,この値が 0 に設定されている場合,dbx
は位置をプリントしない。
カーネル・デバッグについての詳細は,『Kernel Debugging』を参照。 |
| B | $octin |
未定義 | 非ゼロ値に設定すると,省略時の入力定数を 8 進数に変更する。 $hexint は,この設定に優先する。 |
| B | $octints |
未定義 | 非ゼロ値に設定すると,省略時の出力定数を 8 進数に変更する。 $hexints はこの設定に優先する。 |
| B | $page |
1 | 長い情報をページングするかどうか指定する。 非ゼロ値でページングを実行し,0 は実行しない。 |
| I | $pagewindow |
種々 | 1 画面を越える長い情報を表示する場合に,表示する行数を指定する。 この変数には,端末の表示行数を設定する。 0 を指定すると,最小値の 1 行の設定になる。 省略字の値は端末のタイプに依存する。 標準ビデオ端末の場合は 24。 |
| B | $pimode |
0 | playback
input
コマンドを使用する場合の入力を表示する。 |
| I | $printdata |
0 | 非ゼロ値に設定すると,命令を逆アセンブルする場合にレジスタの値が表示される。 ゼロの場合は,レジスタの値は表示されない。 |
| B | $printtargets |
1 | 1 に設定した場合,表示される逆アセンブルのリストに,ジャンプ命令のターゲットのラベルを含める。 0 に設定した場合は,このラベルの表示を行わない。 |
| B | $printwhilestep |
0 | step
[n] および
stepi
[n] の命令で使用する。
ゼロ以外の値を指定すると,n
個のすべての行または命令が表示される。
0 を指定した場合は,最後の行または命令だけが表示される。 |
| B | $printwide |
0 | 変数を表示するフォーマットとして,水平または垂直のフォーマットを指定する。 水平フォーマットは,構造体または配列の表示に有効。 非ゼロ値は,水平フォーマットを示し,0 は垂直のフォーマットを示す。 |
| S | $prompt |
"(dbx)" |
dbx
のプロンプトを設定する。 |
| B | $readtextfile |
1 | 1 に設定した場合,dbx
は,プロセスからではなくオブジェクト・ファイルから命令を読み取ろうとする。
この変数は,デバッグ対象のプロセスがデバッグ処理の間に,コードとしてコピーされている場合には,常に 0 に設定する必要がある。
ただし,性能は,$readtextfile
を 1 に設定した場合の方が優れている。 |
| B | $regstyle |
1 | 使用するレジスタ名の型を指定する。
1 に設定した場合はハードウェア名を指定する。
0 に設定した場合は,ファイル
regdefs.h
で定義された,ソフトウェア名を指定する。 |
| B | $repeatmode |
1 | Return キーを押したときに最後のコマンドを再実行できるようにするかどうかを指定する。 非ゼロ値の場合は最後のコマンドの再実行が可能であり,ゼロの場合は繰り返さない。 |
| B | $rimode |
0 | record
output
コマンドを使用する場合に,入力を記録する。 |
| S | $sigvec |
"sigaction" |
シグナル・ハンドラを設定するためにシステムが呼び出すコード名を
dbx
に通知する。 |
| S | $sigtramp |
"_sigtramp" |
ユーザ・シグナル・ハンドラを実行するためにシステムが呼び出すコード名を
dbx
に通知する。 |
| B | $stopall_on_step |
1 | 1 の場合,dbx
はフォークされたすべての子プロセスを停止する。
0 の場合,さまざまなシステム・コールおよびライブラリ・コールで生成されたフォークの多くを無視する。
$stop_all_forks
が設定されていなければ,$stop_on_fork
の値がフォークによる
dbx
の動作を決定する。
$stop_all_forks
は,通常
$stop_on_fork
によって無視されるライブラリ・コールおよびシステム・コール内でのフォークをトラップする。 |
| B | $stop_in_main |
N/A | 使用されない。
この変数は
set
コマンドによって表示されるが,現在では
dbx
処理に対して効果はない。 |
| B | $stop_on_exec |
1 | dbx
が
execl( )
および
execv( )
への呼び出しを検出して,新しく起動されたイメージを実行可能コードの最初の行で停止するかどうかを指定する。 |
| B | $stop_on_fork |
1 | 1 の場合,dbx
は,fork( )
または
vfork( )
呼び出しによって起動された新しいイメージを,そのメインの起動ポイントまで進めた後,停止させる。
0 の場合,ブレークポイントまたはイベントにより停止するまで,処理を続行する。
$stop_all_forks
が設定されていなければ,dbx
プログラムは,システム・コールまたはライブラリ・コールからのフォークでの停止を回避しようとする。 |
| S | $tagfile |
"tags" |
tag
コマンドおよび
tagvalue
マクロがタグを探索するファイルであることを示すファイル名が入っている。 |
| I | $traploops |
3 | プログラムがトラップ処理ループに入ったと
dbx
が見なす前に,SIGTRAP
ハンドラへの連続する呼び出しの回数を指定する。 |
alias
コマンドは,新しい別名を定義したり,すべての現在の別名を表示したりします。
alias
コマンドを使用すると,どのデバッガ・コマンドにも新しく名前を付けることができます。
スペースの含まれるコマンドは,一重または二重の引用符で囲んでください。
別名の一部としてマクロを定義することもできます。
dbx
デバッガには,あらかじめ定義されている一群の別名があります。
ユーザは,これらの別名を変更したり,または新しい別名を追加したりすることができます。
別名を
.dbxinit
ファイルに入れておくことによって,後でデバッグ・セッションで使用することもできます。
コマンドの別名を削除するには,unalias
コマンドを使用します。
unalias
コマンドには削除する別名を指定します。
別名の削除は,現在のデバッグ・セッションでのみ有効です。
alias
および
unalias
コマンドの形式は次のとおりです。
aliasすべての別名のリストを表示する。
alias NAME1[(ARG1,...,ARGN)] "NAME2"新しい別名を定義する。
NAME1
には新しい別名を,NAME2
にはコマンド文字列を,ARG1,...,ARGN
にはコマンドの引数を指定する。
unalias NAMEコマンドの別名を削除する。
NAME
には別名を指定する。
alias
および
unalias
コマンドの使用例を次に示します。
(dbx) alias [1] h history si stepi Si nexti
.
.
.
g goto s step More (n if no) ?n (dbx) alias ok(x) "stop at x" [2] (dbx) ok(52) [3] [2] Stop at "sam.c":52 [4] (dbx) (dbx) unalias h [5] (dbx) alias si stepi Si nexti
.
.
.
g goto s step More (n if no)? n (dbx)
別名を表示します。 [例に戻る]
ブレークポイントを設定するために別名を定義します。 [例に戻る]
52 行目にブレークポイントを設定します。 [例に戻る]
52 行目にブレークポイントを設定したことをデバッガが認識しています。 [例に戻る]
別名
h
を削除します。
別名のリストに表示されないことに注意してください。
[例に戻る]
status
コマンドは,次のコマンドのうちで現在設定されているものがあるかどうかを確認します。
ブレークポイントに対する
stop
コマンドまたは
stopi
コマンド
行単位の変数トレース用の
trace
コマンドまたは
tracei
コマンド
when
コマンド
ファイルに情報を保管する
record input
コマンドおよび
record output
コマンド
status
コマンドには引数は不要です。
例
(dbx) status [2] trace i in main [3] stop in prnt [4] record output /tmp/dbxt0018898 (0 lines) (dbx)
大カッコ内の番号 (たとえば
[2]) は,状態項目番号を示しています。
5.5.5 ブレークポイントの削除あるいは無効化
delete
コマンドは,ブレークポイントを削除し,入出力の記録をやめます。
ブレークポイントの削除および入出力記録の中止は,status
コマンドが生成する状態リストから該当する項目を削除することによって行われます。
disable
コマンドは,項目を削除しないでブレークポイントを無効にします。
enable
コマンドを使用すると,無効にしたイベントを再度有効にすることができます。
delete
コマンドの形式は次のとおりです。
delete EXP1[,...,EXPN]指定した状態項目を削除する。
delete alldelete *すべての状態項目を削除する。
delete
コマンドの使用例を次に示します。
(dbx) status [2] record output /tmp/dbxt0018898 (0 lines) [3] trace i in main [4] print pline at "sam.c": [5] stop in prnt (dbx) delete 4 (dbx) status [2] record output /tmp/dbxt0018898 (0 lines) [3] trace i in main [5] stop in prnt (dbx)
disable
および
enable
コマンドの形式は次のとおりです。
disable EVENT1[,EVENT2,...]enable EVENT1[,EVENT2,...]指定したイベントを有効/無効にする。
disable allenable allすべてのイベントを有効/無効にする。
listobj
コマンドは,dbx
によってロードされたオブジェクト・ファイルの名前をアドレスおよびサイズとともに表示します。
これらのオブジェクトには,メイン・プログラム,およびアプリケーションで使用されるすべてのシェアード・ライブラリが含まれます。
listobj
コマンドには引数は不要です。
例
(dbx) listobj sam addr: 0x120000000 size: 0x2000 /usr/shlib/libc.so addr: 0x3ff80080000 size: 0xbc000 (dbx)
コア・ダンプが発生すると,プログラムの使用するすべてのシェアード・ライブラリの位置がコア・ファイルに記録されて,dbx
からライブラリが検索できるようになります。
ダンプの発生時に実行中だったバージョンのシェアード・ライブラリが別の場所に移動されると,dbx
はそれを検索できなくなります。
次のいずれかの方法を使用して,dbx
がシェアード・ライブラリを検索するディレクトリ・パスを指定できます
(詳細については,
dbx(1)
dbx
コマンド行で,-module_path
オプションを使ってディレクトリ・パスを指定します。
次に例を示します。
% dbx a.out core -module_path /usr/project4/lib_dir
dbx
を呼び出す前に,環境変数
DBX_MODULE_PATH
を設定します。
次に例を示します。
% setenv DBX_MODULE_PATH /usr/project4/lib_dir
dbx
セッション中に,シェアード・ライブラリを動的にロードする場合は,まず
$module_path
dbx
変数を設定してから,addobj
コマンドを使用してライブラリをロードします。
次に例を参照してください。
(dbx)set $module_path /usr/project4/lib_dir(dbx)addobj libdef.so
モジュールが適切な場所からロードされたことを確認するには,次のいずれかの方法で,verbose モジュール・ロード機能を設定します。
-module_verbose
dbx
コマンド・オプションを指定する。
環境変数
DBX_MODULE_VERBOSE
を任意の整数値に設定する。
$module_verbose
dbx
変数をゼロ以外の値に設定する。
dbx
プロンプトでサブシェルを起動するには,sh
コマンドを入力します。
サブシェルから
dbx
に戻るには,exit
を入力するか,または Ctrl/D を押します。
単一のコマンドをサブシェルで実行してすぐに
dbx
に戻るには,sh
のコマンドの後にシェル・コマンドを続けて入力してください。
例
(dbx) sh % date Tue Aug 9 17:25:15 EDT 1998 % exit
.
.
.
(dbx) sh date Tue Aug 9 17:29:34 EDT 1998 (dbx)
この節では,ソース・コードのリストおよび編集,ディレクトリの変更,ソース・ファイルの変更,ソース・コード内の文字列の探索,修飾されたシンボル名の表示,型宣言の表示などを行う方法について説明します。
5.6.1 ソース・ファイルのディレクトリ位置の指定
デバッガの実行 (5.2.3 項を参照) 時に
-I
オプションが指定されていない場合,dbx
は,現在のディレクトリまたはオブジェクト・ファイルのディレクトリでソース・ファイルを探索します。
use
コマンドには次の機能があります。
デバッガが探索するディレクトリの変更
現在使用中のディレクトリのリスト
use
コマンドは,絶対パス名および
./
などの相対パス名を認識します。
ただし,C シェルのチルド (~) は認識しません。
use
コマンドの形式は次のとおりです。
use現在のディレクトリをリストする。
use DIR1 ...
DIRN現在のディレクトリ・リストを新しいディレクトリと置換する。
例
(dbx) use . [1] (dbx) use /usr/local/lib (dbx) use /usr/local/lib [2] (dbx)
5.1.2 項で説明するように,デバッガはアクティブ化スタックのレベルを保守します。
特定のプロシージャの名前またはアクティブ化番号を探索するには,where
あるいは
tstack
コマンドを使用してスタック・トレースを行ってください。
アクティブ化スタック内の移動は,up,down
および
func
コマンドで行うことができます。
5.6.2.1 where コマンドおよび tstack コマンド
where
コマンドは,スタック・トレースを表示します。
スタック・トレースによってデバッグしているプログラムの現在のアクティブ化レベル (実行中のプロシージャ) を知ることができます。
tstack
コマンドは,すべてのスレッドのスタック・トレースを表示します。
スレッドのデバッグについては5.12 節を参照してください。
where
コマンドおよび
tstack
コマンドの形式は,次のとおりです。
where [EXP]tstack [EXP]スタック・トレースを表示する。
EXP
が指定されている場合,dbx
はスタックの上位
EXP
レベルのみを表示します。
EXP
が指定されていない場合は,スタック全体が表示されます。
サンプル・プログラム
sam.c
でブレークポイントが
prnt
に設定されると,プログラム
sam.c
は,プロシージャ
prnt()
で実行/停止します。
where
を入力すると,スタック・トレースは次のような情報を表示します。
(dbx) stop in prnt [1] stop in prnt (dbx) run
.
.
.
(dbx) where 1 > 0 prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04] | | | | | | | | | | | [6] | | | | [5] | | | [4] | | [3] | [2] [1] (dbx)
アクティブ化レベル番号 [例に戻る]
プロシージャ名 [例に戻る]
引数
pline
の現在の値 [例に戻る]
ソース・ファイル名 [例に戻る]
行番号 [例に戻る]
プログラム・カウンタ [例に戻る]
up
および
down
コマンドを使用すると,スタック内のアクティブ化レベルを上下に移動できます。
これらのコマンドは,あるレベルから別のレベルへの呼び出しを追跡する場合に便利です。
func
コマンドは,現在の行,現在のファイル,および現在のプロシージャなど,アクセスできる変数の有効範囲を変更します。
func
コマンドは,プログラムが実行されていない場合のソース・コードの検査にも使用することができます。
up,down
および
func
コマンドの形式は次のとおりです。
up [EXP]スタックのアクティブ化レベルを,指定された数だけ上げる。 省略時の値は 1 レベル。
down [EXP]スタック内のアクティブ化レベルを,指定された数だけ下げる。 省略時の値は 1 レベル。
func現在のアクティブ化レベルを表示する。
func PROCEDUREPROCEDURE
に指定されたアクティブ化レベルに移動する。
func EXP式によって指定されたアクティブ化レベルに移動する。
これらのコマンドの例を次に示します。
(dbx) where > 0 prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04] 1 main(argc = 2, argv = 0x11ffffe08) ["sam.c":45, 0x120000bac] (dbx) up main: 45 prnt(&line1); [1] (dbx) where 0 prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04] > 1 main(argc = 2, argv = 0x11ffffe08) ["sam.c":45, 0x120000bac] (dbx) down prnt: 52 fprintf(stdout,"%3d. (%3d) %s", [2] (dbx) where > 0 prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04] 1 main(argc = 2, argv = 0x11ffffe08) ["sam.c":45, 0x120000bac] (dbx) func 1 main 47 prnt(&line1) [3] (dbx)
file
コマンドは,現在のソース・ファイルの表示,あるいは現在のソース・ファイルの変更を行います。
注意
ブレークポイントまたはトレースをある行番号に設定する前に,
funcコマンドを使用して正しいプロシージャを取得してください。fileコマンドでは,デバッガがブレークポイントを設定する際に必要な詳しい情報にアクセスできません。
file
コマンドの形式は次のとおりです。
file現在使用中のファイル名を表示する。
file FILE現在のファイルを指定されたファイルに変更する。
例
(dbx) file sam.c [1] (dbx) file data.c (dbx) file data.c [2] (dbx)
list
コマンドは,ソース・コードの行を表示します。
dbx
変数
$listwindow
は,dbx
が省略時の設定でリストする行番号を定義します。
list
コマンドは,特に指定しない限り現在のファイル,現在のプロシージャ,および現在の行を使用します。
次に
list
コマンドの形式を示します。
list現在の行から
$listwindow
行をリストする。
list EXP現在の行から
EXP
行をリストする。
list EXP1,EXP2EXP1
から
EXP2
までの行をリストする。
list EXP:INT指定された行 (EXP) から指定された行 (INT) だけをリストする。
($listwindow
を無効にする。
)
list PROCEDURE$listwindow
の行数分だけ,指定されたプロシージャをリストする。
次の例では,49 行目から 2 行リストしています。
例
(dbx) list 49:2
49 void prnt(pline)
50 LINETYPE *pline;
list
コマンドの定義済み別名
w
を使用した場合は,次のように出力されます。
(dbx) w
45 prnt(&line1);
46 }
47 }
48
49 void prnt(pline)
> 50 LINETYPE *pline;
51 {
* 52 fprintf(stdout,"%3d. (%3d) %s",pline->linenumber,
53 pline->length, pline->string);
54 fflush(stdout);
右向きの山カッコ (>) は現在の行を,アスタリスク (*) はこのアクティブ化レベルのプログラム・カウンタ (pc) の位置を示します。
5.6.5 ソース・ファイル・テキストの探索
/
コマンドおよび
?
コマンドは,ソース・コード内で正規表現を探索します。
スラッシュ (/) は順方向に探索し,疑問符 (?) は現在の行から逆方向に探索します。
いずれのコマンドも,必要に応じてファイルの終わりの部分でラップ・アラウンドを行います。
ラップ・アラウンドでは,開始ポイントから再び開始ポイントに戻るまで,ファイル全体の探索を行います。
dbx
変数
$casesense
を非ゼロ値に設定した場合は,dbx
は大文字と小文字を区別します。
次の表に
/
および
?
コマンドの形式を示します。
/[REGEXP]指定された正規表現があるかどうか,コード内を順方向に探索する。 式が指定されなかった場合には,現在の 1 つ前の探索コマンドで指定された正規表現を探索する。
?[REGEXP]指定された正規表現があるかどうか,コード内を逆方向に探索する。
例
(dbx) /lines
no match
(dbx) /line1
16 LINETYPE line1;
(dbx) /
39 while(fgets(line1.string, sizeof(line1.string), fd) != NULL){
(dbx)
edit
コマンドを使用すると,dbx
内からソース・コードを変更することができます。
変更内容を有効にするには,dbx
を終了してプログラムを再コンパイルし,dbx
を再起動しなければなりません。
次に
edit
コマンドの形式を示します。
edit現在のファイルでエディタを呼び出す。
edit FILE指定されたファイルでエディタを呼び出す。
edit
コマンドは,環境変数
EDITOR
によって指定されるエディタをロードします。
EDITOR
が設定されていない場合は,vi
エディタが使用されます。
dbx
に戻るには,エディタを終了してください。
5.6.7 同じ名前の変数の識別
which
コマンドおよび
whereis
コマンドは,プログラム変数を表示します。
これらのコマンドは,異なる有効範囲で複数の同じ名前の変数を含むプログラムのデバッグに有効です。
この 2 つのコマンドは,5.3.1 項で説明した規則に従います。
次に
which
コマンドおよび
whereis
コマンドの形式を示します。
which VAR変数の省略時のバージョンを表示する。
whereis VAR指定された変数のすべてのバージョンを表示する。
次の例では,省略時の
i
変数の設定を調べ,次に
i
変数がプログラム内で 1 つしか定義されていないことを確認しています。
(dbx) which i sam.main.i (dbx) whereis i sam.main.i
whatis
コマンドは,プログラムの変数およびプロシージャの型宣言をリストします。
次に
whatis
コマンドの形式を示します。
whatis VAR指定された変数またはプロシージャの型宣言を表示する。
例
(dbx) whatis main int main(argc,argv) int argc; unsigned char **argv; (dbx) whatis i int i; (dbx)
この節では,プログラムを実行するために使用する
dbx
コマンドについて説明します。
これらのコマンドでは,プログラムの実行,ソース・コードの行単位の実行,プロシージャ呼び出しからの戻り,指定行からの開始,ブレークポイントで停止した後の再開,プログラム変数への値の割り当て,実行可能なディスク・ファイルのパッチ,特定ルーチンの実行,環境変数の設定,およびシェアード・ライブラリのロードなどを実行することができます。
5.7.1 プログラムの実行および再実行
run
および
rerun
コマンドは,プログラムの実行を開始します。
いずれのコマンドにも引数を指定し,それをプログラムに渡すことができます。
run
コマンドに引数が指定されていない場合は,dbx
は引数なしでプログラムを実行します。
rerun
コマンドに引数が指定されていない場合は,前回の
run
あるいは
rerun
コマンド実行時の引数が使用されます。
rerun
コマンドを実行する前に,args
コマンドを使用して前もって引数を指定しておくこともできます。
args
コマンドで指定された引数は,次の
run
コマンドでは無視されます。
これらのコマンドは,C シェルのリダイレクションと同様の方法で,プログラム入出力をリダイレクトすることができます。
オプションのパラメータ
<FILE1
は,入力を指定されたファイルから実行プログラムにリダイレクトする。
オプションのパラメータ
>FILE2
は,出力を実行プログラムから指定されたファイルにリダイレクトする。
オプションのパラメータ
>&FILE2
は,stderr
および
stdout
を指定されたファイルにリダイレクトする。
注意
この出力内容は,
record outputコマンドで保存した出力内容とは異なります。record outputコマンドは,プログラム出力ではなくデバッガ出力をファイルに保存します。record outputコマンドの詳細については,5.9.4.2 項を参照してください。
次に
run
コマンド,rerun
コマンドおよび
args
コマンドの形式を示します。
run [ARG1 ...
ARGN] [<FILE1] [>FILE2]run [ARG1 ...
ARGN] [<FILE1] [>&FILE2]指定された引数およびリダイレクションでプログラムを実行する。
args [ARG1 ...
ARGN] [<FILE1] [>FILE2]args [ARG1 ...
ARGN] [<FILE1] [>&FILE2]以降のコマンドで使用するために,指定した引数およびリダイレクションを設定する。
設定した値は,run
および
rerun
コマンドで新たな値が指定されるまで有効。
rerun [ARG1 ...
ARGN] [<FILE1] [>FILE2]rerun [ARG1 ...
ARGN] [<FILE1] [>&FILE2]前回に指定した引数またはリダイレクションでプログラムを再実行する。
(dbx) run sam.c [1]
0. (19)#include <stdio.h>
1. (14) struct line {
2. (19) char string[256];
.
.
.
Program terminated normally
(dbx) rerun [2]
0. (19)#include <stdio.h>
1. (14) struct line {
2. (19) char string[256];
.
.
.
Program terminated normally
(dbx)
高級言語で作成されているプログラムに対しては,step
コマンドおよび
next
コマンドを使用することによって,指定した行数のソース・コードを実行することができます。
アセンブリ言語で作成されているプログラムに対しては,stepi
コマンドおよび
nexti
コマンドを使用します。
ただしこの場合,EXP
に指定する数はプログラムの行数ではなく機械語命令の数になります。
EXP
を指定しない場合は,dbx
はソース・コードを 1 行あるいは 1 機械語命令だけ実行します。
EXP
に値を指定する際の規則は次のとおりです。
dbx
デバッガは,コメント行については
EXP
を解釈する際に無視します。
コメント行は
EXP
で指定した数に含まれません。
step
および
stepi
に対して指定した
EXP
は,現在のプロシージャおよび呼び出されるプロシージャに適用されます。
EXP
で指定しただけのソース・コードを現在のプロシージャおよび呼び出されたプロシージャで実行した後,プログラムは停止します。
next
および
nexti
に対して指定した
EXP
は,現在のプロシージャのみに適用されます。
EXP
で指定しただけのソース行を現在のプロシージャで実行した後,プログラムは停止します。
呼び出されたプロシージャで実行するソース・コードは
EXP
で指定した行数には含まれません。
次に
step/stepi
および
next/nexti
コマンドの形式を示します。
step [EXP]stepi [EXP]指定した数のソース・コード行あるいは機械語命令を実行する。
EXP
の値は,現在のプロシージャおよび呼び出されるプロシージャの両方に適用される。
省略時の値は 1。
next [EXP]nexti [EXP]指定した数のソース・コード行あるいは機械語命令を実行する。
EXP
の値は,現在のプロシージャのみに適用される。
省略時の値は 1。
例
(dbx) rerun [7] stopped at [prnt:52,0x120000c04] fprintf(stdout,"%3d.(%3d) %s", (dbx) step 2 0. ( 19) #include <stdio.h> [prnt:55 ,0x120000c48] } (dbx) step [main:40 ,0x120000b40] i=strlen(line1.string); (dbx)
$break_during_step
および
$printwhilestep
変数の値が,step/stepi
および
next/nexti
コマンドの動作に影響を与えます。
詳細については表 5-8
を参照してください。
5.7.3 return コマンド
return
コマンドは,呼び出されたプロシージャ内で使用されます。
return
コマンドは,プロシージャ内の残りの命令を実行し,呼び出しプロシージャへ戻ります。
次に
return
コマンドの形式を示します。
return現在のプロシージャの残りの命令を実行し,呼び出しプロシージャの次の行に戻って停止する。
return PROCEDURE現在のプロシージャ,および現在のプロシージャと
PROCEDURE
で指定されたプロシージャの間に介在する呼び出しプロシージャの残りの命令を実行して,指定されたプロシージャ内の呼び出しポイントで停止する。
例
(dbx) rerun [7] stopped at [prnt:52,0x120000c04] fprintf(stdout,"%3d.(%3d) %s", (dbx) return 0. (19) #include <stdio.h> stopped at [main:45 +0xc,0x120000bb0] prnt(&line1); (dbx)
goto
コマンドは,指定された行に移動して実行を続けます。
このコマンドは,when
文で,問題のあることが分かっている行を飛び越す場合などに便利です。
次に
goto
コマンドの形式を示します。
goto LINE実行を続行するとき,指定されたソース行に移動する。
例
(dbx) when at 40 {goto 43}
[8] start sam.c:43 at "sam.c":40
(dbx)
高級言語で作成されているプログラムをデバッグしている場合,ブレークポイントの後にプログラムの実行を再開するには
cont
コマンドを使用します。
アセンブリ言語で作成されているプログラムをデバッグしている場合は,conti
コマンドを使用します。
次に
cont
および
conti
コマンドの形式を示します。
contconti現在のソース・コード行あるいは機械語コード・アドレスから続行する。
cont to LINE
conti to ADDRESS指定されたソース行あるいは機械語コード・アドレスまで続行する。
cont in PROCEDURE
conti in PROCEDURE指定されたプロシージャまで続行する。
cont SIGNAL
conti SIGNAL指定されたシグナルを受信した後,現在の行あるいは機械語命令から続行する。
cont SIGNAL to LINE
conti SIGNAL to ADDRESS指定されたシグナルを受信した後,指定された行あるいはアドレスに到達するまで続行する。
cont SIGNAL in PROCEDURE
conti SIGNAL in PROCEDURE指定されたプロシージャに到達するまで続行し,シグナルを送信する。
C プログラムでの
cont
コマンドの使用例を次に示します。
(dbx) stop in prnt [9] stop in prnt (dbx) rerun [9] stopped at [prnt:52,0x120000c04] fprintf(stdout,"%3d.(%3d) %s", (dbx) cont 0. ( 19) #include <stdio.h> [9] stopped at [prnt:52,0x120000c04] fprintf(stdout,"%3d.(%3d) %s", (dbx)
アセンブリ言語プログラムでの
conti
コマンドの使用例を次に示します。
(dbx) conti 0. ( 19) #include <stdio.h> [4] stopped at >*[prnt:52 ,0x120000c04] ldq r16,-32640(gp) (dbx)
次に
assign
コマンドの形式を示します。
assign VAR = EXP
assign EXP1 = EXP2VAR
で指定したプログラム変数に新しい値を割り当てる。
または,EXP1
に指定したアドレスに新しい値を割り当てる。
例
(dbx) print i 19 [1] (dbx) assign i = 10 10 [2] (dbx) assign *(int *)0x444 = 1 [3] 1 (dbx)
patch
コマンドは,実行可能なディスク・ファイルにパッチを当てて,誤ったデータまたは命令を訂正します。
テキスト,初期化されたデータ,または読み取り専用データ領域のみにパッチを当てることができます。
bss
セグメントは,ディスク・ファイルに存在しないためパッチを当てることはできません。
patch
コマンドは,実行中のプログラムに対して実行されると,異常終了します。
次に
patch
コマンドの形式を示します。
patch VAR = EXP
patch EXP1 = EXP2VAR
に指定したプログラム変数あるいは
EXP1
に指定したアドレスに新しい値を割り当てる。
パッチは省略時のディスク・ファイルに適用されます。 省略時のディスク・ファイル以外のファイルにパッチを指定するために,修飾変数名を使用することもできます。 このようにパッチを当てることによって,パッチを当てるファイルのメモリ内イメージにもパッチを当てることができます。
例
(dbx) patch &main = 0 (dbx) patch var = 20 (dbx) patch &var = 20 (dbx) patch 0xnnnnn = 0xnnnnn
現在行のポインタをプロシージャの先頭に設定し,ブレークポイントをプロシージャの最後に置いて,プロシージャを実行することができます。
ただし,通常は,call
あるいは
print
コマンドを使用してプログラム内でプロシージャを実行するほうが簡単です。
call
あるいは
print
コマンドは,コマンド行で指定したプロシージャを実行します。
call
あるいは
print
コマンドの引数としてパラメータを指定すると,パラメータをルーチンに渡すことができます。
call
あるいは
print
コマンドは,プログラムの流れには影響を与えません。
プロシージャに制御が戻ると,プログラムは
call
あるいは
print
コマンドを入力した位置で停止しています。
print
コマンドは呼び出したプロシージャから返される値を表示しますが,call
コマンドの場合は表示しません。
次に
call
コマンドおよび
print
コマンドの形式を示します。
call PROCEDURE([parameters
])print PROCEDURE([parameters
])指定したプロシージャまたは関数に対応するオブジェクト・コードを実行する。 指定したパラメータは,指定プロシージャまたは関数に渡される。
(dbx) stop in prnt [1] [11] stop in prnt (dbx) call prnt(&line1) [2] [11] stopped at [prnt:52,0x120000c] fprintf(stdout,"%3d.(%3d) %s", (dbx) status [3] [11] stop in prnt [12] stop at "sam.c":40 [2] record output example2 (126 lines) (dbx) delete 11,12 [4] (dbx)
stop
コマンドで
prnt()
関数にブレークポイントを設定します。
[例に戻る]
call
コマンドで
prnt()
に対応するオブジェクト・コードを実行します。
参照により,line1
引数は文字列を
prnt
に渡します。
[例に戻る]
status
コマンドで現在有効なブレークポイントを表示します。
[例に戻る]
delete
コマンドで 52 行と 40 行のブレークポイントを削除します。
[例に戻る]
print
コマンドでは,出力する式にプロシージャを使用することができます。
次に例を示します。
(dbx) print sqrt(2.)+sqrt(3.)
環境変数を設定するには,setenv
コマンドを使用します。
このコマンドを使用して既存の環境変数の値を設定したり,新しい環境変数を作成したりすることができます。
環境変数は,dbx
および
dbx
の制御のもとに実行しているプログラムで表示可能ですが,dbx
環境を終了した後は表示できません。
ただし,dbx
内で
sh
コマンドを使用してシェルを起動している場合には,そのシェルは
dbx
環境変数を参照できます。
プロセスの環境変数を変更するには,dbx
内で
run
コマンドを使用してプロセスを開始する前に,setenv
コマンドを入力する必要があります。
次に
setenv
コマンドの形式を示します。
setenv VAR "STRING"既存の環境変数の値を変更するかまたは新たに値を設定する。 環境変数をリセットするには,空文字列を指定する。
(dbx) setenv TEXT "sam.c" [1] (dbx) run [2] [4] stopped at [prnt:52,0x120000e34] fprintf(stdout,"%3d.(%3d) %s", (dbx) setenv TEXT "" [3] (dbx) run [4] Usage: sam filename Program exited with code 1
setenv
コマンドで環境変数
TEXT
を
sam.c
に設定します。
[例に戻る]
run
コマンドでプログラムを初めから実行します。
プログラムは,環境変数
TEXT
に指定されたファイルから入力を読み取ります。
プログラムは 52 行目のブレークポイントで停止します。
[例に戻る]
setenv
コマンドで環境変数
TEXT
をヌルに設定します。
[例に戻る]
run
コマンドでプログラムを実行します。
TEXT
環境変数にヌル値が指定されているため,入力ファイルを指定する必要があります。
[例に戻る]
ブレークポイントは,プログラムの実行を一時的に停止し,その時点でプログラムの状態を検査できるようにします。
この節では,dbx
コマンドを使用して,特定行またはプロシージャ内にブレークポイントを設定したり,各シグナルによってプログラムの実行を停止する方法について説明します。
5.8.1 概要
プログラムがブレークポイントで停止すると,デバッガが情報メッセージを表示します。
たとえば,main()
プロシージャの 23 行目にあるサンプル・プログラム
sam.c
にブレークポイントが設定されると,次のメッセージが表示されます。
[4] stopped at [main:40, 0x120000b18] i=strlen(line1.string); | | | | | | | | | [5] | | | [4] | | [3] | [2] [1]
複数のソース・ファイルがあるプログラムにブレークポイントを設定する前には,正しいファイルにブレークポイントを設定していることを確認します。 正しいプロシージャを選択するには,次の手順を実行してください。
file
コマンドを使用してソース・ファイルを選択する。
func
コマンドを使用してプロシージャ名を指定する。
list
コマンドでファイルまたはプロシージャの行をリストする。
5.6.4 項を参照。
stop atコマンドを使用して必要な行にブレークポイントを設定する。
5.8.2 stop および stopi によるブレークポイントの設定
高級言語で作成されているプログラムのデバッグの場合,stop
コマンドは,次のように実行を停止するためのブレークポイントを設定します。
つまり,変数が変更されるか,あるいは指定された条件が真のときに,特定のプロシージャの特定の行で,プログラムの実行を停止させることができます。
アセンブリ言語で作成されているプログラムのデバッグの場合は,stopi
コマンドを使用します。
ただし,stopi
コマンドは,プログラム行の代わりに機械語命令をトレースします。
$stop_on_exec
定義済み変数を設定することにより,dbx
に指示して,exec()
によって起動された新しいイメージに入ると,停止するように設定することもできます (表 5-8
を参照)。
stop at
コマンドおよび
stopi at
コマンド
特定のソース・コード行あるいは機械語コード・アドレスにブレークポイントを設定します。
dbx
デバッガは,実行可能なコードのある行あるいはアドレスでのみ停止します。
実行不可能な行あるいはアドレスを指定した場合,dbx
は次の実行可能ポイントにブレークポイントを設定します。
VAR
パラメータを指定すると,デバッガは
VAR
に変更があるときのみ,変数を表示してプログラムの実行を停止します。
if EXP
を指定すると,EXP
が真のときのみ
dbx
が停止します。
stop in
コマンドおよび
stopi in
コマンド
stop if
コマンドまたは
stopi if
コマンド
指定した条件が真のときに,プログラムの実行を停止します。
dbx
が各行の実行後にそのつど条件の検査を行うため,プログラムの実行速度は,大幅に遅くなります。
できる限り,stop/stopi if
コマンドではなく
stop/stopi at
または
stop/stopi in
を使用してください。
$stop_on_exec
定義済み変数が 1 に設定されている場合
exec()
呼び出しにより,dbx
が停止して新しいイメージのシンボル・テーブルで読み取りを行った後,イメージのメイン起動ポイントまで進み,ユーザ入力のために停止するようにします。
delete
コマンドは,stop
あるいは
stopi
コマンドで設定したブレークポイントを削除します。
次に
stop
コマンド および
stopiコマンドの形式を示します。
stop VAR
stopi VARVAR
の値に変更があると停止する。
stop VAR at LINE
stopi VAR at ADDRESS指定したソース・コード行あるいは機械語コード・アドレスで
VAR
の値に変更があると停止する。
stop VAR at LINE if EXP
stopi VAR at ADDRESS if EXP式が真の場合に限り,指定した行あるいはアドレスで
VAR
の値に変更があると停止する。
stop if EXP
stopi if EXPEXP
が真のとき停止する。
stop VAR if EXP
stopi VAR if EXPVAR
の値に変更があり,EXP
が真のとき停止する。
stop in PROCEDURE
stopi in PROCEDUREプロシージャの先頭で停止する。
stop VAR in PROCEDUREVAR
の値に変更があると,指定されたプロシージャの中で停止する。
stop VAR in PROCEDURE if EXP
stopi VAR in PROCEDURE if EXPEXP
が真の場合,VAR
の値に変更があると,指定されたプロシージャの中で停止する。
注意
VARおよびEXPをともに指定すると,プロシージャの最初だけでなく他の箇所でも,停止する可能性があります。 この機能を使用すると,デバッガが各ソース行の実行前と後に条件の検査を行わなければならないため,実行速度が遅くなります。 なお,両方の引数が指定されている場合は,EXPは常にVARの前に検査されます。
C プログラムでの
stop
コマンドの使用例を次に示します。
(dbx) stop at 52 [3] stop at "sam.c":52 (dbx) rerun [3] stopped at [prnt:52,0x120000fb0] fprintf(stdout,"%3d.(%3d) %s", (dbx) stop in prnt [15] stop in prnt (dbx)
stopi
コマンドの使用例を次に示します。
(dbx) stopi at 0x120000c04 [4] stop at 0x120000c04 (dbx) rerun [7] stopped at >*[prnt:52 ,0x120000c04] ldq r16, -32640(gp)
高級言語で作成されているプログラムのデバッグの場合は,trace
コマンドを使用して,プログラム実行中に変数の値をリストし,トレースしている変数の有効範囲を決定することができます。
アセンブリ言語で作成されているプログラムのデバッグの場合は,tracei
コマンドを使用します。
ただし,tracei
コマンドは,プログラム行の代わりに機械語命令でトレースします。
次に
trace
および
tracei
コマンドの形式を示します。
trace LINE指定のソース行を実行するたびにリストする。
trace VARtracei VAR各ソース行あるいは機械語命令の実行後に,指定の変数をリストする。
trace [VAR] at LINEtracei [VAR] at ADDRESS指定した行あるいは命令の指定した変数をリストする。
trace [VAR] in PROCEDUREtracei [VAR] in PROCEDURE指定したプロシージャの指定した変数をリストする。
trace [VAR] at LINE if EXPtracei [VAR] at ADDRESS if EXP式が真である場合に,指定したソース・コード行あるいは機械語コード・アドレスの変数の値に変更があるとき,その変数をリストする。
EXP
は
VAR
より先に検査される。
trace [VAR] in PROCEDURE if EXPtracei [VAR] in PROCEDURE if EXP式が真である場合に,指定されたプロシージャの変数の値に変更があるとき,その変数をリストする。
EXP
は
VAR
より先に検査される。
例
(dbx) trace i [5] trace i in main (dbx) rerun sam.c [4] [main:25 ,0x400a50] (dbx) c [5] i changed before [main: line 41]: new value = 19; [5] i changed before [main: line 41]: old value = 19; new value = 14; [5] i changed before [main: line 41]: old value = 14; new value = 19; [5] i changed before [main: line 41]: old value = 19; new value = 13; [5] i changed before [main: line 41]: old value = 13; new value = 17; [5] i changed before [main: line 41]: old value = 17; new value = 3; [5] i changed before [main: line 41]: old value = 3; new value = 1; [5] i changed before [main: line 41]: old value = 1; new value = 30;
when
コマンドは,指定されたある
dbx
コマンドを実行する条件を制御します。
次に
when
コマンドの形式を示します。
when VAR [if EXP] {COMMAND_LIST}EXP
が真で,VAR
の値に変更があると,指定したコマンド・リストを実行する。
when [VAR] at LINE [if EXP] {COMMAND_LIST}EXP
が真で,VAR
の値に変更があり,かつデバッガが
LINE
の行に到達すると,コマンド・リストを実行する。
when in PROCEDURE {COMMAND_LIST}PROCEDURE
に入ると,コマンド・リストを実行する。
when [VAR] in PROCEDURE [if EXP] {COMMAND_LIST}EXP
が真で,VAR
の値に変更があると,PROCEDURE
の各行に対して,指定されたコマンドを実行する。
EXP
は
VAR
の前に検査される。
例
(dbx) when in prnt {print line1.length}
[6] print line1.length in prnt
(dbx) rerun
19 [1]
14
19
.
.
.
17
59
45
12
More (n if no)?
(dbx) delete 6
(dbx) when in prnt {stop}
[7] stop in prnt
(dbx) rerun
[7] stopped at [prnt:52,0x12000fb0] fprintf(stdout,"%3d.(%3d) %s") [2]
catch
コマンドは,dbx
が受信するシグナルをリストしたり,受信するシグナルを指定したりする場合に使用します。
プロセスが指定のシグナルを検出すると,dbx
はプロセスを停止します。
ignore
コマンドは,dbx
が受信しないシグナルをリストしたり,無視リストに追加するシグナルを指定するために使用します。
次に
catch
および
ignore
コマンドの形式を示します。
catchdbx
が受信するすべてのシグナルのリストを表示する。
catch SIGNALシグナルを受信リストに追加する。
ignoredbx
が受信しないすべてのシグナルのリストを表示する。
ignore SIGNAL指定したシグナルを受信リストから削除し,無視リストに追加する。
(dbx) catch [1] INT QUIT ILL TRAP ABRT EMT FPE BUS SEGV SYS PIPE TERM URG \ STOP TTIN TTOU IO XCPU XFSZ VTALRM PROF WINCH INFO USR1 USR2 (dbx) ignore [2] HUP KILL ALRM TSTP CONT CHLD (dbx) catch kill [3] (dbx) catch INT QUIT ILL TRAP ABRT EMT FPE KILL BUS SEGV SYS PIPE TERM URG \ STOP TTIN TTOU IO XCPU XFSZ VTALRM PROF WINCH INFO USR1 USR2 (dbx) ignore HUP ALRM TSTP CONT CHLD (dbx)
前述の例中のバックスラッシュは,行の継続を表しています。
catch
および
ignore
の実際の出力は,1 行です。
5.9 プログラム状態の検査
dbx
がブレークポイントで停止すると,プログラム状態を検査して問題のありそうな箇所を検査することができます。
dbx
デバッガには,スタック・トレース,変数値,およびレジスタ値を表示する
dbx
コマンドがあります。
スタック・トレースに記録されているアクティブ化レベルについての情報を表示したり,アクティブ化レベルを上下に変更するコマンドもあります (5.6.2 項を参照)。
5.9.1 変数および式の値の出力
print
コマンドは,1 つまたは複数の式の値を表示します。
printf
コマンドは,指定されたフォーマットで情報をリストします。
printf
コマンドは,%s
を除いて,printf()
関数でサポートするすべてのフォーマットをサポートします。
フォーマットの一覧については,
printf(3)printf
コマンドは,変数の値を別の基数で参照することができます。
コマンド別名リスト (5.5.3 項参照) には,8 進数 (po),10 進数 (pd),および 16 進数 (px) の各基数で変数の値を表示できる有効な別名が用意されています。
省略時の基数は 10 進数です。
インクルード・ファイル
regdefs.h
にある,実際のマシン・レジスタ名あるいはソフトウェア名のどちらを指定することもできます。
レジスタ番号の前に指定される接頭語は,レジスタのタイプを示します。
次の表に示すように,接頭語は
$f
または
$r
のいずれかです。
| レジスタ名 | レジスタ・タイプ |
$f00-$f31 |
浮動小数点レジスタ (32 の 1) |
$r00-$r31 |
マシン・レジスタ (32 の 1) |
$fpcr |
浮動小数点制御レジスタ |
$pc |
プログラム・カウンタ値 |
$ps |
プログラム状態レジスタ [脚注 4] |
接頭語の付いたレジスタを
print
コマンドで指定して,レジスタ値やプログラム・カウンタを表示することができます。
次のコマンドは,マシン・レジスタ 3 およびプログラム・カウンタの値を表示します。
(dbx) print $r3 (dbx) print $pc
次に
print
コマンドの形式を示します。
print EXP1,...,EXPN指定された式の値を表示する。
printf "STRING", EXP1,...,EXPNSTRING
に指定されたフォーマットで指定された式の値を表示する。
注意
dbxキーワードと同一の名前が式にある場合は,その名前をカッコで囲む必要があります。 たとえば,playbackコマンドとrecordコマンドのキーワードであるoutputをプリントするときは,次のように指定します。(dbx) print (output)
例
(dbx) print i 14 [1] (dbx) po i 016 [2] (dbx) px i 0xe [3] (dbx) pd i 14 [4] (dbx)
printregs
コマンドはすべてのレジスタ値の一覧を表示します。
このコマンドには引数は不要です。
print
コマンドと同じように,省略時の設定では,printregs
が表示する値は 10 進数です。
16 進で値を表示する場合は,dbx
変数
$hexints
を設定します。
例
(dbx) printregs $vfp= 4831837712 $r0_v0=0 $r1_t0=0 $r2_t1=0 $r3_t2=18446744069416926720 $r4_t3=18446744071613142936 $r5_t4=1 $r6_t5=0
.
.
.
$f25= 0.0 $f26= 0.0 $f27= 2.3873098155006918e-314 $f28= 2.6525639909000367e-314 $f29= 9.8813129168249309e-324 $f30= 2.3872988413145664e-314 $f31= 0.0 $pc= 4831840840
5.9.2 dump コマンドによるアクティブ化レベル情報の表示
dump
コマンドは,アクティブ化レベルについての情報を表示します。
指定されたアクティブ化レベルにローカルな変数の値もすべて表示されます。
プログラムで現在実行中のアクティブ化レベルを調べるには,where
コマンドでスタック・トレースを行います。
次に
dump
コマンドの形式を示します。
dump現在のアクティブ化レベルの情報を表示する。
dump .すべてのアクティブ化レベルの情報を表示する。
dump PROCEDURE指定されたプロシージャ (アクティブ化レベル) についての情報を表示する。
例
(dbx) where
> 0 prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04]
1 main(argc = 2, argv = 0x11ffffe08) ["sam.c":45, 0x120000bac]
(dbx) dump
prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04]
(dbx) dump .
> 0 prnt(pline = 0x11ffffcb8) ["sam.c":52, 0x120000c04]
1 main(argc = 2, argv = 0x11ffffe08) ["sam.c":45, 0x120000bac]
line1 = struct {
string = "#include <stdio.h>"
length = 19
linenumber = 0
}
fd = 0x140000158
fname = 0x11ffffe9c = "sam.c"
i = 19
curlinenumber = 1
(dbx) dump main
main(argc = 2, argv = 0x11ffffe08) ["sam.c":45, 0x120000bac]
line1 = struct {
string = "#include <stdio.h>"
length = 19
linenumber = 0
}
fd = 0x140000158
fname = 0x11ffffe9c = "sam.c"
i = 19
curlinenumber = 1
(dbx)
メモリの内容は,アドレスおよび表示フォーマットを指定することによって表示することができます。
コマンドの形式は次のとおりで,3 つの部分の間にはスペースは不要です。
address/count mode
address には表示する最初の項目のアドレス,count には表示する項目の数,mode には項目の表示フォーマットを指定します。 次に例を示します。
prnt/20i
この例では,prnt
関数のアドレスで始まる 20 の機械語命令の内容を表示します。
mode
に指定できる値を表 5-9
に示します。
表 5-9: メモリ・アドレス表示モード
| モード | 表示フォーマット |
b |
8 進数でバイトの内容を表示する。 |
c |
1 バイト文字として表示する。 |
D |
10 進数でロングワード (64 ビット) を表示する。 |
d |
10 進数でショートワード (16 ビット) を表示する。 |
dd |
10 進数でワード (32 ビット) を表示する。 |
f |
単精度実数を表示する。 |
g |
倍精度実数を表示する。 |
i |
機械語命令を表示する。 |
O |
8 進数でロングワードを表示する。 |
o |
8 進数でショートワードを表示する。 |
oo |
8 進数でワード (32 ビット) を表示する。 |
s |
ヌル・バイトで終わる文字列を表示する。 |
X |
16 進数でロングワードを表示する。 |
x |
16 進数でショートワードを表示する。 |
xx |
16 進数でワード (32 ビット) を表示する。 |
メモリのアドレスを命令として表示したときの出力は次の例のようになります。
(dbx) &prnt/20i [prnt:51, 0x120000bf0] ldah gp, 8193(r27) [prnt:51, 0x120000bf4] lda gp, -25616(gp) [prnt:51, 0x120000bf8] lda sp, -64(sp) [prnt:51, 0x120000bfc] stq r26, 8(sp) [prnt:51, 0x120000c00] stq r16, 16(sp) [prnt:52, 0x120000c04] ldq r16, -32640(gp) >*[prnt:52, 0x120000c08] addq r16, 0x38, r16 [prnt:52, 0x120000c0c] ldq r17, -32552(gp) [prnt:52, 0x120000c10] ldq r1, 16(sp) [prnt:52, 0x120000c14] ldl r18, 260(r1) [prnt:52, 0x120000c18] ldl r19, 256(r1) [prnt:52, 0x120000c1c] bis r1, r1, r20 [prnt:52, 0x120000c20] ldq r27, -32624(gp) [prnt:52, 0x120000c24] jsr r26, (r27), 0x4800030a0 [prnt:52, 0x120000c28] ldah gp, 8193(r26) [prnt:52, 0x120000c2c] lda gp, -25672(gp) [prnt:54, 0x120000c30] ldq r16, -32640(gp) [prnt:54, 0x120000c34] addq r16, 0x38, r16 [prnt:54, 0x120000c38] ldq r27, -32544(gp) [prnt:54, 0x120000c3c] jsr r26, (r27), 0x480003100
dbx
デバッガは,プログラムへの入力および出力を記録したり,記録した入力コマンドを再実行することができます。
記録情報は,後で利用できるようにファイルに書き込まれます。
入力の記録は,コマンド・シーケンスを繰り返して実行するために利用するコマンド・ファイルの作成に有効です。
また,出力の記録は,画面に表示するには多すぎる情報を保管して後で分析する場合などに便利です。
出力ファイルを後で参照する場合には,記録ファイルを直接読むことも,dbx
で再現することもできます。
5.9.4.1 デバッガ入力の記録および再実行
入力したデバッガ・コマンドを記録するには,record input
コマンドを使用します。
record input
コマンドによって記録されたコマンドを繰り返すには,playback input
コマンドを使用します。
record input
コマンドおよび
playback input
コマンドの形式は次のとおりです。
record input [FILE]すべての
dbx
コマンドをファイルに記録する。
記録ファイルを指定しない場合は
/tmp
ディレクトリに一時ファイルが作成される。
playback input [FILE]source [FILE]指定されたファイル,またはファイル名が指定されていない場合は一時ファイルからコマンドを実行する。
一時ファイルの名前はデバッガ変数
$defaultin
にあります。
一時ファイル名を表示するには,次のように
print
コマンドを実行してください。
(dbx) print $defaultin
記録した出力を現在のデバッグ・セッションでのみ参照する必要がある場合は,一時ファイルを使用します。
現在のデバッグ・セッション終了後に記録情報を利用する場合は,ファイル名を指定して記録しておきます。
記録が行われているかどうかを調べる場合は
status
コマンドを実行します。
記録を中止する場合は
delete
コマンドを使用します。
これらのファイルも記録されることに注意してください。
後で利用するためにファイルを作成している場合は,ファイルを編集してこの種のコマンドの記録を削除しておく必要があるかもしれません。
record input
コマンドで記録したコマンドを再実行する場合は,playback input
コマンドを使用します。
省略時の設定では,playback input
によるコマンドの再実行はサイレント・モードで行われるため,再実行の様子は表示されません。
dbx
変数
$pimode
が 1 に設定されている場合は,コマンドの再実行の様子が表示されます。
次の例では,入力されたコマンドを記録した後,作成したファイルを表示しています。
(dbx) record input [1]
[2] record input /tmp/dbxtX026963 (0 lines)
(dbx) status
[2] record input /tmp/dbxtX026963 (1 lines)
(dbx) stop in prnt
[3] stop in prnt
(dbx) when i = 19 {stop}
[4] stop ifchanged i = 19
(dbx) delete 2 [2]
(dbx) playback input [3]
[3] stop in prnt
[4] stop ifchanged i = 19
[5] stop in prnt
[6] stop ifchanged i = 19
/tmp/dbxtX026963: 4: unknown event 2 [4]
(dbx)
記録を開始します。 [例に戻る]
記録を中止します。 [例に戻る]
入力コマンドを再現します。 [例に戻る]
記録を中止したときにイベント 2 (記録の開始) を削除しているため,エラー・メッセージが表示されます。 [例に戻る]
この例では,dbx
コマンドで作成した一時ファイルには,次の内容が記録されています。
status
stop in prnt
when i = 19 {stop}
delete 2
デバッグ・セッション中の
dbx
出力を記録するには,record output
コマンドを使用します。
出力とともに入力も記録する場合は,dbx
変数
$rimode
を設定します。
記録された情報を参照するには,playback output
コマンドまたは適当なテキスト・エディタを使用します。
次に
record output
コマンドおよび
playback output
コマンドの形式を示します。
record output [FILE]指定したファイルにすべての
dbx
コマンドを記録する。
ファイルを省略した場合は
/tmp
ディレクトリに一時ファイルが作成される。
playback output [FILE]指定されたファイル,またはファイル名が指定されない場合は一時ファイルからコマンドを表示する。
一時ファイルの名前はデバッガ変数
$defaultout
にあります。
一時ファイル名を表示するには,次のように
print
コマンドを実行してください。
(dbx) print $defaultout
playback output
コマンドは
cat
コマンドと同じように機能します。
record output
コマンドによる表示は,記録ファイルの内容と同一のものです。
記録した出力を現在のデバッグ・セッションでのみ参照する必要がある場合は,一時ファイルを使用します。
現在のデバッグ・セッション終了後に記録情報を利用する場合は,ファイル名を指定して記録しておきます。
記録が行われているかどうかを調べる場合は
status
コマンドを実行します。
記録を中止する場合は
delete
コマンドを使用します。
次の例では,dbx
コマンドの実行結果,および
code
というファイルに記録されたこのコマンド実行の出力を示しています。
(dbx) record output code
[3] record output code (0 lines)
(dbx) stop at 25
[4] stop at "sam.c":25
(dbx) run sam.c
[4] stopped at [main:25 ,0x120000a48] if (argc < 2) {
(dbx) delete 3
(dbx) playback output code
[3] record output code (0 lines)
(dbx) [4] stop at "sam.c":25
(dbx) [4] stopped at [main:25 ,0x120000a48] if (argc < 2) {
(dbx)
この節では,オペレーティング・システムのコア・ダンプ・ファイルのネーミング機能を有効にして,複数のコア・ファイルを保存できるようにする方法について説明します。
コア・ファイルのネーミング機能を有効にすると,システムは,次の形式の名前でコア・ファイルを生成します。
core.prog-name.host-name.tag
コア・ファイル名は,ピリオドで区切った次の 4 つの部分からなります。
短い文字列の
core。
ps
コマンドで表示される 16 文字までのプログラム名。
16 文字までのシステムのネットワーク・ホスト名 (ホスト名フォーマットの最初のドットの前にあるホスト名の部分から)。
ホスト上のプログラムで生成されたすべてのコア・ファイルを一意にするためにコア・ファイルに割り当てられた数字のタグ。
このタグの最大値,つまり,このプログラムおよびホストで生成されるコア・ファイルの最大数は,システム構成パラメータで設定されます (5.10.1 項を参照)。
タグは,文字どおりのバージョン番号ではありません。 システムは,コア・ファイルに対して最初に使用可能な一意のタグを選択します。 たとえば,プログラムのコア・ファイルがタグの 0,1,3,を使用している場合,システムはそのプログラムについて作成する次のコア・ファイルには,タグ 2 を使用します。 コア・ファイル・インスタンスのシステム構成上の上限に達した場合には,そのプログラムとホストの組み合わせに対しては,それ以上コア・ファイルは作成されません。 省略時の設定では,16 バージョンまでのコア・ファイルが作成されます。
ディスク・スペースを節約するため,コア・ファイルは,チェックした後に必ず削除してください。 名前を付けたコア・ファイルは上書きされないので,この作業が必要になります。
コア・ファイルのネーミング機能は,システム・レベル (5.10.1 項) でも,個々のアプリケーション・レベル (5.10.2 項) でも有効にすることができます。
5.10.1 システム・レベルでのコア・ファイルのネーミング機能の有効化
システム・レベルでのコア・ファイルのネーミング機能は,
dxkerneltuner(8X)sysconfig(8)enhanced-core-name
プロセス・サブシステム属性を 1 に設定します。
プログラムが特定のホスト・システム上に作成できる一意のコア・ファイルのバージョン数を制限するには,プロセス・サブシステム属性の
enhanced-core-max-versions
を必要な値に設定します。
次の例を参照してください。
proc: enhanced-core-name = 1 enhanced-core-max-versions = 8
バージョンの最小値,最大値,省略値はそれぞれ,1,99999,および 16 です。
5.10.2 アプリケーション・レベルでのコア・ファイルのネーミング機能の有効化
アプリケーション・レベルでコア・ファイルのネーミングを有効にするには,次の例に示すように,プログラムで
UWS_CORE
フラグを設定して
uswitch
システム・コールを使用します。
#include <signal.h>
#include <xsys/uswitch.h>
/*
* Request enhanced core-file naming for
* this process, then create a core file.
*/
main()
{
long uval = uswitch(USC_GET, 0);
uval = uswitch(USC_SET, uval | USW_CORE);
if (uval < 0) {
perror("uswitch");
exit(1);
}
raise(SIGQUIT);
}
dbx
デバッガを使用して,dbx
環境の外で開始された実行中のプロセスをデバッグすることができます。
dbx
デバッガは,/proc
ファイル・システムによってこのようなプロセスのデバッグをサポートしており,親プロセスも子プロセスもサポートされます。
実行中のプロセスのデバッグは,/proc
ファイル・システムがマウントされている場合にのみ可能です。
/proc
ファイル・システムがマウントされていない場合は,スーパユーザは次のコマンドを使用してマウントすることができます。
# mount -t procfs /proc /proc
/etc/fstab
ファイルに次のエントリを追加すると,ブート時に
/proc
をマウントできます。
/proc /proc procfs rw 0 0
dbx
デバッガは,まず
/proc
がマウントされているかどうかをチェックしますが,マウントされていない場合でも機能します。
実行中のプロセスにアタッチするためには,dbx
コマンドの
attach
を使用します。
attach
コマンドの構文は次のとおりです。
attach
process-idprocess-id には,アタッチするプロセスのプロセス ID を指定します。
デバッグのためにプロセスにアタッチするには,コマンド行オプションの
-pid process id
を使用することもできます。
実行中のプロセスからデタッチするには,dbx
コマンドの
detach
を使用します。
このコマンドの構文は次のとおりです。
detach [process-id
]process-id
には,デタッチするプロセスのプロセス ID を指定します。
引数を省略した場合は,dbx
は現在のプロセスをデタッチします。
あるプロセスから別のプロセスに変更する場合は,switch
コマンドを使用します。
このコマンドの構文は次のとおりです。
switch
process-idprocess-id
には,変更先プロセスのプロセス ID を指定します。
変更先プロセスは,switch
コマンドを使用する前にアタッチしておく必要があります。
switch
コマンドに対して別名
sw
を使用することができます。
attach
コマンドは,まず
/proc
がマウントされているかどうかをチェックします。
マウントされていない場合には,dbx
は実行すべき動作を通知する警告メッセージを発行します。
マウントされている場合には,dbx
は
/proc
でプロセス ID を探します。
/proc
でプロセス ID が見つかると,dbx
はプロセスをオープンして,stop
コマンドを発行します。
プロセスがそこにない場合,またはそのプロセスへのアタッチが許可されていない場合には,dbx
はアタッチが失敗したことを通知します。
stop
コマンドが実行されると,dbx
は現在の位置を通知して,dbx
プロンプトを表示し,ユーザがコマンドを入力するのを待ちます。
プログラムはおそらくユーザ・コード内では直ちに停止されませんが,ユーザ・コードから呼び出されたライブラリ・コールまたはシステム・コール内で停止されます。
detach
コマンドは現在のすべてのブレークポイントを削除して,'run on last close' フラグを設定し,プロセスをクローズ (リリース) します。
dbx
内で明示的に終了されていない場合,その後プログラムは実行を継続します。
dbx
の制御下にあるすべてのアクティブなプロセスを参照するには,plist
コマンドを使用します。
このコマンドの構文は次のとおりです。
plistアクティブなプロセスとその状態を表示します。
現在のプロセスに対しては,�
のマーカが表示されます。
dbx
デバッガは,スレッドを使用するアプリケーションのデバッグを支援する次の 3 つの基本コマンドをサポートします。
tlist
コマンドは,すべてのスレッドの一覧を表示し,それらが現在プログラムのどの位置にあるかを表示します。
このコマンドには引数は不要です。
tlist
コマンドを使用すると,現在プログラム内にあるすべてのスレッドを ID とともに表示することができます。
tset
コマンドは現在のスレッドを設定します。
デバッガは,1 つのスレッドを現在のスレッドとして保持します。
このスレッドが,ブレークポイントにヒットしたり,停止信号を受信して,制御を
dbx
に引き渡すスレッドです。
tset
を使用すると,現在のスレッドとして異なるスレッドを選択し,通常の
dbx
コマンドで状態を検査できるようになります。
選択したスレッドは,次に
tset
コマンドを入力するまで,現在のスレッドであることに注意してください。
また,ブロックされていたり,別のスレッドに加わるために待機している場合,continue,step,または
next
コマンドはそのスレッドについて適切ではありません。
tstack
コマンドはアプリケーション内のすべてのスレッドのスタックをリストします。
このコマンドは
where
コマンドに似ていて,引数として数値を指定することにより,表示するスタック・レベル数を制限することができます。
tset
および
tstack
コマンドの形式は次のとおりです。
tset [EXP]現在のスレッドを選択する。
EXP
引数には ID を 16 進数で指定する。
tstack [EXP]すべてのスレッドのスタック・トレースを表示する。
EXP
を指定すると,dbx
は上位
EXP
レベルのスタックのみを表示する。
この引数を省略すると,すべてのスタックを表示する。
ご使用のシステムに POSIX Threads Library がインストールされている場合は,dbx
セッションで
call cma_debug()
コマンドを実行することによって,POSIX Threads Library pthread デバッガにアクセスすることができます。
pthread デバッガは,プログラムのスレッドに関する多くの有用な情報を提供します。
pthread デバッガの使用方法については,debug>
プロンプトで
help
コマンドを入力してください。
サンプル・スレッド・プログラム
twait.c
を例 12-1
に示してあります。
次の例では,dbx
セッションで
twait.c
を使用しています。
% dbx twait
dbx version 3.11.6
Type 'help' for help.
main: 50 pthread_t me = pthread_self(), timer_thread;
(dbx) stop in do_tick
[2] stop in do_tick
(dbx) stop at 85
[3] stop at "twait.c":85
(dbx) stop at 35
[4] stop at "twait.c":35
(dbx) run
1: main thread starting up
1: exit lock initialized
1: exit lock obtained
1: exit cv initialized
1: timer_thread 2 created
1: exit lock released
[2] thread 0x81c62e80 stopped at [do_tick:21 ,0x12000730c] pthread_
t me = pthread_self();
(dbx) tlist
thread 0x81c623a0 stopped at [msg_receive_trap:74 +0x8,0x3ff808edf04]
Source not available
thread 0x81c62e80 stopped at [do_tick:21 ,0x12000730c] pthread_
t me = pthread_self();
(dbx) where
> 0 do_tick(argP = (nil)) ["twait.c":21, 0x12000730c]
1 cma__thread_base(0x0, 0x0, 0x0, 0x0, 0x0) ["../../../../../src/usr/
ccs/lib/DECthreads/COMMON/cma_thread.c":1441, 0x3ff80931410]
(dbx) tset 0x81c623a0
thread 0x81c623a0 stopped at [msg_receive_trap:74 +0x8,0x3ff808edf04]
Source not available
(dbx) where
> 0 msg_receive_trap(0x3ff8087b8dc, 0x3ffc00a2480, 0x3ff8087b928, 0x181
57f0d0d, 0x3ff8087b68c) ["/usr/build/osf1/goldos.bld/export/alpha/usr/in
clude/mach/syscall_sw.h":74, 0x3ff808edf00]
1 msg_receive(0x61746164782e, 0x3ffc009a420, 0x3ffc009a420, 0x3c20, 0
xe0420) ["../../../../../src/usr/ccs/lib/libmach/msg.c":95, 0x3ff808e474
4]
2 cma__vp_sleep(0x280187f578, 0x3990, 0x7, 0x3ffc1032848, 0x0) ["../.
./../../../src/usr/ccs/lib/DECthreads/COMMON/cma_vp.c":1471, 0x3ff809375
cc]
3 cma__dispatch(0x7, 0x3ffc1032848, 0x0, 0x3ffc100ee08, 0x3ff80917e3c
) ["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_dispatch.c":967
, 0x3ff80920e48]
4 cma__int_wait(0x11ffff228, 0x140009850, 0x3ffc040cdb0, 0x5, 0x3ffc0
014c00) ["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_condition
.c":2202, 0x3ff80917e38]
5 cma_thread_join(0x11ffff648, 0x11ffff9f0, 0x11ffff9e8, 0x60aaec4, 0
x3ff8000cf38) ["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_thr
ead.c":825, 0x3ff80930a58]
6 pthread_join(0x140003110, 0x40002, 0x11ffffa68, 0x3ffc040cdb0, 0x0)
["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_pthread.c":2193,
0x3ff809286c8]
7 main() ["twait.c":81, 0x12000788c]
(dbx) tlist
thread 0x81c623a0 stopped at [msg_receive_trap:74 +0x8,0x3ff808edf04]
Source not available
thread 0x81c62e80 stopped at [do_tick:21 ,0x12000730c] pthread_
t me = pthread_self();
(dbx) tset 0x81c62e80
thread 0x81c62e80 stopped at [do_tick:21 ,0x12000730c] pthread_
t me = pthread_self();
(dbx) cont
2: timer thread starting up, argP=0x0
[4] thread 0x81c62e80 stopped at [do_tick:35 ,0x120007430] printf("
%d: wait for next tick\n", THRID(&me));
(dbx) cont
2: wait for next tick
2: TICK #1
[4] thread 0x81c62e80 stopped at [do_tick:35 ,0x120007430] printf("
%d: wait for next tick\n", THRID(&me));
(dbx) tstack
Thread 0x81c623a0:
> 0 msg_receive_trap(0x3ff8087b8dc, 0x3ffc00a2480, 0x3ff8087b928, 0x181
57f0d0d, 0x3ff8087b68c) ["/usr/build/osf1/goldos.bld/export/alpha/usr/in
clude/mach/syscall_sw.h":74, 0x3ff808edf00]
1 msg_receive(0x61746164782e, 0x3ffc009a420, 0x3ffc009a420, 0x3c20, 0
xe0420) ["../../../../../src/usr/ccs/lib/libmach/msg.c":95, 0x3ff808e474
4]
2 cma__vp_sleep(0x280187f578, 0x3990, 0x7, 0x3ffc1032848, 0x0) ["../.
./../../../src/usr/ccs/lib/DECthreads/COMMON/cma_vp.c":1471, 0x3ff809375
cc]
3 cma__dispatch(0x7, 0x3ffc1032848, 0x0, 0x3ffc100ee08, 0x3ff80917e3c
) ["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_dispatch.c":967
, 0x3ff80920e48]
4 cma__int_wait(0x11ffff228, 0x140009850, 0x3ffc040cdb0, 0x5, 0x3ffc0
014c00) ["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_condition
.c":2202, 0x3ff80917e38]
5 cma_thread_join(0x11ffff648, 0x11ffff9f0, 0x11ffff9e8, 0x60aaec4, 0
x3ff8000cf38) ["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_thr
ead.c":825, 0x3ff80930a58]
6 pthread_join(0x140003110, 0x40002, 0x11ffffa68, 0x3ffc040cdb0, 0x0)
["../../../../../src/usr/ccs/lib/DECthreads/COMMON/cma_pthread.c":2193,
0x3ff809286c8]
7 main() ["twait.c":81, 0x12000788c]
Thread 0x81c62e80:
> 0 do_tick(argP = (nil)) ["twait.c":35, 0x120007430]
1 cma__thread_base(0x0, 0x0, 0x0, 0x0, 0x0) ["../../../../../src/usr/
ccs/lib/DECthreads/COMMON/cma_thread.c":1441, 0x3ff80931410]
More (n if no)?
(dbx) tstack 3
Thread 0x81c623a0:
> 0 msg_receive_trap(0x3ff8087b8dc, 0x3ffc00a2480, 0x3ff8087b928, 0x181
57f0d0d, 0x3ff8087b68c) ["/usr/build/osf1/goldos.bld/export/alpha/usr/in
clude/mach/syscall_sw.h":74, 0x3ff808edf00]
1 msg_receive(0x61746164782e, 0x3ffc009a420, 0x3ffc009a420, 0x3c20, 0
xe0420) ["../../../../../src/usr/ccs/lib/libmach/msg.c":95, 0x3ff808e474
4]
2 cma__vp_sleep(0x280187f578, 0x3990, 0x7, 0x3ffc1032848, 0x0) ["../.
./../../../src/usr/ccs/lib/DECthreads/COMMON/cma_vp.c":1471, 0x3ff809375
cc]
Thread 0x81c62e80:
> 0 do_tick(argP = (nil)) ["twait.c":35, 0x120007430]
1 cma__thread_base(0x0, 0x0, 0x0, 0x0, 0x0) ["../../../../../src/usr/
ccs/lib/DECthreads/COMMON/cma_thread.c":1441, 0x3ff80931410]
(dbx) cont
2: wait for next tick
2: TICK #2
[4] thread 0x81c62e80 stopped at [do_tick:35 ,0x120007430] printf("
%d: wait for next tick\n", THRID(&me));
(dbx) assign ticks = 29
29
(dbx) cont
2: wait for next tick
2: TICK #29
[4] thread 0x81c62e80 stopped at [do_tick:35 ,0x120007430] printf("
%d: wait for next tick\n", THRID(&me));
(dbx) cont
2: wait for next tick
2: TICK #30
2: exiting after #31 ticks
1: joined with timer_thread 2
[3] thread 0x81c623a0 stopped at [main:85 ,0x1200078ec] if (errn
o != 0) printf("errno 7 = %d\n",errno);
(dbx) tlist
thread 0x81c623a0 stopped at [main:85 ,0x1200078ec] if (errno != 0)
printf("errno 7 = %d\n",errno);
thread 0x81c62e80 stopped at [msg_rpc_trap:75 +0x8,0x3ff808edf10]
Source not available
(dbx) cont
Program terminated normally
(dbx) tlist
(dbx) quit
dbx
デバッガで複数の非同期プロセスをデバッグすることができます。
非同期プロセスをデバッグしている間,dbx
は状態を表示して,非同期にコマンドを受け入れることができます。
非同期に実行していると,デバッガの動作が混乱しているように見えることがあります。
これは,停止している別のプロセスを調べるコマンドを入力しているときに,実行プロセスが出力を画面に表示することがあるためです。
次のいずれかの状況の場合,デバッガは自動的に非同期モードになります。
以前のプロセスがまだアタッチされているときに,新しいプロセスにアタッチするように命じた場合
dbx
がアタッチしているプロセスが子プロセスにフォークして,デバッガが親プロセスからデタッチせずにその子プロセスに自動的にアタッチした場合
デバッガは,多数の定義済み変数を使用して,非同期デバッグの動作を定義します (表 5-8
を参照)。
変数
$asynch_interface
は,カウンタとしても見ることができ,新しいプロセスがアタッチされると 1 だけ増加し,プロセスが終了するかデタッチされると 1 だけ減少します。
省略時の設定は 0 です。
$asynch_interface
の値が正で非ゼロの場合,非同期デバッガは使用可能であり,変数の値が 0 (ゼロ) または負の場合,非同期デバッガは使用不能です。
dbx
が非同期モードになるのを防ぐには,$asynch_interface
変数に負の値を設定します。
ただし,停止されている子を親が待っている場合には,非同期モードを使用不能にすると,デバッグがより困難になります。
プロセスが
fork()
または
vfork()
呼び出しを実行すると,dbx
は子プロセスにアタッチして,自動的に非同期モードになります ($asynch_interface
で許可されている場合)。
省略時の動作では,フォークした後,直ちに子プロセスを停止します。
変数
$stop_on_fork
を 0 に設定すると,この省略時の設定を変更することができます。
この場合,dbx
は子プロセスにアタッチしますが,それを停止されることはありません。
dbx
デバッガは,さまざまなシステム・コールおよびライブラリ・コールによって行われたフォーク呼び出しの多くにフィルタをかけることにより,フォークの処理にインテリジェンス度を適用しようとします。
これらのフォークでプロセスを停止させる場合にも,定義済み変数
$stop_all_forks
を 1 に設定します。
この変数の省略時の値は 0 です。
ライブラリ・ルーチンをデバッグしている際には,すべてのフォークで停止させることは特に有効です。
デバッガの
plist
および
switch
コマンドを使用すると,プロセス間のモニタおよび切り替えを行うことができます。
5.14 サンプル・プログラム
例 5-1
のサンプル C プログラム (sam.c) は,この章のいくつかのコマンド使用例で引用しているプログラムです。
例 5-1: dbx の例で使用されているサンプル・プログラム
#include <stdio.h>
struct line {
char string[256];
int length;
int linenumber;
};
typedef struct line LINETYPE;
void prnt();
main(argc,argv)
int argc;
char **argv;
{
LINETYPE line1;
FILE *fd;
extern FILE *fopen();
extern char *fgets();
extern char *getenv();
char *fname;
int i;
static curlinenumber=0;
if (argc < 2) {
if((fname = getenv("TEXT")) == NULL || *fname == ' ') {
fprintf(stderr, "Usage: sam filename\n");
exit(1);
}
} else
fname = argv[1];
fd = fopen(fname,"r");
if (fd == NULL) {
fprintf(stderr, "cannot open %s\n",fname);
exit(1);
}
while(fgets(line1.string, sizeof(line1.string), fd) != NULL){
i=strlen(line1.string);
if (i==1 && line1.string[0] == '\n')
continue;
line1.length = i;
line1.linenumber = curlinenumber++;
prnt(&line1);
}
}
void prnt(pline)
LINETYPE *pline;
{
fprintf(stdout,"%3d. (%3d) %s",
pline->linenumber, pline->length, pline->string);
fflush(stdout);
}