Intel® oneAPI DPC++/C++ Compiler Developer Guide and Reference

ID 767253
Date 9/08/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Alphabetical Option List

The following table lists all the current compiler options in alphabetical order.

ansi

Enables language compatibility with the gcc option ansi.

arch

Tells the compiler which features it may target, including which instruction sets it may generate.

ax, Qax

Tells the compiler to generate multiple, feature-specific auto-dispatch code paths for Intel® processors if there is a performance benefit.

B

Specifies a directory that can be used to find include files, libraries, and executables.

Bdynamic

Enables dynamic linking of libraries at run time.

Bstatic

Enables static linking of a user's library.

Bsymbolic

Binds references to all global symbols in a program to the definitions within a user's shared library.

Bsymbolic-functions

Binds references to all global function symbols in a program to the definitions within a user's shared library.

C

Places comments in preprocessed source output.

c

Prevents linking.

D

Defines a macro name that can be associated with an optional value.

dD, QdD

Same as option -dM, but outputs #define directives in preprocessed source.

debug (Linux*)

Enables or disables generation of debugging information.

debug (Windows*)

Enables or disables generation of debugging information.

device-math-lib

Enables or disables certain device libraries. This is a deprecated option that may be removed in a future release.

dM, QdM

Tells the compiler to output macro definitions in effect after preprocessing.

dryrun

Specifies that driver tool commands should be shown but not executed.

dumpmachine

Displays the target machine and operating system configuration.

dumpversion

Displays the version number of the compiler.

dynamic-linker

Specifies a dynamic linker other than the default.

E

Causes the preprocessor to send output to stdout.

EH

Specifies the model of exception handling to be performed.

EP

Causes the preprocessor to send output to stdout, omitting #line directives.

F (Windows*)

Specifies the stack reserve amount for the program.

Fa

Specifies that an assembly listing file should be generated.

fasm-blocks

Enables the use of blocks and entire functions of assembly code within a C or C++ file.

fast

Maximizes speed across the entire program.

fasynchronous-unwind-tables

Determines whether unwind information is precise at an instruction boundary or at a call boundary.

fbuiltin, Oi

Enables or disables inline expansion of intrinsic functions.

fcommon

Determines whether the compiler treats common symbols as global definitions.

fdata-sections, Gw

Places each data item in its own COMDAT section.

FD

Generates file dependencies related to the Microsoft* C/C++ compiler.

Fe

Specifies the name for a built program or dynamic-link library.

fexceptions

Enables exception handling table generation.

ffp-contract

Controls when the compiler is permitted to form fused floating-point operations, such as fused multiply-add (FMA). Fused operations are allowed to produce more precise results than performing the individual operations separately.

ffreestanding , Qfreestanding

Ensures that compilation takes place in a freestanding environment.

ffunction-sections, Gy

Places each function in its own COMDAT section.

fgnu89-inline

Tells the compiler to use C89 semantics for inline functions when in C99 mode.

fimf-absolute-error, Qimf-absolute-error

Defines the maximum allowable absolute error for math library function results.

fimf-accuracy-bits, Qimf-accuracy-bits

Defines the relative error for math library function results, including division and square root.

fimf-arch-consistency, Qimf-arch-consistency

Ensures that the math library functions produce consistent results across different microarchitectural implementations of the same architecture.

fimf-domain-exclusion, Qimf-domain-exclusion

Indicates the input arguments domain on which math functions must provide correct results.

fimf-force-dynamic-target, Qimf-force-dynamic-target

Instructs the compiler to use run-time dispatch in calls to math functions.

fimf-max-error, Qimf-max-error

Defines the maximum allowable relative error for math library function results, including division and square root.

fimf-precision, Qimf-precision

Lets you specify a level of accuracy (precision) that the compiler should use when determining which math library functions to use.

fimf-use-svml, Qimf-use-svml

Instructs the compiler to use the Short Vector Math Library (SVML) rather than the Intel® oneAPI DPC++/C++ Compiler Math Library (LIBM) to implement math library functions.

finline

Tells the compiler to inline functions declared with __inline and perform C++ inlining .

finline-functions

Enables function inlining for single file compilation.

fintelfpga

Lets you perform ahead-of-time (AOT) compilation for the Field Programmable Gate Array (FPGA).

fiopenmp, Qiopenmp

Enables recognition of OpenMP* features, such as parallel, simd, and offloading directives. This is an alternate option for compiler option [Q or q]openmp.

FI

Tells the preprocessor to include a specified file name as the header file.

fixed

Causes the linker to create a program that can be loaded only at its preferred base address.

fjump-tables

Determines whether jump tables are generated for switch statements.

fkeep-static-consts , Qkeep-static-consts

Tells the compiler to preserve allocation of variables that are not referenced in the source.

flto

Enables whole program link time optimization (LTO).

Fm

Tells the linker to generate a link map file. This is a deprecated option that may be removed in a future release.

fma, Qfma

Determines whether the compiler generates fused multiply-add (FMA) instructions if such instructions exist on the target processor.

fmath-errno

Tells the compiler that errno can be reliably tested after calls to standard math library functions.

fno-gnu-keywords

Tells the compiler to not recognize typeof as a keyword.

fno-operator-names

Disables support for the operator names specified in the standard.

fno-rtti

Disables support for run-time type information (RTTI).

fno-sycl-libspirv

Disables the check for libspirv (the SPIR-V* tools library).

Fo

Specifies the name for an object file.

foffload-static-lib

Tells the compiler to link with a fat (multi-architecture) static library. This is a deprecated option that may be removed in a future release.

fomit-frame-pointer

Determines whether EBP is used as a general-purpose register in optimizations.

fopenmp

Option -fopenmp is a deprecated option that will be removed in a future release.

fopenmp-declare-target-scalar-defaultmap, Qopenmp-declare-target-scalar-defaultmap

Determines which implicit data-mapping/sharing rules are applied for a scalar variable referenced in a target pragma.

fopenmp-device-lib

Enables or disables certain device libraries for an OpenMP* target.

fopenmp-target-buffers, Qopenmp-target-buffers

Enables a way to overcome the problem where some OpenMP* offload SPIR-V* devices produce incorrect code when a target object is larger than 4GB.

fopenmp-targets, Qopenmp-targets

Enables offloading to a specified GPU target if OpenMP* features have been enabled.

foptimize-sibling-calls

Determines whether the compiler optimizes tail recursive calls.

Fp

Lets you specify an alternate path or file name for precompiled header files.

fpack-struct

Specifies that structure members should be packed together.

fpermissive

Tells the compiler to allow for non-conformant code.

fpic

Determines whether the compiler generates position-independent code.

fpie

Tells the compiler to generate position-independent code. The generated code can only be linked into executables.

fp-model, fp

Controls the semantics of floating-point calculations.

fp-speculation, Qfp-speculation

Tells the compiler the mode in which to speculate on floating-point operations.

fshort-enums

Tells the compiler to allocate as many bytes as needed for enumerated types.

fstack-protector

Enables or disables stack overflow security checks for certain (or all) routines.

fstack-security-check

Determines whether the compiler generates code that detects some buffer overruns.

fsycl

Enables a program to be compiled as a SYCL* program rather than as plain C++11 program.

fsycl-add-targets

Lets you add arbitrary device binary images to the fat SYCL* binary when linking. This is a deprecated option that may be removed in a future release.

fsycl-dead-args-optimization

Enables elimination of SYCL dead kernel arguments.

fsycl-device-code-split

Specifies a SYCL* device code module assembly.

fsycl-device-lib

Enables or disables certain device libraries for a SYCL* target.

fsycl-device-only

Tells the compiler to generate a device-only binary.

fsycl-early-optimizations

Enables LLVM-related optimizations before SPIR-V* generation.

fsycl-enable-function-pointers

Enables function pointers and support for virtual functions for SYCL kernels and device functions. This is an experimental feature.

fsycl-esimd-force-stateless-mem

Determines whether the compiler enforces stateless memory accesses within ESIMD kernels on the target device. This is an experimental feature.

fsycl-explicit-simd

Enables or disables the experimental "Explicit SIMD" SYCL* extension. This is a deprecated option that may be removed in a future release.

fsycl-force-target

Forces the compiler to use the specified target triple device when extracting device code from any given objects on the command line.

fsycl-help

Causes help information to be emitted from the device compiler backend.

fsycl-host-compiler

Tells the compiler to use the specified compiler for the host compilation of the overall offloading compilation that is performed.

fsycl-host-compiler-options

Passes options to the compiler specified by option fsycl-host-compiler.

fsycl-id-queries-fit-in-int

Tells the compiler to assume that SYCL ID queries fit within MAX_INT.

fsycl-instrument-device-code

Enables or disables linking of the Instrumentation and Tracing Technology (ITT) device libraries for VTune™.

fsycl-link

Tells the compiler to perform a partial link of device binaries to be used with Field Programmable Gate Array (FPGA).

fsycl-link-huge-device-code

Tells the compiler to place device code later in the linked binary. This is to prevent 32-bit PC-relative relocations between surrounding Executable and Linkable Format (ELF) sections when the device code is larger than 2GB.

fsycl-link-targets

Tells the compiler to link only device code. This is a deprecated option that may be removed in a future release.

fsycl-max-parallel-link-jobs

Tells the compiler that it can simultaneously spawn up to the specified number of processes to perform actions required to link SYCL applications. This is an experimental feature.

fsycl-targets

Tells the compiler to generate code for specified device targets.

fsycl-unnamed-lambda

Enables unnamed SYCL* lambda kernels.

fsycl-use-bitcode

Tells the compiler to produce device code in LLVM Intermediate Representation (IR) bitcode format into fat objects.

fsyntax-only

Tells the compiler to check only for correct syntax.

ftrapuv , Qtrapuv

Initializes stack local variables to an unusual value to aid error detection.

funsigned-char

Change default char type to unsigned.

fuse-ld

Tells the compiler to use a different linker instead of the default linker, which is ld on Linux and link on Windows.

fvec-peel-loops, Qvec-peel-loops

Enables peel loop vectorization.

fvec-remainder-loops, Qvec-remainder-loops

Enables remainder loop vectorization.

fvec-with-mask, Qvec-with-mask

Enables vectorization for short trip-count loops with masking.

fverbose-asm

Produces an assembly listing with compiler comments, including options and version information.

fvisibility

Specifies the default visibility for global symbols or the visibility for symbols in declarations, functions, or variables.

fzero-initialized-in-bss, Qzero-initialized-in-bss

Determines whether the compiler places in the DATA section any variables explicitly initialized with zeros.

g

Tells the compiler to generate a level of debugging information in the object file.

GA

Enables faster access to certain thread-local storage (TLS) variables.

gcc-toolchain

Lets you specify the location of the base toolchain.

Gd

Makes __cdecl the default calling convention.

gdwarf

Lets you specify a DWARF Version format when generating debug information.

GF

Enables read-only string-pooling optimization.

GR

Enables or disables C++ Run Time Type Information (RTTI).

grecord-gcc-switches

Causes the command line options that were used to invoke the compiler to be appended to the DW_AT_producer attribute in DWARF debugging information.

GS

Determines whether the compiler generates code that detects some buffer overruns.

Gs

Lets you control the threshold at which the stack checking routine is called or not called.

gsplit-dwarf

Creates a separate object file containing DWARF debug information.

guard

Enables the control flow protection mechanism.

Gv

Tells the compiler to use the vector calling convention (__vectorcall) when passing vector type arguments.

H, QH

Tells the compiler to display the include file order and continue compilation.

help

Displays a list of supported compiler options in alphabetical order.

I

Specifies an additional directory to search for include files.

I-

Splits the include path.

idirafter

Adds a directory to the second include file search path.

imacros

Allows a header to be specified that is included in front of the other headers in the translation unit.

ipo, Qipo

Enables interprocedural optimization between files.

ipp-link, Qipp-link

Controls whether the compiler links to static or dynamic threaded Intel® Integrated Performance Primitives (Intel® IPP) run-time libraries.

iprefix

Lets you indicate the prefix for referencing directories that contain header files.

iquote

Adds a directory to the front of the include file search path for files included with quotes but not brackets.

isystem

Specifies a directory to add to the start of the system include path.

iwithprefix

Appends a directory to the prefix passed in by -iprefix and puts it on the include search path at the end of the include directories.

iwithprefixbefore

Similar to -iwithprefix except the include directory is placed in the same place as -I command-line include directories.

J

Sets the default character type to unsigned.

Kc++, TP

Tells the compiler to process all source or unrecognized file types as C++ source files. This is a deprecated option that may be removed in a future release.

l

Tells the linker to search for a specified library when linking.

L

Tells the linker to search for libraries in a specified directory before searching the standard directories.

LD

Specifies that a program should be linked as a dynamic-link (DLL) library.

link

Passes user-specified options directly to the linker at compile time.

m

Tells the compiler which features it may target, including which instruction set architecture (ISA) it may generate.

M, QM

Tells the compiler to generate makefile dependency lines for each source file.

m64 , Qm64

Tells the compiler to generate code for a specific architecture. Option m32 (and Qm32) is deprecated and will be removed in a future release.

m80387

Specifies whether the compiler can use x87 instructions.

march

Tells the compiler to generate code for processors that support certain features.

masm

Tells the compiler to generate the assembler output file using a selected dialect.

mbranches-within-32B-boundaries, Qbranches-within-32B-boundaries

Tells the compiler to align branches and fused branches on 32-byte boundaries for better performance.

mcmodel

Tells the compiler to use a specific memory model to generate code and store data.

MD

Tells the linker to search for unresolved references in a multithreaded, dynamic-link run-time library.

MD, QMD

Preprocess and compile, generating output file containing dependency information ending with extension .d.

MF, QMF

Tells the compiler to generate makefile dependency information in a file.

MG, QMG

Tells the compiler to generate makefile dependency lines for each source file.

mintrinsic-promote, Qintrinsic-promote

Enables functions containing calls to intrinsics that require a specific CPU feature to have their target architecture automatically promoted to allow the required feature.

MM, QMM

Tells the compiler to generate makefile dependency lines for each source file.

MMD, QMMD

Tells the compiler to generate an output file containing dependency information.

momit-leaf-frame-pointer

Determines whether the frame pointer is omitted or kept in leaf functions.

MQ

Changes the default target rule for dependency generation.

MT

Tells the linker to search for unresolved references in a multithreaded, static run-time library.

MT, QMT

Changes the default target rule for dependency generation.

mtune, tune

Performs optimizations for specific processors but does not cause extended instruction sets to be used (unlike -march).

nodefaultlibs

Prevents the compiler from using standard libraries when linking.

no-intel-lib, Qno-intel-lib

Disables linking to specified Intel® libraries, or to all Intel® libraries.

no-libgcc

Prevents the linking of certain gcc-specific libraries.

nolib-inline

Disables inline expansion of standard library or intrinsic functions.

nolibsycl

Disables linking of the SYCL* runtime library.

nologo

Tells the compiler to not display compiler version information.

nostartfiles

Prevents the compiler from using standard startup files when linking.

nostdinc++

Do not search for header files in the standard directories for C++, but search the other standard directories.

nostdlib

Prevents the compiler from using standard libraries and startup files when linking.

O

Specifies the code optimization for applications.

o

Specifies the name for an output file.

Od

Disables all optimizations.

Ofast

Sets certain aggressive options to improve the speed of your application.

Os

Enables optimizations that do not increase code size; it produces smaller code size than O2.

Ot

Enables all speed optimizations.

Ox

Enables maximum optimizations.

P

Tells the compiler to stop the compilation process and write the results to a file.

pc, Qpc

Enables control of floating-point significand precision.

pie

Determines whether the compiler generates position-independent code that will be linked into an executable.

pragma-optimization-level

Specifies which interpretation of the optimization_level pragma should be used if no prefix is specified.

pthread

Tells the compiler to use pthreads library for multithreading support.

qactypes, Qactypes

Tells the compiler to include the Algorithmic C (AC) data type folder for header searches and link to the AC data types libraries for Field Programmable Gate Array (FPGA) and CPU compilations.

qdaal, Qdaal

Tells the compiler to link to certain libraries in the Intel® oneAPI Data Analytics Library ( oneDAL ).

qipp, Qipp

Tells the compiler to link to some or all of the Intel® Integrated Performance Primitives (Intel® IPP) libraries.

Qlong-double

Changes the default size of the long double data type.

qmkl, Qmkl

Tells the compiler to link to certain libraries in the Intel® oneAPI Math Kernel Library ( oneMKL ) . On Windows systems, you must specify this option at compile time.

qmkl-ilp64, Qmkl-ilp64

Tells the compiler to link to the ILP64-specific version of the Intel® oneAPI Math Kernel Library ( oneMKL ) . On Windows systems, you must specify this option at compile time.

qopenmp, Qopenmp

Enables recognition of OpenMP* features and tells the parallelizer to generate multi-threaded code based on OpenMP* directives.

qopenmp-lib, Qopenmp-lib

Lets you specify an OpenMP* run-time library to use for linking.

qopenmp-link

Controls whether the compiler links to static or dynamic OpenMP* run-time libraries.

qopenmp-simd, Qopenmp-simd

Enables or disables OpenMP* SIMD compilation.

qopenmp-stubs, Qopenmp-stubs

Enables compilation of OpenMP* programs in sequential mode.

Qoption

Passes options to a specified tool.

qopt-assume-no-loop-carried-dep, Qopt-assume-no-loop-carried-dep

Lets you set a level of performance tuning for loops.

qopt-dynamic-align, Qopt-dynamic-align

Enables or disables dynamic data alignment optimizations.

qopt-for-throughput, Qopt-for-throughput

Determines how the compiler optimizes for throughput depending on whether the program is to run in single-job or multi-job mode.

qopt-multiple-gather-scatter-by-shuffles, Qopt-multiple-gather-scatter-by-shuffles

Enables or disables the optimization for multiple adjacent gather/scatter type vector memory references.

qopt-report, Qopt-report

Enables the generation of a YAML file that includes optimization transformation information.

qopt-report-file, Qopt-report-file

Specifies whether the output for the generated optimization report goes to a file, stderr, or stdout.

qopt-streaming-stores, Qopt-streaming-stores

Enables generation of streaming stores for optimization.

qtbb, Qtbb

Tells the compiler to link to the Intel® oneAPI Threading Building Blocks ( oneTBB ) libraries.

regcall, Qregcall

Tells the compiler that the __regcall calling convention should be used for functions that do not directly specify a calling convention.

reuse-exe

Tells the compiler to speed up Field Programmable Gate Array (FPGA) target compile time by reusing a previously compiled FPGA hardware image.

RTC

Enables checking for certain run-time conditions.

S

Causes the compiler to compile to an assembly file only and not link.

save-temps , Qsave-temps

Tells the compiler to save intermediate files created during compilation.

shared

Tells the compiler to produce a dynamic shared object instead of an executable.

shared-intel

Causes Intel-provided libraries to be linked in dynamically.

shared-libgcc

Links the GNU libgcc library dynamically.

showIncludes

Tells the compiler to display a list of the include files.

sox, Qsox

Tells the compiler to save the compilation options in the executable file.

static

Prevents linking with shared libraries.

static-intel

Causes Intel-provided libraries to be linked in statically.

static-libgcc

Links the GNU libgcc library statically.

static-libstdc++

Links the GNU libstdc++ library statically.

std, Qstd

Tells the compiler to conform to a specific language standard.

strict-ansi

Tells the compiler to implement strict ANSI conformance dialect.

sysroot

Specifies the root directory where headers and libraries are located.

T

Tells the linker to read link commands from a file.

Tc

Tells the compiler to process a file as a C source file.

TC

Tells the compiler to process all source or unrecognized file types as C source files.

Tp

Tells the compiler to process a file as a C++ source file.

U

Undefines any definition currently in effect for the specified macro .

u (Linux*)

Tells the compiler the specified symbol is undefined.

undef

Disables all predefined macros .

unroll , Qunroll

Tells the compiler the maximum number of times to unroll loops.

use-intel-optimized-headers, Quse-intel-optimized-headers

Determines whether the performance headers directory is added to the include path search list.

use-msasm

Enables the use of blocks and entire functions of assembly code within a C or C++ file.

v

Specifies that driver tool commands should be displayed and executed.

vd

Enables or suppresses hidden vtordisp members in C++ objects.

vec, Qvec

Enables or disables vectorization.

vec-threshold, Qvec-threshold

Sets a threshold for the vectorization of loops.

version

Tells the compiler to display GCC-style version information.

vmg

Selects the general representation that the compiler uses for pointers to members.

vmv

Enables pointers to members of any inheritance type.

w

Disables all warning messages.

w, W

Specifies the level of diagnostic messages to be generated by the compiler.

Wa

Passes options to the assembler for processing.

Wabi

Determines whether a warning is issued if generated code is not C++ ABI compliant.

Wall

Enables warning and error diagnostics.

watch

Tells the compiler to display certain information to the console output window.

Wcheck-unicode-security

Determines whether the compiler performs source code checking for Unicode vulnerabilities.

Wcomment

Determines whether a warning is issued when /* appears in the middle of a /* */ comment.

Wdeprecated

Determines whether warnings are issued for deprecated C++ headers.

Weffc++, Qeffc++

Enables warnings based on certain C++ programming guidelines.

Werror, WX

Changes all warnings to errors.

Werror-all

Causes all warnings and currently enabled remarks to be reported as errors.

Wextra-tokens

Determines whether warnings are issued about extra tokens at the end of preprocessor directives.

Wformat

Determines whether argument checking is enabled for calls to printf, scanf, and so forth.

Wformat-security

Determines whether the compiler issues a warning when the use of format functions may cause security problems.

Wl

Passes options to the linker for processing.

Wmain

Determines whether a warning is issued if the return type of main is not expected.

Wmissing-declarations

Determines whether warnings are issued for global functions and variables without prior declaration.

Wmissing-prototypes

Determines whether warnings are issued for missing prototypes.

Wno-sycl-strict

Disables warnings that enforce strict SYCL* language compatibility.

Wp

Passes options to the preprocessor.

Wpointer-arith

Determines whether warnings are issued for questionable pointer arithmetic.

Wreorder

Tells the compiler to issue a warning when the order of member initializers does not match the order in which they must be executed.

Wreturn-type

Determines whether warnings are issued when a function is declared without a return type, when the definition of a function returning void contains a return statement with an expression, or when the closing brace of a function returning non-void is reached.

Wshadow

Determines whether a warning is issued when a variable declaration hides a previous declaration.

Wsign-compare

Determines whether warnings are issued when a comparison between signed and unsigned values could produce an incorrect result when the signed value is converted to unsigned.

Wstrict-aliasing

Determines whether warnings are issued for code that might violate the optimizer's strict aliasing rules.

Wstrict-prototypes

Determines whether warnings are issued for functions declared or defined without specified argument types.

Wtrigraphs

Determines whether warnings are issued if any trigraphs are encountered that might change the meaning of the program.

Wuninitialized

Determines whether a warning is issued if a variable is used before being initialized.

Wunknown-pragmas

Determines whether a warning is issued if an unknown #pragma directive is used.

Wunused-function

Determines whether a warning is issued if a declared function is not used.

Wunused-variable

Determines whether a warning is issued if a local or non-constant static variable is unused after being declared.

Wwrite-strings

Issues a diagnostic message if const char * is converted to (non-const) char *.

X

Removes standard directories from the include file search path.

x (type option)

All source files found subsequent to -x type will be recognized as a particular type.

x, Qx

Tells the compiler which processor features it may target, including which instruction sets and optimizations it may generate.

xHost, QxHost

Tells the compiler to generate instructions for the highest instruction set available on the compilation host processor.

Xlinker

Passes a linker option directly to the linker.

Xopenmp-target

Enables options to be passed to the specified tool in the device compilation tool chain for the target.

Xs

Passes options to the backend tool.

Xsycl-target

Enables options to be passed to the specified tool in the device compilation tool chain for the target.

Y-

Tells the compiler to ignore all other precompiled header files.

Yc

Tells the compiler to create a precompiled header file.

Yu

Tells the compiler to use a precompiled header file.

Zc

Lets you specify ANSI C standard conformance for certain language features.

Zg

Tells the compiler to generate function prototypes. This is a deprecated option that may be removed in a future release.

Zi, Z7 , ZI

Tells the compiler to generate full debugging information in either an object (.obj) file or a project database (PDB) file.

Zl

Causes library names to be omitted from the object file.

Zp

Specifies alignment for structures on byte boundaries.

Zs

Tells the compiler to check only for correct syntax.