tcollect-filter、Qtcollect-filter

 

指定された関数のインストルメンテーションを有効/無効にします。

IDE オプション

なし

アーキテクチャー

IA-32、インテル® 64、IA-64 アーキテクチャー

構文

Linux:

-tcollect-filter file

Mac OS X:

なし

Windows:

/Qtcollect-filter:file

引数

file

各行に 1 つのフィルターをリストする設定ファイルです。各フィルターは通常の文字列式とスイッチからなります。スペースが前後に入る文字列は、引用符で囲む必要があります。その他の文字列については、引用符は必要ありません。スイッチの値は、ON、on、OFF、off です。

デフォルト

オフ

関数はインストルメントされません。ただし、-tcollect (Linux) または /Qtcollect (Windows) オプションが指定されると、フィルター設定は ".* ON" で、すべての関数がインストルメントされます。

説明

このオプションは、指定された関数のインストルメンテーションを有効/無効にします。

インストルメンテーション時に、ファイル中の正規表現と対応する関数名が確認されます。このスイッチは、対応する関数をインストルメントするかどうかを指定します。フィルターが複数ある場合は、先頭から順に評価され、後に行くほど優先度が高くなります。

対応する関数名は次のような書式になります。

-opt-report (Linux) または /Qopt-report (Windows) オプションを使用すると、コンパイラーがコンパイル単位で認識するファイルと関数名の完全なリストを取得できます。このリストを設定ファイルでフィルターするベースとして使用できます。

このオプションを使用するには、インテル® トレース・コレクターがインストールされ、セットアップ・スクリプトを使用して設定されている必要があります。セットアップ・スクリプトは、インテル® トレース・アナライザーおよびインテル® トレースコレクターのコンポーネントです。

詳細は、『Intel® Trace Collector User Guide』(英語) を参照してください。

代替オプション

なし

設定ファイルに次のフィルターがあるとします。

'.*' OFF '.*vector.*' ON

上記の例は、関数名に 'vector' が含まれる関数のみをインストルメントします。その他の関数はインストルメントされません。このフィルターの順序を逆にすると、すべての関数がインストルメントされないことに注意してください。

正規表現フィルターに対応するファイルまたはルーチン文字列のリストを取得するには、tcollect 情報を使用して最適化レポートを生成してください。次に例を示します。

Windows: icl /Qtcollect /Qopt-report /Qopt-report-phase tcollect

Linux: icc -tcollect -opt-report -opt-report-phase tcollect

関連情報