検索ディレクトリーはサポートファイルを特定し、ソースコードに関連する解析情報を表示する際に使用されます。
状況によって、インテル® VTune™ プロファイラーは解析情報の表示に必要なユーザーファイルを検出できず、追加の検索場所を設定したり標準の検索場所を上書する必要があります。これは、プロジェクトのディレクトリー構造に関する情報が利用できない Visual Studio* で作成された Windows* の .exe プロジェクト、バイナリー/ソースを定義するサードパーティー・ライブラリーを持つ C++ プロジェクト、またはリモートで収集されたデータをインポートしたプロジェクトに必要です。リモートデータ収集を実行すると、インテル® VTune™ プロファイラーはデフォルトでターゲットシステムからホストにバイナリーファイルをコピーします。シンボルファイルとソースファイルをホストにコピーするか、これらのファイルを含むディレクトリーをマウントする必要があります。
インテル® VTune™ プロファイラーは、収集したデータをファイナライズする際に、特定の順番でディレクトリーを検索します。インテル® VTune™ プロファイラーが Visual Studio* IDE に統合されている場合、検索ディレクトリーは Visual Studio* C++ プロジェクトのプロパティーから引き継がれます。
モジュールを解決するため、インテル® VTune™ プロファイラーは以下のファイルを検出する必要があります。
バイナリー (実行可能形式とダイナミック・ライブラリー)
シンボル
ソースファイル
アプリケーションをビルドしてパフォーマンス・データを収集した後、移動されていない C/C++ プロジェクトのファイルを自動的に検索します。
検索ディレクトリーの設定
検索ディレクトリーを設定するには、次の操作を行います。
[解析の設定] ツールバーボタンをクリックします。[解析の設定] ウィンドウが開きます。
下部にある
[バイナリー/シンボル検索] ボタンをクリックして、対応するダイアログボックスを開き、ホスト上のファイル解決に必要なシンボル、バイナリー、およびソースファイルのパスを指定します。検索ディレクトリーのリストに新しい検索ディレクトリーを追加するには、[新たな検索場所を追加] 行をクリックしてアクティブなテキストボックスにディレクトリーのパスと名前を入力するか、右側の [参照] ボタンをクリックしてリストからディレクトリーを選択します。例えば、プロジェクトが最初に Linux* の /work/projects/my_project にあり、その後 /home/user/my_project_copy に移動された場合、バイナリー/シンボルおよびソースファイルの検索ディレクトリーを /home/user/my_project_copy に変更する必要があります。
注
検索は再帰的ではありません。必要なディレクトリーがすべて指定されていることを確認します。
検索ディレクトリーが適切に設定されておらず、モジュールが解決されていないと、次のように表示されます。
[サマリー] ウィンドウに、「ユーザーモジュールのシンボル情報が見つからないため、データは完全ではありません...」で始まるメッセージが表示されます。このメッセージには、検索ディレクトリーを指定して解析結果を再解決するショートカット・オプションが表示されます。
[ボトムアップ] または [トップダウン・ツリー] ペインで、モジュールには関数名などではなく [不明] が 1 行だけ表示されます。
行をダブルクリックして関連するソースコードを表示すると、ソースファイルを検出できないというウィンドウが表示され、ソースファイルの場所を確認します。
インテル® VTune™ プロファイラーがシステムモジュールのシンボルファイルを検出できない場合、[ボトムアップ/トップダウン・ツリー] ペインと [コールスタック] ペインに不完全なスタック情報が表示されることがあります。この場合、フィルターツールバーの [コールスタック・モード] オプションを使用して、システムレイヤーをユーザーコードに属性化する際に、[不明なフレーム] のホットスポットが表示されることがあります。Windows* ターゲットでこれを回避するには、Microsoft* シンボルサーバーを設定するか、_NT_SYMBOL_PATH 環境変数を設定します。Linux* ターゲットでは、Linux* カーネル解析を有効にします。