OpenVMS マニュアル

第 2 部
コマンド・インタフェース

デバッガの DECwindows Motif ユーザ・インタフェースについては， 第 3 部 をご覧ください。

第 2 章
デバッガの起動

本章では，デバッガの基本的なコマンド・インタフェースについて説明します。

デバッガの使用法は，デバッグの対象となるプログラムの種類，探しているエラーの種類，およびユーザの個人的な方法や経験など，いくつかの要素によって決まります。本章では，ほとんどの状況にあてはまる，次のような基本的な作業について説明します。

• デバッガ・コマンドの入力とオンライン・ヘルプの表示

• TYPE コマンドによる画面モードでのソース・コードの表示

• GO，STEP，SET BREAK の各コマンドを使用したプログラムの実行制御と， SHOW CALLS，SET TRACE，SET WATCH の各コマンドを使用したプログラムの実行のモニタ

• EXAMINE，DEPOSIT，EVALUATE の各コマンドを使用したデータの検査と操作

• パス名と SET MODULE コマンドおよび SET SCOPE コマンドを使用したシンボル参照の制御

ほとんどの例は，すべてのサポート言語に十分適用できまが，一部には，言語特有のものもあります。

第 2.6 節 内のデバッグ・セッション例は，エラーを見つけ修正する方法を説明します。

デバッグ・セッションの開始と終了についての詳しい説明は， 第 1.3 節 を参照してください。

2.1 デバッガ・コマンドの入力とオンライン・ヘルプへのアクセス

第 1.3 節 の説明どおりにいったんデバッガを起動すると，デバッガ・プロンプト (DBG> ) が表示されているときはいつでも，デバッガ・コマンドを入力できます。デバッガ・コマンドを入力するには，キーボード上でコマンドを入力して Return キーを押します。たとえば，次のコマンドは変数 COUNT にウォッチポイントを設定します。

DBG> SET WATCH COUNT

デバッガ・コマンドについての詳しい説明は，『デバッガ・コマンド・ディクショナリ』またはオンライン・ヘルプで参照できます。

• ヘルプ・トピックを表示するには，プロンプトにHELPと入力する。

• ヘルプ・システムの説明を表示するには，HELP HELPと入力する。

• 完全なコマンド入力形式を表示するには， HELP Command_Format と入力する。

• 特定のコマンドについてのヘルプを表示するには， HELP command と入力する。たとえば，SET WATCHコマンドのヘルプを表示するには， HELP SET WATCHと入力する。

• コマンドを機能別に表示するには，HELP Command_Summary と入力する。

次のトピックについても，オンライン・ヘルプが使用できます。

新機能
リリース・ノート
アドレス式
組み込みシンボル
DECwindowsインタフェース
キーパッド定義
言語サポート
論理名
メッセージ(診断メッセージ)
(シンボリック名を修飾する)パス名
画面モード
(プログラムからデバッガを起動する)SS$_DEBUG条件
システム管理

上記の任意のトピックに関するヘルプを表示するには， HELP topic と入力します。たとえば，診断メッセージに関する情報を表示するには， HELP Messages と入力します。

デバッガを起動すると，よく使用されるいくつかのコマンドが，自動的にメイン・キーボードの右側の数値キーパッド上のキーに割り当てられます。したがって，これらの機能は，コマンドを入力するか，またはキーパッド上のキーを押すことによって実行できます。

キーパッド上の定義済みキー機能を 図 2-1 に示します。

図 2-1 デバッガの定義済みキーパッド・キー機能---コマンド・インタフェース

ほとんどのキーパッド・キーには，DEFAULT，GOLD，BLUE の 3 つの定義済み機能があります。

• あるキーの DEFAULT 機能は，その目的のキーを押して実行する。

• あるキーの GOLD 機能は，まず PF1 (GOLD) キーを押してから，その目的のキーを押して実行する。

• あるキーの BLUE 機能は，まず PF4 (BLUE) キーを押してから，その目的のキーを押して実行する。

図 2-1 では，各キーの中に DEFAULT，GOLD，および BLUE の各機能をそれぞれ上から下に順番に示してあります。次に例を示します。

• KP0キー(キーパッド・キー0)を押すと，STEPコマンドを実行できる。

• PF1キーを押してからKP0キーを押すと，STEP/INTOコマンドを実行できる。

• PF4キーを押してからKP0キーを押すと，STEP/OVERコマンドを実行できる。

通常，KP2，KP4，KP6，および KP8 の各キーは，それぞれ下方向，左方向，右方向，上方向の画面スクロールを実行します。また 図 2-1 に示したように，キーボードを MOVE，EXPAND，CONTRACT の各状態に設定すると，上の 4 つのキーを使用して，画面を 4 方向に移動，拡大，または縮小できます。キーパッド・キー定義を表示するには， HELP Keypad_Definitionsコマンドを入力します。

また，キーパッド・キー機能を再定義するには，DEFINE/KEY コマンドを使用します。

2.2 ソース・コードの表示

デバッガには，非画面モードと画面モードの 2 つの情報表示モードがあります。省略時の設定では，デバッガ起動時に非画面モードになります。しかし，画面モードでソース・コードを表示したほうがよい場合があります。次の 2 つの項では，2 つのモードについて簡単に説明します。

2.2.1 非画面モード

非画面モードは省略時の設定であり，入出力 (I/O) を行用モードで表示します。本章での会話例は， 第 2.2.2 項 を除き，すべて非画面モードを使用しています。

非画面モードでは，TYPE コマンドを使用して，1 行または複数行のソース行を表示します。たとえば，次のコマンドは，現在一時停止しているモジュールの 7 行目を表示します。

DBG> TYPE 7 module SWAP_ROUTINES 7: TEMP := A; DBG>

ソース行の表示は，プログラムの実行とは関係ありません。現在一時停止しているモジュール以外のモジュール ( コンパイル単位 ) からソース・コードを表示するには，TYPE コマンドにパス名を使用して，そのモジュールを指定します。たとえば，次のコマンドは，モジュール TEST の 16 行目から 21 行目までを表示します。

DBG> TYPE TEST\16:21

パス名については，STEP コマンドとともに 第 2.3.2 項 で詳しく説明します。

また，EXAMINE/SOURCE コマンドを使用すれば，特定の命令と対応するルーチンまたは他の任意のプログラム記憶位置のソース行を表示することができます。

ブレークポイント，ウォッチポイント，STEP コマンドのあと，またはトレース・ポイントが検出されたとき ( 第 2.3 節 参照) にデバッガが実行を中断する場合は，ソース行が自動的に表示されます。

プログラム内のさまざまな記憶位置のソース行を表示したあと，現在実行が一時停止している記憶位置を再表示するには，KP5キーを押します。

表示するソース行の位置を確定できない場合，デバッガは診断メッセージを発行します。ソース行を表示できない理由は，いくつか考えられます。次に例を示します。

• /DEBUG 修飾子を使用しないでコンパイルまたはリンクされたモジュール内で実行が一時停止している。

• ソース・コードが使用できないシステム・ルーチンまたは共用可能イメージ・ルーチン内で実行が一時停止している。

• ソース・ファイルが，コンパイル後に別のディレクトリに移された ( ソース・ファイルの記憶位置は，オブジェクト・モジュールに組み込まれている )。この場合，SET SOURCE コマンドを使用して新しい記憶位置を指定する。

• SET MODULE コマンドを使用して，モジュールを設定する必要がある。モジュールの設定については， 第 2.5.1 項 を参照。

画面モードから非画面モードに移行するには，PF1 キーを押したあと， PF3 キーを押すか，または SET MODE NOSCREEN を入力します。 TYPE コマンドおよび EXAMINE/SOURCE コマンドは，非画面モードだけでなく，画面モードでも使用できることに注意してください。

2.2.2 画面モード

画面モードは，ソース・コードを表示する最も簡単な方法を提供します。画面モードに切り替えるには，PF3 キーを押すか，または SET MODE SCREEN と入力します。画面モードでは， 図 2-2 に示すように省略時の設定により，画面は 3 つの部分，すなわち SRC，OUT，および PROMPT に分割されます。

図 2-2 省略時の画面モード・ディスプレイ構成

---

「SRC」ディスプレイは，現在実行を一時停止しているモジュールのソース・コードを表示します。最左欄の矢印は，プログラム・カウンタ (PC) の現在値に対応するソース行を指しています。PC は，次の実行命令のメモリ・アドレスを含むレジスタです。行番号は，コンパイラによって割り当てられますから，リスト・ファイル内の行番号と一致します。プログラムを実行するうちに，矢印は下に移動し，矢印がディスプレイの中央になるようにソース・コードは上にスクロールします。

「OUT」ディスプレイは，入力されたコマンドに対するデバッガの出力を表示します。「PROMPT」ディスプレイは，デバッガのプロンプト，ユーザの入力(ユーザの入力したコマンド)，デバッガの診断メッセージ，およびプログラムの出力を表示します。

「SRC」ディスプレイと「OUT」ディスプレイをスクロールすれば，ディスプレイ・ウィンドウに収まらない情報もすべて，スクロールして見ることができます。スクロールするディスプレイを選択するには，KP3 キーを必要なだけ繰り返し押してください。省略時の設定では，「SRC」ディスプレイがスクロールします。上方スクロールには KP8 キーを，下方スクロールには KP2 キーを使用します。ディスプレイのスクロールは，プログラムの実行とは関係ありません。

画面モードで，実行を一時停止しているルーチンのソース行を確定できない場合，デバッガはソース行を表示できる，呼び出しスタック内の次のルーチンのソース行を表示しようとします。このようなルーチンのソース行が表示された場合，デバッガは次のメッセージを発行します。

%DEBUG-I-SOURCESCOPE, Source lines not available for .0\%PC. Displaying source in a caller of the current routine. DBG>

このような場合，「SRC」ディスプレイ内の矢印は，呼び出し元ルーチンの CALL 文の直後のコードを含む行を示します。

2.3 プログラム実行の制御とモニタ

この節では次の作業の実行方法について説明します。

• プログラムの実行を開始または再開する。

• プログラムを，1行単位，命令単位，または他のステップ単位で実行する。

• 現在実行が一時停止している箇所を決定する。

• ブレークポイントを使用して目的の箇所でプログラムの実行を中断する。

• トレースポイントを使用して，指定された記憶位置を通るプログラムの実行パスをトレースする。

• ウォッチポイントを使用して変数値の変化をモニタする。

これらの情報を使用すれば， 第 2.4 節 で説明するように，プログラム記憶位置を選択し，その記憶位置で変数の内容を検査および操作することができます。

2.3.1 プログラム実行の開始または再開

プログラムの実行を開始または再開するには，GO コマンドを使用します。

GO コマンドを使用してプログラムが開始されると，プログラムは次のいずれかのイベントが発生するまで実行を続けます。

• プログラムが実行を終了する。

• ブレークポイントに到達する。

• ウォッチポイントが検出される。

• 例外がシグナル通知される。

• ユーザがCtrl/Cを押す。

ほとんどのプログラミング言語では，プログラムがデバッガの制御下に置かれたとき，メイン・プログラムの先頭で最初に実行を一時停止します。この時点で GO コマンドを入力すると，簡単に無限ループや例外をテストできます。

実行中に無限ループが発生すると，プログラムは終了せず，デバッガのプロンプトは再表示されません。プロンプトを表示するには，Ctrl/C を押して実行に割り込みをかけます ( 第 1.4 節 参照)。画面モードを使用している場合は，ソース・ディスプレイ内のポインタが実行停止箇所を示しています。また，SHOW CALLSコマンドを使用すれば，呼び出しスタック内の現在アクティブなルーチン呼び出しを確認できます ( 第 2.3.3 項 を参照)。

プログラムによって処理されない例外がシグナル通知されると，デバッガはその時点で実行を中断し，ユーザがコマンドを入力できるようにします。ユーザは，ソース・ディスプレイおよび SHOW CALLS ディスプレイを見て，実行が一時停止している箇所を見つけることができます。

GO コマンドの一般的な使用方法は，ブレークポイント，トレースポイント，およびウォッチポイントとともに使用する方法です。これらの使用方法については，それぞれ 第 2.3.4 項 ， 第 2.3.5 項 ，および 第 2.3.6 項 で説明します。実行パス内にブレークポイントを設定して GO コマンドを入力すると，そのブレークポイントで実行が一時停止します。同様に，トレースポイントを設定すると，そのトレースポイントを通して実行がモニタされます。またウォッチポイントを設定すると，ウォッチされている変数の値が変化したとき，実行が一時停止します。

2.3.2 ステップ単位でのプログラムの実行

STEP コマンドを使用すれば，プログラムを一度に 1 ステップまたはそれ以上の単位で実行できます。

省略時の設定では，ステップ単位はソース・コード 1 行です。次の例では， STEP コマンドはソース・コードを 1 行実行し，動作 ("stepped to..." ) を報告し，次の実行行の番号(27)とソース・コードを表示します。

DBG> STEP stepped to TEST\COUNT\%LINE 27 27: X := X + 1; DBG>

実行は，モジュール TEST 内のルーチン COUNT 内にある行 27 の最初の機械語コード命令で一時停止しています。

プログラム・シンボル ( たとえば，行番号，ルーチン名，または変数名など ) を表示する場合，デバッガは常に パス名 を使用します。パス名は，シンボルとそのシンボルの記憶位置を示す接頭辞から構成されます。上の例では，TEST\COUNT\%LINE27 がパス名です。パス名の一番左の要素はモジュール名です。そのあとには，右に移動するにしたがって，そのシンボルを含むネストされたルーチンおよびブロックが続きます。バックスラッシュ(\)は，要素を区切るために使用します。使用言語がAdaの場合は，Adaの構文にならってピリオドが使用されます。

パス名はデバッガに対して，プログラム内のシンボルを一意に識別します。通常，コマンド内でパス名を使用する必要があるのは，デバッガがプログラム内のシンボルのあいまいさを解消できないときだけです ( 第 2.5 節 を参照)。通常デバッガは，前後関係からユーザの意味するシンボルを特定できます。

STEP コマンドを使用する場合，デバッガは，コンパイラによってコード命令が生成されたソース行だけを実行可能な行とみなします。コメント行などのその他の行は，スキップされます。

ユーザは，行単位のステップ実行の代わりに命令単位のステップ実行 (SET STEP INSTRUCTION) などの異なるステップ実行モードを指定することができます。また，省略時の設定では，呼び出されたルーチンは 1 ステップとして実行されます。すなわち，呼び出されたルーチンは実行されますが，ルーチン内で実行は一時停止されません。SET STEP INTO コマンドを入力すれば，現在実行を一時停止しているルーチン内だけでなく，呼び出されたルーチン内でも実行を中断するようデバッガに指示できます。省略時の設定は，SET STEP OVER です。

2.3.3 実行停止箇所の決定

SHOW CALLS コマンドは，デバッグ・セッション中に実行が一時停止した箇所が分からない場合 ( たとえば，Ctrl/C による割り込みのあとなど ) に使用します。

このコマンドは，実行が一時停止しているルーチンに至るまでの呼び出しの並びをリストします。デバッガは，各ルーチン ( 実行が一時停止しているルーチンから始まる ) について，次の情報を表示します。

• そのルーチンを含むモジュール名

• ルーチン名

• 呼び出しが実行された行番号 ( 現在のルーチンの場合は，実行が一時停止された行番号 )

• 対応するPC値。
  Alpha プロセッサと Itanium® プロセッサでは，PC 値は，モジュール内の先頭コード・アドレスからの相対アドレスと，絶対アドレスの両方の値が表示されます。
  Itanium® プロセッサには，ハードウェア PC レジスタはありません。 PC 値は，ハードウェア・インストラクション・ポインタ (IP) レジスタと，バンドル内の命令のスロット・オフセット (0，1，または 2) を加算して，ソフトウェアにより組み立てられます。

次に例を示します。

DBG> SHOW CALLS module name routine name line rel PC abs PC *TEST PRODUCT 18 00000009 0000063C *TEST COUNT 47 00000009 00000647 *MY_PROG MY_PROG 21 0000000D 00000653 DBG>

この例は，モジュール TEST 内のルーチン PRODUCT の 18 行目で実行が一時停止しており，ルーチン PRODUCT は，モジュール TEST 内のルーチン COUNT の 47 行目で呼び出され，さらにルーチン COUNT は，モジュール MY_PROG 内のルーチン MY_PROG の 21 行目で呼び出されたことを示しています。

---

目次

索引