CPU の関数を呼び出してコプロセッサーの実行環境を変更する

このトピックは、インテル® メニー・インテグレーテッド・コア (インテル® MIC) アーキテクチャーにのみ適用されます。

一部の CPU API には同等のオフロード API があります。オフロードバージョンでは、ターゲットの型とターゲット番号の 2 つの引数を指定します。引数の定義を次に示します。

target_type

target_type はスタティックです。次の事前に定義されたデフォルトの 1 つを使用することを推奨します。

DEFAULT_TARGET_TYPE

target_number

ターゲットの特定のコプロセッサー。

値が次のように解釈される式。

-1

コプロセッサーでの実行を指定します。ランタイムシステムは特定のコプロセッサーを選択します。CPU で実行することはできません。オフロードプログラムの実行に必要な正しいターゲット・ハードウェアがシステムで利用できない場合、プログラムは実行に失敗してエラーメッセージを出力します。

>=0

0 以上の値は、特定のコプロセッサーでの実行を指定します。特定のコプロセッサーは次のように指定します。

coprocessor=target-number % number_of_coprocs

オフロードプログラムの実行に必要な正しいターゲット・ハードウェアがシステムで利用できない場合、プログラムは実行に失敗してエラーメッセージを出力します。

<-1

この値は予約されています。

例えば、4 つのコプロセッサーを搭載したシステムの場合:

2 または 6 を指定すると、ランタイムシステムはコプロセッサー 2 でコードを実行します (2 % 4 と 6 % 4 はどちらも 2 になるため)。
1000 を指定すると、ランタイムシステムはコプロセッサー 0 でコードを実行します (1000 % 4 = 0 になるため)。

次の offload.h ヘッダーファイルは、コプロセッサーの環境に影響する、CPU から可能な関数呼び出しをすべて定義します。

このトピックでは、例として CPU API omp_set_num_threads およびそのオフロードバージョンを使用します。

例

CPU API
void omp_set_num_threads (int num_threads);

オフロード API
void omp_set_num_threads_target (TARGET_TYPE target_type, int target_number, int num_threads);

#include "offload.h"
#include "omp.h"

int main()
{
        int value, result;

        value = 66;
        omp_set_num_threads_target(TARGET_MIC, 0, value);
        #pragma offload target(mic) out(result)
        #pragma omp parallel
        #pragma omp master
        result = omp_get_num_threads();

        printf("Number of threads on target %d\n", result);
        if (result != value) {
          printf("failed1 result=%d, value=%d\n", result, value);
          return 1;
        }
        return 0;
}

CPU の関数を呼び出してコプロセッサーの実行環境を変更する

例

関連情報