offload, Qoffload

Lets you specify the mode for offloading or tell the compiler to ignore language constructs for offloading. This option only applies to Intel® MIC Architecture. Option /Qoffload- and /Qoffload:none are also available for Intel® Graphics Technology.

Architecture Restrictions

[Q]offload keywords mandatory and optional: Only available on Intel® 64 architecture targeting Intel® MIC Architecture

/Qoffload- and /Qoffload:none: Only available on Intel® 64 architecture targeting Intel® MIC Architecture, and IA-32 architecture targeting Intel® Graphics Technology

Syntax

Linux OS:

-offload[=keyword]

-no-offload

OS X:

None

Windows OS:

/Qoffload[:keyword]

/Qoffload-

Arguments

keyword

Specifies the mode for offloading or it disables offloading. Possible values are:

none

Tells the compiler to ignore language constructs for offloading. Warnings are issued by the compiler. This is equivalent to the negative form of the option.

mandatory

Specifies that offloading is mandatory (required). If the target is not available, one of the following occurs:

If no status clause is specified for the offload pragma, the program fails with an error message.
If the STATUS clause is specified, the program continues execution on the CPU.

optional

Specifies that offloading is optional (requested). If the target is not available, the program is executed on the CPU, not the target.

Default

mandatory

The compiler recognizes language constructs for offloading if they are specified. If option [Q]offload is specified with no keyword, the default is mandatory.

Description

This option lets you specify the mode for offloading or tell the compiler to ignore language constructs for offloading.

On Intel® Graphics Technology, the only options you can specify are /Qoffload- or /Qoffload:none, which tells the compiler to ignore language constructs for offloading. By default, offloading is optional for Intel® Graphics Technology.

If no [Q]offload option appears on the command line, then offload pragmas are processed and:

The mandatory or optional clauses are obeyed if present
If no mandatory or optional clause is present, the offload is mandatory

If any of the following appears on the command line, then offload pragmas are ignored:

Linux* OS: -offload=none or -no-offload
Windows* OS: /offload:none or /Qoffload-

However, OpenMP* pragmas for coprocessor control (for example, omp target) are recognized if the [Q]openmp option is specified, regardless of whether or not offload pragmas are recognized or ignored.

If keyword mandatory or optional appears for [Q]offload, then offload pragmas are processed and:

The mandatory or optional clauses are obeyed, regardless of the [Q]offload keyword
If no mandatory or optional clause is present, then the [Q]offload keyword is obeyed

If the status clause is specified for an offload pragma, it affects run-time behavior.

IDE Equivalent

Windows: Code Generation > Offload Constructs (VS 2008)

Code Generation [Intel C++] > Offload Constructs (VS 2010/VS 2012)

Linux: Language > Generate Only CPU code (-no-offload)

OS X: None

Alternate Options

None