OpenVMS マニュアル

5.4.2 共用可能イメージ内のシンボルへのアクセス

第 5.1 節 ， 第 5.2 節 ，および 第 5.3 節 で説明したすべての概念は，単一イメージのモジュール，すなわち実行可能なメイン・イメージに適用されます。ここでは，共用可能イメージのデバッグに固有の追加情報を提供します。

第 5.4.1 項 で説明したように，デバッグ用に共用可能イメージをリンクすると，リンカは各イメージに DST と GST を作成します。共用可能イメージの GST には，ユニバーサル・シンボルだけが含まれます。メモリを節約するために，デバッガはイメージが設定されたときだけ，そのイメージの RST を作成します。イメージは，動的に，または SET IMAGE コマンドの入力によって設定されます。

SHOW IMAGE コマンドは，ユーザ・プログラムにリンクされているすべての共用可能イメージを示し，設定されているイメージや現在のイメージを識別します (現在のイメージの定義については， 第 5.4.2.2 項 を参照)。プログラムがデバッガの制御下に置かれたときには，最初にメイン・イメージだけが設定されます。

次の各項では，デバッガが，プログラムの実行中に動的にイメージを設定する方法と，実行に関係なく任意のイメージ内のシンボルへのアクセスを可能にする方法を説明します。

インストールされた書き込み可能な共用可能イメージ内にウォッチポイントを設定する方法については， 第 3.4.3.4 項 を参照してください。

省略時の設定では，動的モードが有効になっています。したがって，実行が中断したときにはいつも，停止している位置のイメージおよびモジュールが設定されます (それらのモジュールがまだ設定されていない場合)。

動的モードを使用すれば，次のようなシンボルへのアクセスが自動的に可能となります。

• 実行が停止しているイメージ内のすべての設定されているモジュールで定義されているシンボルの参照

• そのイメージの GST 内の任意のユニバーサル・シンボルの参照

SET MODULE コマンドを使用して，そのイメージ内の他のモジュールを設定すると，ユーザはそのイメージ内の任意のシンボルを参照することができます。

いったん設定されたイメージは，CANCEL IMAGE コマンドによって取り消されるまで，そのまま設定されています。設定されたイメージおよびモジュールの数が増えたため，デバッガの処理速度が低下する場合は，CANCEL IMAGE コマンドを使用してイメージを取り消します。また，SET MODE NODYNAMIC コマンドを使用して，動的モードを無効にすることもできます。

ユーザまたはデバッガが最後に設定したイメージを 現在のイメージ と言います。現在のイメージは，シンボル検索のためのデバッグ・コンテキストです。したがって，次のコマンドを使用した場合，ユーザは現在のイメージ内に定義されているシンボルだけを参照することができます。

DEFINE/ADDRESS
DEFINE/VALUE
DEPOSIT
EVALUATE
EXAMINE
TYPE
(SET,CANCEL) BREAK
(SET,SHOW,CANCEL) MODULE
(SET,CANCEL) TRACE
(SET,CANCEL) WATCH
SHOW SYMBOL

SHOW BREAK，SHOW TRACE，SHOW WATCH の各コマンドは，すべてのイメージ内に設定されている任意のブレークポイント，トレースポイント，またはウォッチポイントを示すことに注意してください。

現在のイメージ以外のイメージ内に存在するシンボルを参照するには， SET IMAGE コマンドを使用して現在のイメージを指定したあと， SET MODULE コマンドを使用して，そのシンボルが定義されているモジュールを設定します。SET IMAGE コマンドは，モジュールを設定しません。次のサンプル・プログラムは，これらの概念を示したものです。

サンプル・プログラムは，メイン・イメージ PROG1 と共用可能イメージ SHR1 からなります。現在，プログラムがデバッガの制御下に置かれ，実行がイメージ PROG1 内のメイン・プログラム単位で停止していると想定します。ここで，ルーチン ROUT2 にブレークポイントを設定したいとします。 ROUT2 は，イメージ SHR1 内のあるモジュールで定義されています。

ROUT2 にブレークポイントを設定しようとすると，デバッガは現在のイメージ PROG1 内から ROUT2 を検索します。

DBG> SET BREAK ROUT2
%DEBUG-E-NOSYMBOL, symbol 'ROUT2' is not in symbol table
DBG>

SHOW IMAGE コマンドは，イメージ SHR1 の設定が必要であることを示しています。

DBG> SHOW IMAGE
 image name           set    base address    end address 
 
*PROG1                yes    00000200        000009FF 
 SHR1                 no     00001000        00001FFF 
 
 total images: 2           bytes allocated: 32856
DBG> SET IMAGE SHR1
 
DBG> SHOW IMAGE
 image name           set    base address    end address 
 
 PROG1                yes    00000200        000009FF 
*SHR1                 yes    00001000        00001FFF 
 
 total images: 2           bytes allocated: 41948
DBG>

これで，SHR1 が設定され，現在のイメージになりました。しかし，SET IMAGE コマンドはモジュールを設定しないので，ユーザはブレークポイントを設定する前に， ROUT2 が定義されているモジュールを設定しなければなりません。

DBG> SET BREAK ROUT2
%DEBUG-E-NOSYMBOL, symbol 'ROUT2' is not in symbol table
DBG> SET MODULE/ALL
DBG> SET BREAK ROUT2
DBG> GO
break at routine ROUT2 
10:     SUBROUTINE ROUT2(A,B)
DBG>

イメージ SHR1 とそのすべてのモジュールが設定され， ROUT2 でブレークポイントに到達しています。あとは，通常の方法でデバッグすることができます。たとえば，ルーチン内の命令のステップ実行や変数の検査などです。

いったん設定されたイメージおよびそのイメージ内のモジュールは，新しい現在のイメージが設定されても，そのまま設定されています。しかし，任意の一時点に複数のシンボルにアクセスできるのは，それらのシンボルが現在のイメージ内に存在するときだけです。

次の段落では，実行時ライブラリ，またはシンボル・テーブル情報が生成されていないその他の共用可能イメージ内のユニバーサル・シンボル ( ルーチン名など ) にアクセスする方法について説明します。この方法を使用すれば，ユーザはたとえば CALL コマンドを使用して， 第 13.7 節 で説明するように実行時ライブラリまたはシステム・サービス・ルーチンを実行できます。

次のコマンド構文を使用して SET MODULE コマンドを入力します。

SET MODULE SHARE$image-name

次に例を示します。

DBG> SET MODULE SHARE$LIBRTL

デバッガは，ユーザ・プログラム内の各共用可能イメージに仮モジュールを作成します。これらの共用可能イメージ・モジュールの名前には，接頭辞 "SHARE$" が付いています。 SHOW MODULE/SHARE コマンドは，現在のイメージ内のモジュールだけでなく，これらの共用可能イメージ・モジュールも示します。

SET MODULE コマンドによって，いったん共用可能イメージ・モジュールが設定されると，ユーザは，そのイメージ内のすべてのユニバーサル・シンボルにアクセスできます。次のコマンドは，LIBRTL 内のすべてのユニバーサル・シンボルをリストします。

DBG> SHOW SYMBOL * IN SHARE$LIBRTL
   .
   .
   .
routine SHARE$LIBRTL\STR$APPEND 
routine SHARE$LIBRTL\STR$DIVIDE 
routine SHARE$LIBRTL\STR$ROUND
   .
   .
   .
routine SHARE$LIBRTL\LIB$WAIT 
routine SHARE$LIBRTL\LIB$GETDVI
   .
   .
   .

ユーザは，これらのユニバーサル・シンボルを，たとえば CALL コマンドや SET BREAK コマンドなどに指定できます。

SET MODULE コマンドを使用して共用可能イメージ・モジュールを設定すると，そのイメージのユニバーサル・シンボルが実行時シンボル・テーブルにロードされます。その結果，これらのシンボルは現在のイメージから参照できるようになります。しかし，そのイメージ内の他のシンボル ( ローカル・シンボルやグローバル・シンボル ) は，現在のイメージからは参照できません。すなわち，ユーザのデバッグ・コンテキストは，現在のイメージに設定されたままです。

5.4.3 常駐イメージのデバッグ (Alpha のみ)

常駐イメージは，効率を高めることができるように特定の方法で作成され，インストールされた共用可能モジュールです。このようなイメージを作成するには，シンボル・テーブルを除いてイメージをリンクし，システム空間でイメージを実行する必要があります。このようにして作成したイメージは，デバッグが困難になります。次の手順では，もっと簡単にデバッグできる常駐イメージを作成します。

1. 共用可能イメージをコンパイルする。次の例を参照。

   $ CC/DEBUG/NOOPTIMIZE RESIDENTMODULE.C

2. /DSF 修飾子を使用して共用可能イメージをリンクする。次の例を参照。

   $ LINK/NOTRACEBACK/SHAREABLE/SECTION_BINDING/DSF RESIDENTMODULE

   
   イメージのリンクについては，『OpenVMS Linker Utility Manual』を参照。

3. インストール済み常駐イメージを作成する。Install ユーティリティの使い方については，『OpenVMS システム管理ユーティリティ・リファレンス・マニュアル (上巻 ) 』を参照。常駐イメージの詳細については，『OpenVMS システム管理者マニュアル (下巻)』を参照。

4. 常駐イメージを呼び出すプログラムをコンパイルする。次の例を参照。

   $ CC/DEBUG/NOOPTIMIZE TESTPROGRAM

5. 常駐イメージを呼び出す実行可能イメージを作成する。次の例を参照。

   $ LINK/DSF TESTPROGRAM

6. 常駐イメージのプライベート・コピーを作成する。次の例を参照。

   $ COPY SYS$LIBRARY:RESIDENTMODULE.EXE []RESIDENTMODULE.EXE

7. 常駐イメージのプライベート・コピーを指す論理名を定義する。次の例を参照。

   $ DEFINE RESIDENTMODULE []RESIDENTMODULE

8. テスト・プログラム用の .DSF ファイルと常駐モジュール用の .DSF ファイルの両方が同じディレクトリに格納されていることを確認する。

9. .DSF ファイルを格納したディレクトリを指すように， DBG$IMAGE_DSF_PATH を定義する。

10. デバッガを起動する。次の例を参照。

    $ DEBUG/KEEP TESTPROGRAM

これで実行可能イメージと常駐イメージに対して，すべてのデバッグ・オプションを使用できるようになります。

---

目次

索引