Linux* ターゲット上のパフォーマンス解析向けのコンパイラー・オプション

インテル® VTune™ プロファイラーは、Linux* ターゲットシステム上で大部分のネイティブバイナリーを解析できます。次の設定は、パフォーマンス解析をより生産的および簡単に行うために推奨されます。

使用するオプション

説明

-g (強く推奨)

アドレスとソースコード行を関連付けて、ユーザーモードのサンプリングとトレース収集タイプ (ホットスポットとスレッド化) で呼び出しスタックを適切に追跡するには、シンボル情報の生成を有効にする必要があります。

リリースビルド、または -O2 (強く推奨)

コンパイラーの最適化機能を最大限に有効にして、コンパイラーが最適化できないパフォーマンス上の問題をインテル® VTune™ プロファイラーで特定します。

-shared-intel (インテル® C++ コンパイラー)

-shared-libgcc (gcc* コンパイラー)

適切なフィルターモードをインテル® VTune™ プロファイラーの収集結果に適用したときに、libm と C ランタイム呼び出しをシステム関数として識別し、ユーザーコードと区別できるようにします。

-debug inline-debug-info
(インテル® C++ コンパイラー)

インテル® VTune™ プロファイラーがインライン展開された関数を特定し、選択されたインラインモードに応じて、インライン展開された関数のシンボルをインライン展開された関数自身または呼び出し元に関連付けることを可能にします。これは、GCC* 4.1 以降ではデフォルトのモードです。

最適化 (-O2 以降) とデバッグ情報 (-g オプション) を使用してコンパイルする場合、インテル® oneAPI DPC++/C++ コンパイラーの debug inline-debug-info オプションはデフォルトで有効になります。

-D TBB_USE_THREADING_TOOLS

インテル® VTune™ プロファイラーによるインテル® oneAPI スレッディング・ビルディング・ブロック (インテル® oneTBB) 解析を有効にします。このマクロは、-D_DEBUG または -DTBB_USE_DEBUG を指定してコンパイルすると自動的に設定されます。

TBB_USE_THREADING_TOOLS を設定しないと、インテル® VTune™ プロファイラーはインテル® oneTBB 構文に関連する並行性の問題を正しく識別できません。

-qopenmp (強く推奨)
(インテル® C++ コンパイラー)

インテル® VTune™ プロファイラーで OpenMP* プラグマによる並列領域を識別します。

-qopenmp-link dynamic
(インテル® C++ コンパイラー)

インテル® コンパイラーがインテル® VTune™ プロファイラー向けにインストルメントされた OpenMP* ランタイム・ライブラリーのダイナミック・バージョンを選択できるようにします。通常、このオプションはインテル® コンパイラーではデフォルトで有効になります。

-parallel-source-info=2
(インテル® C++ コンパイラー)

OpenMP* または自動並列化コードの生成時にソースの位置情報の出力を有効/無効にします。2 はソース位置の出力レベルを示し、パス、ファイル、ルーチン名、および行情報を出力するようにコンパイラーに指示します。

--info-for-profiling
インテル® oneAPI DPC++ コンパイラー
インテル® Fortran コンパイラー

SYCL* アプリケーションの GPU 解析向けのデバッグ情報の生成を有効にします。

インテル® Fortran コンパイラーによってコンパイルされた OpenMP* オフロード・アプリケーションのデバッグ情報を生成します。

-Xsprofile

インテル® oneAPI DPC++ コンパイラー

FPGA アプリケーション解析向けにパフォーマンス・データのソースレベルのマッピングを有効にします。

避けるべきオプション

次のコンパイラー・オプションは推奨されません。

使用しないオプション

理由

デバッグビルドまたは -O0

アプリケーションのパフォーマンスに影響するオプションを使用すると、「リリース」ビルドとしてコンパイルしたときにパフォーマンス上問題にならないコード領域に対して解析や最適化を行う可能性があり、パフォーマンス・プロファイルに大きな影響を与える可能性があります。

-static

-static-libgcc

インテル® VTune™ プロファイラーが、ユーザーモード・サンプリングとトレース解析タイプを実行するのを妨げます。詳細は、以下を参照してください。

インテル® コンパイラーで -fast オプションを指定すると、自動的に -static が有効になります。

-static-intel

ユーザーモード・サンプリングとトレース解析タイプがシステム関数を区別できなくなります。インテル® コンパイラーではデフォルトのオプションです。

-qopenmp-link static

インテル® コンパイラーの静的バージョンの OpenMP* ランタイム・ライブラリーを選択します。このバージョンの OpenMP* ランタイム・ライブラリーは、インテル® VTune™ プロファイラーの解析で必要なインストルメント・データを含みません。

-qopenmp_stubs

OpenMP* コードが並列化されないようにします。

-msse4a-m3dnow

インテル® プロセッサーがサポートしない命令を使用するバイナリーを生成し、インテル® VTune™ プロファイラーのプロファイルが予測できない振る舞いをする可能性があります。

-debug [parallel | extended | emit-column | expr-source-pos | semantic-stepping | variable-locations]

インテル® VTune™ プロファイラーに最適なオプションは -debug full (-g を使用する場合のデフォルトモード) です。その他のオプション parallelextendedemit-columnexpr-source-possemantic-steppingおよびvariable-locations は、インテル® VTune™ プロファイラー でサポートされません。詳細は、-debug inline-debug-info を参照してください。

-coarray

Co-Array Fortran でスケーリングを制限するロックをスレッド化解析が正しく識別するのを妨げます。

ユーザーモード・サンプリングとトレース解析向けのコンパイル

実行コードとすべての共有ライブラリーのユーザーモード・サンプリングとトレース解析 (ホットスポットとスレッド化) を成功させるには、次のオプションを使用してコールスタックを適切に監視できるようにします。

ユーザーモード・サンプリングとトレース解析タイプは、次の動的バージョンのライブラリーで上手く動作します。

ライブラリー

動的バージョン (推奨)

静的バージョン (非推奨)

OpenMP* ランタイム (インテル® コンパイラーが提供)

libiomp5.so または libguide40.so

libiomp5.a または libguide4.a

POSIX* スレッド

libpthread.so

libpthread.a

C ランタイム

libc.so

libc.a

C++ ランタイム

libstdc++.so

libstdc++.a

インテルの Libm

libm.so

libm.a

ユーザーモード・サンプリングとトレース解析は、静的にリンクされたライブラリー/関数では次のような制限があります。

アプリケーションが (明示的に、または OpenMP* ライブラリーやほかのスタティック・ライブラリーを介して) POSIX* スレッドを生成する場合、次の関数を定義する必要があります

これらを容易に行う方法は、上記のオプションを含むファイルを作成して、gcc または ld を指定してコンパイルすることです。次に例を示します。

gcc -static mysource.cpp @Cdefs @Pdefs

ここで、Cdefs は 必要な C 関数のオプションを含むファイルで、Pdefs は必要な POSIX* 関数 のオプションを含むファイルです。

製品とパフォーマンス情報

性能は、使用状況、構成、その他の要因によって異なります。詳細については、http://www.intel.com/PerformanceIndex/ (英語) を参照してください。

改訂 #20201201

関連情報