5    dbx によるプログラムのデバッグ

dbx デバッガは,コマンド行プログラムです。 これは,ソース・コード・レベルおよび機械語コード・レベルのプログラム・デバッグ用のツールであり,C 言語,Fortran,Pascal,アセンブリ言語で使用することができます。 dbx を起動した後に,dbx コマンドを入力して実行の制御およびトレース,変数および式の値の表示,ソース・ファイルの表示および編集を行うことができます。

代替デバッガの ladebug デバッガは,コマンド行およびグラフィカル・ユーザ・インタフェース (GUI) の両方を提供しています。 dbx でサポートされていない言語をいくつかサポートするとともに,ladebug デバッガではマルチスレッド・プログラムのデバッグ機能をサポートしています。 ladebug についての詳細は,『Ladebug Debugger Manual』または ladebug(1) を参照してください。

この章では,次の項目について説明を行います。

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 節で説明しています。

5.1    デバッグの一般的な留意事項

この節では,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] 
 
 

  1. 最後に呼び出されたプロシージャは prnt です。 prnt のアクティブ化レベルは 0 なので,この関数はスタックの最上位にあります。 [例に戻る]

  2. メイン・プログラムは main です。 [例に戻る]

  3. アクティブ化レベル番号

    > は,現在調査中のアクティブ化レベルを示します。 [例に戻る]

  4. プロシージャ名 [例に戻る]

  5. プロシージャの引数 [例に戻る]

  6. ソース・ファイル名 [例に戻る]

  7. 現在の行番号 [例に戻る]

  8. 現在のプログラム・カウンタ [例に戻る]

5.1.3    プログラム実行障害箇所の特定

dbx デバッガは,実行時エラーだけを検出するため,デバッグ・セッションを開始する前に,コンパイラ・エラーを訂正する必要があります。 実行時エラーとは,プログラムが,コア・ファイルを作成してしまうような実行中の障害,または不正な実行結果の作成につながるものです。 実行時に異常終了するプログラムをデバッグする方法と,終了まで実行はするが,不正な実行結果を出力するプログラムをデバッグする方法は異なります。 不正な実行結果を作成するプログラムをデバッグする方法については,5.1.4 項を参照してください。

実行時にプログラムが異常終了する場合には,1 行ずつデバッグするのではなく,次の方法を使用してデバッグ・セッションを開始すると,通常は時間を節約することができます。

  1. dbx からプログラムを呼び出す。

    dbx コマンド行で,適切なオプション,実行可能ファイル,およびコア・ダンプ・ファイルを指定します。

  2. where コマンドを使用してスタック・トレースを行い,障害の位置を特定する。

    注意

    オブジェクト・ファイルからシンボル・テーブルの情報を削除していない場合は,当該プログラムが -g デバッグ・オプションでコンパイルされていなくても,スタック・トレースを行うことができます。

  3. stop あるいは stopi コマンドを使用してブレークポイントを設定し,エラーを分離する。

  4. print コマンドを使用して変数の値を表示し,変数に不正な値が割り当てられた箇所を調べる。

この時点でまだエラーを発見できない場合には,この章で説明している他の dbx コマンドを使用してください。

5.1.4    不正の出力結果の原因分析

プログラムが終了まで実行しても,不正な値または出力が生成される場合には,次の手順に従ってください。

  1. 問題が発生していると考えられる位置,たとえば不正な値または出力のデータを生成する箇所のコードにブレークポイントを設定する。

  2. プログラムを実行する。

  3. where コマンドを使用して,スタック・トレースを行う。

  4. print コマンドを使用して,問題があると考えられる変数の値を表示する。

  5. 問題が発見されるまで,手順 1 以降を繰り返す。

5.1.5    実行プロセスのコア・スナップショットの作成

異常終了や不正な結果を出力しないプログラムでも,正常に動作していない場合があります。 たとえば次のような場合です。

また,プログラムが無限ループに入ることもあります。

このような場合,プログラムの実行を停止せずに状態を調べることができます。 coredump コマンドを使用すると,実行中のプロセスのコア・スナップショットを作成できます。 省略時,コア・スナップショット・ファイルは現行ディレクトリに作成され,名前は corefile になります。 dbx を使用すると,5.2.3 項 での説明どおりにコア・スナップショットを調べることができます。 詳細は coredump(1) を参照してください。

5.1.6    障害の回避

デバッガですべての問題が解決されるとは限りません。 たとえば,プログラムに論理エラーがある場合には,デバッガは問題の発見には利用できますが,解決はできません。 デバッガにより表示される情報が混乱していたり間違っているような場合には,次のような処理でその状況を訂正することができます。

5.2    dbx の実行

dbx を呼び出す前に,デバッグ用にプログラムをコンパイルする必要があります。 デバッガ起動時に各 dbx コマンドを実行する dbx 初期化ファイルを作成することもできます。

5.2.1    デバッグ用プログラムのコンパイル

デバッガ用にプログラムの準備をするには,コンパイル時に -g オプションを指定します。 このオプションにより,シンボル・テーブル情報が dbx プログラムに読み込まれ,最適化レベルを -O0 に設定します。 dbx デバッガは,この情報を使用してソース行をリストします。 別の最適化レベル (-O2 など) を使用すると,最適化プログラムは,プログラム内の制御フローを変更はしませんが,演算命令を移動し,オブジェクト・コードとソース・コードが一致しなくなることがあります。 これらの変更されたコード・シーケンスは,デバッガを使用する場合に混乱を招く可能性があります。

-g オプションを付けずにコンパイルしたコードで,限定されたデバッグを実行することができます。 たとえば,次のコマンドは,デバッグ用に再コンパイルしなくても,正常に動作します。

このコードで限定されたデバッグを実行することはできますが,-g を使用してプログラムを再コンパイルする方が有効です。 -g オプションを付けないでオブジェクト・ファイルをコンパイルしても,デバッガは警告を出さないことに注意してください。

完全なシンボル・テーブル情報が利用できるのは,すべてのモジュールが -g オプションを付けてコンパイルされているプログラムだけです。 そうでないプログラムの場合は,-g オプションを付けてコンパイルされたモジュールで参照されているか,または定義されているシンボルに関するシンボル・テーブル情報しか利用できません。

注意

ブレークポイントを設定するシェアード・ライブラリ・アプリケーションのルーチンはすべて,-g オプションを使用してコンパイルする必要があります。 -g オプションを指定しない場合には,dbx にブレークポイントを設定するのに必要なシンボル・テーブルの情報が生成されないため,dbx は,アプリケーションを停止することができません。

5.2.2    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 ] ]

options

dbx コマンド行がサポートするオプションについては,表 5-2 を参照してください。

objectfile

デバッグ対象のプログラムの実行可能ファイル名を指定します。 objectfile が指定されない場合,dbx は,省略時の設定 a.outを使用します。

corefile

プログラムの実行が異常終了した場合や, 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]
 
 

  1. 現在のファイル [例に戻る]

  2. プロシージャ名 [例に戻る]

  3. 変数名 [例に戻る]

5.3.2    dbx 式と式の優先順位

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.3.3    dbx のデータ型および定数

表 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 項を参照してください。

5.4    dbx モニタによる作業

dbx デバッガでは,コマンド・ヒストリ,コマンド行編集,およびシンボル名の補完が可能です。 また,dbx デバッガでは,入力行に複数のコマンドを使用することができます。 これらの機能を使用すると,必要な入力数を減らしたり,前に実行したコマンドを繰り返すことができます。

5.4.1    dbx コマンドの繰り返し

dbx デバッガは,コマンドのヒストリを記憶して,再入力しなくてもデバッガ・コマンドを繰り返し入力できるようにします。 これらのコマンドは,history コマンドを使用して表示することができます。 $lines 変数は,記憶するヒストリ行の数を制御します。 省略時の設定は,20 コマンドです。 set コマンドを使用して,$lines 変数を変更することができます。 5.5.1 項を参照してください。

コマンドを繰り返すには,[Return] キー,または感嘆符 (!) コマンドの 1 つを使用します。

次の表に,history コマンドの形式を示します。

history

ヒストリ・リストのコマンド群を表示する。

Return キー

最後に入力したコマンドを繰り返す。 この機能は,$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)

5.4.2    dbx コマンド行の編集

dbx デバッガには,コマンド行編集のためのコマンドが備わっています。 これらのコマンドを使用すると,コマンド全部を再入力せずにタイプ・ミスを訂正することができます。 コマンド行の編集を使用可能にするには,dbx を呼び出す前に,EDITOR,EDITMODE,または LINEEDIT 環境変数を設定します。 C シェルの場合に LINEEDIT を設定するには,次のコマンドを入力します。

% setenv LINEEDIT
 

Bourn シェルあるいは Korn シェルの場合は,次のコマンドを入力します。

% export LINEEDIT
 

このデバッガでは,コマンド行編集で次のモードが使用できます。

表 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 文字後に移動する。

5.4.3    複数のコマンドの入力

セミコロン (;) を区切り記号として使用して,コマンド行に複数のコマンドを入力することができます。 この機能は,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)

5.4.4    シンボル名の補完

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]

  1. データ型およびライブラリのシンボルが含まれている可能性があります。 [例に戻る]

  2. 指定の文字で始まるすべての名前をリストした後,別の文字の指定および再探索ができるように,dbx はプロンプトとともに事前に指定された文字列を再表示します。 [例に戻る]

次に,シンボル名の単純な補完の例を示します。

(dbx) print file [Ctrl/Z]
(dbx) print file_header_ptr
0x124ac
(dbx)

5.5    dbx の制御

dbx デバッガには,dbx 変数の設定および削除,別名の作成および削除,サブシェルの起動,状態リスト項目の検査および削除,アプリケーションに関連するオブジェクト・ファイル・リストの表示,入力の記録および再生のためのコマンドが用意されています。

5.5.1    変数の設定および削除

set コマンドは,dbx 変数の定義,既存の dbx 変数値の変更,dbx 定義済み変数のリストの表示などを行います。 unset コマンドは,dbx 変数を削除します。 プログラム変数およびデバッガ変数の値を表示するには,print コマンドを表示します。 dbx の定義済み変数については,表 5-8 を参照してください。 プログラム変数と同じ名前でデバッガ変数を定義することはできません。

set および unset コマンドの形式は次のとおりです。

set

dbx の定義済み変数のリストを表示する。

set VAR = EXP

変数に新しい値を割り当てるか,または新しい変数を定義する。

unset VAR

dbx 変数の値を設定解除する。

次の例は,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) 

  1. dbx 定義済み変数のリストを表示します。 [例に戻る]

  2. 変数に新しい値を割り当てます。 [例に戻る]

  3. 変数を削除します。 [例に戻る]

5.5.2    定義済みの 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 ハンドラへの連続する呼び出しの回数を指定する。

5.5.3    別名の定義および削除

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)

  1. 別名を表示します。 [例に戻る]

  2. ブレークポイントを設定するために別名を定義します。 [例に戻る]

  3. 52 行目にブレークポイントを設定します。 [例に戻る]

  4. 52 行目にブレークポイントを設定したことをデバッガが認識しています。 [例に戻る]

  5. 別名 h を削除します。 別名のリストに表示されないことに注意してください。 [例に戻る]

5.5.4    デバッグ・セッション状態の監視

status コマンドは,次のコマンドのうちで現在設定されているものがあるかどうかを確認します。

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 all
delete *

すべての状態項目を削除する。

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 all
enable all

すべてのイベントを有効/無効にする。

5.5.6    ロードされたオブジェクト・ファイル名の表示

listobj コマンドは,dbx によってロードされたオブジェクト・ファイルの名前をアドレスおよびサイズとともに表示します。 これらのオブジェクトには,メイン・プログラム,およびアプリケーションで使用されるすべてのシェアード・ライブラリが含まれます。 listobj コマンドには引数は不要です。

例

(dbx) listobj
sam                        addr: 0x120000000      size: 0x2000
/usr/shlib/libc.so         addr: 0x3ff80080000    size: 0xbc000
(dbx) 

5.5.7    コア・ダンプ用のシェアード・ライブラリの指定

コア・ダンプが発生すると,プログラムの使用するすべてのシェアード・ライブラリの位置がコア・ファイルに記録されて,dbx からライブラリが検索できるようになります。 ダンプの発生時に実行中だったバージョンのシェアード・ライブラリが別の場所に移動されると,dbx はそれを検索できなくなります。 次のいずれかの方法を使用して,dbx がシェアード・ライブラリを検索するディレクトリ・パスを指定できます (詳細については, dbx(1) を参照してください)。

モジュールが適切な場所からロードされたことを確認するには,次のいずれかの方法で,verbose モジュール・ロード機能を設定します。

5.5.8    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    ソース・プログラムの検査

この節では,ソース・コードのリストおよび編集,ディレクトリの変更,ソース・ファイルの変更,ソース・コード内の文字列の探索,修飾されたシンボル名の表示,型宣言の表示などを行う方法について説明します。

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) 

  1. 現在のディレクトリ [例に戻る]

  2. 新しいディレクトリ [例に戻る]

5.6.2    アクティブ化スタックでの移動

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)

  1. アクティブ化レベル番号 [例に戻る]

  2. プロシージャ名 [例に戻る]

  3. 引数 pline の現在の値 [例に戻る]

  4. ソース・ファイル名 [例に戻る]

  5. 行番号 [例に戻る]

  6. プログラム・カウンタ [例に戻る]

5.6.2.2    up コマンド,down コマンド,func コマンド

up および down コマンドを使用すると,スタック内のアクティブ化レベルを上下に移動できます。 これらのコマンドは,あるレベルから別のレベルへの呼び出しを追跡する場合に便利です。

func コマンドは,現在の行,現在のファイル,および現在のプロシージャなど,アクセスできる変数の有効範囲を変更します。 func コマンドは,プログラムが実行されていない場合のソース・コードの検査にも使用することができます。

up,down および func コマンドの形式は次のとおりです。

up [EXP]

スタックのアクティブ化レベルを,指定された数だけ上げる。 省略時の値は 1 レベル。

down [EXP]

スタック内のアクティブ化レベルを,指定された数だけ下げる。 省略時の値は 1 レベル。

func

現在のアクティブ化レベルを表示する。

func PROCEDURE

PROCEDURE に指定されたアクティブ化レベルに移動する。

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) 

  1. 1 レベル上げる。 [例に戻る]

  2. 1 レベル下げる。 [例に戻る]

  3. main に移動する。 [例に戻る]

5.6.3    現在のソース・ファイルの変更

file コマンドは,現在のソース・ファイルの表示,あるいは現在のソース・ファイルの変更を行います。

注意

ブレークポイントまたはトレースをある行番号に設定する前に,func コマンドを使用して正しいプロシージャを取得してください。 file コマンドでは,デバッガがブレークポイントを設定する際に必要な詳しい情報にアクセスできません。

file コマンドの形式は次のとおりです。

file

現在使用中のファイル名を表示する。

file FILE

現在のファイルを指定されたファイルに変更する。

例

(dbx) file
sam.c               [1]
(dbx) file data.c
(dbx) file
data.c              [2]
(dbx) 

  1. 現在のファイル [例に戻る]

  2. 新しいファイル [例に戻る]

5.6.4    ソース・コードのリスト

list コマンドは,ソース・コードの行を表示します。 dbx 変数 $listwindow は,dbx が省略時の設定でリストする行番号を定義します。 list コマンドは,特に指定しない限り現在のファイル,現在のプロシージャ,および現在の行を使用します。

次に list コマンドの形式を示します。

list

現在の行から $listwindow 行をリストする。

list EXP

現在の行から EXP 行をリストする。

list EXP1,EXP2

EXP1 から 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)

5.6.6    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

5.6.8    変数およびプロシージャのタイプの確認

whatis コマンドは,プログラムの変数およびプロシージャの型宣言をリストします。

次に whatis コマンドの形式を示します。

whatis VAR

指定された変数またはプロシージャの型宣言を表示する。

例

(dbx) whatis main
int main(argc,argv)
int argc;
unsigned char **argv;
(dbx) whatis i
int i;
(dbx) 

5.7    プログラムの制御

この節では,プログラムを実行するために使用する dbx コマンドについて説明します。 これらのコマンドでは,プログラムの実行,ソース・コードの行単位の実行,プロシージャ呼び出しからの戻り,指定行からの開始,ブレークポイントで停止した後の再開,プログラム変数への値の割り当て,実行可能なディスク・ファイルのパッチ,特定ルーチンの実行,環境変数の設定,およびシェアード・ライブラリのロードなどを実行することができます。

5.7.1    プログラムの実行および再実行

run および rerun コマンドは,プログラムの実行を開始します。 いずれのコマンドにも引数を指定し,それをプログラムに渡すことができます。 run コマンドに引数が指定されていない場合は,dbx は引数なしでプログラムを実行します。 rerun コマンドに引数が指定されていない場合は,前回の run あるいは rerun コマンド実行時の引数が使用されます。 rerun コマンドを実行する前に,args コマンドを使用して前もって引数を指定しておくこともできます。 args コマンドで指定された引数は,次の run コマンドでは無視されます。

これらのコマンドは,C シェルのリダイレクションと同様の方法で,プログラム入出力をリダイレクトすることができます。

注意

この出力内容は,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)  

  1. 引数は sam.c です。 [例に戻る]

  2. 前回指定した引数でプログラムを再実行します。 [例に戻る]

5.7.2    step コマンドによるプログラムの実行

高級言語で作成されているプログラムに対しては,step コマンドおよび next コマンドを使用することによって,指定した行数のソース・コードを実行することができます。 アセンブリ言語で作成されているプログラムに対しては,stepi コマンドおよび nexti コマンドを使用します。 ただしこの場合,EXP に指定する数はプログラムの行数ではなく機械語命令の数になります。 EXP を指定しない場合は,dbx はソース・コードを 1 行あるいは 1 機械語命令だけ実行します。

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)

5.7.4    コード内の特定の場所への移動

goto コマンドは,指定された行に移動して実行を続けます。 このコマンドは,when 文で,問題のあることが分かっている行を飛び越す場合などに便利です。

次に goto コマンドの形式を示します。

goto LINE

実行を続行するとき,指定されたソース行に移動する。

例

(dbx) when at 40 {goto 43}
[8] start sam.c:43 at "sam.c":40
(dbx)

5.7.5    ブレークポイント後のプログラム実行の再開

高級言語で作成されているプログラムをデバッグしている場合,ブレークポイントの後にプログラムの実行を再開するには cont コマンドを使用します。 アセンブリ言語で作成されているプログラムをデバッグしている場合は,conti コマンドを使用します。

次に cont および conti コマンドの形式を示します。

cont
conti

現在のソース・コード行あるいは機械語コード・アドレスから続行する。

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)

5.7.6    プログラム変数値の変更

assign コマンドは,プログラム変数の値を変更します。

次に assign コマンドの形式を示します。

assign VAR = EXP
assign EXP1 = EXP2

VAR で指定したプログラム変数に新しい値を割り当てる。 または,EXP1 に指定したアドレスに新しい値を割り当てる。

例

(dbx) print i
19                                     [1]
(dbx) assign i = 10
10                                     [2]
(dbx) assign *(int *)0x444 = 1         [3]
 1
(dbx) 

  1. i の値。 [例に戻る]

  2. i の新しい値。 [例に戻る]

  3. アドレスが整数となるように設定し,値 1 を割り当てる。 [例に戻る]

5.7.7    実行可能なディスク・ファイルのパッチ

patch コマンドは,実行可能なディスク・ファイルにパッチを当てて,誤ったデータまたは命令を訂正します。 テキスト,初期化されたデータ,または読み取り専用データ領域のみにパッチを当てることができます。 bss セグメントは,ディスク・ファイルに存在しないためパッチを当てることはできません。

patch コマンドは,実行中のプログラムに対して実行されると,異常終了します。

次に patch コマンドの形式を示します。

patch VAR = EXP
patch EXP1 = EXP2

VAR に指定したプログラム変数あるいは EXP1 に指定したアドレスに新しい値を割り当てる。

パッチは省略時のディスク・ファイルに適用されます。 省略時のディスク・ファイル以外のファイルにパッチを指定するために,修飾変数名を使用することもできます。 このようにパッチを当てることによって,パッチを当てるファイルのメモリ内イメージにもパッチを当てることができます。

例

(dbx) patch &main = 0
(dbx) patch var = 20
(dbx) patch &var = 20
(dbx) patch 0xnnnnn = 0xnnnnn

5.7.8    特定のプロシージャの実行

現在行のポインタをプロシージャの先頭に設定し,ブレークポイントをプロシージャの最後に置いて,プロシージャを実行することができます。 ただし,通常は,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) 

  1. stop コマンドで prnt() 関数にブレークポイントを設定します。 [例に戻る]

  2. call コマンドで prnt() に対応するオブジェクト・コードを実行します。 参照により,line1 引数は文字列を prnt に渡します。 [例に戻る]

  3. status コマンドで現在有効なブレークポイントを表示します。 [例に戻る]

  4. delete コマンドで 52 行と 40 行のブレークポイントを削除します。 [例に戻る]

print コマンドでは,出力する式にプロシージャを使用することができます。 次に例を示します。

(dbx) print sqrt(2.)+sqrt(3.)

5.7.9    環境変数の設定

環境変数を設定するには,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

  1. setenv コマンドで環境変数 TEXT を sam.c に設定します。 [例に戻る]

  2. run コマンドでプログラムを初めから実行します。 プログラムは,環境変数 TEXT に指定されたファイルから入力を読み取ります。 プログラムは 52 行目のブレークポイントで停止します。 [例に戻る]

  3. setenv コマンドで環境変数 TEXT をヌルに設定します。 [例に戻る]

  4. run コマンドでプログラムを実行します。 TEXT 環境変数にヌル値が指定されているため,入力ファイルを指定する必要があります。 [例に戻る]

5.8    ブレークポイントの設定

ブレークポイントは,プログラムの実行を一時的に停止し,その時点でプログラムの状態を検査できるようにします。 この節では,dbx コマンドを使用して,特定行またはプロシージャ内にブレークポイントを設定したり,各シグナルによってプログラムの実行を停止する方法について説明します。

5.8.1    概要

プログラムがブレークポイントで停止すると,デバッガが情報メッセージを表示します。 たとえば,main() プロシージャの 23 行目にあるサンプル・プログラム sam.c にブレークポイントが設定されると,次のメッセージが表示されます。

[4] stopped at   [main:40, 0x120000b18]     i=strlen(line1.string);
 |                 |   |    |               |
 |                 |   |    |               [5] 
 |                 |   |    [4]
 |                 |   [3]
 |                 [2]
 [1]
 
 

  1. ブレークポイント状態番号 [例に戻る]

  2. プロシージャ名 [例に戻る]

  3. 行番号 [例に戻る]

  4. 現在のプログラム・カウンタ

    この番号によって示されるポイントからアセンブリ言語命令を表示します。 5.7.5 項を参照。 [例に戻る]

  5. ソース行 [例に戻る]

複数のソース・ファイルがあるプログラムにブレークポイントを設定する前には,正しいファイルにブレークポイントを設定していることを確認します。 正しいプロシージャを選択するには,次の手順を実行してください。

  1. file コマンドを使用してソース・ファイルを選択する。

  2. func コマンドを使用してプロシージャ名を指定する。

  3. list コマンドでファイルまたはプロシージャの行をリストする。 5.6.4 項を参照。

  4. stop atコマンドを使用して必要な行にブレークポイントを設定する。

5.8.2    stop および stopi によるブレークポイントの設定

高級言語で作成されているプログラムのデバッグの場合,stop コマンドは,次のように実行を停止するためのブレークポイントを設定します。 つまり,変数が変更されるか,あるいは指定された条件が真のときに,特定のプロシージャの特定の行で,プログラムの実行を停止させることができます。 アセンブリ言語で作成されているプログラムのデバッグの場合は,stopi コマンドを使用します。 ただし,stopi コマンドは,プログラム行の代わりに機械語命令をトレースします。 $stop_on_exec 定義済み変数を設定することにより,dbx に指示して,exec() によって起動された新しいイメージに入ると,停止するように設定することもできます (表 5-8 を参照)。

delete コマンドは,stop あるいは stopi コマンドで設定したブレークポイントを削除します。

次に stop コマンド および stopiコマンドの形式を示します。

stop VAR
stopi VAR

VAR の値に変更があると停止する。

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 EXP

EXP が真のとき停止する。

stop VAR if EXP
stopi VAR if EXP

VAR の値に変更があり,EXP が真のとき停止する。

stop in PROCEDURE
stopi in PROCEDURE

プロシージャの先頭で停止する。

stop VAR in PROCEDURE

VAR の値に変更があると,指定されたプロシージャの中で停止する。

stop VAR in PROCEDURE if EXP
stopi VAR in PROCEDURE if EXP

EXP が真の場合,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)

5.8.3    実行中の変数のトレース

高級言語で作成されているプログラムのデバッグの場合は,trace コマンドを使用して,プログラム実行中に変数の値をリストし,トレースしている変数の有効範囲を決定することができます。 アセンブリ言語で作成されているプログラムのデバッグの場合は,tracei コマンドを使用します。 ただし,tracei コマンドは,プログラム行の代わりに機械語命令でトレースします。

次に trace および tracei コマンドの形式を示します。

trace LINE

指定のソース行を実行するたびにリストする。

trace VAR
tracei VAR

各ソース行あるいは機械語命令の実行後に,指定の変数をリストする。

trace [VAR] at LINE
tracei [VAR] at ADDRESS

指定した行あるいは命令の指定した変数をリストする。

trace [VAR] in PROCEDURE
tracei [VAR] in PROCEDURE

指定したプロシージャの指定した変数をリストする。

trace [VAR] at LINE if EXP
tracei [VAR] at ADDRESS if EXP

式が真である場合に,指定したソース・コード行あるいは機械語コード・アドレスの変数の値に変更があるとき,その変数をリストする。 EXP は VAR より先に検査される。

trace [VAR] in PROCEDURE if EXP
tracei [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;

5.8.4    dbx での条件コードの記述

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]    

  1. line1.length の値 [例に戻る]

  2. プロシージャ prnt 内で停止します。 [例に戻る]

5.8.5    シグナルの受信および無視

catch コマンドは,dbx が受信するシグナルをリストしたり,受信するシグナルを指定したりする場合に使用します。 プロセスが指定のシグナルを検出すると,dbx はプロセスを停止します。

ignore コマンドは,dbx が受信しないシグナルをリストしたり,無視リストに追加するシグナルを指定するために使用します。

次に catch および ignore コマンドの形式を示します。

catch

dbx が受信するすべてのシグナルのリストを表示する。

catch SIGNAL

シグナルを受信リストに追加する。

ignore

dbx が受信しないすべてのシグナルのリストを表示する。

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) 

  1. 受信リストを表示します。 [例に戻る]

  2. 無視リストを表示します。 [例に戻る]

  3. KILL を受信リストに追加し,無視リストから削除します。 [例に戻る]

前述の例中のバックスラッシュは,行の継続を表しています。 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,...,EXPN

STRING に指定されたフォーマットで指定された式の値を表示する。

注意

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) 

  1. 10 進数 [例に戻る]

  2. 8 進数 [例に戻る]

  3. 16 進数 [例に戻る]

  4. 10 進数 [例に戻る]

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)

5.9.3    メモリの内容の表示

メモリの内容は,アドレスおよび表示フォーマットを指定することによって表示することができます。

コマンドの形式は次のとおりで,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

5.9.4    dbx セッションの入出力の記録および再生

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) 

  1. 記録を開始します。 [例に戻る]

  2. 記録を中止します。 [例に戻る]

  3. 入力コマンドを再現します。 [例に戻る]

  4. 記録を中止したときにイベント 2 (記録の開始) を削除しているため,エラー・メッセージが表示されます。 [例に戻る]

この例では,dbx コマンドで作成した一時ファイルには,次の内容が記録されています。

status
stop in prnt
when i = 19 {stop}
delete 2

5.9.4.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) 

5.10    コア・ダンプ・ファイルのネーミング

この節では,オペレーティング・システムのコア・ダンプ・ファイルのネーミング機能を有効にして,複数のコア・ファイルを保存できるようにする方法について説明します。

コア・ファイルのネーミング機能を有効にすると,システムは,次の形式の名前でコア・ファイルを生成します。

core.prog-name.host-name.tag

コア・ファイル名は,ピリオドで区切った次の 4 つの部分からなります。

コア・ファイルのネーミング機能は,システム・レベル (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);
}

5.11    実行中のプロセスのデバッグ

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-id

process-id には,アタッチするプロセスのプロセス ID を指定します。

デバッグのためにプロセスにアタッチするには,コマンド行オプションの -pid  process  id を使用することもできます。

実行中のプロセスからデタッチするには,dbx コマンドの detach を使用します。 このコマンドの構文は次のとおりです。

detach [process-id ]

process-id には,デタッチするプロセスのプロセス ID を指定します。 引数を省略した場合は,dbx は現在のプロセスをデタッチします。

あるプロセスから別のプロセスに変更する場合は,switch コマンドを使用します。 このコマンドの構文は次のとおりです。

switch process-id

process-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

アクティブなプロセスとその状態を表示します。 現在のプロセスに対しては,� のマーカが表示されます。

5.12    マルチスレッド・アプリケーションのデバッグ

dbx デバッガは,スレッドを使用するアプリケーションのデバッグを支援する次の 3 つの基本コマンドをサポートします。

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

5.13    複数の非同期プロセスのデバッグ

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);
}