CDB でのシンボルと実行可能イメージ パスの設定
シンボル パス
シンボルパスは、シンボルファイルが置かれているディレクトリを指定します。 シンボルとシンボル ファイルの詳細については、シンボルに関する記事を参照してください。
注 インターネットや企業ネットワークに接続している場合、シンボルにアクセスする最も効 率的な方法はシンボルサーバーを使用することです。 シンボルパスの中で srv* または symsrv* 文字列を使用することで、シンボルサーバーを使用することができます。 シンボル・サーバーの詳細については、Windows デバッガーのシンボル・パスを参照してください。
CDB のシンボル・パスを制御するには、以下のいずれかを実行します：
.sympath（Set Symbol Path）コマンドを入力します。 シンボル・サーバーを使用している場合、.symfix (Set Symbol Store Path) コマンドは .sympath と似ていますが、入力の手間が省けます。
デバッガーを起動するときは、-y コマンドラインオプションを使用します。 CDBコマンドラインオプションを参照してください。
デバッガーを起動する前に、_NT_SYMBOL_PATH および _NT_ALT_SYMBOL_PATH 環境変数を使用してパスを設定します。 シンボル・パスは、_NT_ALT_SYMBOL_PATH の後に _NT_SYMBOL_PATH を追加して作成します。 (通常、パスは_NT_SYMBOL_PATHを通して設定される。しかし、共有シンボル・ファイルのプライベート・バージョンを持っている場合など、特別な場合には_NT_ALT_SYMBOL_PATHを使用してこれらの設定を上書きするとよいでしょう)。
注-sins コマンド行オプションを使用すると、デバッガーはシンボル・パス環境変数を 無視します。
実行イメージ・パス
実行可能ファイルは、プロセッサが実行できるバイナリ・ファイルです。 これらのファイルには通常、.exe、.dll、または .sys というファイル名の拡張子があります。 実行可能ファイルはモジュールとも呼ばれ、特に実行可能ファイルがより大きなアプリケーションのユニットとして記述されている場合によく使われます。 Windowsオペレーティングシステムは、実行可能ファイルを実行する前に、それをメモリにロードします。 メモリ上の実行可能ファイルのコピーは、実行可能イ メージまたはイメージと呼ばれる。
注 これらの用語は、時に不正確に使われることがある。 例えば、ディスク上の実際のファイルに対して「イメージ」を使う文書もあるかもしれません。 また、WindowsカーネルとHALには特別なモジュール名があります。 例えば、ntモジュールはNtoskrnl.exeファイルに対応します。
実行イメージパスは、バイナリの実行ファイルがあるディレクトリを指定します。
ほとんどの場合、デバッガーは、このファイルのパスを設定する必要はありませんので、実行可能ファイルの場所を認識します。
ただし、このパスが必要な場合があります。 たとえば、カーネルモードの小さいメモリダンプファイルには、停止エラー(つまり、クラッシュ)の時点でメモリ内に存在する実行可能ファイルのすべてが含まれていません。 同様に、ユーザーモードのミニダンプファイルには、アプリケーションバイナリは含まれません。 実行可能ファイルのパスを設定すると、デバッガーはこれらのバイナリファイルを見つけることができます。
デバッガーの実行イメージ・パスは、セミコロンで区切られた複数のディレクトリ・パスからなる文字列です。 相対パスがサポートされています。 ただし、常に同じディレクトリからデバッガーを起動する場合を除き、各パスの前にドライブ文字またはネットワーク共有を追加する必要があります。 ネットワーク共有もサポートされています。 デバッガは実行イメージパスを再帰的に検索します。 つまり、デバッガはこのパスにリストされている各ディレクトリのサブディレクトリを検索します。
CDBで実行イメージのパスを制御するには、次のいずれかを実行します：
.exepath（Set Executable Path）コマンドを入力します。
デバッガーを起動するときに、-i コマンドライン・オプションを使用します。 CDBコマンドラインオプションを参照してください。
デバッガーを起動する前に、_NT_EXECUTABLE_IMAGE_PATH 環境変数を使用してパスを設定します。
注-sins コマンドライン・オプションを使用すると、デバッガーは実行可能イメー ジ・パス環境変数を無視します。