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:

  • 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* systems: -qoffload=none or -qno-offload

  • Windows* systems: /offload:none or /Qoffload-

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:

  • The mandatory or optional clauses are obeyed, regardless of the -qoffload (Linux*) or /Qoffload (Windows*) keyword

  • If no mandatory or optional clause is present, then the -qoffload (Linux*) or /Qoffload (Windows*) keyword is obeyed

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

Для получения подробной информации о возможностях оптимизации компилятора обратитесь к нашему Уведомлению об оптимизации.