DBH Commands

DBH コマンド ラインから、さまざまなコマンドを使用してシンボルとシンボル ファイルを分析できます。

次の表に、DBH オプションを制御し、その他の基本的なタスクを実行するコマンドを示します。

Command	Effect
verbose [on|off]	詳細モードをオンまたはオフにします。 パラメーターを指定しない場合は、現在の詳細モードの設定が表示されます。
sympath [Path]	シンボル検索パスを設定します。 パラメーターを指定しない場合は、現在のシンボル検索パスが表示されます。
symoptOptions symopt +Options symopt -Options symopt	シンボル オプションを設定します。 With no + or -, the value of Options replaces the current symbol options. If + or - is used, Options specifies the options to be added or removed; there must be a space before the + or - but no space after it. パラメーターがないと、現在のシンボル オプションが表示されます。 DBH を起動すると、すべてのシンボル オプションの既定値が0x10C13されます。 使用可能なオプションの一覧については、「 シンボル オプションの設定」を参照してください。
help	DBH コマンドのヘルプ テキストを表示します。
quit	DBH プログラムを終了します。

次の表に、ターゲット モジュールの読み込み、アンロード、およびリベースを行うコマンドを示します。 コマンド・ラインでプロセス ID を指定して DBH が開始された場合、これらのコマンドは使用できません。

Command	Effect
loadFile	指定したモジュールを読み込みます。 File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	現在のモジュールをアンロードします。
baseAddress	既定のベース アドレスを指定した値に設定します。 すべてのシンボル アドレスは、このベース アドレスを基準にして決定されます。

次の表に、ファイルを検索し、ディレクトリ情報を表示するコマンドを示します。

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	指定したパス内の指定した .dbg ファイルを検索します。 .dbg 拡張機能の組み込みは省略可能です。
dirFile Path	Locates the specified file in the specified path or in any subdirectory under this path, using the EnumDirTree routine.
srchtreePath File	Locates the specified file in the specified path or in any subdirectory under this path, using the SearchTreeForFile routine. This command is the same as dir, except that the parameters are reversed.
ffpathFile	現在のシンボル パス内の指定したファイルを検索します。

次の表に、モジュールの一覧を解析し、既定のモジュールを制御するコマンドを示します。 既定のモジュールとそのベース アドレスが DBH プロンプトに表示されます。

Command	Effect
modAddress	既定のモジュールを、指定したベース アドレスを持つモジュールに変更します。
refresh	モジュールの一覧を更新します。
omap	モジュール OMAP 構造体を表示します。
epmodPID	指定したプロセスに対して読み込まれたすべてのモジュールを列挙します。 PID specifies the process ID of the desired process.
info	現在読み込まれているモジュールに関する情報を表示します。
objMask	指定したパターンに一致する既定のモジュールに関連付けられているすべてのオブジェクト ファイルを一覧表示します。 Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	指定したパターンに一致する既定のモジュールに関連付けられているすべてのソース ファイルを一覧表示します。 Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enummod	読み込まれたすべてのモジュールを列挙します。 DBH がターゲットなしで実行されていない限り、少なくとも 1 つのモジュールが常に存在します。その場合は何もありません。

次の表に、シンボルを表示および検索するコマンドの一覧を示します。

Command	Effect
enumModule!Symbol	指定したモジュールとシンボルに一致するすべてのシンボルを列挙します。 Module specifies the module to search (without the file name extension). Symbol specifies a pattern that the symbol must contain. Both Module and Symbol may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enumaddrAddress	指定したアドレスに関連付けられているすべてのシンボルを列挙します。
addrAddress	指定したアドレスに関連付けられているシンボルに関する詳細情報を表示します。
name [Module!]Symbol	指定したシンボルに関する詳細情報を表示します。 An optional Module specifier may be included. Wildcards should not be used, because if multiple symbols match the pattern, name only displays the first of them.
next [Module!]Symbol nextAddress	指定したシンボルまたはアドレスの後の次のシンボルに関する詳細情報を表示します。 If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	指定したシンボルまたはアドレスの前の最初のシンボルに関する詳細情報を表示します。 If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	指定したソース行に関連付けられているバイナリ命令の 16 進数アドレスと、この行に関連付けられているすべてのシンボルを表示します。 また、現在の行番号を指定した行番号と同じ値に設定します。 File specifies the name of the source file, and LineNum specifies the line number within that file; these should be separated with a number sign ( # ).
srclinesFile LineNum	指定したソース行に関連付けられているオブジェクト ファイルと、この行に関連付けられているバイナリ命令の 16 進アドレスを表示します。 現在の行番号は変更されません。 File specifies the name of the source file, and LineNum specifies the line number within that file; these should be separated with a space.
laddrAddress	指定したアドレスにあるシンボルに対応するソース ファイルと行番号を表示します。
linenext	現在の行番号をインクリメントし、新しい行番号に関する情報を表示します。
lineprev	現在の行番号をデクリメントし、新しい行番号に関する情報を表示します。
localsFunction [Mask]	指定した関数に含まれるすべてのローカル変数を表示します。 If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	指定したデータ型に関する詳細情報を表示します。 TypeName specifies the name of the data type (for example, WSTRING). この値と一致する型名がない場合は、一致するシンボルが表示されます。 Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	指定したソース マスクとオブジェクト マスクに一致するすべてのソース行を列挙します。 Source specifies the name of the source file, including the absolute path and file name extension. Obj specifies the name of the object file, including the relative path and file name extension. Both Source and Obj may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details. パラメーターを省略した場合、これはアスタリスク () ワイルドカードの使用と同じです。 パス情報を指定しない場合は、ワイルドカード パスを示すために、ファイル名の先頭に </strong> を付けます。
indexValue	指定したインデックス値を持つシンボルに関する詳細情報を表示します。
scopeAddress scope [Module!]Symbol	指定したシンボルの親に関する詳細情報を表示します。 シンボルは、アドレスまたは名前で指定できます。
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	指定したマスクに一致するすべてのシンボルを検索します。 Symbol specifies the symbol name. モジュール名を含めてはいけませんが、ワイルドカード文字と指定子を含めることができます。詳細については、「 文字列ワイルドカード構文 」を参照してください。 Index specifies the hexadecimal address of a symbol to be used as the parent for the search. Tag specifies the hexadecimal symbol type classifier (SymTagXxx) value that must match the symbol. Address specifies the address of the symbol. If globals is included, only global symbols will be displayed.
uwAddress	指定したアドレスにある関数のアンワインド情報を表示します。
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	すべてのデータ型を列挙します。
dump	ターゲット ファイル内のすべてのシンボル情報の完全な一覧を表示します。

次の表に、シンボル サーバーとシンボル ストアに関連するコマンドを示します。

Command	Effect
home [Path]	既定のダウンストリーム ストアに SymSrv と SrcSrv によって使用されるホーム ディレクトリを設定します。 If the symbol path contains a reference to a symbol server that uses a default downstream store, then the sym subdirectory of the home directory will be used for the downstream store. With no parameter, home displays the current home directory.
srvpathPath	指定したパスがシンボル ストアのパスであるかどうかをテストします。
srvindFile	指定したファイルに対応するシンボル サーバーインデックスを検索します。 シンボル サーバー インデックスは、実際にシンボル ストアに追加されているかどうかに関係なく、ファイルの内容に基づく一意の値です。 File should specify the file name and absolute path of the desired file.
fiiFile	指定したバイナリ ファイルとそれに関連付けられているファイルのシンボル サーバー インデックスを表示します。
getfileFile Index	指定した名前とシンボル サーバーインデックスを持つファイルを表示します。 File specifies the name of the desired file; this should not include its path. Index specifies the symbol server index of the desired file. DBH uses the SymFindFileInPath routine to search the tree under the current symbol path for a file with this name and this index.
supPath File1 File2	パラメーターの値に基づいて、シンボル ストアにファイルを格納します。 Path specifies the directory path of the symbol store. File1 and File2 are used to create a delta value, which is in turn used to determine the file being stored.
storeaddFile Store	指定したファイルを指定したシンボル ストアに追加します。 Store should be the root path of the symbol store.

次の表に、実数記号と虚数記号に適用される DBH コマンドを示します。

Command	Effect
undecName	指定したシンボル名にアタッチされている装飾の意味を表示します。 Name can be any string; it need not correspond to a currently loaded symbol. If Name contains C++ decorations, the meaning of these decorations is displayed.
addName Address Size	DBH に読み込まれたシンボルの一覧に、指定した虚数記号を追加します。 Name specifies the name of the symbol to be added, Address specifies its hexadecimal address, and Size its hexadecimal size in bytes. This is treated like any other symbol in later DBH commands, until the DBH session is ended with quit or unload, or until the imaginary symbol is deleted with del. The actual target symbol file is not altered.
delName delAddress	Deletes an imaginary symbol previously added with the add command. シンボルは、名前またはアドレスで指定できます。 これを使用して実際のシンボルを削除することはできません。