ソース コード パス

  • [アーティクル]

ソース パスは、C および C++ ソース ファイルが配置されているディレクトリを指定します。

実行可能ファイルがビルドされたコンピューターでユーザー モード プロセスをデバッグしていて、ソース ファイルがまだ元の場所にある場合、デバッガーはソース ファイルを自動的に見つけることができます。

その他のほとんどの状況では、ソース パスを設定するか、個々のソース ファイルを読み込む必要があります。

デバッガーを使用してリモート デバッグを実行する場合、デバッグ サーバーはソース パスを使用します。 デバッガーとして WinDbg を使用している場合は、各デバッグ クライアントにも独自 のローカル ソース パスがあります。 すべてのソース関連コマンドは、ローカル コンピューター上のソース ファイルにアクセスします。 ソース コマンドを使用する任意のクライアントまたはサーバーで、適切なパスを設定する必要があります。

この複数パス システムを使用すると、デバッグ クライアントは、ソース ファイルを他のクライアントやサーバーと実際に共有することなく、ソース関連のコマンドを使用することもできます。 このシステムは、ユーザーの 1 人がアクセスできるプライベートまたは機密のソース ファイルがある場合に便利です。

ソース パスに関係なく、いつでもソース ファイルを読み込むこともできます。

ソース パスの構文

デバッガーのソース パスは、セミコロンで区切られた複数のディレクトリ パスで構成される文字列です。

相対パスがサポートされています。 ただし、常に同じディレクトリからデバッガーを起動する場合を除き、各パスの前にドライブ文字またはネットワーク共有を追加する必要があります。 ネットワーク共有もサポートされています。

注: 企業ネットワークに接続している場合、ソース ファイルにアクセスする最も効率的な方法は、ソース サーバーを使用することです。 ソース パス内の srv\* 文字列を使用して、ソース サーバーを使用できます。 ソース サーバーの詳細については、「ソース サーバーの使用」を参照してください。

ソース パスの制御

ソース パスとローカル ソース パスを制御するには、次のいずれかの操作を行います。

  • デバッガーを起動する前に、_NT_SOURCE_PATH 環境変数を使用してソース パスを設定します。 この環境変数を使用して無効なディレクトリを追加しようとすると、デバッガーはこのディレクトリを無視します。

  • デバッガーを起動するときに、-srcpath コマンドライン オプションを使用してソース パスを設定します。

  • .srcpath (ソースパスの設定) コマンドを使用して、ソース パスを表示、設定、変更、または追加します。 ソース サーバーを使用している場合は、.srcfix (ソース サーバーの使用) が少し簡単です。

  • (WinDbg のみ) .lsrcpath (ローカル ソース パス) コマンドを使用して、ローカル ソース パスの表示、設定、変更、または追加を行います。 ソース サーバーを使用している場合は、.lsrcfix (ローカル ソース サーバーの使用) が少し簡単です。 パラメーター -lscrpath で WinDbg コマンドラインを使用することもできます。 詳細については、「WinDbg のコマンドライン オプション」を参照してください。

  • (WinDbg のみ) [File | Source File Path コマンドを使用するか、CTRL + P キーを押して、ソース パスまたはローカル ソース パスを表示、設定、変更、または追加します。

次のいずれかの操作を行って、ソース ファイルを直接開いたり閉じたりすることもできます。

  • ソース ファイルを開いたり閉じたりするには、 lsf (ソース ファイルの読み込みまたはアンロード) コマンドを使用します。

  • (WinDbg のみ) .open (ソース ファイルを開く) コマンドを使用して、ソース ファイルを開きます。

  • (WinDbg のみ) file | open source file コマンドを使用するか、ctrl + o キーを押して、ソース ファイルを開きます。 ツール バーの オープンソース ファイル (ctrl + o) ボタンを使用することもできます。

    メモ: File | Open Source File (またはそれに相当するショートカット メニューやボタン) を使用してソース ファイルを開くと、そのファイルのパスがソース パスに自動的に追加されます。

  • (WinDbg のみ) File | Recent Files コマンドを使用して、WinDbg で最近開いた 4 つのソース ファイルのいずれかを開きます。

  • (WinDbg のみ) File | Close Current Window コマンドまたは [ソース] ウィンドウの隅にある [閉じる] ボタンを選択して、ソース ファイルを閉じます。

関連項目

ソース ファイルの使用方法の詳細については、「ソース モードでのデバッグ」を参照してください。