Intel® C++ Compiler 19.0 Developer Guide and Reference

qoffload, Qoffload

Lets you specify the mode for offloading or tell the compiler to ignore language constructs for offloading. This option only applies when targeting Intel® Xeon Phi™ products. This is a deprecated option. There is no replacement option.

Architecture Restrictions

Keywords mandatory and optional: Only available when targeting Intel® Xeon Phi™ products

/Qoffload- and /Qoffload:none: Only available when targeting Intel® Xeon Phi™ products

Syntax

Linux:

-qoffload[=keyword]

-qno-offload

macOS:

None

Windows:

/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 -qoffload (Linux*) or /Qoffload (Windows*) 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.

Option -q[no-]offload is the replacement option for -[no-]offload, which is deprecated.

If no -qoffload (Linux*) or /Qoffload (Windows*) option appears on the command line, then offload pragmas are processed and:

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

However, OpenMP* pragmas for processor control (for example, omp target) are recognized if the [q or 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:

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

IDE Equivalent

Visual Studio: Code Generation [Intel C++] > Offload Constructs

Eclipse: Language > Offload Constructs

Xcode: None

Alternate Options

None

See Also