# qoffload

Lets you specify the mode for offloading or tell the compiler to ignore language constructs for offloading. This is a deprecated option. There is no replacement option.

## Syntax

Linux: | -qoffload[=keyword] -qno-offload

macOS: | None

Windows: | None

## 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 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 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 -qoffload=none or -qno-offload 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 -qoffload, then offload pragmas are processed and:

- The mandatory or optional clauses are obeyed, regardless of the -qoffload keyword specified.

- If no mandatory or optional clause is present, then the -qoffload keyword is obeyed.

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

## IDE Equivalent

Visual Studio: None

Eclipse: Language > Offload Constructs

Xcode: None

## Alternate Options

None

Parent topic: Offload Options (Linux* only)

## See Also

Supported Environment Variables