インテル® C++ コンパイラー XE 13.1 ユーザー・リファレンス・ガイド

offload-option

指定したターゲットとツールで使用されるオプションを明示的に指定できます。このオプションは、インテル® MIC アーキテクチャーにのみ適用されます。

IDE オプション

Windows*: なし

Linux*: [Compiler (コンパイラー)] > [Command Line (コマンドライン)] > [Additional Options for MIC Offload Compiler (MIC オフロード・コンパイラー用追加オプション)] (tool compiler)

[Archiver Command Line (アーカイバー・コマンドライン)] > [Additional Options for MIC Offload Archiver (MIC オフロード・アーカイバー用追加オプション)] (tool ar)

OS X*: なし

アーキテクチャー

インテル® MIC アーキテクチャー向けのインテル® 64 アーキテクチャー

構文

Linux*:

-offload-option,target,tool,"option-list"

OS X*:

なし

Windows*:

なし

引数

target

ターゲット・アーキテクチャー。利用可能な値は mic のみです。

tool

オプションリストと関連するツール。次のいずれかの値を使用できます: ldas、または compiler

option-list

ツール固有の 1 つまたは複数のオプション。リスト全体を引用符 (") で囲み、option-list 中の各オプションはスペースで区切る必要があります。

tool の値が compiler の場合はコンパイラー固有のオプションを、ld の場合はリンカー固有のオプションを、そして as の場合はアセンブラー固有のオプションを使用します。

デフォルト

オフ

コンパイラーは、ターゲット・アーキテクチャー上の個別のツールに対して追加のオプションを渡しません。

説明

このオプションを使用して、指定したターゲットとツールで使用されるオプションを明示的に指定できます。このオプションは、コマンドラインで複数回指定することができます。

ヘテロジニアス・アプリケーションをビルドする場合、ドライバーはホストコンパイルにはコマンドラインで指定されたすべてのオプションを渡し、オフロードコンパイルには特定のオプションのみ渡します。オフロードコンパイルに渡されるオプションのリストを確認するには、–watch=mic-cmd オプションを指定します。

オフロードコンパイルに追加のオプションを渡す場合やオフロードコンパイルに渡されるオプションをオーバーライドする場合は、-offload-option オプションを使用して追加のオプションまたはオーバーライドするオプションを指定する必要があります。

-offload-option オプションと一緒に ILD、または U オプションを指定すると、ホストからオフロードコンパイルへ自動で渡される ILD、および U オプションよりも優先されます。

確実にオーバーライドするため、-offload-option オプションと一緒に指定する ILD、および U オプションは、ホストコンパイルから自動でコピーされる ILD、および U オプションよりも前に配置してください。-offload-option と一緒に指定するその他のすべてのオプションは、ホストからオフロードコンパイルにコピーされるオプションの後に配置します。

代替オプション

なし

次に、tool 値が compiler の場合の例を示します。

-offload-option,mic,compiler, "-O3 -diag-disable 1234 –vec-report2"

次に、tool 値が ld の場合の例を示します。

-offload-option,mic,ld,"-lmylib -L/my/path"

次に、tool 値が as の場合の例を示します。

-offload-option,mic,as,"<assembler options>"

次の例で、オフロードコンパイルは最初に -I/my_dir/mic/include を検索し、前出の -I/my_dir/include-DMY_DEFINE=10 をオーバーライドする-DMY_DEFINE=20 を使用します。また、コンパイラーは -L/my_dir/mic/lib -L/my_dir/lib をオフロードのリンクステップに渡します。

icc -offload-option,mic,compiler, "-I/my_dir/include -L/my_dir/lib -DMY_DEFINE=10 -I/my_dir/mic/include -DMY_DEFINE=20" -offload-option,mic,ld, "-L/my_dir/mic/lib" hello.c

次の例は、-offload-option で指定したオプションにより、ホストコンパイルからオフロードコンパイルへ自動で渡されるオプションをオーバーライドする方法を示します。

-offload-option,mic,compiler,”-O3 -DMY_DEFINE=MIC” -DMY_DEFINE=HOST -O2

ホストコンパイルでは -DMY_DEFINE=HOST -O2 が使用されますが、オフロードコンパイルでは -DMY_DEFINE=MIC -O3-O2-DMY_DEFINE=HOST をオーバーライドします。

関連情報


このヘルプトピックについてのフィードバックを送信