Alphabetical Option List

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

Download PDF

ID 767253

Date 9/08/2022

Version

Public

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

Visible to Intel only — GUID: GUID-59331A36-D05E-4A4B-9122-986D9341361A

View Details

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.

Parent topic: Compiler Options

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

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

Alphabetical Option List