カスタム共有オブジェクトをビルドするには、以下のコマンドを使用します。
make target [<オプション>]
以下の表は、target の設定可能な値と実行される内容を示しています。
値 |
コメント |
|---|---|
| libintel64 | ビルダーは、インテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) の静的インターフェイス、スレッド、およびコア・ライブラリーを使用して、インテル® 64 アーキテクチャー用のカスタム共有オブジェクトをビルドします。 |
| help | このコマンドはカスタム共有オブジェクト・ビルダーのヘルプを表示します。 |
<オプション> は、makefile で使用するマクロを定義するパラメーターのリストを表します。以下の表で、これらのパラメーターを説明します。
パラメーター [値] |
説明 |
|---|---|
| interface = {lp64|ilp64} | lp64 インターフェイスは 32 ビット整数タイプを使用し、 ilp64 インターフェイスは 64 ビット整数タイプを使用します。デフォルト値は lp64 です。 |
| threading = {parallel|sequential} | インテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) をマルチスレッド (parallel) モードとシーケンシャル (sequential) モードのどちらで使用するかを定義します。デフォルト値は parallel です。 |
| parallel = {intel|tbb|gnu} | インテルの OpenMP* (intel)、インテル® oneTBB (tbb)、または GNU* OpenMP* (gnu - GNU コンパイラーのみ) のいずれを使用するか指定します。デフォルト値は Intel です。 |
| cluster = {yes|no} | カスタム共有オブジェクトのビルドにインテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) クラスター・コンポーネント (BLACS、ScaLAPACK、CDFT) が必要かどうかを指定します。デフォルト値は no です。 |
| blacs_mpi = {intelmpi|openmpi} | 使用する事前コンパイル済みのインテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) BLACS ライブラリーを指定します。'cluster=no' の場合は無視されます。デフォルト値は intelmpi です。 |
| blacs_name = <ライブラリー名> | 使用するカスタムバージョンのインテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) BLACS ライブラリーの名前 (拡張子なし) を指定します。'cluster=no' の場合は無視されます。'blacs_name' が明示的に指定された場合、'blacs_mpi' は無視されます。デフォルト値は mkl_blacs_<blacs_mpi>_<interface> です。 |
| export = <ファイル名> | 共有オブジェクトに含めるエントリーポイント関数のリストを含むファイルの完全な名前を指定します。デフォルト名は、user_example_list (拡張子なし) です。 |
| name = <so 名> | 作成するライブラリーの名前を指定します。デフォルトでは、作成されるライブラリーの名前は mkl_custom.so です。 |
| xerbla = <エラーハンドラー> | ユーザーのエラーハンドラーを含むオブジェクト・ファイル <user_xerbla>.o の名前を指定します。Makefile は、このエラーハンドラーをライブラリーに追加します。デフォルトのインテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) エラーハンドラー xerbla の代わりに使用されます。このパラメーターを省略すると、標準インテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) エラーハンドラー xerbla が使用されます。独自のエラーハンドラーの作成方法は、『インテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) デベロッパー・リファレンス』の xerbla 関数の説明を参照してください。 |
| MKLROOT = <mkl ディレクトリー> | カスタム共有オブジェクトのビルドに使用されるインテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) の場所を指定します。デフォルトでは、ビルダーはインテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) のインストール・ディレクトリーを使用します。 |
上記のすべてのパラメーターはオプションです。
以下は、最も単純な場合の例です。
make libintel64
省略したオプションはデフォルト値になります。このコマンドは、mkl_custom.so ライブラリーを作成します。このコマンドは、user_example_list ファイルから関数のリストを取得し、ネイティブのインテル® oneAPI マス・カーネル・ライブラリー (インテル® oneMKL) エラーハンドラー xerbla を使用します。
以下は、より複雑な場合の例です。
make libintel64 export=my_func_list name=mkl_small xerbla=my_xerbla.o
この場合、コマンドは mkl_small.so ライブラリーを作成します。my_func_list ファイルから関数のリストが取得され、ユーザーのエラーハンドラー my_xerbla.o が使用されます。
製品および性能に関する情報 |
|---|
性能は、使用状況、構成、およびその他の要因によって異なります。詳細については、www.Intel.com/PerformanceIndex (英語) をご覧ください。 改訂 #20201201 |