Quantcast
Channel: Intel® C++-Compiler
Viewing all articles
Browse latest Browse all 1665

qoffload, Qoffload

$
0
0

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. Options /Qoffload- and /Qoffload:none are also available for Intel® Graphics Technology. Option -q[no-]offload is the replacement option for -[no-]offload, which is deprecated.

Architecture Restrictions

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, on IA-32 architecture targeting Intel® Graphics Technology, or on Intel® 64 architecture targeting Intel® Graphics Technology

Syntax

Linux OS:

-qoffload[=keyword]

-qno-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 -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.

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 -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* OS: -qoffload=none or -qno-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 keywordmandatory 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

Windows: Code Generation [Intel C++] > Offload Constructs

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

OS X: None

Alternate Options

None

Englisch

Viewing all articles
Browse latest Browse all 1665

Trending Articles



<script src="https://jsc.adskeeper.com/r/s/rssing.com.1596347.js" async> </script>