インテル® C++ コンパイラー 18.0 デベロッパー・ガイドおよびリファレンス

OpenMP* ライブラリーの使用

このセクションでは、コマンドラインで OpenMP* ライブラリーを設定して使用するのに必要なステップを説明します。Windows* システムでは、Microsoft* Visual Studio* 開発環境で OpenMP* ライブラリーを使用してコンパイルされたアプリケーションをビルドすることもできます。

インテル® コンパイラーで提供されているライブラリーのサポートについては、「OpenMP* のソース互換性とその他のコンパイラーとの互換性」を参照してください。

OpenMP* ライブラリーにより使用されるオプションとライブラリーのリストは、「OpenMP* のサポート・ライブラリー」を参照してください。

インテル® C++ コンパイラーへのアクセスを確立するために環境を設定し、リンクで適切な OpenMP* ライブラリーが利用できるようにします。Windows* システムでは、適切なバッチ (.bat) ファイルを実行するか、またはすでに環境設定されているコマンドライン・ウィンドウ (コンパイラーのプログラムメニューから起動可能) を使用します。Linux* および macOS* システムでは、適切なスクリプトファイルをソース (読み込み) します (compilervars ファイル)。

コンパイルで、コンパイル時に使用される omp.h のバージョンがそのコンパイラーにより提供されているバージョンであることを確認します。例えば、Linux* システムでコンパイルする場合は、gcc により提供される omp.h を使用します。

注意

gcc コンパイラーまたは Microsoft* コンパイラーの使用時は、不適切なヘッダー/モジュールファイルを誤って使用することがあるので注意してください。これを避けるには、別のディレクトリーにヘッダー/モジュールファイルをコピーし、-I オプションを使用して、正しい include パスを指定します。

プログラムでデータ構造やクラスが使用されており、それらが omp.h ファイルで定義されるデータ型を持つメンバーを含む場合、そのようなデータ構造を使用するソースファイルはすべて同じ omp.h ファイルでコンパイルする必要があります。

次の表は、C および C++ ソースファイルに使用するコンパイラーのコマンドをリストしています。

オペレーティング・システム

C ソースモジュール

C++ ソースモジュール

Linux*

gcc
インテル: icc

g++
インテル: icpc

macOS* [10.8 以前]

gcc
インテル: icc

g++
インテル: icpc

macOS* [v10.9 以降]

clang
インテル: icc

clang++
インテル: icpc

Windows*

Visual C++*: cl
インテル: icl

Visual C++*: cl
インテル: icl

インテル® C++ コンパイラーで使用される OpenMP* ライブラリーとオプションについての情報は、「OpenMP* サポート・ライブラリー」を参照してください。

コマンドラインの例 (Windows*)

互換ライブラリーを使用して、1 つのコマンドでアプリケーション全体をコンパイルおよびリンク (ビルド) するには、次のインテル® C++ コンパイラー・コマンドを指定します。

ファイルの種類

コマンド

C ソース、ダイナミック・リンク

icl /MD /Qopenmp hello.c

C++ ソース、ダイナミック・リンク

icl /MD /Qopenmp hello.cpp

Microsoft* Visual C++* コンパイラーを使用する場合は、インテルの OpenMP* 互換ライブラリーとリンクします。Microsoft* OpenMP* ランタイム・ライブラリー (vcomp) にリンクされないように、リンカーオプションを使用して (/link の後で)、インテルの OpenMP* 互換ライブラリー名を明示的に渡す必要があります。

ファイルの種類

コマンド

C ソース、ダイナミック・リンク

cl /MD /openmp hello.c /link /nodefaultlib:vcomp libiomp5md.lib

C++ ソース、ダイナミック・リンク

cl /MD /openmp hello.cpp /link /nodefaultlib:vcomp libiomp5md.lib

また、インテル® C++ コンパイラーと Visual C++* コンパイラーの両方を使用して、アプリケーションの一部をコンパイルし、オブジェクト・ファイルを作成することができます (オブジェクト・レベルの互換性)。この例では、インテル® C++ コンパイラーはアプリケーション全体をコンパイルしてリンクします。

ファイルの種類

コマンド

C ソース、ダイナミック・リンク

cl /MD /openmp /c f1.c f2.c

icl /MD /Qopenmp /c f3.c f4.c

icl /MD /Qopenmp f1.obj f2.obj f3.obj f4.obj /Feapp /link /nodefaultlib:vcomp

最初のコマンドは、Visual C++* コンパイラーでコンパイルされた 2 つのオブジェクト・ファイルを生成します。2 番目のコマンドはインテル® C++ コンパイラーによってコンパイルされたさらに 2 つのオブジェクト・ファイルを生成します。最後のコマンドは 4 つのオブジェクト・ファイルをアプリケーションにリンクします。

また、下記の 3 行目は、Visual C++* リンカーを使用してアプリケーションをリンクし、互換ライブラリーの libiomp5md.lib を 3 番目のコマンドの終わりに指定しています。

ファイルの種類

コマンド

C ソース、ダイナミック・リンク

cl /MD /openmp /c f1.c f2.c

icl /MD /Qopenmp /c f3.c f4.c

link f1.obj f2.obj f3.obj f4.obj /out:app.exe /nodefaultlib:vcomp libiomp5md.lib

次の例は、インテル® C++ コンパイラーで複数のファイルのプロシージャー間の最適化を使用し、Visual C++* コンパイラーで複数のファイルをコンパイルし、Visual C++* リンカーでオブジェクト・ファイルをリンクして、実行ファイルを作成する例を示しています。

ファイルの種類

コマンド

C ソース、ダイナミック・リンク

icl /MD /Qopenmp /O3 /Qipo /Qipo-c f1.c f2.c f3.c

cl /MD /openmp /O2 /c f4.c f5.c

cl /MD /openmp /O2 ipo_out.obj f4.obj f5.obj /Feapp /link /nodefaultlib:vcomp libiomp5md.lib

最初のコマンドは、インテル® C++ コンパイラーを使用して、デフォルトで、ipo_out.obj という名前の最適化された複数ファイル情報を持つ単一のオブジェクト・ファイルを生成します (/Fe オプションは必要ありません)。2 番目のコマンドは、Visual C++* コンパイラーを使用してさらに 2 つのオブジェクト・ファイルを生成します。3 番目のコマンドは、インテル® C++ コンパイラーの OpenMP* ライブラリーを使用して、Visual C++* の cl コマンドで 3 つすべてのオブジェクト・ファイルをリンクします。

Visual Studio* でのインテルの OpenMP* ライブラリーの使用

Windows* システムで、Visual Studio* の Visual C++* 開発環境を一部変更すると、インテル® C++ コンパイラーと Visual C++* を使用して、インテルの OpenMP* ライブラリーを使用するアプリケーションを作成することができます。

Microsoft* Visual C++* では、_OPENMP_NOFORCE_MANIFEST シンボルが定義されていなければなりません。定義されていない場合は、vcomp90 dll のマニフェストがインクルードされます。これにより、ビルドシステムでは問題ありませんが、この DLL がインストールされていない別のシステムにアプリケーションを移動すると問題が発生します。

プロジェクトの [プロパティ ページ] でインテルの OpenMP* ランタイム・ライブラリーの場所を示します。

  1. メインメニューでプロジェクトのプロパティー・ページを開きます ([プロジェクト] > [プロパティ] を選択するか、プロジェクト名を右クリックして [プロパティ] を選択します)。

  2. [構成プロパティ] > [Linker (リンカー)] > [General (全般)] > [Additional Library Directories (追加のライブラリー・ディレクトリー)] を選択します。

  3. インテル® コンパイラー・ライブラリーへのパスを入力します。例えば、IA-32 アーキテクチャー・システムの場合は、次のように入力します:

    <Intel_compiler_installation_path>\IA32\LIB

インテルの OpenMP* ダイナミック・ランタイム・ライブラリーを実行時にアクセス可能にするには、対応するパスを指定しなければなりません。

  1. メインメニューでプロジェクトのプロパティー・ページを開きます ([プロジェクト][プロパティ] を選択するか、プロジェクト名を右クリックして [プロパティ] を選択します)。

  2. [構成プロパティ] > [デバッグ] > [環境] を選択します。

  3. インテル® コンパイラー・ライブラリーへのパスを入力します。例えば、IA-32 アーキテクチャー・システムの場合は、次のように入力します:

    PATH=%PATH%;<Intel_compiler_installation_path>\IA32\Bin

インテルの OpenMP* ランタイム・ライブラリー名をリンカーオプションに追加し、デフォルトの Microsoft* の OpenMP* ランタイム・ライブラリーを除外します。

  1. メインメニューでプロジェクトのプロパティー・ページを開きます ([プロジェクト] > [プロパティ] を選択するか、プロジェクト名を右クリックして [プロパティ] を選択します)。

  2. [構成プロパティ] > [Linker (リンカー)] > [Command Line (コマンドライン)] > [Additional Options (追加のオプション)] を選択します。

  3. OpenMP* ライブラリー名と Visual C++* リンカーオプション /nodefaultlib を入力します。

コマンドラインの例 (Linux*)

Linux* 上でインテルの OpenMP* ライブラリーを使用して、1 つのコマンドでアプリケーション全体をコンパイルおよびリンク (ビルド) するには、次のインテル® C++ コンパイラー・コマンドを指定します。

ファイルの種類

コマンド

C ソース

icc -qopenmp hello.c

C++ ソース

icpc -qopenmp hello.cpp

デフォルトでは、インテル® C++ コンパイラーは OpenMP* ライブラリーのダイナミック・リンクを行います。スタティック・リンク (非推奨) を行うには、-qopenmp-link=static オプションを追加します。インテル® C++ コンパイラー・オプションの -qopenmp-link は、Linux* および macOS* システムでリンカーが使用する OpenMP* ライブラリー (スタティックまたはダイナミック) を制御します (デフォルトは -qopenmp-link=dynamic)。

また、インテル® C++ コンパイラー (icc/icpc) と gcc/g++ コンパイラーの両方を使用して、アプリケーションの一部をコンパイルし、オブジェクト・ファイルを作成することができます (オブジェクト・レベルの互換性)。

この例では、gcc コンパイラーは、C ファイルの foo.c (gcc オプション -fopenmp で OpenMP* サポートは有効) をコンパイルし、インテル® C++ コンパイラーは、インテルの OpenMP* ライブラリーを使用してアプリケーションをリンクしています。

ファイルの種類

コマンド

C ソース

gcc -fopenmp -c foo.c

C++ ソース

g++ -fopenmp -c foo.cpp

インテル® C++ コンパイラーの OpenMP* 互換ライブラリーを使用して、gcc または g++ コンパイラーでアプリケーションをリンクする場合は、-l オプションでインテルの OpenMP* ライブラリー名、-l オプションで Linux* pthread ライブラリー、-L オプションでインテル® C++ コンパイラーがインストールされている場所にあるインテルのライブラリーへのパスを明示的に渡す必要があります。

ファイルの種類

コマンド

C ソース

gcc -fopenmp -c foo.c bar.c

gcc foo.o bar.o -liomp5 -lpthread -L<icc_dir>/lib

オブジェクト・ファイルを混在させることもできますが、gcc-l オプション、-L オプション、-lpthread オプションを指定しなくても済むように、インテル® C++ コンパイラーでアプリケーションをリンクするほうが簡単です。

ファイルの種類

コマンド

C ソース

gcc -fopenmp -c foo.c

icc -qopenmp -c bar.c (Linux* および macOS*)

icc -qopenmp foo.o bar.o (Linux* および macOS*)

gcc コンパイラー、インテル® C++ コンパイラー、インテル® Fortran コンパイラーでコンパイルされた OpenMP* オブジェクト・ファイルを混在させることができます。

インテル® Fortran コンパイラーと gfortran コンパイラーでコンパイルされたオブジェクト・ファイルは混在させることはできません。

次の表は、インテル® Fortran コンパイラーを使用して、すべてのオブジェクトをリンクする例を示します。

ファイルの種類

コマンド

C ソースと Fortran ソースの混在

icc -qopenmp -c ibar.c

gcc -fopenmp -c gbar.c

ifort -qopenmp -c foo.f

ifort -qopenmp foo.o ibar.o gbar.o

ファイルの種類

コマンド

C ソースと GNU* Fortran ソースの混在

icc -qopenmp -c ibar.c

gcc -fopenmp -c gbar.c

gfortran -fopenmp -c foo.f

gfortran foo.o ibar.o gbar.o -lirc -liomp5 -lpthread -lc -L<icc_dir>/lib

また、インテル® C++ コンパイラーを使用してアプリケーションをリンクするこができますが、-l オプションを使用して、リンク行で複数の gfortran ライブラリーを渡す必要があります。

ファイルの種類

コマンド

C ソースと Fortran ソースの混在

gfortran -fopenmp -c foo.f

icc -qopenmp -c ibar.c

icc -qopenmp foo.o bar.o -lgfortranbegin -lgfortran

コマンドラインの例 (macOS*)

macOS* 上でインテルの OpenMP* ライブラリーを使用して、1 つのコマンドでアプリケーション全体をコンパイルおよびリンク (ビルド) するには、次のインテル® C++ コンパイラー・コマンドを指定します。

ファイルの種類

コマンド

C ソース

icc -qopenmp hello.c

C++ ソース

icpc -qopenmp hello.cpp

デフォルトでは、インテル® C++ コンパイラーは OpenMP* ライブラリーのダイナミック・リンクを行います。スタティック・リンク (非推奨) を行うには、-qopenmp-link=static オプションを追加します。インテル® C++ コンパイラー・オプションの -qopenmp-link は、Linux* および macOS* システムでリンカーが使用する OpenMP* ライブラリー (スタティックまたはダイナミック) を制御します (デフォルトは -qopenmp-link=dynamic)。

また、インテル® C++ コンパイラー (icc/icpc/icl) と gcc/g++ コンパイラーの両方を使用して、アプリケーションの一部をコンパイルし、オブジェクト・ファイルを作成することができます (オブジェクト・レベルの互換性)。

古いバージョンの macOS* プラットフォームでは、インテル® C++ コンパイラーと GCC コンパイラーを併用してコンパイルできます。最新の macOS* 10.x プラットフォームには、GCC コンパイラーの代わりに Clang コンパイラーが含まれていますが、このコンパイラーは OpenMP* 実装をサポートしていません。Clang コンパイラーの将来のバージョンでは OpenMP* 実装がサポートされる可能性があります。

この例では、icl/icc は C ファイルの foo.c をコンパイルし、icpc は C++ ファイルの ifoo.cpp をコンパイルします。Qopenmp (Windows*) または qopenmp (Linux* および macOS*) は OpenMP* サポートを有効にして、インテル® Fortran コンパイラーが、インテルの OpenMP* ライブラリーを使用してアプリケーションをリンクするようにします。

ファイルの種類

コマンド

C ソース

icc -qopenmp -c foo.c

C++ ソース

icpc -qopenmp -c ifoo.cpp

macOS* 10.9 以降 (Xcode* 5.x 以降) には GCC コンパイラーが含まれていません。ただし、インテル® C++ コンパイラーと一緒に GCC コンパイラーをインストールできます。

オブジェクト・ファイルを混在させることもできますが、gcc-l オプション、-L オプション、-lpthread オプションを指定しなくても済むように、インテル® コンパイラーでアプリケーションをリンクするほうが簡単です。

ファイルの種類

コマンド

C ソース

icc -qopenmp -c bar.c

icc -qopenmp foo.o bar.o

また、インテル® C++ コンパイラーを使用してアプリケーションをリンクするこができますが、-l オプションを使用して、リンク行で複数の gfortran ライブラリーを渡す必要があります。

ファイルの種類

コマンド

C ソースと Fortran ソースの混在

icc -qopenmp -c ibar.c

icc -qopenmp foo.o bar.o -lgfortranbegin -lgfortran

関連情報