インテル® C++ コンパイラー 19.0 デベロッパー・ガイドおよびリファレンス
同期データ転送を開始して完了します。signal 節と一緒に使用すると、非同期データ転送を開始します。このプラグマは、インテル® MIC アーキテクチャーにのみ適用されます。
#pragma offload_transfer clause[clause...] |
必須の指示節
offload-parameter
target ( target-name [ :target-number ] )
オプション指示節
if-clause
mandatory
optional
signal ( tag )
status ( statusvarname )
stream ( handle )
wait ( tag[, tag, ...])
必須の指示節
ホストとターゲット間でコピーされるプログラム変数とデータの量を制御します。clause (節) は次のいずれかです。
in |
ターゲット領域への入力に使用する変数。この値はターゲット領域が完了した後にターゲットからホストにコピーされません。 構文: in ( variable-ref [, variable-ref …] [ modifier[ , modifier… ] ] ) |
out |
ターゲット領域の出力に使用する変数。ホストはこの変数をターゲットにコピーしません。 構文: out ( variable-ref [, variable-ref …] [ modifier[ , modifier… ] ] ) |
nocopy |
以前のターゲットの実行から再利用される値、またはオフロードされたコードセクション内で使用される値を含む変数は、コピーを防ぐために nocopy 節にリストします。 構文: nocopy ( variable-ref [, variable-ref …] [ modifier[ , modifier… ] ] ) |
in または out 式 (後述の modifier の説明を参照) は、式が記述される文または節の前で評価されます。
宣言からサイズが分かる配列変数は全体でコピーされます。配列のサブセットを処理する場合、サブセットの開始要素へのポインターと element-count-expr を使用して配列のサブセットを転送します。
この引数の変数は次のとおりです。
variable-ref |
次のいずれかです。
|
||||||||||||||||||||
modifier |
次のいずれかです。
|
||||||||||||||||||||
target-name はターゲットを表します。インテル® Xeon Phi™ 製品の場合は mic を使用します。
target-number は signal 節と wait 節に必須です。target-number は整数式です。値は次のように解釈されます。
次の式に応じて、文を特定のターゲット上で実行します。
target = target-number % number_of_targets
例えば、4 つのターゲットを搭載したシステムの場合:
2 または 6 を指定すると、ランタイムシステムはターゲット 2 でコードを実行します (2 % 4 と 6 % 4 はどちらも 2 になるため)。
1000 を指定すると、ランタイムシステムはターゲット 0 でコードを実行します (1000 % 4 = 0 になるため)。
文をランタイムシステムによって選択されたターゲット上で実行します。
予約済み。
target-number は signal 節と wait 節に必須です。
ターゲットが利用できない場合、optional 節を一緒に指定しない限り、プログラムは実行に失敗してエラーメッセージを出力します。optional 節は、ターゲットが利用できないときに文をホストで実行します。
オプション指示節
ブール式。
式の評価結果 |
動作 |
---|---|
true |
文はターゲットで実行されます。 |
false |
文はホストで実行されます。if-clause と signal 節あるいは wait 節を一緒に使用した場合の動作は不定です。 |
この節を使用してオフロードを有効にするかどうかを制御します。関連するオフロード文がすべて有効または無効になるように、関連するプラグマでこの節を適切に使用してください。
ターゲットで実行する必要がある場合に指定します。ホストで実行することはできません。
ターゲット・ハードウェアが利用できない場合にプログラムの実行を継続するには、statusvarname 変数を初期化して、このプラグマで status ( statusvarname ) 節を指定します。後述の「説明」セクションでステータス変数の初期化方法と設定可能な値について説明します。
optional 節を指定しないと、この節を指定した場合と同じになります。この節を明示的に指定することで、暗黙のデフォルトを明確にすることができます。
ターゲットでの実行を要求しますが、必須ではありません。ターゲットが利用できない場合にホストで実行するように指定します。
ターゲットではなく、ホストで文が実行された理由を確認するには、statusvarname 変数を初期化して、このプラグマで status ( statusvarname ) 節を指定します。後述の「説明」セクションでステータス変数の初期化方法と設定可能な値について説明します。
mandatory 節はこの節の逆です。そのため、同じプラグマでこの節と一緒に使用しないでください。
非同期データ転送または計算処理のハンドルとなります。演算はオフロードで処理され、ホストでプラグマ以降のコードを実行中に out 節によりオフロードから結果が返されます。この節がない場合、オフロード全体と関連するデータ転送は同期して実行されます。ホストは、プラグマが完了するまでそれ以降のコードを実行しません。
tag は、ポインターのサイズ値をベースライン言語で表現したもので、非同期データ転送または計算処理のハンドルとして使用されます。
この節を使用する場合、target 節で 0 以上の target-number を指定します。
オフロード構造の実行状態を特定します。statusvarname 変数には、実行状態を示す値が含まれます。後述の「説明」セクションでステータス変数の初期化方法と設定可能な値について説明します。
optional 節と一緒に使用し、ターゲットが利用できない場合、ターゲットで実行される文は代わりにホストで実行されます。
mandatory 節と一緒に使用し、ターゲットが利用できない場合、ターゲットで実行される文は無視され、プログラムは実行を継続します。文が無視されたり、ホストで実行された理由を確認するには、この変数の値を調べます。
handle で指定した stream へオフロードします。handle は、ストリームを作成するインテル® MIC アーキテクチャー・ベースのデバイスを指定する _Offload_create_stream 関数から取得されます。オフロードは、ストリームが作成されたデバイスに対して実行されます。詳細は、「ストリームを使用したオフロード」を参照します。
開始した非同期データ転送または非同期計算を待つ場合に指定します。
tag は、ポインターのサイズ値をベースライン言語で表現したものです。signal 節と同じ表現の値が使用され、開始した非同期処理のハンドルとして使用されます。ここで言う非同期処理は、非同期データ転送または非同期計算です。
この節を使用する場合、target 節で 0 以上の target-number を指定します。
シグナルが開始される前にシグナルを照会すると、未定義の動作を引き起こし、アプリケーションはランタイムアボートします。例えば、target:1 で開始されたシグナルを target:0 で照会すると、シグナルは target:1 で開始されているため、target:0 に関連付けられたシグナルはなく、アプリケーションはランタイムアボートします。
このプラグマは、非同期データ転送を開始し、同期データ転送を開始して完了します。
プラグマに続く文は、ターゲットが利用可能な場合、ターゲットで実行されます。ターゲットが利用できない場合、optional、mandatory、および status (statusvarname ) 節により文の実行方法が決定されます。
指定する節 |
動作 |
---|---|
optional |
文はホストで実行されます。 |
optional および status (statusvarname ) |
文はホストで実行され、statusvarname にターゲットを利用できない理由が格納されます。 |
mandatory |
文は無視され、プログラムは終了します。 |
mandatory および status (statusvarname ) |
文は無視され、プログラムは実行を継続します。statusvarname にターゲットを利用できない理由が格納されます。 |
statusvarname ステータス変数を初期化するには、OFFLOAD_STATUS_INIT(statusvarname) マクロを使用します。ステータス変数の値は offload.h で定義されています。設定可能な値は次のとおりです。
値 |
説明 |
---|---|
OFFLOAD_SUCCESS = 0 |
文はターゲットで実行されました。 |
OFFLOAD_DISABLED |
文はターゲットで実行されませんでした。if-clause を指定し、その値が false の場合、文はホストで実行されました。 |
OFFLOAD_UNAVAILABLE |
ターゲットが利用できないため、文はターゲットで実行されませんでした。 |
OFFLOAD_OUT_OF_MEMORY |
offload-parameter 用のメモリーが不足していたため、文はターゲットで実行されませんでした。 |
OFFLOAD_PROCESS_DIED |
ターゲットでランタイムエラーが発生し、ターゲットのプロセスが終了したため、文はターゲットで実行されませんでした。 |
OFFLOAD_ERROR |
エラーが発生したため、文はターゲットで実行されませんでした。 |
2 つの異なるプラグマを使用してターゲットとホストからデータを非同期に受け取る例 |
---|
|
offload_target プラグマはデータ転送を開始し、offload_transfer プラグマはデータ転送が完了するのを待機します。
オフロードの入力をダブルバッファーにする例 |
---|
|
ターゲットでアライメントを指定するポインター配列の例 |
---|
|
ポインター配列と部分配列を使用する alloc_if と free_if の例 |
---|
|
into、into_extent、alloc_extent を使用するポインター配列の例 |
---|
|