シンボル・テーブルの検査

ここで説明するコマンドによって、 ユーザ・プログラムの中で定義されているシンボル情報 （変数名、 関数名、 型名） に関する問い合わせを行うことができます。 この情報はユーザ・プログラムのテキストに固有のもので、 プログラムの実行時に変わるものではありません。 GDBはこの情報を、 ユーザ・プログラムのシンボル・テーブルの中、 または、 GDB起動時に指定されたファイル （ファイルの選択参照） の中で見つけるか、 ファイル管理コマンド （ファイルを指定するコマンド参照） の実行によって見つけます。

ときには、 参照する必要のあるシンボルの中に、 GDBが通常は単語の区切り文字として扱う文字が含まれていることがあるかもしれません。 特に多いのが、 他のソース・ファイルの中の静的変数を参照する場合です （プログラム変数参照）。 ファイル名は、 オブジェクト・ファイルの中にデバッグ・シンボルとして記録されていますが、 GDBは通常、 典型的なファイル名、 例えば`foo.c'を解析して、 3つの単語 `foo'、 `.'（ピリオド）、 `c'であるとみなします。 GDBが`foo.c'を単一のシンボルであると認識できるようにするには、 それを単一引用符で囲みます。 例えば、

p 'foo.c'::x

は、 xの値をファイル`foo.c'のスコープの中で検索します。

info address symbol

symbolで指定されるシンボルのデータがどこに格納されているかを示します。 レジスタ変数の場合は、 それがどのレジスタに入っているかを示します。 レジスタ変数ではないローカル変数の場合は、 その変数が常に格納されている位置の、 スタック・フレーム内におけるオフセット値を表示します。 `print &symbol'との相違に注意してください。 `print &symbol'はレジスタ変数に対しては機能しませんし、 スタック内のローカル変数に対して実行すると、 その変数のカレントなインスタンスの存在するアドレスそのものが表示されます。

whatis expr

式exprのデータ型を表示します。 exprは実際には評価されず、 expr内の副作用を持つ操作 （例えば、代入や関数呼び出し） は実行されません。 式 を参照してください。

whatis

値履歴の最後の値である $のデータ型を表示します。

ptype typename

データ型typenameの説明を表示します。 typenameは型の名前です。 Cで記述されたコードの場合は、 `class class-name'、 `struct struct-tag'、 `union union-tag'、 `enum enum-tag'という形式を取ることができます。

ptype expr

ptype

式exprの型に関する説明を表示します。 単に型の名前を表示するだけではなく、 詳細な説明も表示するという点で、 ptypeはwhatisと異なります。 例えば、 変数宣言

struct complex {double real; double imag;} v;

に対して、 whatis、 ptypeはそれぞれ以下のような出力をもたらします。

(gdb) whatis v
type = struct complex
(gdb) ptype v
type = struct complex {
    double real;
    double imag;
}

whatisと同様、 引数なしでptypeを使用すると、 値履歴の最後の値である$の型を参照することになります。

info types regexp

info types

その名前がregexpで指定される正規表現にマッチするすべての型 （あるいは、 引数を指定しなければ、 ユーザ・プログラム中のすべての型） の簡単な説明を表示します。 個々の型の完全な名前は、 それ自体が1つの完全な行であるものとみなしてマッチされます。 したがって、 `i type value'は、 ユーザ・プログラムの中で、 その名前が文字列valueを含むすべての型に関する情報を表示し、 `i type ^value$'は、 名前がvalueそのものである型に関する情報だけを表示します。 このコマンドはptypeとは2つの点で異なります。 まず第1にwhatisと同様、 詳細な情報を表示しません。 第2に、 型が定義されているすべてのソース・ファイルを一覧表示します。

info source

カレントなソース・ファイル、 すなわち、 カレントな実行箇所を含む関数のソース・ファイルの、 ファイル名とそれが記述された言語の名前を表示します。

info sources

ユーザ・プログラムのソース・ファイルのうち、 デバッグ情報の存在するものすべての名前を、 2つの一覧にして表示します。 2つの一覧とは、 シンボルが既に読み込まれたファイルの一覧と、 後に必要なときにシンボルが読み込まれるファイルの一覧です。

info functions

すべての定義済み関数の名前とデータ型を表示します。

info functions regexp

その名前がregexpで指定される正規表現にマッチする部分を持つすべての定義済み関数の名前とデータ型を表示します。 したがって、 `info fun step'は、 その名前が文字列stepを含むすべての関数を見つけ、 `info fun ^step'は、 名前が文字列stepで始まるすべての関数を見つけます。

info variables

関数の外部で宣言されているすべての変数 （つまり、 ローカル変数を除く変数） の名前とデータ型を表示します。

info variables regexp

その名前が正規表現regexpにマッチする部分を持つすべての （ローカル変数を除く） 変数の名前とデータ型を表示します。 いくつかのシステムにおいては、 ユーザ・プログラムの停止・再起動を伴うことなく、 そのユーザ・プログラムを構成する個々のオブジェクト・ファイルを更新することができます。 例えば、 VxWorksでは、 欠陥のあるオブジェクト・ファイルを再コンパイルして、 実行を継続することができます。 このようなマシン上でプログラムを実行しているのであれば、 自動的に再リンクされたモジュールのシンボルをGDBに再ロードさせることができます。

set symbol-reloading on

ある特定の名前を持つオブジェクト・ファイルが再検出されたときに、 対応するソース・ファイルのシンボル定義を入れ替えます。

set symbol-reloading off

同じ名前を持つオブジェクト・ファイルを2回以上検出したときに、 シンボル定義を入れ替えません。 これがデフォルトの状態です。 モジュールの自動再リンクを許しているシステム上でプログラムを実行しているのでない場合は、 symbol-reloadingの設定はoffのままにするべきです。 さもないと、 （異なるディレクトリやライブラリの中にある） 同じ名前を持ついくつかのモジュールを含むような大きなプログラムをリンクする際に、 GDB はシンボルを破棄してしまうかもしれません。

show symbol-reloading

symbol-reloadingのカレントな設定 （onまたはoff） を表示します。

set opaque-type-resolution on

オペーク（opaque）型の解決を行うようGDBに指示します。 オペーク型とは、 struct、 class、 または、 unionへのポインタとして宣言されている型 --例えば、struct MyType *-- であり、 かつ、 struct MyType(5) の完全な宣言が行われているソース・ファイルとは異なるソース・ファイルにおいて使用される型のことです。 デフォルトはonです。 このサブコマンドの設定を変更しても、 ファイルのシンボルが次にロードされるまでは効力を持ちません。

set opaque-type-resolution off

オペーク型の解決を行わないようGDBに指示します。 この場合、 オぺーク型は以下のように表示されます。

{<no data fields>}

show opaque-type-resolution

オペーク型の解決が行われるか否かを示します。

maint print symbols filename

maint print psymbols filename

maint print msymbols filename

デバッグ・シンボル・データのダンプをファイルfilenameの中に書き込みます。 これらのコマンドは、 GDBのシンボル読み込みコードをデバッグするのに使われています。 デバッグ・データを持つシンボルだけがダンプに含まれます。 `maint print symbols'を使用すると、 GDBは、 完全な詳細情報を既に入手済みのすべてのシンボルをダンプに含めます。 つまり、 ファイルfilenameには、 GDBがそのシンボルを読み込み済みのファイルに対応するシンボルが反映されます。 info sourcesコマンドを使用することで、 これらのファイルがどれであるかを知ることができます。 代わりに`maint print psymbols'を使用すると、 GDB が部分的にしか知らないシンボルに関する情報もダンプの中に含まれます。 これは、 GDBがざっと読みはしたものの、 まだ完全には読み込んでいないファイルに定義されているシンボルに関する情報です。 最後に`maint print msymbols'では、 GDBが何らかのシンボル情報を読み込んだオブジェクト・ファイルから、 最小限必要とされるシンボル情報がダンプされます。 GDBがどのようにしてシンボルを読み込むかについては、 ファイルを指定するコマンド （のsymbol-fileの説明の部分） を参照してください。