シンボル パス
シンボル パスは、シンボル ファイルが配置されているディレクトリを指定します。 シンボルとシンボル ファイルの詳細については、シンボルを参照してください。
#B0 注 #C1 インターネットまたは企業ネットワークに接続している場合、シンボルにアクセスする最も効率的な方法はシンボル サーバーを使用することです。 シンボル パス内で srv* または symsrv* 文字列を使用することで、シンボル サーバーを使用できます。 シンボル サーバーへのアクセスの詳細については、「Windows デバッガーのシンボル パス」を参照してください。
WinDbg のシンボル パスを制御するには、次のいずれかの操作を行います。
[ファイル] メニューから [シンボル ファイル パス] を選択するか、Ctrl キーを押しながら S キーを押します。
.sympath (シンボル パスの設定) コマンドを使用します。 シンボルサーバーを使用する場合、.symfix (シンボルストアパスの設定) コマンドは .sympath に似ていますが、入力を減らすことができます。
デバッガーを起動するときは、-y コマンドラインオプションを使用します。 WinDbg Command-Line オプションを参照してください。
デバッガーを開始する前に、環境変数の_NT_SYMBOL_PATHと_NT_ALT_SYMBOL_PATHを使用してパスを設定します。 シンボル パスは、_NT_ALT_SYMBOL_PATHの後に_NT_SYMBOL_PATHを追加することによって作成されます。 (通常、パスは_NT_SYMBOL_PATHによって設定されます。ただし、_NT_ALT_SYMBOL_PATHを使用して、共有シンボル ファイルのプライベート バージョンがある場合など、特別な場合にこれらの設定をオーバーライドすることができます)。これらの環境変数を使用して無効なディレクトリを追加しようとすると、デバッガーはこのディレクトリを無視します。
手記 -sins コマンド ライン オプションを使用すると、デバッガーはシンボル パス環境変数を無視します。 詳細については、「 WinDbg Command-Line オプション」を参照してください。
実行可能イメージのパス
実行可能ファイルは、プロセッサが実行できるバイナリ ファイルです。 通常、これらのファイルには、.exe、.dll、またはファイル名拡張子 .sys があります。 実行可能ファイルはモジュールとも呼ばれ、特に実行可能ファイルが大規模なアプリケーションの単位として記述されている場合に使用されます。 Windows オペレーティング システムは、実行可能ファイルを実行する前にメモリに読み込みます。 メモリ内の実行可能ファイルのコピーは、実行可能イメージまたはイメージと呼ばれます。
注意 これらの用語は不正確に使用されることがあります。 たとえば、一部のドキュメントでは、ディスク上の実際のファイルに "image" を使用することがあります。 また、Windows カーネルと HAL には特別なモジュール名があります。 たとえば、 nt モジュールは Ntoskrnl.exe ファイルに対応します。
実行可能イメージ パスは、バイナリ実行可能ファイルが配置されているディレクトリを指定します。
ほとんどの場合、デバッガーは実行可能ファイルの場所を認識するため、このファイルのパスを設定する必要はありません。
ただし、このパスが必要な場合があります。 たとえば、カーネル モード #B0 小さなメモリ ダンプ #C1 ファイルには、停止エラー (つまりクラッシュ) の時点でメモリ内に存在するすべての実行可能ファイルが含まれていません。 同様に、ユーザー モードのミニダンプ ファイルにはアプリケーション バイナリが含まれていません。 実行可能ファイルのパスを設定すると、デバッガーはこれらのバイナリ ファイルを見つけることができます。
デバッガーの実行可能イメージ パスは、セミコロンで区切られた複数のディレクトリ パスで構成される文字列です。 相対パスがサポートされています。 ただし、常に同じディレクトリからデバッガーを起動しない限り、各パスの前にドライブ文字またはネットワーク共有を追加する必要があります。 ネットワーク共有もサポートされています。 デバッガーは実行可能イメージ パスを再帰的に検索します。 つまり、デバッガーは、このパスに一覧表示されている各ディレクトリのサブディレクトリを検索します。
WinDbg の実行可能イメージ パスを制御するには、次のいずれかの操作を行います。
[ファイル] メニューから [イメージ ファイル パス] を選択するか、Ctrl キーを押しながら I キーを押します。
デバッガーを起動するときは、-i コマンドラインオプションを使用します。 WinDbg Command-Line オプションを参照してください。
デバッガーを開始する前に、環境変数 _NT_EXECUTABLE_IMAGE_PATH を使用してパスを設定します。
注意 -sins コマンドライン オプションを使用する場合は、デバッガーは、実行可能なイメージ パス環境変数を無視します。 詳細については、「 WinDbg Command-Line オプション」を参照してください。