qoffload, 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 -q[no-]offload is the replacement option for -[no-]offload, which is deprecated.

Architecture Restrictions

Only available on Intel® 64 architecture targeting Intel® MIC Architecture

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 directive, 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 directives 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 directives are ignored:

Linux* systems: -qoffload=none or -qno-offload
Windows* systems: /offload:none or /Qoffload-

However, OpenMP* directives for coprocessor control (for example, !$OMP TARGET) are recognized if the [q or Q]openmp option is specified, regardless of whether or not OFFLOAD directives are recognized or ignored.

If keyword mandatory or optional appears for [Q]offload, then OFFLOAD directives 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 directive, it affects run-time behavior.

IDE Equivalent

Visual Studio: Code Generation > Offload Constructs

Eclipse: None

Xcode: None

Alternate Options