*** Evolution of Command Line options of different C++ compilers ***[ Abstract ]
Technical details on Evolution of Command Line options of different C++ compilers, more than 10, will be provided.
Icl v07.x.x 32-bit Options
Intel(R) C++ Compiler Help
==========================
usage: icl [options] file1 [file2 ...] [/link linker_options]
where options represents zero or more compiler options
fileN is a C/C++ source (.c .cc .cpp .cxx .i), assembly (.asm),
object (.obj), static library (.lib), or other linkable file
linker_options represents zero or more linker options
Notes
-----
1. Most Microsoft* Visual C++* compiler options are supported; a warning is
printed for most unsupported options. The precise behavior of performance
options does not always match that of the Microsoft Visual C++ compiler.
2. Intel C++ compiler options may be placed in your icl.cfg file.
3. Most options beginning with /Q are specific to the Intel C++ compiler:
(*I) indicates other options specific to the Intel C++ compiler
(*M) indicates /Q options supported by the Microsoft Visual C++ compiler
Compiler Option List
--------------------
Performance
-----------
/O1 optimize for maximum speed, but disable some optimizations which
increase code size for a small speed benefit: /Gfsy /Ob1gysi-
/O2 optimize for maximum speed (DEFAULT): /Gfsy /Ob1gyti
/O3 optimize for maximum speed and enable high-level optimizations
/Ox enable maximum optimizations: /Gs /Ob1gyti (same as /O2 without /Gfy)
/Od disable optimizations; useful for selective optimizations (i.e. /Od /Og)
/Ob control inline expansion:
n=0 disables inlining
n=1 inline functions declared with __inline, and perform C++ inlining
n=2 inline any function, at the compiler's discretion (same as /Qip)
/Og enable global optimizations
/Oi[-] enable/disable inline expansion of intrinsic functions
/Op[-] enable/disable better floating-point precision
/Os enable speed optimizations, but disable some optimizations which
increase code size for small speed benefit (overrides /Ot)
/Ot enable speed optimizations (overrides /Os)
/Oy[-] enable/disable using EBP as general purpose register (no frame pointer)
/Oa[-] assume no aliasing in program
/Ow[-] assume no aliasing within functions, but assume aliasing across calls
/G5 optimize for Pentium(R) processor
/G6 optimize for Pentium(R) Pro, Pentium(R) II, and Pentium(R) III
processors
/G7 optimize for Pentium(R) 4 processor (DEFAULT)
/GB same as /G6
/Qax generate code specialized for processor extensions specified by
while also generating generic IA-32 code. includes
one or more of the following characters:
i Pentium Pro and Pentium II processor instructions
M MMX(TM) instructions
K streaming SIMD extensions
W Pentium(R) 4 New Instructions
/Qx generate specialized code to run exclusively on processors
supporting the extensions indicated by as described above.
/arch:{SSE|SSE2}
same as /QxK and /QxW respectively
/GR[-] enable/disable C++ RTTI
/GX[-] enable/disable C++ exception handling (/GX is same as /EHsc)
/EHa enable asynchronous C++ exception handling model
/EHs enable synchronous C++ exception handling model
/EHc assume extern "C" functions do not throw exceptions
/Gd make __cdecl the default calling convention
/Gr make __fastcall the default calling convention
/Gz make __stdcall the default calling convention
/Ge enable stack checks for all functions
/Gs disable stack checks for functions with less than n bytes of locals
/Gf enable string pooling optimization
/GF enable read-only string pooling optimization
/Gy separate functions for the linker (COMDAT)
/GA optimize for Windows application (assume single-threaded app)
/GS enable overflow security checks
/GT enable fiber-safe thread local storage
Advanced Performance
--------------------
Enable and specify the scope of Interprocedural (IP) Optimizations:
/Qip enable single-file IP optimizations (within files, same as /Ob2)
/Qipo enable multi-file IP optimizations (between files)
/Qipo_c generate a multi-file object file (ipo_out.obj)
/Qipo_S generate a multi-file assembly file (ipo_out.asm)
Modify the behavior of IP:
/Qip_no_inlining disable full and partial inlining (requires /Qip or /Qipo)
/Qip_no_pinlining disable partial inlining (requires /Qip or /Qipo)
/Qipo_obj force generation of real object files (requires /Qipo)
Other Advanced Performance Options:
/Qunroll set maximum number of times to unroll loops. Omit n to use
default heuristics. Use n=0 to disable loop unroller.
/Qprof_dir specify directory for profiling output files (*.dyn and *.dpi)
/Qprof_file specify file name for profiling summary file
/Qprof_gen instrument program for profiling; with the x qualifier, extra
information is gathered for use with the PROFORDER tool
/Qprof_use enable use of profiling information during optimization
/Qfnsplit[-] enable/disable function splitting (enabled with /Qprof_use)
/Qpc32 set internal FPU precision to 24 bit significand
/Qpc64 set internal FPU precision to 53 bit significand (DEFAULT)
/Qpc80 set internal FPU precision to 64 bit significand
/QIfist[-] enable/disable(DEFAULT) fast float-to-int conversions (*M)
/Qrcd same as /QIfist
/Qprec improve floating-point precision (speed impact less than /Op)
/Qprec_div improve precision of FP divides (some speed impact)
/Qfp_port round fp results at assignments & casts (some speed impact)
/Qsfalign8 may align stack for functions with 8 or 16 byte vars (DEFAULT)
/Qsfalign16 may align stack for functions with 16 byte vars
/Qsfalign force stack alignment for all functions
/Qsfalign- disable stack alignment for all functions
/Gh call __penter in function prolog; for custom user profiling
/Qvec_report control amount of vectorizer diagnostic information:
n=0 no diagnostic information
n=1 indicate vectorized loops (DEFAULT)
n=2 indicate vectorized/non-vectorized loops
n=3 indicate vectorized/non-vectorized loops and prohibiting
data dependence information
n=4 indicate non-vectorized loops
n=5 indicate non-vectorized loops and prohibiting data
dependence information
/Qopt_report generate an optimization report to stderr
/Qopt_report_file specify the filename for the generated report
/Qopt_report_level[level] specify the level of report verbosity (min|med|max)
/Qopt_report_phase specify the phase that reports are generated against
/Qopt_report_routine reports on routines containing the given name
/Qopt_report_help display the optimization phases available for
reporting
/Qtcheck generate instrumentation to detect multi-threading bugs
(requires Intel(R) Threading Tools; cannot be used with
compiler alone)
/Qopenmp enable the compiler to generate multi-threaded code
based on the OpenMP directives
/Qopenmp_profile link with instrumented OpenMP runtime library to
generate OpenMP profiling information for use with the
OpenMP component of the VTune(TM) Performance Analyzer
/Qopenmp_stubs enables the user to compile OpenMP programs in
sequential mode. The openmp directives are ignored and
a stub OpenMP library is linked (sequential)
/Qopenmp_report{0|1|2} control the OpenMP parallelizer diagnostic level
/Qparallel enable the auto-parallelizer to generate multi-threaded
code for loops that can be safely executed in parallel
/Qpar_report{0|1|2|3} control the auto-parallelizer diagnostic level
/Qpar_threshold set threshold for the auto-parallelization of loops
where n is an integer from 0 to 100
/Qansi_alias[-] enable/disable(DEFAULT) use of ANSI aliasing rules in
optimizations; user asserts that the program adheres to
these rules
/Qcomplex_limited_range[-] enable/disable(DEFAULT) the use of the basic
algebraic expansions of some complex arithmetic
operations. This can allow for some performance
improvement in programs which use a lot of complex
arithmetic at the loss of some exponent range.
Output, Debug, PCH
------------------
/c compile to object (.obj) only, do not link
/S compile to assembly (.asm) only, do not link (*I)
/FA[cs] produce assembly file with optional code or source annotations
/Fa[file] name assembly file (or directory for multiple files; i.e. /FaMYDIR\)
/Fo[file] name object file (or directory for multiple files; i.e. /FoMYDIR2\)
/Fe name executable file or directory
/Fm[file] name map file or directory
/Fp[file] name precompiled header file
/Yc[hfile] create precompiled header file
/Yu[hfile] use precompiled header file
/YX enable automatic precompiled header file creation/usage
/Y- ignore all other precompiled header file options
/Qpchi[-] enable(DEFAULT)/disable PCH coexistence, to reduce build time
/Qpch_compress specify compression of PCH files
/Qpch_mem preallocate megabytes of memory for PCH creation
/FD generate file dependencies
/Fr[file] name source browser file (excludes local variable info)
/FR[file] name extended source browser file
/Quse_asm[-] enable/disable(DEFAULT) use of assembler to produce object files
/GZ detect "release build" runtime errors in "debug build" code
/RTC1 equivalent to /GZ or /RTCsu
/RTCs enable stack frame runtime checks
/RTCu report use of variable that was not initialized
/Zd produce line number information in object file
/Zi, /Z7 produce symbolic debug information in object file
/ZI same as /Zi
/Qinline_debug_info preserve the source position of inlined code instead
of assigning the call-site source position to inlined code
Preprocessor
------------
/C don't strip comments
/D[{=|#}] define macro
/QA[(val)] create an assertion 'name' having value 'val'
/QA[-] remove all predefined macros
/E preprocess to stdout
/EP preprocess to stdout, omitting #line directives
/EP /P preprocess to file, omitting #line directives
/P preprocess to file
/FI force inclusion of file
/I add directory to include file search path
/QH print include file order
/QM generate makefile include dependencies; don't compile
/QMM similar to /QM, but do not include system header files
/QMG similar to /QM, but treat missing header files as generated files
/QMD preprocess and compile, generating output file containing
dependency information ending with extension .d
/QMMD similar to /QMD, but do not include system header files
/QMF generate makefile dependency information in file (must specify /QM
or /QMM)
/QMX generate dependency file ending with extension .o.dep containing
information used for the Intel wb tool
/QdM output macro definitions in effect after preprocessing (use with -E)
/U remove predefined macro
/u remove all predefined macros
/X remove standard directories from include file search path
Component Control
-----------------
/Qoption,, pass options to tool specified by
/Qlocation,, set as the location of tool specified by
Language
--------
/J change default char type to unsigned
/noBool disable 'bool' keyword
/Qc99[-] enable/disable(default) C99 support for C programs
/Qms allow compilation of certain dubious sources
/Qmspp[-] enable(DEFAULT)/disable Microsoft Visual C++ 6.0 Processor Pack
binary compatibility
/Qvc5 enable Visual C++ 5.0 compatibility
/Qvc6 enable Visual C++ 6.0 compatibility (DEFAULT)
/Qvc7 enable Visual Studio .NET 2002 compatibility
/Qvc7.1 enable Visual Studio .NET 2003 compatibility
/Qrestrict[-] enable/disable the 'restrict' keyword for disambiguating pointers
/Za disable Microsoft Visual C++ compiler language extensions
/Ze enable Microsoft Visual C++ compiler language extensions (DEFAULT)
/Zg enable the generation of function prototypes
/Zp specify alignment constraint for structures (n=1,2,4,8,16)
/Zs check source syntax only, do not compile
/Zc:arg1[,arg2] specify standard conformance for the following arguments:
forScope enforce standard behavior for initializers of for
loops
wchar_t specify that wchar_t is a native data type
/vd{0|1} disable or enable hidden vtordisp field in C++ objects
/vm specify representation method for C++ pointers to members
Compiler Diagnostics
--------------------
/w disable all warnings
/W0 print only errors
/W1, /W2, /W3 print only errors and warnings (DEFAULT)
/W4, /Wall print errors, warnings, and remarks
/WX force warnings to be reported as errors
/Wport issue portability diagnostics
/Qwn print a maximum of n errors
/Qwd[,,...] disable diagnostics L1 through LN
/Qwe[,,...] change severity of diagnostics L1 through LN to error
/Qww[,,...] change severity of diagnostics L1 through LN to warning
/Qwr[,,...] change severity of diagnostics L1 through LN to remark
Miscellaneous
-------------
/?, /help print this help message
/H limit length of external symbols to n characters
/nologo do not display compiler version information
/Tc compile file as C source
/Tp compile file as C++ source
/TC compile all source or unrecognized file types as C source files
/TP compile all source or unrecognized file types as C++ source files
/V embed version text in executable
/Qsox[-] enable/disable(DEFAULT) saving of compiler options and version
in the executable
/Qlong_double enable 80-bit 'long double'
/Qnobss_init disable placement of zero-initialized variables in BSS (use DATA)
/QI0f[-] enable/disable patch for Pentium processor 0f erratum (*M)
Linking/Linker
--------------
/link specify that all following options are for the linker
/F set the stack reserve amount specified to the linker
/LD, /LDd produce a DLL instead of an EXE ('d' = debug version)
/MD, /MDd use dynamically-loaded, multithread C runtime
/ML, /MLd use statically-loaded, single thread C runtime (/ML is DEFAULT)
/MT, /MTd use statically-loaded, multithread C runtime
/Zl omit library names from object file
Copyright (C) 1985-2004, Intel Corporation. All rights reserved.
* Other brands and names are the property of their respective owners.
Icl v08.x.x 32-bit Options
Intel(R) C++ Compiler Help
==========================
usage: icl [options] file1 [file2 ...] [/link linker_options]
where options represents zero or more compiler options
fileN is a C/C++ source (.c .cc .cpp .cxx .i), assembly (.asm),
object (.obj), static library (.lib), or other linkable file
linker_options represents zero or more linker options
Notes
-----
1. Most Microsoft* Visual C++* compiler options are supported; a warning is
printed for most unsupported options. The precise behavior of performance
options does not always match that of the Microsoft Visual C++ compiler.
2. Intel C++ compiler options may be placed in your icl.cfg file.
3. Most options beginning with /Q are specific to the Intel C++ compiler:
(*I) indicates other options specific to the Intel C++ compiler
(*M) indicates /Q options supported by the Microsoft Visual C++ compiler
Compiler Option List
--------------------
Performance
-----------
/O1 optimize for maximum speed, but disable some optimizations which
increase code size for a small speed benefit: /Gfsy /Ob1gysi-
/O2 optimize for maximum speed (DEFAULT): /Gfsy /Ob1gyti
/O3 optimize for maximum speed and enable high-level optimizations
/Ox enable maximum optimizations: /Gs /Ob1gyti (same as /O2 without /Gfy)
/Od disable optimizations; useful for selective optimizations (i.e. /Od /Og)
/fast enable /QxP /O3 /Qipo
/Ob control inline expansion:
n=0 disables inlining
n=1 inline functions declared with __inline, and perform C++ inlining
n=2 inline any function, at the compiler's discretion (same as /Qip)
/Og enable global optimizations
/Oi[-] enable/disable inline expansion of intrinsic functions
/Op[-] enable/disable better floating-point precision
/Os enable speed optimizations, but disable some optimizations which
increase code size for small speed benefit (overrides /Ot)
/Ot enable speed optimizations (overrides /Os)
/Oy[-] enable/disable using EBP as general purpose register (no frame pointer)
/Oa[-] assume no aliasing in program
/Ow[-] assume no aliasing within functions, but assume aliasing across calls
/G5 optimize for Pentium(R) processor
/G6 optimize for Pentium(R) Pro, Pentium(R) II, and Pentium(R) III
processors
/G7 optimize for Pentium(R) 4 processor (DEFAULT)
/GB same as /G6
/Qax generate code specialized for processors specified by
while also generating generic IA-32 code. includes
one or more of the following characters:
K Intel Pentium III and compatible Intel processors
W Intel Pentium 4 and compatible Intel processors
N Intel Pentium 4 and compatible Intel processors
P Intel Pentium 4 processors with SSE3 extensions
B Intel Pentium M and compatible Intel processors
/Qx generate specialized code to run exclusively on processors
indicated by as described above.
/arch:{SSE|SSE2}
same as /QxK and /QxW respectively
/GR[-] enable/disable C++ RTTI
/GX[-] enable/disable C++ exception handling (/GX is same as /EHsc)
/Qcxx_features
enable standard C++ features (-GX -GR)
/EHa enable asynchronous C++ exception handling model
/EHs enable synchronous C++ exception handling model
/EHc assume extern "C" functions do not throw exceptions
/Gd make __cdecl the default calling convention
/Gr make __fastcall the default calling convention
/Gz make __stdcall the default calling convention
/Ge enable stack checks for all functions
/Gs disable stack checks for functions with less than n bytes of locals
/Gf enable string pooling optimization
/GF enable read-only string pooling optimization
/Gy separate functions for the linker (COMDAT)
/GA optimize for Windows application (assume .exe)
/GS[-] enable/disable(DEFAULT) overflow security checks
/GT enable fiber-safe thread local storage
Advanced Performance
--------------------
Enable and specify the scope of Interprocedural (IP) Optimizations:
/Qip enable single-file IP optimizations (within files, same as /Ob2)
/Qipo enable multi-file IP optimizations (between files)
/Qipo_c generate a multi-file object file (ipo_out.obj)
/Qipo_S generate a multi-file assembly file (ipo_out.asm)
Modify the behavior of IP:
/Qip_no_inlining disable full and partial inlining (requires /Qip or /Qipo)
/Qip_no_pinlining disable partial inlining (requires /Qip or /Qipo)
/Qipo_obj force generation of real object files (requires /Qipo)
/Qipo_separate create one object file for every source file
(overrides /Qipo)
Other Advanced Performance Options:
/Qunroll set maximum number of times to unroll loops. Omit n to use
default heuristics. Use n=0 to disable loop unroller.
/Qprof_dir specify directory for profiling output files (*.dyn and *.dpi)
/Qprof_file specify file name for profiling summary file
/Qprof_gen instrument program for profiling; with the x qualifier, extra
information is gathered for use with the PROFORDER tool
/Qprof_use enable use of profiling information during optimization
/Qfnsplit[-] enable/disable function splitting (enabled with /Qprof_use)
/Qpc32 set internal FPU precision to 24 bit significand
/Qpc64 set internal FPU precision to 53 bit significand (DEFAULT)
/Qpc80 set internal FPU precision to 64 bit significand
/QIfist[-] enable/disable(DEFAULT) fast float-to-int conversions (*M)
/Qrcd same as /QIfist
/Qprec improve floating-point precision (speed impact less than /Op)
/Qprec_div improve precision of FP divides (some speed impact)
/Qfp_port round fp results at assignments & casts (some speed impact)
/Qfpstkchk enable fp stack checking after every function/procedure call
/Qsfalign8 may align stack for functions with 8 or 16 byte vars (DEFAULT)
/Qsfalign16 may align stack for functions with 16 byte vars
/Qsfalign force stack alignment for all functions
/Qsfalign- disable stack alignment for all functions
/Gh call __penter in function prolog; for custom user profiling
/GH call __pexit in function epilog; for custom user profiling
/Qprefetch[-] enable(DEFAULT)/disable prefetch insertion
/Qvec_report control amount of vectorizer diagnostic information:
n=0 no diagnostic information
n=1 indicate vectorized loops (DEFAULT)
n=2 indicate vectorized/non-vectorized loops
n=3 indicate vectorized/non-vectorized loops and prohibiting
data dependence information
n=4 indicate non-vectorized loops
n=5 indicate non-vectorized loops and prohibiting data
dependence information
/Qopt_report generate an optimization report to stderr
/Qopt_report_file specify the filename for the generated report
/Qopt_report_level[level] specify the level of report verbosity (min|med|max)
/Qopt_report_phase specify the phase that reports are generated against
/Qopt_report_routine reports on routines containing the given name
/Qopt_report_help display the optimization phases available for
reporting
/Qtcheck generate instrumentation to detect multi-threading bugs
(requires Intel(R) Threading Tools; cannot be used with
compiler alone)
/Qopenmp enable the compiler to generate multi-threaded code
based on the OpenMP directives
/Qopenmp_profile link with instrumented OpenMP runtime library to
generate OpenMP profiling information for use with the
OpenMP component of the VTune(TM) Performance Analyzer
/Qopenmp_stubs enables the user to compile OpenMP programs in
sequential mode. The openmp directives are ignored and
a stub OpenMP library is linked (sequential)
/Qopenmp_report{0|1|2} control the OpenMP parallelizer diagnostic level
/Qparallel enable the auto-parallelizer to generate multi-threaded
code for loops that can be safely executed in parallel
/Qpar_report{0|1|2|3} control the auto-parallelizer diagnostic level
/Qpar_threshold set threshold for the auto-parallelization of loops
where n is an integer from 0 to 100
/Qalias_args[-] enable(DEFAULT)/disable C/C++ rule that function
arguments may be aliased; when disabling the rule, the
user asserts that this is safe
/Qansi_alias[-] enable/disable(DEFAULT) use of ANSI aliasing rules in
optimizations; user asserts that the program adheres to
these rules
/Qcomplex_limited_range[-] enable/disable(DEFAULT) the use of the basic
algebraic expansions of some complex arithmetic
operations. This can allow for some performance
improvement in programs which use a lot of complex
arithmetic at the loss of some exponent range.
Output, Debug, PCH
------------------
/c compile to object (.obj) only, do not link
/S compile to assembly (.asm) only, do not link (*I)
/FA[cs] produce assembly file with optional code or source annotations
/Fa[file] name assembly file (or directory for multiple files; i.e. /FaMYDIR\)
/Fo[file] name object file (or directory for multiple files; i.e. /FoMYDIR2\)
/Fe name executable file or directory
/Fm[file] name map file or directory
/Fp[file] name precompiled header file
/Yc[hfile] create precompiled header file
/Yu[hfile] use precompiled header file
/YX enable automatic precompiled header file creation/usage
/Y- ignore all other precompiled header file options
/Qpchi[-] enable(DEFAULT)/disable PCH coexistence, to reduce build time
/FD generate file dependencies
/Fr[file] name source browser file (excludes local variable info)
/FR[file] name extended source browser file
/Quse_asm[-] enable/disable(DEFAULT) use of assembler to produce object files
/GZ detect "release build" runtime errors in "debug build" code
/RTC1 equivalent to /GZ or /RTCsu
/RTCs enable stack frame runtime checks
/RTCu report use of variable that was not initialized
/Zd produce line number information in object file
/Zi, /Z7 produce symbolic debug information in object file
/ZI same as /Zi
/Qinline_debug_info preserve the source position of inlined code instead
of assigning the call-site source position to inlined code
Preprocessor
------------
/C don't strip comments
/D[{=|#}] define macro
/QA[(val)] create an assertion 'name' having value 'val'
/QA[-] remove all predefined macros
/E preprocess to stdout
/EP preprocess to stdout, omitting #line directives
/EP /P preprocess to file, omitting #line directives
/P preprocess to file
/FI force inclusion of file
/I add directory to include file search path
/QH print include file order
/QM generate makefile include dependencies; don't compile
/QMM similar to /QM, but do not include system header files
/QMG similar to /QM, but treat missing header files as generated files
/QMD preprocess and compile, generating output file containing
dependency information ending with extension .d
/QMMD similar to /QMD, but do not include system header files
/QMF generate makefile dependency information in file (must specify /QM
or /QMM)
/QMT
change the default target rule for dependency generation
/QdM output macro definitions in effect after preprocessing (use with -E)
/U remove predefined macro
/u remove all predefined macros
/X remove standard directories from include file search path
Component Control
-----------------
/Qoption,, pass options to tool specified by
/Qlocation,, set as the location of tool specified by
Language
--------
/J change default char type to unsigned
/noBool disable 'bool' keyword
/Qc99[-] enable/disable(default) C99 support for C programs
/Qms allow compilation of certain dubious sources
n=0 disable Microsoft compatibility bugs
n=1 enable most Microsoft compatibilities (DEFAULT)
n=2 full Microsoft compatibility
/Qmspp[-] enable(DEFAULT)/disable Microsoft Visual C++ 6.0 Processor Pack
binary compatibility
/Qvc6 enable Visual C++ 6.0 compatibility (DEFAULT)
/Qvc7 enable Visual Studio .NET 2002 compatibility
/Qvc7.1 enable Visual Studio .NET 2003 compatibility
/Qrestrict[-] enable/disable the 'restrict' keyword for disambiguating pointers
/Za disable Microsoft Visual C++ compiler language extensions
/Ze enable Microsoft Visual C++ compiler language extensions (DEFAULT)
/Zg enable the generation of function prototypes
/Zp specify alignment constraint for structures (n=1,2,4,8,16)
/Zs check source syntax only, do not compile
/Zc:arg1[,arg2] specify standard conformance for the following arguments:
forScope enforce standard behavior for initializers of for
loops
wchar_t specify that wchar_t is a native data type
/vd{0|1} disable or enable hidden vtordisp field in C++ objects
/vm specify representation method for C++ pointers to members
Compiler Diagnostics
--------------------
/w disable all warnings
/W0 print only errors
/W1, /W2, /W3 print only errors and warnings (DEFAULT)
/W4, /Wall print errors, warnings, and remarks
/WL print brief one-line diagnostics
/WX force warnings to be reported as errors
/Wcheck enable more strict diagnostics
/Wport issue portability diagnostics
/Qwn print a maximum of n errors
/Qwd[,,...] disable diagnostics L1 through LN
/Qwe[,,...] change severity of diagnostics L1 through LN to error
/Qww[,,...] change severity of diagnostics L1 through LN to warning
/Qwr[,,...] change severity of diagnostics L1 through LN to remark
Miscellaneous
-------------
/?, /help print this help message
/H limit length of external symbols to n characters
/nologo do not display compiler version information
/Tc compile file as C source
/Tp compile file as C++ source
/TC compile all source or unrecognized file types as C source files
/TP compile all source or unrecognized file types as C++ source files
/V embed version text in executable
/Qsox[-] enable/disable(DEFAULT) saving of compiler options and version
in the executable
/Qlong_double enable 80-bit 'long double'
/Qnobss_init disable placement of zero-initialized variables in BSS (use DATA)
/Qglobal-hoist[-]
enable(DEFAULT)/disable external globals are load safe
/showIncludes emit include file names
Linking/Linker
--------------
/link specify that all following options are for the linker
/F set the stack reserve amount specified to the linker
/LD, /LDd produce a DLL instead of an EXE ('d' = debug version)
/MD, /MDd use dynamically-loaded, multithread C runtime
/ML, /MLd use statically-loaded, single thread C runtime (/ML is DEFAULT)
/MT, /MTd use statically-loaded, multithread C runtime
/Zl omit library names from object file
Copyright (C) 1985-2005, Intel Corporation. All rights reserved.
* Other brands and names are the property of their respective owners.
Icl v12.1.x 32-bit Options
Intel(R) C++ Compiler Help
==========================
Intel(R) Compiler includes compiler options that optimize for instruction
sets that are available in both Intel(R) and non-Intel microprocessors, but
may perform additional optimizations for Intel microprocessors than for
non-Intel microprocessors. In addition, certain compiler options for
Intel(R) Compiler are reserved for Intel microprocessors. For a detailed
description of these compiler options, including the instructions they
implicate, please refer to "Intel(R) Compiler User and Reference Guides >
Compiler Options."
usage: icl [options] file1 [file2 ...] [/link linker_options]
where options represents zero or more compiler options
fileN is a C/C++ source (.c .cc .cpp .cxx .i), assembly (.asm),
object (.obj), static library (.lib), or other linkable file
linker_options represents zero or more linker options
Notes
-----
1. Most Microsoft* Visual C++* compiler options are supported; a warning is
printed for most unsupported options. The precise behavior of performance
options does not always match that of the Microsoft Visual C++ compiler.
2. Intel C++ compiler options may be placed in your icl.cfg file.
3. Most options beginning with /Q are specific to the Intel C++ compiler:
(*I) indicates other options specific to the Intel C++ compiler
(*M) indicates /Q options supported by the Microsoft Visual C++ compiler
Compiler Option List
--------------------
Optimization
------------
/O1 optimize for maximum speed, but disable some optimizations which
increase code size for a small speed benefit
/O2 optimize for maximum speed (DEFAULT)
/O3 optimize for maximum speed and enable more aggressive optimizations
that may not improve performance on some programs
/Ox enable maximum optimizations (same as /O2)
/Os enable speed optimizations, but disable some optimizations which
increase code size for small speed benefit (overrides /Ot)
/Ot enable speed optimizations (overrides /Os)
/Od disable optimizations
/Oi[-] enable/disable inline expansion of intrinsic functions
/Oy[-] enable/disable using EBP as a general purpose register (no frame
pointer) (i32 only)
/fast enable /QxHOST /O3 /Qipo /Qprec-div-
options set by /fast cannot be overridden with the exception of
/QxHOST, list options separately to change behavior
/Oa[-] assume no aliasing in program
/Ow[-] assume no aliasing within functions, but assume aliasing across calls
Code Generation
---------------
/Qx
generate specialized code to run exclusively on processors
indicated by as described below
SSE2 May generate Intel(R) SSE2 and SSE instructions for Intel
processors. Optimizes for the Intel NetBurst(R)
microarchitecture.
SSE3 May generate Intel(R) SSE3, SSE2, and SSE instructions for
Intel processors. Optimizes for the enhanced Pentium(R) M
processor microarchitecture and Intel NetBurst(R)
microarchitecture.
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors. Optimizes for the
Intel(R) Core(TM) microarchitecture.
SSE4.1 May generate Intel(R) SSE4 Vectorizing Compiler and Media
Accelerator instructions for Intel processors. May
generate Intel(R) SSSE3, SSE3, SSE2, and SSE instructions
and it may optimize for Intel(R) 45nm Hi-k next generation
Intel Core(TM) microarchitecture.
SSE4.2 May generate Intel(R) SSE4 Efficient Accelerated String
and Text Processing instructions supported by Intel(R)
Core(TM) i7 processors. May generate Intel(R) SSE4
Vectorizing Compiler and Media Accelerator, Intel(R) SSSE3,
SSE3, SSE2, and SSE instructions and it may optimize for
the Intel(R) Core(TM) processor family.
AVX May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
Optimizes for a future Intel processor.
CORE-AVX2
May generate Intel(R) Advanced Vector Extensions 2
(Intel(R) AVX2), Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
Optimizes for a future Intel processor.
CORE-AVX-I
May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), including instructions in Intel(R) Core 2(TM)
processors in process technology smaller than 32nm,
Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel(R) processors. Optimizes for a
future Intel processor.
SSSE3_ATOM
May generate MOVBE instructions for Intel processors,
depending on the setting of option /Qinstruction.
May also generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors. Optimizes for the
Intel(R) Atom(TM) processor and Intel(R) Centrino(R)
Atom(TM) Processor Technology.
/QxHost generate instructions for the highest instruction set and processor
available on the compilation host machine
/Qax[,,...]
generate code specialized for processors specified by
while also generating generic IA-32 instructions.
includes one or more of the following:
SSE2 May generate Intel(R) SSE2 and SSE instructions for Intel
processors.
SSE3 May generate Intel(R) SSE3, SSE2, and SSE instructions for
Intel processors.
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors.
SSE4.1 May generate Intel(R) SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors.
SSE4.2 May generate Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2,
and SSE instructions for Intel processors.
AVX May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
CORE-AVX2
May generate Intel(R) Advanced Vector Extensions 2
(Intel(R) AVX2), Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
CORE-AVX-I
May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), including instructions in Intel(R) Core 2(TM)
processors in process technology smaller than 32nm,
Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel(R) processors.
/arch:
generate specialized code to optimize for processors indicated by
as described below
SSE2 May generate Intel(R) SSE2 and SSE instructions
SSE3 May generate Intel(R) SSE3, SSE2 and SSE instructions
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2 and SSE
instructions
SSE4.1 May generate Intel(R) SSE4.1, SSSE3, SSE3, SSE2 and SSE
instructions
SSE4.2 May generate Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2 and
SSE instructions
AVX May generate Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2 and SSE instructions
IA32 generate x86/x87 generic code that is compatible with IA-32
architecture. Disables any default extended instruction
settings and any previously set extended instruction
settings.
SSE same as /arch:IA32
/Qinstruction:
Refine instruction set output for the selected target processor
[no]movbe - Do/do not generate MOVBE instructions with SSSE3_ATOM
(requires /QxSSSE3_ATOM)
/GR[-] enable/disable C++ RTTI
/Qcxx-features
enable standard C++ features (/GX /GR)
/EHa enable asynchronous C++ exception handling model
/EHs enable synchronous C++ exception handling model
/EHc assume extern "C" functions do not throw exceptions
/Qsafeseh[-]
Registers exceptions for safe exception handling (DEFAULT)
/Gd make __cdecl the default calling convention
/Gr make __fastcall the default calling convention
/Gz make __stdcall the default calling convention
/Qregcall
make __regcall the default calling convention
/hotpatch[:n]
generate padding bytes for function entries to enable image
hotpatching. If specified, use 'n' as the padding.
Interprocedural Optimization (IPO)
----------------------------------
/Qip[-] enable(DEFAULT)/disable single-file IP optimization
within files
/Qipo enable multi-file IP optimization between files
/Qipo-c generate a multi-file object file (ipo_out.obj)
/Qipo-S generate a multi-file assembly file (ipo_out.asm)
/Qip-no-inlining
disable full and partial inlining
/Qip-no-pinlining
disable partial inlining
/Qipo-separate
create one object file for every source file (overrides /Qipo)
/Qipo-jobs
specify the number of jobs to be executed simultaneously during the
IPO link phase
Advanced Optimizations
----------------------
/Qunroll
set maximum number of times to unroll loops. Omit n to use default
heuristics. Use n=0 to disable the loop unroller
/Qunroll-aggressive[-]
enables more aggressive unrolling heuristics
/Qopt-args-in-regs:
Determines whether calls to routines are optimized by passing
arguments in registers instead of on the stack.
keywords: none, seen(DEFAULT)
/Qscalar-rep[-]
enable(DEFAULT)/disable scalar replacement (requires /O3)
/Qansi-alias[-]
enable/disable(DEFAULT) use of ANSI aliasing rules optimizations;
user asserts that the program adheres to these rules
/Qansi-alias-check[-]
enable(DEFAULT)/disable ANSI alias checking when using /Qansi-alias
/Qcomplex-limited-range[-]
enable/disable(DEFAULT) the use of the basic algebraic expansions of
some complex arithmetic operations. This can allow for some
performance improvement in programs which use a lot of complex
arithmetic at the loss of some exponent range.
/Qalias-const[-]
enable/disable(DEFAULT) a heuristic stating that if two arguments to
a function have pointer type, a pointer to const does not alias a
pointer to non-const. Also known as the input/output buffer rule, it
assumes that input and output buffer arguments do not overlap.
/Qalias-args[-]
enable(DEFAULT)/disable C/C++ rule that function arguments may be
aliased; when disabling the rule, the user asserts that this is safe
/Qopt-multi-version-aggressive[-]
enables more aggressive multi-versioning to check for pointer
aliasing and scalar replacement
/Qopt-ra-region-strategy[:]
select the method that the register allocator uses to partition each
routine into regions
routine - one region per routine
block - one region per block
trace - one region per trace
loop - one region per loop
default - compiler selects best option
/Qvec[-] enables(DEFAULT)/disables vectorization
/Qvec-guard-write[-]
enables cache/bandwidth optimization for stores under conditionals
within vector loops
/Qvec-threshold
sets a threshold for the vectorization of loops based on the
probability of profitable execution of the vectorized loop in
parallel
/Qopt-malloc-options:{0|1|2|3|4}
specify malloc configuration parameters. Specifying a non-zero
value will cause alternate configuration parameters to be set for
how malloc allocates and frees memory
/Qopt-jump-tables:
control the generation of jump tables
default - let the compiler decide when a jump table, a series of
if-then-else constructs or a combination is generated
large - generate jump tables up to a certain pre-defined size
(64K entries)
- generate jump tables up to in size
use /Qopt-jump-tables- to lower switch statements as chains of
if-then-else constructs
/Qopt-block-factor:
specify blocking factor for loop blocking
/Qfreestanding
compile in a freestanding environment where the standard library
may not be present
/Qopt-streaming-stores:
specifies whether streaming stores are generated
always - enables generation of streaming stores under the
assumption that the application is memory bound
auto - compiler decides when streaming stores are used (DEFAULT)
never - disables generation of streaming stores
/Qipp[:]
link some or all of the Intel(R) Integrated Performance Primitives
(Intel(R) IPP) libraries and bring in the associated headers
common - link using the main libraries set. This is the
default value when /Qipp is specified
crypto - link using the main libraries set and the crypto
library
gen - link using the main libraries set and the fixed
size generated functions library
/Qmkl[:]
link to the Intel(R) Math Kernel Library (Intel(R) MKL) and bring
in the associated headers
parallel - link using the threaded Intel(R) MKL libraries. This
is the default when /Qmkl is specified
sequential - link using the non-threaded Intel(R) MKL libraries
cluster - link using the Intel(R) MKL Cluster libraries plus
the sequential Intel(R) MKL libraries
/Qtbb link to the Intel(R) Threading Building Blocks (Intel(R) TBB)
libraries and bring in the associated headers
/Qopt-subscript-in-range[-]
assumes no overflows in the intermediate computation of the
subscripts
/Quse-intel-optimized-headers[-]
take advantage of the optimized header files
/Qcilk-serialize
run a Cilk program as a C/C++ serialized program
/Qvla[-] enable/disable(DEFAULT) Variable Length Arrays (C99 feature)
/Qintel-extensions[-]
enable(DEFAULT)/disable C/C++ language extensions such as array
notation, Intel(R) Cilk(TM) Plus language extensions, and
support for decimal floating-point types.
/Qopt-matmul[-]
replace matrix multiplication with calls to intrinsics and threading
libraries for improved performance (DEFAULT at /O3 /Qparallel)
/Qsimd[-]
enables(DEFAULT)/disables vectorization using simd pragma
/Qguide-opts:
tells the compiler to analyze certain code and generate
recommendations that may improve optimizations
/Qguide-file[:]
causes the results of guided auto-parallelization to be output to a
file
/Qguide-file-append[:]
causes the results of guided auto-parallelization to be appended to
a file
/Qguide[:]
lets you set a level (1 - 4) of guidance for auto-vectorization,
auto-parallelization, and data transformation (DEFAULT is 4 when the
option is specified)
/Qguide-data-trans[:]
lets you set a level (1 - 4) of guidance for data transformation
(DEFAULT is 4 when the option is specified)
/Qguide-par[:]
lets you set a level (1 - 4) of guidance for auto-parallelization
(DEFAULT is 4 when the option is specified)
/Qguide-vec[:]
lets you set a level (1 - 4) of guidance for auto-vectorization
(DEFAULT is 4 when the option is specified)
/Qopt-mem-layout-trans[:]
controls the level of memory layout transformations performed by the
compiler
0 - disable memory layout transformations (same as
/Qopt-mem-layout-trans-)
1 - enable basic memory layout transformations
2 - enable more memory layout transformations (DEFAULT when the
option is specified)
3 - enable aggressive memory layout transformations
Profile Guided Optimization (PGO)
---------------------------------
/Qprof-dir
specify directory for profiling output files (*.dyn and *.dpi)
/Qprof-src-root
specify project root directory for application source files to
enable relative path resolution during profile feedback on sources
below that directory
/Qprof-src-root-cwd
specify the current directory as the project root directory for
application source files to enable relative path resolution during
profile feedback on sources below that directory
/Qprof-src-dir[-]
specify whether directory names of sources should be
considered when looking up profile records within the .dpi file
/Qprof-file
specify file name for profiling summary file
/Qprof-data-order[-]
enable/disable(DEFAULT) static data ordering with profiling
/Qprof-func-order[-]
enable/disable(DEFAULT) function ordering with profiling
/Qprof-gen[:keyword]
instrument program for profiling.
Optional keyword may be srcpos or globdata
/Qprof-gen-
disable profiling instrumentation
/Qprof-use[:]
enable use of profiling information during optimization
weighted - invokes profmerge with -weighted option to scale data
based on run durations
[no]merge - enable(default)/disable the invocation of the profmerge
tool
/Qprof-use-
disable use of profiling information during optimization
/Qcov-gen
instrument program for profiling
/Qcov-dir
specify directory for profiling output files (*.dyn and *.dpi)
/Qcov-file
specify file name for profiling summary file
/Qfnsplit[-]
enable/disable function splitting (enabled with /Qprof-use)
/Qopt-prefetch[:n]
enable levels of prefetch insertion, where 0 disables.
n may be 0 through 4 inclusive. Default is 2.
/Qopt-prefetch-
disable(DEFAULT) prefetch insertion. Equivalent to /Qopt-prefetch:0
/Qinstrument-functions[-]
determine whether function entry and exit points are instrumented
/Qprof-hotness-threshold:
set the hotness threshold for function grouping and function ordering
val indicates percentage of functions to be placed in hot region.
This option requires /Qprof-use
and /Qprof-func-order
/Qprof-value-profiling:[,,...]
limit value profiling
none - inhibit all types of value profiling
nodivide - inhibit value profiling of non-compile time constants
used in division or remainder operations
noindcall - inhibit value profiling of function addresses at
indirect call sites
/Qprofile-functions
enable instrumentation in generated code for collecting
function execution time profiles
/Qprofile-loops:
enable instrumentation in generated code for collecting
loop execution time profiles
inner - instrument inner loops
outer - instrument outer loops
all - instrument all loops
/Qprofile-loops-report:
Control the level of instrumentation inserted for reporting loop
execution profiles
1 - report loop times
2 - report loop times and iteration counts
Optimization Reports
--------------------
/Qvec-report
control amount of vectorizer diagnostic information
n=0 no diagnostic information
n=1 indicate vectorized loops (DEFAULT when enabled)
n=2 indicate vectorized/non-vectorized loops
n=3 indicate vectorized/non-vectorized loops and prohibiting
data dependence information
n=4 indicate non-vectorized loops
n=5 indicate non-vectorized loops and prohibiting data
dependence information
/Qopt-report[:n]
generate an optimization report to stderr
0 disable optimization report output
1 minimum report output
2 medium output (DEFAULT when enabled)
3 maximum report output
/Qopt-report-file:
specify the filename for the generated report
/Qopt-report-phase:
specify the phase that reports are generated against
/Qopt-report-routine:
reports on routines containing the given name
/Qopt-report-help
display the optimization phases available for reporting
/Qtcheck[:mode]
enable analysis of threaded applications (requires Intel(R) Thread
Checker; cannot be used with compiler alone)
tci - instruments a program to perform a thread-count-independent
analysis
tcd - instruments a program to perform a thread-count-dependent
analysis (DEFAULT when mode is not used)
api - instruments a program at the api-imports level
/Qtcollect[:]
inserts instrumentation probes calling the Intel(R) Trace Collector
API. The library .lib is linked in the default being VT.lib
(requires Intel(R) Trace Collector)
/Qtcollect-filter:file
Enable or disable the instrumentation of specified functions.
(requires Intel(R) Trace Collector)
OpenMP* and Parallel Processing
------------------------------
/Qopenmp enable the compiler to generate multi-threaded code based on the
OpenMP* directives (same as /openmp)
/Qopenmp-stubs
enables the user to compile OpenMP programs in sequential mode. The
OpenMP directives are ignored and a stub OpenMP library is linked
(sequential)
/Qopenmp-report{0|1|2}
control the OpenMP parallelizer diagnostic level
/Qopenmp-lib:
choose which OpenMP library version to link with
compat - use the Microsoft compatible OpenMP run-time libraries
(DEFAULT)
/Qopenmp-task:
choose which OpenMP tasking model to support
omp - support OpenMP 3.0 tasking (DEFAULT)
intel - support Intel taskqueuing
/Qopenmp-threadprivate:
choose which threadprivate implementation to use
compat - use the Microsoft compatible thread local storage
legacy - use the Intel compatible implementation
(DEFAULT)
/Qparallel
enable the auto-parallelizer to generate multi-threaded code for
loops that can be safely executed in parallel
/Qpar-report{0|1|2|3}
control the auto-parallelizer diagnostic level
/Qpar-threshold
set threshold for the auto-parallelization of loops where n is an
integer from 0 to 100
/Qpar-runtime-control
Control parallelizer to generate runtime check code for effective
automatic parallelization.
n=0 no runtime check based auto-parallelization
n=1 generate runtime check code under conservative mode
(DEFAULT when enabled)
n=2 generate runtime check code under heuristic mode
n=3 generate runtime check code under aggressive mode
/Qpar-schedule-static[:n]
Specifies a scheduling algorithm for DO loop iteration.
Divides iterations into contiguous pieces. Size n if
specified, equal sized pieces if not.
/Qpar-schedule-static_balanced[:n]
Divides iterations into even-sized chunks. Size n if
specified, equal sized pieces if not.
/Qpar-schedule-static-steal[:n]
Divides iterations into even-sized chunks, but allows
threads to steal parts of chunks from neighboring threads
/Qpar-schedule-dynamic[:n]
Specifies a scheduling algorithm for DO loop iteration.
Assigns iterations to threads in chunks dynamically.
Chunk size is n iterations if specified, otherwise 1.
/Qpar-schedule-guided[:n]
Specifies a scheduling algorithm for DO loop iteration.
Indicates a minimum number of iterations. If specified,
n is the minimum number, otherwise 1.
/Qpar-schedule-guided-analytical[:n]
Divides iterations by using exponential distribution or
dynamic distributions.
/Qpar-schedule-runtime
Specifies a scheduling algorithm for DO loop iteration.
Defers the scheduling decision until runtime.
/Qpar-schedule-auto
Lets the compiler or run-time system determine the
scheduling algorithm.
/Qpar-adjust-stack
perform fiber-based main thread stack adjustment
/Qpar-affinity=[,...][,][,]
tune application performance by setting different thread affinity
/Qpar-num-threads=
tune application performance by setting different number of threads
/Qparallel-source-info[:n]
enable(DEFAULT)/disable the emission of source location information
for parallel code generation with OpenMP and auto-parallelization
0 - disable (same as /Qparallel-source-info-)
1 - emit routine name and line information (DEFAULT)
2 - emit path, file, routine name and line information
Floating Point
--------------
/fp:
enable floating point model variation
except[-] - enable/disable floating point semantics
fast[=1|2] - enables more aggressive floating point optimizations
precise - allows value-safe optimizations
source - enables intermediates in source precision
strict - enables /fp:precise /fp:except, disables
contractions and enables pragma stdc fenv_access
double - rounds intermediates in 53-bit (double) precision
extended - rounds intermediates in 64-bit (extended) precision
/Qfp-speculation:
enable floating point speculations with the following
conditions:
fast - speculate floating point operations (DEFAULT)
safe - speculate only when safe
strict - same as off
off - disables speculation of floating-point operations
/Qpc32 set internal FPU precision to 24 bit significand
/Qpc64 set internal FPU precision to 53 bit significand (DEFAULT)
/Qpc80 set internal FPU precision to 64 bit significand
/Qprec improve floating-point precision (speed impact less than /Op)
/Qprec-sqrt[-]
determine if certain square root optimizations are enabled
/Qprec-div[-]
improve precision of FP divides (some speed impact)
/Qfast-transcendentals[-]
generate a faster version of the transcendental functions
/Qfp-port[-]
round fp results at assignments and casts (some speed impact)
/Qfp-stack-check
enable fp stack checking after every function/procedure call
/Qrcd rounding mode to enable fast float-to-int conversions
/Qftz[-] enable/disable flush denormal results to zero
/Qfma[-] enable/disable the combining of floating point multiplies and
add/subtract operations
/Qfp-trap:[,,...]
control floating point traps at program start. can be of the
following values
[no]divzero - [Do not] trap on division by zero
[no]inexact - [Do not] trap on inexact result
[no]invalid - [Do not] trap on invalid operation
[no]overflow - [Do not] trap on overflow
[no]underflow - [Do not] trap on underflow
[no]denormal - [Do not] trap on denormal
all - enable trap on all of the above
none - trap on none of the above
common - trap on most commonly used IEEE traps
(invalid, division by zero, overflow)
/Qfp-trap-all:[,,...]
control floating point traps in every routine. can be of the
values specified in /Qfp-trap
Inlining
--------
/Ob control inline expansion:
n=0 disable inlining
n=1 inline functions declared with __inline, and perform C++
inlining
n=2 inline any function, at the compiler's discretion
/Qinline-min-size:
set size limit for inlining small routines
/Qinline-min-size-
no size limit for inlining small routines
/Qinline-max-size:
set size limit for inlining large routines
/Qinline-max-size-
no size limit for inlining large routines
/Qinline-max-total-size:
maximum increase in size for inline function expansion
/Qinline-max-total-size-
no size limit for inline function expansion
/Qinline-max-per-routine:
maximum number of inline instances in any function
/Qinline-max-per-routine-
no maximum number of inline instances in any function
/Qinline-max-per-compile:
maximum number of inline instances in the current compilation
/Qinline-max-per-compile-
no maximum number of inline instances in the current compilation
/Qinline-factor:
set inlining upper limits by n percentage
/Qinline-factor-
do not set set inlining upper limits
/Qinline-forceinline
treat inline routines as forceinline
/Qinline-dllimport
allow(DEFAULT)/disallow functions declared __declspec(dllimport) to
be inlined
/Qinline-calloc
directs the compiler to inline calloc() calls as malloc()/memset()
Output, Debug, PCH
------------------
/c compile to object (.obj) only, do not link
/S compile to assembly (.asm) only, do not link
/FAs produce assembly file with optional source annotations
/FAc produce assembly file with optional code annotations
/FA produce assembly file
/Fa[file]
name assembly file (or directory for multiple files; i.e. /FaMYDIR\)
/Fo[file]
name object file (or directory for multiple files; i.e. /FoMYDIR\)
/Fe[file]
name executable file or directory
/Fp[file]
name precompiled header file
/Zi, /ZI, /Z7
produce symbolic debug information in object file (implies /Od when
another optimization option is not explicitly set)
/debug[:keyword]
enable debug information and control output of enhanced debug
information
keywords: all, full, minimal, none, [no]inline-debug-info
parallel
[no]expr-source-pos
/Qtrapuv trap uninitialized variables
/RTCu report use of variable that was not initialized
/RTC1 equivalent to /RTCsu
/RTCs enable stack frame runtime checks
/RTCc enable checks for converting to smaller types
/Qmap-opts
enable option mapping tool
/Yc[file]
create precompiled header file
/Yu[file]
use precompiled header file
/Y- ignore all other precompiled header file options
/Qpchi[-]
enable(DEFAULT)/disable PCH coexistence, to reduce build time
/FD generate file dependencies
/FR[file]
name extended source browser file
Preprocessor
------------
/QA[]
create an assertion having value
/C do not strip comments
/D[{=|#}]
define macro
/U remove predefined macro
/E preprocess to stdout
/EP preprocess to stdout, omitting #line directives
/EP /P preprocess to file, omitting #line directives
/P preprocess to file
/u remove all predefined macros
/FI
force inclusion of file
/I add directory to include file search path
/X remove standard directories from include file search path
/QH print include file order
/QM generate makefile dependency information
/QMM similar to /QM, but do not include system header files
/QMG similar to /QM, but treat missing header files as generated files
/QMD preprocess and compile, generating output file containing dependency
information ending with extension .d
/QMMD similar to /QMD, but do not include system header files
/QMF
generate makefile dependency information in file (must specify /QM
or /QMM)
/QMT
change the default target rule for dependency generation
/QdM output macro definitions in effect after preprocessing (use with /E)
/QdD same as /QdM, but output #define directives in preprocessed source
/QdN same as /QdD, but #define directives contain only macro names
Component Control
-----------------
/Qoption,,
pass options to tool specified by
/Qlocation,,
set as the location of tool specified by
Language
--------
/Qstd=
enable language support for , as described below
c99 enable C99 support for C programs
c++0x enable preliminary support for some C++0x features
/Za disable Microsoft Visual C++ compiler language extensions
/Zg enable the generation of function prototypes
/Zp specify alignment constraint for structures where
n=1,2,4,8,16. 16 is the default
/Zc:arg1[,arg2]
specify standard conformance for the following arguments:
forScope[-] enforce standard compliance in for loop scope
wchar_t[-] specify that wchar_t is a native data type
auto[-] enforce compliance to the new standard meaning for auto
/Zs perform syntax and semantic checking only (no object file produced)
/vd{0|1} disable or enable hidden vtordisp field in C++ objects
/vm specify representation method for C++ pointers to members
/J change default char type to unsigned
/noBool suppresses the C++ bool, true, and false keywords
/Qtemplate-depth
control the depth in which recursive templates are expanded
/Qrestrict[-]
enable/disable the 'restrict' keyword for disambiguating pointers
/Qhelp-pragma
output supported pragmas and their usage syntax
Compiler Diagnostics
--------------------
/w disable all warnings
/W0 print only errors
/W1, /W2, /W3
print only errors and warnings (DEFAULT)
/W4, /Wall
print errors, warnings and most remarks
/W5 print all errors, warnings and remarks
/WL print brief one-line diagnostics
/WX force warnings to be reported as errors
/Werror-all
force warnings and currently enabled remarks to be reported as errors
/Wcheck enable more strict diagnostics
/Wport issue portability diagnostics
/Qeffc++ enable effective C++ diagnostic warnings
/Qwo[,,...]
issue diagnostics L1 through LN only once
/Wp64 print diagnostics for 64-bit porting
/noerror-limit
set no maximum number on error-level or fatal-level error messages
/Qdiag-enable:[,,...]
enable the specified diagnostics or diagnostic groups
/Qdiag-disable:[,,...]
disable the specified diagnostics or diagnostic groups
where may be individual diagnostic numbers or group names.
where group names include:
sc - perform source code analysis: n=1 for critical
errors, n=2 for all errors and n=3 for all errors
and warnings
sc-include - perform source code analysis on include files
sc-parallel - perform analysis of parallelization in
source code: n=1 for critical errors,
n=2 for errors, n=3 for all errors and
warnings
thread - enable diagnostics to aid in thread-enabling source
port-linux - enable diagnostics for Microsoft extensions that
may cause errors when porting to Linux/MacOS
warn - diagnostic messages that have "warning" severity level.
error - diagnostic messages that have "error" severity level.
remark - diagnostic messages that are remarks or comments.
vec - diagnostic messages issued by the vectorizer.
par - diagnostic messages issued by the auto-parallelizer
openmp - diagnostic messages issued by the OpenMP* parallelizer.
cpu-dispatch Specifies the CPU dispatch remarks.
/Qdiag-error:[,,...]
output the specified diagnostics or diagnostic groups as errors
/Qdiag-warning:[,,...]
output the specified diagnostics or diagnostic groups as warnings
/Qdiag-remark:[,,...]
output the the specified diagnostics or diagnostic groups as remarks
/Qdiag-dump
display the currently enabled diagnostic messages to stdout or to a
specified diagnostic output file.
/Qdiag-sc-dir: directory where diagnostics from Static security analysis are
created, rather than current working directory.
/Qdiag-file[:]
where diagnostics are emitted to. Not specifying this causes
messages to be output to stderr
/Qdiag-file-append[:]
where diagnostics are emitted to. When already exists,
output is appended to the file
/Qdiag-id-numbers[-]
enable(DEFAULT)/disable the diagnostic specifiers to be output in
numeric form
/Qdiag-error-limit:
specify the maximum number of errors emitted
/Qdiag-once:[,,...]
issue diagnostics v1 through vN only once
Miscellaneous
-------------
/nologo do not display compiler version information
/Qsox[:[,keyword]]
enable saving of compiler options, version and additional information
in the executable. Use /Qsox- to disable(DEFAULT)
profile - include profiling data
inline - include inlining information
/Qsave-temps
store the intermediate files in current directory and name them
based on the source file. Only saves files that are generated by
default
/Tc
compile file as C source
/Tp
compile file as C++ source
/TC
compile all source or unrecognized file types as C source files
/TP
compile all source or unrecognized file types as C++ source files
/showIncludes
emit include file names
/Qmultibyte-chars[-]
provide support for multi-byte characters
/MP[] create multiple processes that can be used to compile large numbers
of source files at the same time
/bigobj generate objects with increased address capacity
Data
----
/Zp specify alignment constraint for structures (n=1,2,4,8,16
/Zp16 DEFAULT)
/GS enable overflow security checks.
/GS- disables (DEFAULT)
/GF enable read-only string pooling optimization
/GA optimize for Windows application (assume .exe)
/GT enable fiber-safe thread local storage
/Qsfalign8
may align stack for functions with 8 or 16 byte vars (DEFAULT)
/Qsfalign16
may align stack for functions with 16 byte vars
/Qsfalign
force stack alignment for all functions
/Qsfalign-
disable stack alignment for all functions
/Qfnalign[-]
align the start of functions to an optimal machine-dependent value.
When disabled (DEFAULT) align on a 2-byte boundary
/Qfnalign:[2|16]
align the start of functions on a 2 (DEFAULT) or 16 byte boundary
/Qglobal-hoist[-]
enable(DEFAULT)/disable external globals are load safe
/Qkeep-static-consts[-]
enable/disable(DEFAULT) emission of static const variables even
when not referenced
/Qlong-double
enable 80-bit 'long double'
/Qnobss-init
disable placement of zero-initialized variables in BSS (use DATA)
/Qzero-initialized-in-bss[-]
put explicitly zero initialized variables into the DATA section
instead of the BSS section
/Qimf-absolute-error:value[:funclist]
define the maximum allowable absolute error for math library
function results
/Qimf-accuracy-bits:bits[:funclist]
define the relative error, measured by the number of correct bits,
for math library function results
/Qimf-arch-consistency:value[:funclist]
ensures that the math library functions produce consistent results
across different implementations of the same architecture
/Qimf-max-error:ulps[:funclist]
defines the maximum allowable relative error, measured in ulps, for
math library function results
/Qimf-precision:value[:funclist]
defines the accuracy (precision) for math library functions
Compatibility
-------------
/Qms allow compilation of certain dubious sources
n=0 disable Microsoft compatibility bugs
n=1 enable most Microsoft compatibilities (DEFAULT)
n=2 full Microsoft compatibility
/Qvc
enable compatibility with a specific Microsoft Visual C++ version
8 - Visual Studio 2005 compatibility
9 - Visual Studio 2008 compatibility
10 - Visual Studio 2010 compatibility
Linking/Linker
--------------
/link specify that all options following '/link' are for the linker
/F set the stack reserve amount specified to the linker
/LD produce a DLL instead of an EXE ('d' = debug version)
/MD use dynamically-loaded, multithread C runtime
/MT use statically-linked, multithread C runtime (DEFAULT with
Microsoft Visual Studio 2005 and later)
/ML use statically-linked, single thread C runtime (only valid in
Microsoft Visual Studio 2003 environment)
/Zl omit library names from object file
Deprecated Options
------------------
/Qinline-debug-info use /debug:inline-debug-info
/Gf use /GF
/ML upgrade to /MT
/Quse-asm No replacement
/Qprof-genx use /Qprof-gen:srcpos
/Qdiag-enable:sv[] use /Qdiag-enable:sc[]
/Qdiag-enable:sv-include use /Qdiag-enable:sc-include
/Qdiag-sv use /Qdiag-enable:sc[]
/Qdiag-sv-error use /Qdiag-disable:warning
/Qdiag-sv-include use /Qdiag-enable:sc-include
/Qdiag-sv-level No replacement
/Qdiag-sv-sup use /Qdiag-disable:[,,...]
/Qopenmp-link No replacement
/Qopenmp-profile No replacement
/Qtprofile No replacement
/arch:SSE use /arch:IA32
/QxK upgrade to /arch:SSE2
/QaxK upgrade to /arch:SSE2
/QxW use /arch:SSE2
/QaxW use /arch:SSE2
/QxN use /QxSSE2
/QaxN use /QaxSSE2
/QxP use /QxSSE3
/QaxP use /QaxSSE3
/QxT use /QxSSSE3
/QaxT use /QaxSSSE3
/QxS use /QxSSE4.1
/QaxS use /QaxSSE4.1
/QxH use /QxSSE4.2
/QaxH use /QaxSSE4.2
/QxO use /arch:SSE3
/Qvc7.1 No replacement
/QIfist use /Qrcd
/QxSSE3_ATOM use /QxSSSE3_ATOM
/Op use /fp:precise
/Fr use /FR
/GX use /EHsc
/GZ use /RTC1
/H No replacement
/QA- use /u
/Qc99 use /Qstd=c99
/Qwn use /Qdiag-error-limit:
/Qwd use /Qdiag-disable
/Qwe use /Qdiag-error
/Qww use /Qdiag-warning
/Qwr use /Qdiag-remark
/Qwo use /Qdiag-once
/Yd use /Zi, /ZI, /Z7
/Zd use /debug:minimal
/Ze No replacement
/Zg No replacement
/help, /? [category] print full or category help message
Valid categories include
advanced - Advanced Optimizations
codegen - Code Generation
compatibility - Compatibility
component - Component Control
data - Data
deprecated - Deprecated Options
diagnostics - Compiler Diagnostics
float - Floating Point
help - Help
inline - Inlining
ipo - Interprocedural Optimization (IPO)
language - Language
link - Linking/Linker
misc - Miscellaneous
opt - Optimization
output - Output
pgo - Profile Guided Optimization (PGO)
preproc - Preprocessor
reports - Optimization Reports
openmp - OpenMP and Parallel Processing
Copyright (C) 1985-2012, Intel Corporation. All rights reserved.
* Other names and brands may be claimed as the property of others.
Icl v13.1.x 32-bit Options
Intel(R) C++ Compiler Help
==========================
Intel(R) Compiler includes compiler options that optimize for instruction
sets that are available in both Intel(R) and non-Intel microprocessors, but
may perform additional optimizations for Intel microprocessors than for
non-Intel microprocessors. In addition, certain compiler options for
Intel(R) Compiler are reserved for Intel microprocessors. For a detailed
description of these compiler options, including the instructions they
implicate, please refer to "Intel(R) Compiler User and Reference Guides >
Compiler Options."
usage: icl [options] file1 [file2 ...] [/link linker_options]
where options represents zero or more compiler options
fileN is a C/C++ source (.c .cc .cpp .cxx .i), assembly (.asm),
object (.obj), static library (.lib), or other linkable file
linker_options represents zero or more linker options
Notes
-----
1. Most Microsoft* Visual C++* compiler options are supported; a warning is
printed for most unsupported options. The precise behavior of performance
options does not always match that of the Microsoft Visual C++ compiler.
2. Intel C++ compiler options may be placed in your icl.cfg file.
3. Most options beginning with /Q are specific to the Intel C++ compiler:
(*I) indicates other options specific to the Intel C++ compiler
(*M) indicates /Q options supported by the Microsoft Visual C++ compiler
Some options listed are only available on a specific system
i32 indicates the feature is available on systems based on IA-32
architecture
i64em indicates the feature is available on systems using Intel(R) 64
architecture
Compiler Option List
--------------------
Optimization
------------
/O1 optimize for maximum speed, but disable some optimizations which
increase code size for a small speed benefit
/O2 optimize for maximum speed (DEFAULT)
/O3 optimize for maximum speed and enable more aggressive optimizations
that may not improve performance on some programs
/Ox enable maximum optimizations (same as /O2)
/Os enable speed optimizations, but disable some optimizations which
increase code size for small speed benefit (overrides /Ot)
/Ot enable speed optimizations (overrides /Os)
/Od disable optimizations
/Oi[-] enable/disable inline expansion of intrinsic functions
/Oy[-] enable/disable using EBP as a general purpose register (no frame
pointer) (i32 only)
/fast enable /QxHOST /O3 /Qipo /Qprec-div-
options set by /fast cannot be overridden with the exception of
/QxHOST, list options separately to change behavior
/Oa[-] assume no aliasing in program
/Ow[-] assume no aliasing within functions, but assume aliasing across calls
Code Generation
---------------
/Qx
generate specialized code to run exclusively on processors
indicated by as described below
SSE2 May generate Intel(R) SSE2 and SSE instructions for Intel
processors. Optimizes for the Intel NetBurst(R)
microarchitecture.
SSE3 May generate Intel(R) SSE3, SSE2, and SSE instructions for
Intel processors. Optimizes for the enhanced Pentium(R) M
processor microarchitecture and Intel NetBurst(R)
microarchitecture.
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors. Optimizes for the
Intel(R) Core(TM) microarchitecture.
SSE4.1 May generate Intel(R) SSE4 Vectorizing Compiler and Media
Accelerator instructions for Intel processors. May
generate Intel(R) SSSE3, SSE3, SSE2, and SSE instructions
and it may optimize for Intel(R) 45nm Hi-k next generation
Intel Core(TM) microarchitecture.
SSE4.2 May generate Intel(R) SSE4 Efficient Accelerated String
and Text Processing instructions supported by Intel(R)
Core(TM) i7 processors. May generate Intel(R) SSE4
Vectorizing Compiler and Media Accelerator, Intel(R) SSSE3,
SSE3, SSE2, and SSE instructions and it may optimize for
the Intel(R) Core(TM) processor family.
AVX May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
Optimizes for a future Intel processor.
CORE-AVX2
May generate Intel(R) Advanced Vector Extensions 2
(Intel(R) AVX2), Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
Optimizes for a future Intel processor.
CORE-AVX-I
May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), including instructions in Intel(R) Core 2(TM)
processors in process technology smaller than 32nm,
Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel(R) processors. Optimizes for a
future Intel processor.
SSSE3_ATOM
May generate MOVBE instructions for Intel processors,
depending on the setting of option /Qinstruction.
May also generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors. Optimizes for the
Intel(R) Atom(TM) processor and Intel(R) Centrino(R)
Atom(TM) Processor Technology.
/QxHost generate instructions for the highest instruction set and processor
available on the compilation host machine
/Qax[,,...]
generate code specialized for processors specified by
while also generating generic IA-32 instructions.
includes one or more of the following:
SSE2 May generate Intel(R) SSE2 and SSE instructions for Intel
processors.
SSE3 May generate Intel(R) SSE3, SSE2, and SSE instructions for
Intel processors.
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors.
SSE4.1 May generate Intel(R) SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors.
SSE4.2 May generate Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2,
and SSE instructions for Intel processors.
AVX May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
CORE-AVX2
May generate Intel(R) Advanced Vector Extensions 2
(Intel(R) AVX2), Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
CORE-AVX-I
May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), including instructions in Intel(R) Core 2(TM)
processors in process technology smaller than 32nm,
Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel(R) processors.
/arch:
generate specialized code to optimize for processors indicated by
as described below
SSE2 May generate Intel(R) SSE2 and SSE instructions
SSE3 May generate Intel(R) SSE3, SSE2 and SSE instructions
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2 and SSE
instructions
SSE4.1 May generate Intel(R) SSE4.1, SSSE3, SSE3, SSE2 and SSE
instructions
SSE4.2 May generate Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2 and
SSE instructions
AVX May generate Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2 and SSE instructions
IA32 generate x86/x87 generic code that is compatible with IA-32
architecture. Disables any default extended instruction
settings and any previously set extended instruction
settings.
SSE same as /arch:IA32
/Qinstruction:
Refine instruction set output for the selected target processor
[no]movbe - Do/do not generate MOVBE instructions with SSSE3_ATOM
(requires /QxSSSE3_ATOM)
/GR[-] enable/disable C++ RTTI
/Qcxx-features
enable standard C++ features (/GX /GR)
/EHa enable asynchronous C++ exception handling model
/EHs enable synchronous C++ exception handling model
/EHc assume extern "C" functions do not throw exceptions
/Qsafeseh[-]
Registers exceptions for safe exception handling (DEFAULT)
/Gd make __cdecl the default calling convention
/Gr make __fastcall the default calling convention
/Gz make __stdcall the default calling convention
/Qregcall
make __regcall the default calling convention
/hotpatch[:n]
generate padding bytes for function entries to enable image
hotpatching. If specified, use 'n' as the padding.
/Qextend-arguments:[32|64]
By default, unprototyped scalar integer arguments are passed
in 32-bits (sign-extended if necessary).
On Intel(R) 64, unprototyped scalar integer arguments may be
extended to 64-bits.
Interprocedural Optimization (IPO)
----------------------------------
/Qip[-] enable(DEFAULT)/disable single-file IP optimization
within files
/Qipo enable multi-file IP optimization between files
/Qipo-c generate a multi-file object file (ipo_out.obj)
/Qipo-S generate a multi-file assembly file (ipo_out.asm)
/Qip-no-inlining
disable full and partial inlining
/Qip-no-pinlining
disable partial inlining
/Qipo-separate
create one object file for every source file (overrides /Qipo)
/Qipo-jobs
specify the number of jobs to be executed simultaneously during the
IPO link phase
Advanced Optimizations
----------------------
/Qunroll
set maximum number of times to unroll loops. Omit n to use default
heuristics. Use n=0 to disable the loop unroller
/Qunroll-aggressive[-]
enables more aggressive unrolling heuristics
/Qopt-args-in-regs:
Determines whether calls to routines are optimized by passing
arguments in registers instead of on the stack.
keywords: none, seen(DEFAULT), all(Linux only)
/Qscalar-rep[-]
enable(DEFAULT)/disable scalar replacement (requires /O3)
/Qansi-alias[-]
enable/disable(DEFAULT) use of ANSI aliasing rules optimizations;
user asserts that the program adheres to these rules
/Qansi-alias-check[-]
enable(DEFAULT)/disable ANSI alias checking when using /Qansi-alias
/Qcomplex-limited-range[-]
enable/disable(DEFAULT) the use of the basic algebraic expansions of
some complex arithmetic operations. This can allow for some
performance improvement in programs which use a lot of complex
arithmetic at the loss of some exponent range.
/Qalias-const[-]
enable/disable(DEFAULT) a heuristic stating that if two arguments to
a function have pointer type, a pointer to const does not alias a
pointer to non-const. Also known as the input/output buffer rule, it
assumes that input and output buffer arguments do not overlap.
/Qalias-args[-]
enable(DEFAULT)/disable C/C++ rule that function arguments may be
aliased; when disabling the rule, the user asserts that this is safe
/Qopt-multi-version-aggressive[-]
enables more aggressive multi-versioning to check for pointer
aliasing and scalar replacement
/Qopt-ra-region-strategy[:]
select the method that the register allocator uses to partition each
routine into regions
routine - one region per routine
block - one region per block
trace - one region per trace
loop - one region per loop
default - compiler selects best option
/Qvec[-] enables(DEFAULT)/disables vectorization
/Qvec-guard-write[-]
enables cache/bandwidth optimization for stores under conditionals
within vector loops
/Qvec-threshold
sets a threshold for the vectorization of loops based on the
probability of profitable execution of the vectorized loop in
parallel
/Qopt-malloc-options:{0|1|2|3|4}
specify malloc configuration parameters. Specifying a non-zero
value will cause alternate configuration parameters to be set for
how malloc allocates and frees memory
/Qopt-jump-tables:
control the generation of jump tables
default - let the compiler decide when a jump table, a series of
if-then-else constructs or a combination is generated
large - generate jump tables up to a certain pre-defined size
(64K entries)
- generate jump tables up to in size
use /Qopt-jump-tables- to lower switch statements as chains of
if-then-else constructs
/Qopt-block-factor:
specify blocking factor for loop blocking
/Qfreestanding
compile in a freestanding environment where the standard library
may not be present
/Qopt-streaming-stores:
specifies whether streaming stores are generated
always - enables generation of streaming stores under the
assumption that the application is memory bound
auto - compiler decides when streaming stores are used (DEFAULT)
never - disables generation of streaming stores
/Qipp[:]
link some or all of the Intel(R) Integrated Performance Primitives
(Intel(R) IPP) libraries and bring in the associated headers
common - link using the main libraries set. This is the
default value when /Qipp is specified
crypto - link using the main libraries set and the crypto
library
gen - link using the main libraries set and the fixed
size generated functions library
/Qipp-link:
choose whether to link with static or dynamic libraries to support
Intel(R) Integrated Performance Primitives (Intel(R) IPP)
dynamic - link using the dynamic libraries set. This is the
default value when /Qipp is specified on Windows
static - link using the static libraries set. This is the
default value when /Qipp is specified on Linux
static_thread - link using the optional threaded libraries set
Note: these are provided in a separate install kit
/Qmkl[:]
link to the Intel(R) Math Kernel Library (Intel(R) MKL) and bring
in the associated headers
parallel - link using the threaded Intel(R) MKL libraries. This
is the default when /Qmkl is specified
sequential - link using the non-threaded Intel(R) MKL libraries
cluster - link using the Intel(R) MKL Cluster libraries plus
the sequential Intel(R) MKL libraries
/Qtbb link to the Intel(R) Threading Building Blocks (Intel(R) TBB)
libraries and bring in the associated headers
/Qopt-subscript-in-range[-]
assumes no overflows in the intermediate computation of the
subscripts
/Quse-intel-optimized-headers[-]
take advantage of the optimized header files
/Qcilk-serialize
run a Cilk program as a C/C++ serialized program
/Qvla[-] enable/disable(DEFAULT) Variable Length Arrays (C99 feature)
/Qintel-extensions[-]
enable(DEFAULT)/disable C/C++ language extensions such as array
notation, Intel(R) Cilk(TM) Plus language extensions, and
support for decimal floating-point types.
/Qopt-matmul[-]
replace matrix multiplication with calls to intrinsics and threading
libraries for improved performance (DEFAULT at /O3 /Qparallel)
/Qsimd[-]
enables(DEFAULT)/disables vectorization using simd pragma
/Qguide-opts:
tells the compiler to analyze certain code and generate
recommendations that may improve optimizations
/Qguide-file[:]
causes the results of guide to be output to a file
/Qguide-file-append[:]
causes the results of guide to be appended to a file
/Qguide[:]
lets you set a level (1 - 4) of guidance for auto-vectorization,
auto-parallelization, and data transformation (DEFAULT is 4 when the
option is specified)
/Qguide-data-trans[:]
lets you set a level (1 - 4) of guidance for data transformation
(DEFAULT is 4 when the option is specified)
/Qguide-par[:]
lets you set a level (1 - 4) of guidance for auto-parallelization
(DEFAULT is 4 when the option is specified)
/Qguide-vec[:]
lets you set a level (1 - 4) of guidance for auto-vectorization
(DEFAULT is 4 when the option is specified)
/Qguide-profile:<[file|dir]>[,[file|dir],...]
specify a loop profiler data file (or set of files in a directory)
when using the /Qguide option
/Qopt-mem-layout-trans[:]
controls the level of memory layout transformations performed by the
compiler
0 - disable memory layout transformations (same as
/Qopt-mem-layout-trans-)
1 - enable basic memory layout transformations
2 - enable more memory layout transformations (DEFAULT when the
option is specified)
3 - enable aggressive memory layout transformations
/Qopt-prefetch[:n]
enable levels of prefetch insertion, where 0 disables.
n may be 0 through 4 inclusive. Default is 2.
/Qopt-prefetch-
disable(DEFAULT) prefetch insertion. Equivalent to /Qopt-prefetch:0
Profile Guided Optimization (PGO)
---------------------------------
/Qprof-dir
specify directory for profiling output files (*.dyn and *.dpi)
/Qprof-src-root
specify project root directory for application source files to
enable relative path resolution during profile feedback on sources
below that directory
/Qprof-src-root-cwd
specify the current directory as the project root directory for
application source files to enable relative path resolution during
profile feedback on sources below that directory
/Qprof-src-dir[-]
specify whether directory names of sources should be
considered when looking up profile records within the .dpi file
/Qprof-file
specify file name for profiling summary file
/Qprof-data-order[-]
enable/disable(DEFAULT) static data ordering with profiling
/Qprof-func-order[-]
enable/disable(DEFAULT) function ordering with profiling
/Qprof-gen[:keyword]
instrument program for profiling.
Optional keyword may be srcpos or globdata
/Qprof-gen-
disable profiling instrumentation
/Qprof-use[:]
enable use of profiling information during optimization
weighted - invokes profmerge with -weighted option to scale data
based on run durations
[no]merge - enable(default)/disable the invocation of the profmerge
tool
/Qprof-use-
disable use of profiling information during optimization
/Qcov-gen
instrument program for profiling
/Qcov-dir
specify directory for profiling output files (*.dyn and *.dpi)
/Qcov-file
specify file name for profiling summary file
/Qfnsplit[-]
enable/disable function splitting (enabled with /Qprof-use)
/Qinstrument-functions[-]
determine whether function entry and exit points are instrumented
/Qprof-hotness-threshold:
set the hotness threshold for function grouping and function ordering
val indicates percentage of functions to be placed in hot region.
This option requires /Qprof-use
and /Qprof-func-order
/Qprof-value-profiling:[,,...]
limit value profiling
none - inhibit all types of value profiling
nodivide - inhibit value profiling of non-compile time constants
used in division or remainder operations
noindcall - inhibit value profiling of function addresses at
indirect call sites
/Qprofile-functions
enable instrumentation in generated code for collecting
function execution time profiles
/Qprofile-loops:
enable instrumentation in generated code for collecting
loop execution time profiles
inner - instrument inner loops
outer - instrument outer loops
all - instrument all loops
/Qprofile-loops-report:
Control the level of instrumentation inserted for reporting loop
execution profiles
1 - report loop times
2 - report loop times and iteration counts
Optimization Reports
--------------------
/Qvec-report
control amount of vectorizer diagnostic information
n=0 no diagnostic information
n=1 indicate vectorized loops (DEFAULT when enabled)
n=2 indicate vectorized/non-vectorized loops
n=3 indicate vectorized/non-vectorized loops and prohibiting
data dependence information
n=4 indicate non-vectorized loops
n=5 indicate non-vectorized loops and prohibiting data
dependence information
n=6 indicate vectorized/non-vectorized loops with greater
details and prohibiting data dependence information
n=7 indicate vector code quality message ids and data values
for vectorized loops
/Qopt-report[:n]
generate an optimization report to stderr
0 disable optimization report output
1 minimum report output
2 medium output (DEFAULT when enabled)
3 maximum report output
/Qopt-report-file:
specify the filename for the generated report
/Qopt-report-phase:
specify the phase that reports are generated against
/Qopt-report-routine:
reports on routines containing the given name
/Qopt-report-help
display the optimization phases available for reporting
/Qtcheck[:mode]
enable analysis of threaded applications (requires Intel(R) Thread
Checker; cannot be used with compiler alone)
tci - instruments a program to perform a thread-count-independent
analysis
tcd - instruments a program to perform a thread-count-dependent
analysis (DEFAULT when mode is not used)
api - instruments a program at the api-imports level
/Qtcollect[:]
inserts instrumentation probes calling the Intel(R) Trace Collector
API. The library .lib is linked in the default being VT.lib
(requires Intel(R) Trace Collector)
/Qtcollect-filter:file
Enable or disable the instrumentation of specified functions.
(requires Intel(R) Trace Collector)
OpenMP* and Parallel Processing
------------------------------
/Qopenmp enable the compiler to generate multi-threaded code based on the
OpenMP* directives (same as /openmp)
/Qopenmp-stubs
enables the user to compile OpenMP programs in sequential mode. The
OpenMP directives are ignored and a stub OpenMP library is linked
(sequential)
/Qopenmp-report{0|1|2}
control the OpenMP parallelizer diagnostic level
/Qopenmp-lib:
choose which OpenMP library version to link with
compat - use the Microsoft compatible OpenMP run-time libraries
(DEFAULT)
/Qopenmp-task:
choose which OpenMP tasking model to support
omp - support OpenMP 3.0 tasking (DEFAULT)
intel - support Intel taskqueuing
/Qopenmp-threadprivate:
choose which threadprivate implementation to use
compat - use the Microsoft compatible thread local storage
legacy - use the Intel compatible implementation
(DEFAULT)
/Qparallel
enable the auto-parallelizer to generate multi-threaded code for
loops that can be safely executed in parallel
/Qpar-report{0|1|2|3}
control the auto-parallelizer diagnostic level
/Qpar-threshold
set threshold for the auto-parallelization of loops where n is an
integer from 0 to 100
/Qpar-runtime-control
Control parallelizer to generate runtime check code for effective
automatic parallelization.
n=0 no runtime check based auto-parallelization
n=1 generate runtime check code under conservative mode
(DEFAULT when enabled)
n=2 generate runtime check code under heuristic mode
n=3 generate runtime check code under aggressive mode
/Qpar-schedule-static[:n]
Specifies a scheduling algorithm for DO loop iteration.
Divides iterations into contiguous pieces. Size n if
specified, equal sized pieces if not.
/Qpar-schedule-static_balanced[:n]
Divides iterations into even-sized chunks. Size n if
specified, equal sized pieces if not.
/Qpar-schedule-static-steal[:n]
Divides iterations into even-sized chunks, but allows
threads to steal parts of chunks from neighboring threads
/Qpar-schedule-dynamic[:n]
Specifies a scheduling algorithm for DO loop iteration.
Assigns iterations to threads in chunks dynamically.
Chunk size is n iterations if specified, otherwise 1.
/Qpar-schedule-guided[:n]
Specifies a scheduling algorithm for DO loop iteration.
Indicates a minimum number of iterations. If specified,
n is the minimum number, otherwise 1.
/Qpar-schedule-guided-analytical[:n]
Divides iterations by using exponential distribution or
dynamic distributions.
/Qpar-schedule-runtime
Specifies a scheduling algorithm for DO loop iteration.
Defers the scheduling decision until runtime.
/Qpar-schedule-auto
Lets the compiler or run-time system determine the
scheduling algorithm.
/Qpar-adjust-stack
perform fiber-based main thread stack adjustment
/Qpar-affinity=[,...][,][,]
tune application performance by setting different thread affinity
/Qpar-num-threads=
tune application performance by setting different number of threads
/Qparallel-source-info[:n]
enable(DEFAULT)/disable the emission of source location information
for parallel code generation with OpenMP and auto-parallelization
0 - disable (same as /Qparallel-source-info-)
1 - emit routine name and line information (DEFAULT)
2 - emit path, file, routine name and line information
/Qpar same as /Qparallel
Floating Point
--------------
/fp:
enable floating point model variation
except[-] - enable/disable floating point semantics
fast[=1|2] - enables more aggressive floating point optimizations
precise - allows value-safe optimizations
source - enables intermediates in source precision
strict - enables /fp:precise /fp:except, disables
contractions and enables pragma stdc fenv_access
double - rounds intermediates in 53-bit (double) precision
extended - rounds intermediates in 64-bit (extended) precision
/Qfp-speculation:
enable floating point speculations with the following
conditions:
fast - speculate floating point operations (DEFAULT)
safe - speculate only when safe
strict - same as off
off - disables speculation of floating-point operations
/Qpc32 set internal FPU precision to 24 bit significand
/Qpc64 set internal FPU precision to 53 bit significand (DEFAULT)
/Qpc80 set internal FPU precision to 64 bit significand
/Qprec improve floating-point precision (speed impact less than /Op)
/Qprec-sqrt[-]
determine if certain square root optimizations are enabled
/Qprec-div[-]
improve precision of FP divides (some speed impact)
/Qfast-transcendentals[-]
generate a faster version of the transcendental functions
/Qfp-port[-]
round fp results at assignments and casts (some speed impact)
/Qfp-stack-check
enable fp stack checking after every function/procedure call
/Qrcd rounding mode to enable fast float-to-int conversions
/Qftz[-] enable/disable flush denormal results to zero
/Qfma[-] enable/disable the combining of floating point multiplies and
add/subtract operations
/Qfp-trap:[,,...]
control floating point traps at program start. can be of the
following values
[no]divzero - [Do not] trap on division by zero
[no]inexact - [Do not] trap on inexact result
[no]invalid - [Do not] trap on invalid operation
[no]overflow - [Do not] trap on overflow
[no]underflow - [Do not] trap on underflow
[no]denormal - [Do not] trap on denormal
all - enable trap on all of the above
none - trap on none of the above
common - trap on most commonly used IEEE traps
(invalid, division by zero, overflow)
/Qfp-trap-all:[,,...]
control floating point traps in every routine. can be of the
values specified in /Qfp-trap
Inlining
--------
/Ob control inline expansion:
n=0 disable inlining
n=1 inline functions declared with __inline, and perform C++
inlining
n=2 inline any function, at the compiler's discretion
/Qinline-min-size:
set size limit for inlining small routines
/Qinline-min-size-
no size limit for inlining small routines
/Qinline-max-size:
set size limit for inlining large routines
/Qinline-max-size-
no size limit for inlining large routines
/Qinline-max-total-size:
maximum increase in size for inline function expansion
/Qinline-max-total-size-
no size limit for inline function expansion
/Qinline-max-per-routine:
maximum number of inline instances in any function
/Qinline-max-per-routine-
no maximum number of inline instances in any function
/Qinline-max-per-compile:
maximum number of inline instances in the current compilation
/Qinline-max-per-compile-
no maximum number of inline instances in the current compilation
/Qinline-factor:
set inlining upper limits by n percentage
/Qinline-factor-
do not set set inlining upper limits
/Qinline-forceinline
treat inline routines as forceinline
/Qinline-dllimport
allow(DEFAULT)/disallow functions declared __declspec(dllimport) to
be inlined
/Qinline-calloc
directs the compiler to inline calloc() calls as malloc()/memset()
Output, Debug, PCH
------------------
/c compile to object (.obj) only, do not link
/S compile to assembly (.asm) only, do not link
/FAs produce assembly file with optional source annotations
/FAc produce assembly file with optional code annotations
/FA produce assembly file
/Fa[file]
name assembly file (or directory for multiple files; i.e. /FaMYDIR\)
/Fo[file]
name object file (or directory for multiple files; i.e. /FoMYDIR\)
/Fe[file]
name executable file or directory
/Fp[file]
name precompiled header file
/Zi, /ZI, /Z7
produce symbolic debug information in object file (implies /Od when
another optimization option is not explicitly set)
/debug[:keyword]
enable debug information and control output of enhanced debug
information
keywords: all, full, minimal, none, [no]inline-debug-info
[no]expr-source-pos
/Qtrapuv trap uninitialized variables
/RTCu report use of variable that was not initialized
/RTC1 equivalent to /RTCsu
/RTCs enable stack frame runtime checks
/RTCc enable checks for converting to smaller types
/Qmap-opts
enable option mapping tool
/Yc[file]
create precompiled header file
/Yu[file]
use precompiled header file
/Y- ignore all other precompiled header file options
/Qpchi[-]
enable(DEFAULT)/disable PCH coexistence, to reduce build time
/FD generate file dependencies
/FR[file]
name extended source browser file
/Qcheck-pointers:
Specifies what type of bounds checking occurs. Possible values are:
none - Disables bounds checking. This is the default.
rw - Checks bounds for reads and writes through pointers.
write - Checks bounds for writes through pointers only.
This switch is only valid with Intel(R) Parallel Studio XE
/Qcheck-pointers-dangling:
Specifies what type of dangling pointer checking occurs. Possible
values are:
none - Disables dangling pointer checking. This is the default.
heap - Check dangling references on heap.
stack - Check dangling references on stack.
all - Check dangling references on both heap and stack.
This switch is only valid with Intel(R) Parallel Studio XE
/Qcheck-pointers-undimensioned[-]
Bounds checking occurs for memory access through arrays that are
declared without dimensions. This checking occurs for both
dimensioned and undimensioned arrays.
This switch is only valid with Intel(R) Parallel Studio XE
Preprocessor
------------
/QA[]
create an assertion having value
/C do not strip comments
/D[{=|#}]
define macro
/U remove predefined macro
/E preprocess to stdout
/EP preprocess to stdout, omitting #line directives
/EP /P preprocess to file, omitting #line directives
/P preprocess to file
/u remove all predefined macros
/FI
force inclusion of file
/I add directory to include file search path
/X remove standard directories from include file search path
/QH print include file order
/QM generate makefile dependency information
/QMM similar to /QM, but do not include system header files
/QMG similar to /QM, but treat missing header files as generated files
/QMD preprocess and compile, generating output file containing dependency
information ending with extension .d
/QMMD similar to /QMD, but do not include system header files
/QMF
generate makefile dependency information in file (must specify /QM
or /QMM)
/QMT
change the default target rule for dependency generation
/QdM output macro definitions in effect after preprocessing (use with /E)
/QdD same as /QdM, but output #define directives in preprocessed source
/QdN same as /QdD, but #define directives contain only macro names
Component Control
-----------------
/Qoption,,
pass options to tool specified by
/Qlocation,,
set as the location of tool specified by
Language
--------
/Qstd=
enable language support for , as described below
c99 enable C99 support for C programs
c++11 enable C++11 experimental support for C++ programs
c++0x same as c++11
/Za disable Microsoft Visual C++ compiler language extensions
/Zg enable the generation of function prototypes
/Zp specify alignment constraint for structures where
n=1,2,4,8,16. 16 is the default
/Zc:arg1[,arg2]
specify standard conformance for the following arguments:
forScope[-] enforce standard compliance in for loop scope
wchar_t[-] specify that wchar_t is a native data type
auto[-] enforce compliance to the new standard meaning for auto
/Zs perform syntax and semantic checking only (no object file produced)
/vd{0|1} disable or enable hidden vtordisp field in C++ objects
/vm specify representation method for C++ pointers to members
/J change default char type to unsigned
/noBool suppresses the C++ bool, true, and false keywords
/Qtemplate-depth
control the depth in which recursive templates are expanded
/Qrestrict[-]
enable/disable the 'restrict' keyword for disambiguating pointers
/Qhelp-pragma
output supported pragmas and their usage syntax
/check:[,,...]
check run-time conditions.
keywords: [no]conversions, [no]stack, [no]uninit
Compiler Diagnostics
--------------------
/w disable all warnings
/W0 print only errors
/W1, /W2, /W3
print only errors and warnings (DEFAULT)
/W4, /Wall
print errors, warnings and most remarks
/W5 print all errors, warnings and remarks
/WL print brief one-line diagnostics
/WX force warnings to be reported as errors
/Werror-all
force warnings and currently enabled remarks to be reported as errors
/Wcheck enable more strict diagnostics
/Wport issue portability diagnostics
/Qeffc++ enable effective C++ diagnostic warnings
/Qwo[,,...]
issue diagnostics L1 through LN only once
/Wp64 print diagnostics for 64-bit porting
/Qdiag-enable:[,,...]
enable the specified diagnostics or diagnostic groups
/Qdiag-disable:[,,...]
disable the specified diagnostics or diagnostic groups
where may be individual diagnostic numbers or group names.
where group names include:
sc - perform source code analysis: n=1 for critical
errors, n=2 for all errors and n=3 for all errors
and warnings
sc-
{full|concise|precise} - perform static analysis and determine the analysis
mode.
Full mode - attempts to find all program weaknesses,
even at the expense of more false positives.
Concise mode - attempts to reduce false positives
somewhat more than reducing false negatives.
Precise mode - attempts to avoid all false positives
Default: full if /Qdiag-enable:sc{[1|2|3]} is
present; otherwise None
(static analysis diagnostics are disabled).
sc-include - perform source code analysis on include files
sc-single-file - This option tells static analysis to process each
file individually.
Default: OFF
sc-enums - This option tells static analysis to treat
enumeration variables as known values equal to any
one of the associated enumeration literals.
Default: OFF
sc-parallel - perform analysis of parallelization in
source code: n=1 for critical errors,
n=2 for errors, n=3 for all errors and
warnings
thread - enable diagnostics to aid in thread-enabling source
port-linux - enable diagnostics for Microsoft extensions that
may cause errors when porting to Linux/MacOS
warn - diagnostic messages that have "warning" severity level.
error - diagnostic messages that have "error" severity level.
remark - diagnostic messages that are remarks or comments.
vec - diagnostic messages issued by the vectorizer.
par - diagnostic messages issued by the auto-parallelizer
openmp - diagnostic messages issued by the OpenMP* parallelizer.
cpu-dispatch Specifies the CPU dispatch remarks.
/Qdiag-error:[,,...]
output the specified diagnostics or diagnostic groups as errors
/Qdiag-warning:[,,...]
output the specified diagnostics or diagnostic groups as warnings
/Qdiag-remark:[,,...]
output the the specified diagnostics or diagnostic groups as remarks
/Qdiag-dump
display the currently enabled diagnostic messages to stdout or to a
specified diagnostic output file.
/Qdiag-sc-dir: directory where diagnostics from static analysis are created,
rather than current working directory.
/Qdiag-file[:]
where diagnostics are emitted to. Not specifying this causes
messages to be output to stderr
/Qdiag-file-append[:]
where diagnostics are emitted to. When already exists,
output is appended to the file
/Qdiag-id-numbers[-]
enable(DEFAULT)/disable the diagnostic specifiers to be output in
numeric form
/Qdiag-error-limit:
specify the maximum number of errors emitted
/Qdiag-once:[,,...]
issue diagnostics v1 through vN only once
/Wpch-messages[-]
enable(DEFAULT)/disable PCH information messages
Miscellaneous
-------------
/nologo do not display compiler version information
/Qsox[:[,keyword]]
enable saving of compiler options, version and additional information
in the executable. Use /Qsox- to disable(DEFAULT)
profile - include profiling data
inline - include inlining information
/Qsave-temps
store the intermediate files in current directory and name them
based on the source file. Only saves files that are generated by
default
/watch:
tells the driver to output processing information
keywords: all, none (same as /nowatch), [no]source,
[no]cmd
/nowatch suppress processing information output (DEFAULT)
/Tc
compile file as C source
/Tp
compile file as C++ source
/TC
compile all source or unrecognized file types as C source files
/TP
compile all source or unrecognized file types as C++ source files
/showIncludes
emit include file names
/Qmultibyte-chars[-]
provide support for multi-byte characters
/MP[] create multiple processes that can be used to compile large numbers
of source files at the same time
/bigobj generate objects with increased address capacity
Data
----
/Zp specify alignment constraint for structures (n=1,2,4,8,16
/Zp16 DEFAULT)
/GS enable overflow security checks.
/GS- disables (DEFAULT)
/GF enable read-only string pooling optimization
/GA optimize for Windows application (assume .exe)
/GT enable fiber-safe thread local storage
/Qsfalign8
may align stack for functions with 8 or 16 byte vars (DEFAULT)
/Qsfalign16
may align stack for functions with 16 byte vars
/Qsfalign
force stack alignment for all functions
/Qsfalign-
disable stack alignment for all functions
/Qfnalign[-]
align the start of functions to an optimal machine-dependent value.
When disabled (DEFAULT) align on a 2-byte boundary
/Qfnalign:[2|16]
align the start of functions on a 2 (DEFAULT) or 16 byte boundary
/Qglobal-hoist[-]
enable(DEFAULT)/disable external globals are load safe
/Qkeep-static-consts[-]
enable/disable(DEFAULT) emission of static const variables even
when not referenced
/Qlong-double
enable 80-bit 'long double'
/Qnobss-init
disable placement of zero-initialized variables in BSS (use DATA)
/Qzero-initialized-in-bss[-]
put explicitly zero initialized variables into the DATA section
instead of the BSS section
/Qimf-absolute-error:value[:funclist]
define the maximum allowable absolute error for math library
function results
value - a positive, floating-point number conforming to the
format [digits][.digits][{e|E}[sign]digits]
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-accuracy-bits:bits[:funclist]
define the relative error, measured by the number of correct bits,
for math library function results
bits - a positive, floating-point number
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-arch-consistency:value[:funclist]
ensures that the math library functions produce consistent results
across different implementations of the same architecture
value - true or false
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-max-error:ulps[:funclist]
defines the maximum allowable relative error, measured in ulps, for
math library function results
ulps - a positive, floating-point number conforming to the
format [digits][.digits][{e|E}[sign]digits]
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-precision:value[:funclist]
defines the accuracy (precision) for math library functions
value - defined as one of the following values
high - equivalent to max-error = 0.6
medium - equivalent to max-error = 4 (DEFAULT)
low - equivalent to accuracy-bits = 11 (single
precision); accuracy-bits = 26 (double
precision)
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
Compatibility
-------------
/Qms allow compilation of certain dubious sources
n=0 disable Microsoft compatibility bugs
n=1 enable most Microsoft compatibilities (DEFAULT)
n=2 full Microsoft compatibility
/Qvc
enable compatibility with a specific Microsoft* Visual Studio version
9 - Microsoft* Visual Studio 2008 compatibility
10 - Microsoft* Visual Studio 2010 compatibility
11 - Microsoft* Visual Studio 2012 compatibility
/Qgcc-dialect:
enable a limited gcc-compatible dialect on Windows. The gcc
version may be specified as 440, 450 or 460.
Example: /Qgcc-dialect:440 -> gcc 4.4 compatibility
Linking/Linker
--------------
/link specify that all options following '/link' are for the linker
/F set the stack reserve amount specified to the linker
/LD produce a DLL instead of an EXE ('d' = debug version)
/MD use dynamically-loaded, multithread C runtime
/MT use statically-linked, multithread C runtime (DEFAULT with
Microsoft Visual Studio 2005 and later)
/ML use statically-linked, single thread C runtime (only valid in
Microsoft Visual Studio 2003 environment)
/Zl omit library names from object file
Deprecated Options
------------------
/Qinline-debug-info use /debug:inline-debug-info
/Gf use /GF
/ML upgrade to /MT
/Quse-asm No replacement
/Qprof-genx use /Qprof-gen:srcpos
/Qdiag-enable:sv[] use /Qdiag-enable:sc[]
/Qdiag-enable:sv-include use /Qdiag-enable:sc-include
/Qdiag-sv use /Qdiag-enable:sc[]
/Qdiag-sv-error use /Qdiag-disable:warning
/Qdiag-sv-include use /Qdiag-enable:sc-include
/Qdiag-sv-level No replacement
/Qdiag-sv-sup use /Qdiag-disable:[,,...]
/Qtprofile No replacement
/arch:SSE use /arch:IA32
/QxK upgrade to /arch:SSE2
/QaxK upgrade to /arch:SSE2
/QxW use /arch:SSE2
/QaxW use /arch:SSE2
/QxN use /QxSSE2
/QaxN use /QaxSSE2
/QxP use /QxSSE3
/QaxP use /QaxSSE3
/QxT use /QxSSSE3
/QaxT use /QaxSSSE3
/QxS use /QxSSE4.1
/QaxS use /QaxSSE4.1
/QxH use /QxSSE4.2
/QaxH use /QaxSSE4.2
/QxO use /arch:SSE3
/Qvc7.1 No replacement
/QIfist use /Qrcd
/QxSSE3_ATOM use /QxSSSE3_ATOM
/Qrct No replacement
/Op use /fp:precise
/Fr use /FR
/GX use /EHsc
/GZ use /RTC1
/H No replacement
/QA- use /u
/Qc99 use /Qstd=c99
/Qwn use /Qdiag-error-limit:
/Qwd use /Qdiag-disable
/Qwe use /Qdiag-error
/Qww use /Qdiag-warning
/Qwr use /Qdiag-remark
/Qwo use /Qdiag-once
/Yd use /Zi, /ZI, /Z7
/Zd use /debug:minimal
/Ze No replacement
/Zg No replacement
/help, /? [category] print full or category help message
Valid categories include
advanced - Advanced Optimizations
codegen - Code Generation
compatibility - Compatibility
component - Component Control
data - Data
deprecated - Deprecated Options
diagnostics - Compiler Diagnostics
float - Floating Point
help - Help
inline - Inlining
ipo - Interprocedural Optimization (IPO)
language - Language
link - Linking/Linker
misc - Miscellaneous
opt - Optimization
output - Output
pgo - Profile Guided Optimization (PGO)
preproc - Preprocessor
reports - Optimization Reports
openmp - OpenMP and Parallel Processing
Copyright (C) 1985-2013, Intel Corporation. All rights reserved.
* Other names and brands may be claimed as the property of others.
Icl v13.1.x 64-bit Options
Intel(R) C++ Compiler Help
==========================
Intel(R) Compiler includes compiler options that optimize for instruction
sets that are available in both Intel(R) and non-Intel microprocessors, but
may perform additional optimizations for Intel microprocessors than for
non-Intel microprocessors. In addition, certain compiler options for
Intel(R) Compiler are reserved for Intel microprocessors. For a detailed
description of these compiler options, including the instructions they
implicate, please refer to "Intel(R) Compiler User and Reference Guides >
Compiler Options."
usage: icl [options] file1 [file2 ...] [/link linker_options]
where options represents zero or more compiler options
fileN is a C/C++ source (.c .cc .cpp .cxx .i), assembly (.asm),
object (.obj), static library (.lib), or other linkable file
linker_options represents zero or more linker options
Notes
-----
1. Most Microsoft* Visual C++* compiler options are supported; a warning is
printed for most unsupported options. The precise behavior of performance
options does not always match that of the Microsoft Visual C++ compiler.
2. Intel C++ compiler options may be placed in your icl.cfg file.
3. Most options beginning with /Q are specific to the Intel C++ compiler:
(*I) indicates other options specific to the Intel C++ compiler
(*M) indicates /Q options supported by the Microsoft Visual C++ compiler
Some options listed are only available on a specific system
i32 indicates the feature is available on systems based on IA-32
architecture
i64em indicates the feature is available on systems using Intel(R) 64
architecture
Compiler Option List
--------------------
Optimization
------------
/O1 optimize for maximum speed, but disable some optimizations which
increase code size for a small speed benefit
/O2 optimize for maximum speed (DEFAULT)
/O3 optimize for maximum speed and enable more aggressive optimizations
that may not improve performance on some programs
/Ox enable maximum optimizations (same as /O2)
/Os enable speed optimizations, but disable some optimizations which
increase code size for small speed benefit (overrides /Ot)
/Ot enable speed optimizations (overrides /Os)
/Od disable optimizations
/Oi[-] enable/disable inline expansion of intrinsic functions
/Oy[-] enable/disable using EBP as a general purpose register (no frame
pointer) (i32 only)
/fast enable /QxHOST /O3 /Qipo /Qprec-div-
options set by /fast cannot be overridden with the exception of
/QxHOST, list options separately to change behavior
/Oa[-] assume no aliasing in program
/Ow[-] assume no aliasing within functions, but assume aliasing across calls
Code Generation
---------------
/Qx
generate specialized code to run exclusively on processors
indicated by as described below
SSE2 May generate Intel(R) SSE2 and SSE instructions for Intel
processors. Optimizes for the Intel NetBurst(R)
microarchitecture.
SSE3 May generate Intel(R) SSE3, SSE2, and SSE instructions for
Intel processors. Optimizes for the enhanced Pentium(R) M
processor microarchitecture and Intel NetBurst(R)
microarchitecture.
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors. Optimizes for the
Intel(R) Core(TM) microarchitecture.
SSE4.1 May generate Intel(R) SSE4 Vectorizing Compiler and Media
Accelerator instructions for Intel processors. May
generate Intel(R) SSSE3, SSE3, SSE2, and SSE instructions
and it may optimize for Intel(R) 45nm Hi-k next generation
Intel Core(TM) microarchitecture.
SSE4.2 May generate Intel(R) SSE4 Efficient Accelerated String
and Text Processing instructions supported by Intel(R)
Core(TM) i7 processors. May generate Intel(R) SSE4
Vectorizing Compiler and Media Accelerator, Intel(R) SSSE3,
SSE3, SSE2, and SSE instructions and it may optimize for
the Intel(R) Core(TM) processor family.
AVX May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
Optimizes for a future Intel processor.
CORE-AVX2
May generate Intel(R) Advanced Vector Extensions 2
(Intel(R) AVX2), Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
Optimizes for a future Intel processor.
CORE-AVX-I
May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), including instructions in Intel(R) Core 2(TM)
processors in process technology smaller than 32nm,
Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel(R) processors. Optimizes for a
future Intel processor.
SSSE3_ATOM
May generate MOVBE instructions for Intel processors,
depending on the setting of option /Qinstruction.
May also generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors. Optimizes for the
Intel(R) Atom(TM) processor and Intel(R) Centrino(R)
Atom(TM) Processor Technology.
/QxHost generate instructions for the highest instruction set and processor
available on the compilation host machine
/Qax[,,...]
generate code specialized for processors specified by
while also generating generic IA-32 instructions.
includes one or more of the following:
SSE2 May generate Intel(R) SSE2 and SSE instructions for Intel
processors.
SSE3 May generate Intel(R) SSE3, SSE2, and SSE instructions for
Intel processors.
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors.
SSE4.1 May generate Intel(R) SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel processors.
SSE4.2 May generate Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2,
and SSE instructions for Intel processors.
AVX May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
CORE-AVX2
May generate Intel(R) Advanced Vector Extensions 2
(Intel(R) AVX2), Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2, and SSE instructions for Intel(R) processors.
CORE-AVX-I
May generate Intel(R) Advanced Vector Extensions (Intel(R)
AVX), including instructions in Intel(R) Core 2(TM)
processors in process technology smaller than 32nm,
Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2, and SSE
instructions for Intel(R) processors.
/arch:
generate specialized code to optimize for processors indicated by
as described below
SSE2 May generate Intel(R) SSE2 and SSE instructions
SSE3 May generate Intel(R) SSE3, SSE2 and SSE instructions
SSSE3 May generate Intel(R) SSSE3, SSE3, SSE2 and SSE
instructions
SSE4.1 May generate Intel(R) SSE4.1, SSSE3, SSE3, SSE2 and SSE
instructions
SSE4.2 May generate Intel(R) SSE4.2, SSE4.1, SSSE3, SSE3, SSE2 and
SSE instructions
AVX May generate Intel(R) AVX, SSE4.2, SSE4.1, SSSE3, SSE3,
SSE2 and SSE instructions
/Qinstruction:
Refine instruction set output for the selected target processor
[no]movbe - Do/do not generate MOVBE instructions with SSSE3_ATOM
(requires /QxSSSE3_ATOM)
/GR[-] enable/disable C++ RTTI
/Qcxx-features
enable standard C++ features (/GX /GR)
/EHa enable asynchronous C++ exception handling model
/EHs enable synchronous C++ exception handling model
/EHc assume extern "C" functions do not throw exceptions
/Qsafeseh[-]
Registers exceptions for safe exception handling (DEFAULT)
/Qregcall
make __regcall the default calling convention
/hotpatch[:n]
generate padding bytes for function entries to enable image
hotpatching. If specified, use 'n' as the padding.
/Qextend-arguments:[32|64]
By default, unprototyped scalar integer arguments are passed
in 32-bits (sign-extended if necessary).
On Intel(R) 64, unprototyped scalar integer arguments may be
extended to 64-bits.
Interprocedural Optimization (IPO)
----------------------------------
/Qip[-] enable(DEFAULT)/disable single-file IP optimization
within files
/Qipo enable multi-file IP optimization between files
/Qipo-c generate a multi-file object file (ipo_out.obj)
/Qipo-S generate a multi-file assembly file (ipo_out.asm)
/Qip-no-inlining
disable full and partial inlining
/Qip-no-pinlining
disable partial inlining
/Qipo-separate
create one object file for every source file (overrides /Qipo)
/Qipo-jobs
specify the number of jobs to be executed simultaneously during the
IPO link phase
Advanced Optimizations
----------------------
/Qunroll
set maximum number of times to unroll loops. Omit n to use default
heuristics. Use n=0 to disable the loop unroller
/Qunroll-aggressive[-]
enables more aggressive unrolling heuristics
/Qscalar-rep[-]
enable(DEFAULT)/disable scalar replacement (requires /O3)
/Qansi-alias[-]
enable/disable(DEFAULT) use of ANSI aliasing rules optimizations;
user asserts that the program adheres to these rules
/Qansi-alias-check[-]
enable(DEFAULT)/disable ANSI alias checking when using /Qansi-alias
/Qcomplex-limited-range[-]
enable/disable(DEFAULT) the use of the basic algebraic expansions of
some complex arithmetic operations. This can allow for some
performance improvement in programs which use a lot of complex
arithmetic at the loss of some exponent range.
/Qalias-const[-]
enable/disable(DEFAULT) a heuristic stating that if two arguments to
a function have pointer type, a pointer to const does not alias a
pointer to non-const. Also known as the input/output buffer rule, it
assumes that input and output buffer arguments do not overlap.
/Qalias-args[-]
enable(DEFAULT)/disable C/C++ rule that function arguments may be
aliased; when disabling the rule, the user asserts that this is safe
/Qopt-multi-version-aggressive[-]
enables more aggressive multi-versioning to check for pointer
aliasing and scalar replacement
/Qopt-ra-region-strategy[:]
select the method that the register allocator uses to partition each
routine into regions
routine - one region per routine
block - one region per block
trace - one region per trace
loop - one region per loop
default - compiler selects best option
/Qvec[-] enables(DEFAULT)/disables vectorization
/Qvec-guard-write[-]
enables cache/bandwidth optimization for stores under conditionals
within vector loops
/Qvec-threshold
sets a threshold for the vectorization of loops based on the
probability of profitable execution of the vectorized loop in
parallel
/Qopt-malloc-options:{0|1|2|3|4}
specify malloc configuration parameters. Specifying a non-zero
value will cause alternate configuration parameters to be set for
how malloc allocates and frees memory
/Qopt-jump-tables:
control the generation of jump tables
default - let the compiler decide when a jump table, a series of
if-then-else constructs or a combination is generated
large - generate jump tables up to a certain pre-defined size
(64K entries)
- generate jump tables up to in size
use /Qopt-jump-tables- to lower switch statements as chains of
if-then-else constructs
/Qopt-block-factor:
specify blocking factor for loop blocking
/Qfreestanding
compile in a freestanding environment where the standard library
may not be present
/Qopt-streaming-stores:
specifies whether streaming stores are generated
always - enables generation of streaming stores under the
assumption that the application is memory bound
auto - compiler decides when streaming stores are used (DEFAULT)
never - disables generation of streaming stores
/Qipp[:]
link some or all of the Intel(R) Integrated Performance Primitives
(Intel(R) IPP) libraries and bring in the associated headers
common - link using the main libraries set. This is the
default value when /Qipp is specified
crypto - link using the main libraries set and the crypto
library
gen - link using the main libraries set and the fixed
size generated functions library
/Qipp-link:
choose whether to link with static or dynamic libraries to support
Intel(R) Integrated Performance Primitives (Intel(R) IPP)
dynamic - link using the dynamic libraries set. This is the
default value when /Qipp is specified on Windows
static - link using the static libraries set. This is the
default value when /Qipp is specified on Linux
static_thread - link using the optional threaded libraries set
Note: these are provided in a separate install kit
/Qmkl[:]
link to the Intel(R) Math Kernel Library (Intel(R) MKL) and bring
in the associated headers
parallel - link using the threaded Intel(R) MKL libraries. This
is the default when /Qmkl is specified
sequential - link using the non-threaded Intel(R) MKL libraries
cluster - link using the Intel(R) MKL Cluster libraries plus
the sequential Intel(R) MKL libraries
/Qtbb link to the Intel(R) Threading Building Blocks (Intel(R) TBB)
libraries and bring in the associated headers
/Qopt-subscript-in-range[-]
assumes no overflows in the intermediate computation of the
subscripts
/Quse-intel-optimized-headers[-]
take advantage of the optimized header files
/Qcilk-serialize
run a Cilk program as a C/C++ serialized program
/Qvla[-] enable/disable(DEFAULT) Variable Length Arrays (C99 feature)
/Qintel-extensions[-]
enable(DEFAULT)/disable C/C++ language extensions such as array
notation, Intel(R) Cilk(TM) Plus language extensions, and
support for decimal floating-point types.
/Qopt-matmul[-]
replace matrix multiplication with calls to intrinsics and threading
libraries for improved performance (DEFAULT at /O3 /Qparallel)
/Qsimd[-]
enables(DEFAULT)/disables vectorization using simd pragma
/Qguide-opts:
tells the compiler to analyze certain code and generate
recommendations that may improve optimizations
/Qguide-file[:]
causes the results of guide to be output to a file
/Qguide-file-append[:]
causes the results of guide to be appended to a file
/Qguide[:]
lets you set a level (1 - 4) of guidance for auto-vectorization,
auto-parallelization, and data transformation (DEFAULT is 4 when the
option is specified)
/Qguide-data-trans[:]
lets you set a level (1 - 4) of guidance for data transformation
(DEFAULT is 4 when the option is specified)
/Qguide-par[:]
lets you set a level (1 - 4) of guidance for auto-parallelization
(DEFAULT is 4 when the option is specified)
/Qguide-vec[:]
lets you set a level (1 - 4) of guidance for auto-vectorization
(DEFAULT is 4 when the option is specified)
/Qguide-profile:<[file|dir]>[,[file|dir],...]
specify a loop profiler data file (or set of files in a directory)
when using the /Qguide option
/Qopt-mem-layout-trans[:]
controls the level of memory layout transformations performed by the
compiler
0 - disable memory layout transformations (same as
/Qopt-mem-layout-trans-)
1 - enable basic memory layout transformations
2 - enable more memory layout transformations (DEFAULT when the
option is specified)
3 - enable aggressive memory layout transformations
/Qopt-prefetch[:n]
enable levels of prefetch insertion, where 0 disables.
n may be 0 through 4 inclusive. Default is 2.
/Qopt-prefetch-
disable(DEFAULT) prefetch insertion. Equivalent to /Qopt-prefetch:0
Profile Guided Optimization (PGO)
---------------------------------
/Qprof-dir
specify directory for profiling output files (*.dyn and *.dpi)
/Qprof-src-root
specify project root directory for application source files to
enable relative path resolution during profile feedback on sources
below that directory
/Qprof-src-root-cwd
specify the current directory as the project root directory for
application source files to enable relative path resolution during
profile feedback on sources below that directory
/Qprof-src-dir[-]
specify whether directory names of sources should be
considered when looking up profile records within the .dpi file
/Qprof-file
specify file name for profiling summary file
/Qprof-data-order[-]
enable/disable(DEFAULT) static data ordering with profiling
/Qprof-func-order[-]
enable/disable(DEFAULT) function ordering with profiling
/Qprof-gen[:keyword]
instrument program for profiling.
Optional keyword may be srcpos or globdata
/Qprof-gen-
disable profiling instrumentation
/Qprof-use[:]
enable use of profiling information during optimization
weighted - invokes profmerge with -weighted option to scale data
based on run durations
[no]merge - enable(default)/disable the invocation of the profmerge
tool
/Qprof-use-
disable use of profiling information during optimization
/Qcov-gen
instrument program for profiling
/Qcov-dir
specify directory for profiling output files (*.dyn and *.dpi)
/Qcov-file
specify file name for profiling summary file
/Qinstrument-functions[-]
determine whether function entry and exit points are instrumented
/Qprof-hotness-threshold:
set the hotness threshold for function grouping and function ordering
val indicates percentage of functions to be placed in hot region.
This option requires /Qprof-use
and /Qprof-func-order
/Qprof-value-profiling:[,,...]
limit value profiling
none - inhibit all types of value profiling
nodivide - inhibit value profiling of non-compile time constants
used in division or remainder operations
noindcall - inhibit value profiling of function addresses at
indirect call sites
/Qprofile-functions
enable instrumentation in generated code for collecting
function execution time profiles
/Qprofile-loops:
enable instrumentation in generated code for collecting
loop execution time profiles
inner - instrument inner loops
outer - instrument outer loops
all - instrument all loops
/Qprofile-loops-report:
Control the level of instrumentation inserted for reporting loop
execution profiles
1 - report loop times
2 - report loop times and iteration counts
Optimization Reports
--------------------
/Qvec-report
control amount of vectorizer diagnostic information
n=0 no diagnostic information
n=1 indicate vectorized loops (DEFAULT when enabled)
n=2 indicate vectorized/non-vectorized loops
n=3 indicate vectorized/non-vectorized loops and prohibiting
data dependence information
n=4 indicate non-vectorized loops
n=5 indicate non-vectorized loops and prohibiting data
dependence information
n=6 indicate vectorized/non-vectorized loops with greater
details and prohibiting data dependence information
n=7 indicate vector code quality message ids and data values
for vectorized loops
/Qopt-report[:n]
generate an optimization report to stderr
0 disable optimization report output
1 minimum report output
2 medium output (DEFAULT when enabled)
3 maximum report output
/Qopt-report-file:
specify the filename for the generated report
/Qopt-report-phase:
specify the phase that reports are generated against
/Qopt-report-routine:
reports on routines containing the given name
/Qopt-report-help
display the optimization phases available for reporting
/Qtcheck[:mode]
enable analysis of threaded applications (requires Intel(R) Thread
Checker; cannot be used with compiler alone)
tci - instruments a program to perform a thread-count-independent
analysis
tcd - instruments a program to perform a thread-count-dependent
analysis (DEFAULT when mode is not used)
api - instruments a program at the api-imports level
/Qtcollect[:]
inserts instrumentation probes calling the Intel(R) Trace Collector
API. The library .lib is linked in the default being VT.lib
(requires Intel(R) Trace Collector)
/Qtcollect-filter:file
Enable or disable the instrumentation of specified functions.
(requires Intel(R) Trace Collector)
OpenMP* and Parallel Processing
------------------------------
/Qopenmp enable the compiler to generate multi-threaded code based on the
OpenMP* directives (same as /openmp)
/Qopenmp-stubs
enables the user to compile OpenMP programs in sequential mode. The
OpenMP directives are ignored and a stub OpenMP library is linked
(sequential)
/Qopenmp-report{0|1|2}
control the OpenMP parallelizer diagnostic level
/Qopenmp-lib:
choose which OpenMP library version to link with
compat - use the Microsoft compatible OpenMP run-time libraries
(DEFAULT)
/Qopenmp-task:
choose which OpenMP tasking model to support
omp - support OpenMP 3.0 tasking (DEFAULT)
intel - support Intel taskqueuing
/Qopenmp-threadprivate:
choose which threadprivate implementation to use
compat - use the Microsoft compatible thread local storage
legacy - use the Intel compatible implementation
(DEFAULT)
/Qparallel
enable the auto-parallelizer to generate multi-threaded code for
loops that can be safely executed in parallel
/Qpar-report{0|1|2|3}
control the auto-parallelizer diagnostic level
/Qpar-threshold
set threshold for the auto-parallelization of loops where n is an
integer from 0 to 100
/Qpar-runtime-control
Control parallelizer to generate runtime check code for effective
automatic parallelization.
n=0 no runtime check based auto-parallelization
n=1 generate runtime check code under conservative mode
(DEFAULT when enabled)
n=2 generate runtime check code under heuristic mode
n=3 generate runtime check code under aggressive mode
/Qpar-schedule-static[:n]
Specifies a scheduling algorithm for DO loop iteration.
Divides iterations into contiguous pieces. Size n if
specified, equal sized pieces if not.
/Qpar-schedule-static_balanced[:n]
Divides iterations into even-sized chunks. Size n if
specified, equal sized pieces if not.
/Qpar-schedule-static-steal[:n]
Divides iterations into even-sized chunks, but allows
threads to steal parts of chunks from neighboring threads
/Qpar-schedule-dynamic[:n]
Specifies a scheduling algorithm for DO loop iteration.
Assigns iterations to threads in chunks dynamically.
Chunk size is n iterations if specified, otherwise 1.
/Qpar-schedule-guided[:n]
Specifies a scheduling algorithm for DO loop iteration.
Indicates a minimum number of iterations. If specified,
n is the minimum number, otherwise 1.
/Qpar-schedule-guided-analytical[:n]
Divides iterations by using exponential distribution or
dynamic distributions.
/Qpar-schedule-runtime
Specifies a scheduling algorithm for DO loop iteration.
Defers the scheduling decision until runtime.
/Qpar-schedule-auto
Lets the compiler or run-time system determine the
scheduling algorithm.
/Qpar-adjust-stack
perform fiber-based main thread stack adjustment
/Qpar-affinity=[,...][,][,]
tune application performance by setting different thread affinity
/Qpar-num-threads=
tune application performance by setting different number of threads
/Qparallel-source-info[:n]
enable(DEFAULT)/disable the emission of source location information
for parallel code generation with OpenMP and auto-parallelization
0 - disable (same as /Qparallel-source-info-)
1 - emit routine name and line information (DEFAULT)
2 - emit path, file, routine name and line information
/Qpar same as /Qparallel
Floating Point
--------------
/fp:
enable floating point model variation
except[-] - enable/disable floating point semantics
fast[=1|2] - enables more aggressive floating point optimizations
precise - allows value-safe optimizations
source - enables intermediates in source precision
strict - enables /fp:precise /fp:except, disables
contractions and enables pragma stdc fenv_access
double - rounds intermediates in 53-bit (double) precision
extended - rounds intermediates in 64-bit (extended) precision
/Qfp-speculation:
enable floating point speculations with the following
conditions:
fast - speculate floating point operations (DEFAULT)
safe - speculate only when safe
strict - same as off
off - disables speculation of floating-point operations
/Qpc32 set internal FPU precision to 24 bit significand
/Qprec improve floating-point precision (speed impact less than /Op)
/Qprec-sqrt[-]
determine if certain square root optimizations are enabled
/Qprec-div[-]
improve precision of FP divides (some speed impact)
/Qfast-transcendentals[-]
generate a faster version of the transcendental functions
/Qfp-port[-]
round fp results at assignments and casts (some speed impact)
/Qfp-stack-check
enable fp stack checking after every function/procedure call
/Qrcd rounding mode to enable fast float-to-int conversions
/Qftz[-] enable/disable flush denormal results to zero
/Qfma[-] enable/disable the combining of floating point multiplies and
add/subtract operations
/Qfp-trap:[,,...]
control floating point traps at program start. can be of the
following values
[no]divzero - [Do not] trap on division by zero
[no]inexact - [Do not] trap on inexact result
[no]invalid - [Do not] trap on invalid operation
[no]overflow - [Do not] trap on overflow
[no]underflow - [Do not] trap on underflow
[no]denormal - [Do not] trap on denormal
all - enable trap on all of the above
none - trap on none of the above
common - trap on most commonly used IEEE traps
(invalid, division by zero, overflow)
/Qfp-trap-all:[,,...]
control floating point traps in every routine. can be of the
values specified in /Qfp-trap
Inlining
--------
/Ob control inline expansion:
n=0 disable inlining
n=1 inline functions declared with __inline, and perform C++
inlining
n=2 inline any function, at the compiler's discretion
/Qinline-min-size:
set size limit for inlining small routines
/Qinline-min-size-
no size limit for inlining small routines
/Qinline-max-size:
set size limit for inlining large routines
/Qinline-max-size-
no size limit for inlining large routines
/Qinline-max-total-size:
maximum increase in size for inline function expansion
/Qinline-max-total-size-
no size limit for inline function expansion
/Qinline-max-per-routine:
maximum number of inline instances in any function
/Qinline-max-per-routine-
no maximum number of inline instances in any function
/Qinline-max-per-compile:
maximum number of inline instances in the current compilation
/Qinline-max-per-compile-
no maximum number of inline instances in the current compilation
/Qinline-factor:
set inlining upper limits by n percentage
/Qinline-factor-
do not set set inlining upper limits
/Qinline-forceinline
treat inline routines as forceinline
/Qinline-dllimport
allow(DEFAULT)/disallow functions declared __declspec(dllimport) to
be inlined
/Qinline-calloc
directs the compiler to inline calloc() calls as malloc()/memset()
Output, Debug, PCH
------------------
/c compile to object (.obj) only, do not link
/S compile to assembly (.asm) only, do not link
/FAs produce assembly file with optional source annotations
/FAc produce assembly file with optional code annotations
/FA produce assembly file
/Fa[file]
name assembly file (or directory for multiple files; i.e. /FaMYDIR\)
/Fo[file]
name object file (or directory for multiple files; i.e. /FoMYDIR\)
/Fe[file]
name executable file or directory
/Fp[file]
name precompiled header file
/Zi, /ZI, /Z7
produce symbolic debug information in object file (implies /Od when
another optimization option is not explicitly set)
/debug[:keyword]
enable debug information and control output of enhanced debug
information
keywords: all, full, minimal, none, [no]inline-debug-info
[no]expr-source-pos
/Qtrapuv trap uninitialized variables
/RTCu report use of variable that was not initialized
/RTC1 equivalent to /RTCsu
/RTCs enable stack frame runtime checks
/RTCc enable checks for converting to smaller types
/Qmap-opts
enable option mapping tool
/Yc[file]
create precompiled header file
/Yu[file]
use precompiled header file
/Y- ignore all other precompiled header file options
/Qpchi[-]
enable(DEFAULT)/disable PCH coexistence, to reduce build time
/FD generate file dependencies
/FR[file]
name extended source browser file
/Qcheck-pointers:
Specifies what type of bounds checking occurs. Possible values are:
none - Disables bounds checking. This is the default.
rw - Checks bounds for reads and writes through pointers.
write - Checks bounds for writes through pointers only.
This switch is only valid with Intel(R) Parallel Studio XE
/Qcheck-pointers-dangling:
Specifies what type of dangling pointer checking occurs. Possible
values are:
none - Disables dangling pointer checking. This is the default.
heap - Check dangling references on heap.
stack - Check dangling references on stack.
all - Check dangling references on both heap and stack.
This switch is only valid with Intel(R) Parallel Studio XE
/Qcheck-pointers-undimensioned[-]
Bounds checking occurs for memory access through arrays that are
declared without dimensions. This checking occurs for both
dimensioned and undimensioned arrays.
This switch is only valid with Intel(R) Parallel Studio XE
Preprocessor
------------
/QA[]
create an assertion having value
/C do not strip comments
/D[{=|#}]
define macro
/U remove predefined macro
/E preprocess to stdout
/EP preprocess to stdout, omitting #line directives
/EP /P preprocess to file, omitting #line directives
/P preprocess to file
/u remove all predefined macros
/FI
force inclusion of file
/I add directory to include file search path
/X remove standard directories from include file search path
/QH print include file order
/QM generate makefile dependency information
/QMM similar to /QM, but do not include system header files
/QMG similar to /QM, but treat missing header files as generated files
/QMD preprocess and compile, generating output file containing dependency
information ending with extension .d
/QMMD similar to /QMD, but do not include system header files
/QMF
generate makefile dependency information in file (must specify /QM
or /QMM)
/QMT
change the default target rule for dependency generation
/QdM output macro definitions in effect after preprocessing (use with /E)
/QdD same as /QdM, but output #define directives in preprocessed source
/QdN same as /QdD, but #define directives contain only macro names
Component Control
-----------------
/Qoption,,
pass options to tool specified by
/Qlocation,,
set as the location of tool specified by
Language
--------
/Qstd=
enable language support for , as described below
c99 enable C99 support for C programs
c++11 enable C++11 experimental support for C++ programs
c++0x same as c++11
/Za disable Microsoft Visual C++ compiler language extensions
/Zg enable the generation of function prototypes
/Zp specify alignment constraint for structures where
n=1,2,4,8,16. 16 is the default
/Zc:arg1[,arg2]
specify standard conformance for the following arguments:
forScope[-] enforce standard compliance in for loop scope
wchar_t[-] specify that wchar_t is a native data type
auto[-] enforce compliance to the new standard meaning for auto
/Zs perform syntax and semantic checking only (no object file produced)
/vd{0|1} disable or enable hidden vtordisp field in C++ objects
/vm specify representation method for C++ pointers to members
/J change default char type to unsigned
/noBool suppresses the C++ bool, true, and false keywords
/Qtemplate-depth
control the depth in which recursive templates are expanded
/Qrestrict[-]
enable/disable the 'restrict' keyword for disambiguating pointers
/Qhelp-pragma
output supported pragmas and their usage syntax
/check:[,,...]
check run-time conditions.
keywords: [no]conversions, [no]stack, [no]uninit
Compiler Diagnostics
--------------------
/w disable all warnings
/W0 print only errors
/W1, /W2, /W3
print only errors and warnings (DEFAULT)
/W4, /Wall
print errors, warnings and most remarks
/W5 print all errors, warnings and remarks
/WL print brief one-line diagnostics
/WX force warnings to be reported as errors
/Werror-all
force warnings and currently enabled remarks to be reported as errors
/Wcheck enable more strict diagnostics
/Wport issue portability diagnostics
/Qeffc++ enable effective C++ diagnostic warnings
/Qwo[,,...]
issue diagnostics L1 through LN only once
/Wp64 print diagnostics for 64-bit porting
/Qdiag-enable:[,,...]
enable the specified diagnostics or diagnostic groups
/Qdiag-disable:[,,...]
disable the specified diagnostics or diagnostic groups
where may be individual diagnostic numbers or group names.
where group names include:
sc - perform source code analysis: n=1 for critical
errors, n=2 for all errors and n=3 for all errors
and warnings
sc-
{full|concise|precise} - perform static analysis and determine the analysis
mode.
Full mode - attempts to find all program weaknesses,
even at the expense of more false positives.
Concise mode - attempts to reduce false positives
somewhat more than reducing false negatives.
Precise mode - attempts to avoid all false positives
Default: full if /Qdiag-enable:sc{[1|2|3]} is
present; otherwise None
(static analysis diagnostics are disabled).
sc-include - perform source code analysis on include files
sc-single-file - This option tells static analysis to process each
file individually.
Default: OFF
sc-enums - This option tells static analysis to treat
enumeration variables as known values equal to any
one of the associated enumeration literals.
Default: OFF
sc-parallel - perform analysis of parallelization in
source code: n=1 for critical errors,
n=2 for errors, n=3 for all errors and
warnings
thread - enable diagnostics to aid in thread-enabling source
port-linux - enable diagnostics for Microsoft extensions that
may cause errors when porting to Linux/MacOS
warn - diagnostic messages that have "warning" severity level.
error - diagnostic messages that have "error" severity level.
remark - diagnostic messages that are remarks or comments.
vec - diagnostic messages issued by the vectorizer.
par - diagnostic messages issued by the auto-parallelizer
openmp - diagnostic messages issued by the OpenMP* parallelizer.
cpu-dispatch Specifies the CPU dispatch remarks.
/Qdiag-error:[,,...]
output the specified diagnostics or diagnostic groups as errors
/Qdiag-warning:[,,...]
output the specified diagnostics or diagnostic groups as warnings
/Qdiag-remark:[,,...]
output the the specified diagnostics or diagnostic groups as remarks
/Qdiag-dump
display the currently enabled diagnostic messages to stdout or to a
specified diagnostic output file.
/Qdiag-sc-dir: directory where diagnostics from static analysis are created,
rather than current working directory.
/Qdiag-file[:]
where diagnostics are emitted to. Not specifying this causes
messages to be output to stderr
/Qdiag-file-append[:]
where diagnostics are emitted to. When already exists,
output is appended to the file
/Qdiag-id-numbers[-]
enable(DEFAULT)/disable the diagnostic specifiers to be output in
numeric form
/Qdiag-error-limit:
specify the maximum number of errors emitted
/Qdiag-once:[,,...]
issue diagnostics v1 through vN only once
/Wpch-messages[-]
enable(DEFAULT)/disable PCH information messages
Miscellaneous
-------------
/nologo do not display compiler version information
/Qsox[:[,keyword]]
enable saving of compiler options, version and additional information
in the executable. Use /Qsox- to disable(DEFAULT)
profile - include profiling data
inline - include inlining information
/Qsave-temps
store the intermediate files in current directory and name them
based on the source file. Only saves files that are generated by
default
/watch:
tells the driver to output processing information
keywords: all, none (same as /nowatch), [no]source,
[no]cmd
[no]mic-cmd
/nowatch suppress processing information output (DEFAULT)
/Tc
compile file as C source
/Tp
compile file as C++ source
/TC
compile all source or unrecognized file types as C source files
/TP
compile all source or unrecognized file types as C++ source files
/showIncludes
emit include file names
/Qmultibyte-chars[-]
provide support for multi-byte characters
/MP[] create multiple processes that can be used to compile large numbers
of source files at the same time
/bigobj generate objects with increased address capacity
Data
----
/Zp specify alignment constraint for structures (n=1,2,4,8,16
/Zp16 DEFAULT)
/GS enable overflow security checks.
/GS- disables (DEFAULT)
/GF enable read-only string pooling optimization
/GA optimize for Windows application (assume .exe)
/GT enable fiber-safe thread local storage
/Qauto-ilp32
specify that the application cannot exceed a 32-bit address space
(/Qipo required)
/Qpatchable-addresses
generate code such that references to statically assigned addresses
can be patched with arbitrary 64-bit addresses.
/Qsfalign8
may align stack for functions with 8 or 16 byte vars (DEFAULT)
/Qsfalign16
may align stack for functions with 16 byte vars
/Qsfalign
force stack alignment for all functions
/Qsfalign-
disable stack alignment for all functions
/Qfnalign[-]
align the start of functions to an optimal machine-dependent value.
When disabled (DEFAULT) align on a 2-byte boundary
/Qfnalign:[2|16]
align the start of functions on a 2 (DEFAULT) or 16 byte boundary
/homeparams
force to store parameters passed in registers to the stack
/Qglobal-hoist[-]
enable(DEFAULT)/disable external globals are load safe
/Qkeep-static-consts[-]
enable/disable(DEFAULT) emission of static const variables even
when not referenced
/Qlong-double
enable 80-bit 'long double'
/Qnobss-init
disable placement of zero-initialized variables in BSS (use DATA)
/Qzero-initialized-in-bss[-]
put explicitly zero initialized variables into the DATA section
instead of the BSS section
/Qimf-absolute-error:value[:funclist]
define the maximum allowable absolute error for math library
function results
value - a positive, floating-point number conforming to the
format [digits][.digits][{e|E}[sign]digits]
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-accuracy-bits:bits[:funclist]
define the relative error, measured by the number of correct bits,
for math library function results
bits - a positive, floating-point number
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-arch-consistency:value[:funclist]
ensures that the math library functions produce consistent results
across different implementations of the same architecture
value - true or false
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-max-error:ulps[:funclist]
defines the maximum allowable relative error, measured in ulps, for
math library function results
ulps - a positive, floating-point number conforming to the
format [digits][.digits][{e|E}[sign]digits]
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
/Qimf-precision:value[:funclist]
defines the accuracy (precision) for math library functions
value - defined as one of the following values
high - equivalent to max-error = 0.6
medium - equivalent to max-error = 4 (DEFAULT)
low - equivalent to accuracy-bits = 11 (single
precision); accuracy-bits = 26 (double
precision)
funclist - optional comma separated list of one or more math
library functions to which the attribute should be
applied
Compatibility
-------------
/Qms allow compilation of certain dubious sources
n=0 disable Microsoft compatibility bugs
n=1 enable most Microsoft compatibilities (DEFAULT)
n=2 full Microsoft compatibility
/Qvc
enable compatibility with a specific Microsoft* Visual Studio version
9 - Microsoft* Visual Studio 2008 compatibility
10 - Microsoft* Visual Studio 2010 compatibility
11 - Microsoft* Visual Studio 2012 compatibility
/Qgcc-dialect:
enable a limited gcc-compatible dialect on Windows. The gcc
version may be specified as 440, 450 or 460.
Example: /Qgcc-dialect:440 -> gcc 4.4 compatibility
Linking/Linker
--------------
/link specify that all options following '/link' are for the linker
/F set the stack reserve amount specified to the linker
/LD produce a DLL instead of an EXE ('d' = debug version)
/MD use dynamically-loaded, multithread C runtime
/MT use statically-linked, multithread C runtime (DEFAULT with
Microsoft Visual Studio 2005 and later)
/ML use statically-linked, single thread C runtime (only valid in
Microsoft Visual Studio 2003 environment)
/Zl omit library names from object file
Deprecated Options
------------------
/Qinline-debug-info use /debug:inline-debug-info
/Gf use /GF
/ML upgrade to /MT
/Quse-asm No replacement
/Qprof-genx use /Qprof-gen:srcpos
/Qdiag-enable:sv[] use /Qdiag-enable:sc[]
/Qdiag-enable:sv-include use /Qdiag-enable:sc-include
/Qdiag-sv use /Qdiag-enable:sc[]
/Qdiag-sv-error use /Qdiag-disable:warning
/Qdiag-sv-include use /Qdiag-enable:sc-include
/Qdiag-sv-level No replacement
/Qdiag-sv-sup use /Qdiag-disable:[,,...]
/Qtprofile No replacement
/arch:SSE use /arch:IA32
/QxK upgrade to /arch:SSE2
/QaxK upgrade to /arch:SSE2
/QxW use /arch:SSE2
/QaxW use /arch:SSE2
/QxN use /QxSSE2
/QaxN use /QaxSSE2
/QxP use /QxSSE3
/QaxP use /QaxSSE3
/QxT use /QxSSSE3
/QaxT use /QaxSSSE3
/QxS use /QxSSE4.1
/QaxS use /QaxSSE4.1
/QxH use /QxSSE4.2
/QaxH use /QaxSSE4.2
/QxO use /arch:SSE3
/Qvc7.1 No replacement
/QIfist use /Qrcd
/QxSSE3_ATOM use /QxSSSE3_ATOM
/Qrct No replacement
/Op use /fp:precise
/Fr use /FR
/GX use /EHsc
/GZ use /RTC1
/H No replacement
/QA- use /u
/Qc99 use /Qstd=c99
/Qwn use /Qdiag-error-limit:
/Qwd use /Qdiag-disable
/Qwe use /Qdiag-error
/Qww use /Qdiag-warning
/Qwr use /Qdiag-remark
/Qwo use /Qdiag-once
/Yd use /Zi, /ZI, /Z7
/Zd use /debug:minimal
/Ze No replacement
/Zg No replacement
/help, /? [category] print full or category help message
Valid categories include
advanced - Advanced Optimizations
codegen - Code Generation
compatibility - Compatibility
component - Component Control
data - Data
deprecated - Deprecated Options
diagnostics - Compiler Diagnostics
float - Floating Point
help - Help
inline - Inlining
ipo - Interprocedural Optimization (IPO)
language - Language
link - Linking/Linker
misc - Miscellaneous
opt - Optimization
output - Output
pgo - Profile Guided Optimization (PGO)
preproc - Preprocessor
reports - Optimization Reports
openmp - OpenMP and Parallel Processing
Copyright (C) 1985-2013, Intel Corporation. All rights reserved.
* Other names and brands may be claimed as the property of others.
Tcc v1.0.1 16-bit Options
Turbo C++ Version 1.01 Copyright (c) 1990 Borland International
Syntax is: TCC [ options ] file * = default; -x- = turn switch x off
-1 80186/286 Instructions -2 80286 Protected Mode Inst.
-Ax Disable extensions -B Compile via assembly
-C Allow nested comments -Dxxx Define macro
-Exxx Alternate Assembler name -G Generate for speed
-Ixxx Include files directory -K Default char is unsigned
-Lxxx Libraries directory -M Generate link map
-N Check stack overflow -O Optimize jumps
-P Force C++ compile -Qxxx Memory usage control
-S Produce assembly output -Txxx Set assembler option
-Uxxx Undefine macro -Vx Virtual table control
-X Suppress autodep. output -Yx Overlay control
-Z Optimize register usage -a Generate word alignment
-b * Treat enums as integers -c Compile only
-d Merge duplicate strings -exxx Executable file name
-fxx Floating point options -gN Stop after N warnings
-iN Max. identifier length -jN Stop after N errors
-k Standard stack frame -lx Set linker option
-mx Set Memory Model -nxxx Output file directory
-oxxx Object file name -p Pascal calls
-r * Register variables -u * Underscores on externs
-v Source level debugging -wxxx Warning control
-y Produce line number info -zxxx Set segment names
Tcc v3.0.0 16-bit Options
Turbo C++ Version 3.00 Copyright (c) 1992 Borland International
Syntax is: TCC [ options ] file * = default; -x- = turn switch x off
-1 80186/286 Instructions -2 80286 Protected Mode Inst.
-Ax Disable extensions -B Compile via assembly
-C Allow nested comments -Dxxx Define macro
-Exxx Alternate Assembler name -G Generate for speed
-Ixxx Include files directory -K Default char is unsigned
-Lxxx Libraries directory -M Generate link map
-N Check stack overflow -O Optimize jumps
-P Force C++ compile -Qxxx Memory usage control
-S Produce assembly output -Txxx Set assembler option
-Uxxx Undefine macro -Vx Virtual table control
-X Suppress autodep. output -Yx Overlay control
-Z Suppress register reloads -a Generate word alignment
-b * Treat enums as integers -c Compile only
-d Merge duplicate strings -exxx Executable file name
-fxx Floating point options -gN Stop after N warnings
-iN Max. identifier length -jN Stop after N errors
-k Standard stack frame -lx Set linker option
-mx Set Memory Model -nxxx Output file directory
-oxxx Object file name -p Pascal calls
-r * Register variables -u * Underscores on externs
-v Source level debugging -wxxx Warning control
-y Produce line number info -zxxx Set segment names
Open Watcom v1.9.0 32-bit Options
Open Watcom C/C++32 Compile and Link Utility Version 1.9
Portions Copyright (c) 1988-2002 Sybase, Inc. All Rights Reserved.
Source code is available under the Sybase Open Watcom Public License.
See http://www.openwatcom.org/ for details.
Usage: wcl386 [options] file(s)
Options: ( /option is also accepted )
-c compile only, no link
-cc treat source files as C code
-cc++ treat source files as C++ code
-y ignore the WCL386 environment variable
[ Processor options ]
-3r 386 register calling conventions -5r Pentium register calling conv.
-3s 386 stack calling conventions -5s Pentium stack calling conventions
-4r 486 register calling conventions -6r Pentium Pro register call conven.
-4s 486 stack calling conventions -6s Pentium Pro stack call conven.
[ Floating-point processor options ]
-fpc calls to floating-point library -fp2 generate 287 floating-point code
-fpd enable Pentium FDIV check -fp3 generate 387 floating-point code
-fpi inline 80x87 with emulation -fp5 optimize f-p for Pentium
-fpi87 inline 80x87 -fp6 optimize f-p for Pentium Pro
-fpr use old floating-point conventions
[ Compiler options ]
-bcl= compile and link for OS. -nm= set module name
-bt= compile for target OS. -nt= set text segment name
-db generate browsing information -q operate quietly
-e= set error limit number -r save/restore segregs across calls
-ecc set calling conv. to __cdecl -ri promote function args/rets to int
-ecd set calling conv. to __stdcall -s remove stack overflow checks
-ecf set calling conv. to __fastcall -sg generate calls to grow the stack
-ecp set calling conv. to __pascal -st touch stack through SS first
-ecr set calling conv. to __fortran -v output func declarations to .def
-ecs set calling conv. to __syscall -vcap VC++ compat: alloca in arg lists
-ecw set calling conv. to __watcall -w= set warning level number
-ee call epilogue hook routine -wcd= disable warning message
-ef full paths in messages -wce= enable warning message
-ei force enums to be type int -we treat all warnings as errors
-em minimum base type for enum is int -wx set warning level to max
-en emit routine names in the code -xr (C++) enable RTTI
-ep[=] call prologue hook routine -z{a,e} disable/enable extensions
-eq do not display error messages -zc place strings in CODE segment
-et P5 profiling -zd{f,p} DS floats vs DS pegged to DGROUP
-ez generate PharLap EZ-OMF object -zdl load DS directly from DGROUP
-fh= pre-compiled headers -zf{f,p} FS floats vs FS pegged to seg
-fhq[=] fh without warnings -zg{f,p} GS floats vs GS pegged to seg
-fhr (C++) only read PCH -zg function prototype using base type
-fhw (C++) only write PCH -zk{0,0u,1,2,3,l} double-byte support
-fhwe (C++) don't count PCH warnings -zku= UNICODE support
-fi= force include of file -zl remove default library information
-fo= set object file name -zld remove file dependency information
-fr= set error file name -zm place functions in separate segments
-ft (C++) check for 8.3 file names -zmf (C++) zm with near calls allowed
-fx (C++) no check for 8.3 file names -zp{1,2,4,8,16} struct packing align.
-g= set code group name -zpw warning when padding a struct
-hc codeview debug format -zq operate quietly
-hd dwarf debug format -zs check syntax only
-hw watcom debug format -zt set data threshold
-j change char default to signed -zu SS != DGROUP
-m{f,s,m,c,l} memory model -zv (C++) enable virt. fun. removal opt
-nc= set CODE class name -zw generate code for MS Windows
-nd= set data segment name -zz remove @size from __stdcall func.
[ Debugging options ]
-d0 no debugging information -d2t (C++) d2 but without type names
-d1{+} line number debugging info. -d3 debug info with unref'd type names
-d2 full symbolic debugging info. -d3i (C++) d3 + inlines as COMDATs
-d2i (C++) d2 + inlines as COMDATs -d3s (C++) d3 + inlines as statics
-d2s (C++) d2 + inlines as statics
[ Optimization options ]
-oa relax alias checking -ol+ ol with loop unrolling
-ob branch prediction -om generate inline math functions
-oc disable call/ret optimization -on numerically unstable floating-point
-od disable optimizations -oo continue compile when low on memory
-oe[=num] expand functions inline -op improve floating-point consistency
-of[+] generate traceable stack frames -or re-order instructions to avoid stalls
-oh enable repeated optimizations -os optimize for space
-oi inline intrinsic functions -ot optimize for time
-oi+ (C++) oi with max inlining depth -ou ensure unique addresses for functions
-ok control flow entry/exit seq. -ox maximum optimization (-obmiler -s)
-ol perform loop optimizations
[ C++ exception handling options ]
-xd no exception handling -xs exception handling: balanced
-xds no exception handling: space -xss exception handling: space
-xdt no exception handling -xst exception handling: time
[ Preprocessor options ]
-d[=text] define a macro -u undefine macro name
-d+ extend syntax of -d option -pil ignore #line directives
-fo= set object file name -p{c,l,w=} preprocess source file
-i= include directory c -> preserve comments
-t= (C++) # of spaces in tab stop l -> insert #line directives
-tp= (C) set #pragma on( w= -> wrap output at column n
[ Linker options ]
-bd build Dynamic link library -fm[=] generate map file
-bm build Multi-thread application -k set stack size
-br build with dll run-time library -l= link for the specified OS
-bw build default Windowing app. -x make names case sensitive
-bcl= compile and link for OS. @ additional directive file
-fd[=[.lnk]] write directives -""
-fe= name executable file
Open Watcom v2.0.0 32-bit Options
Open Watcom C/C++ x86 32-bit Compile and Link Utility
Version 2.0 beta Apr 2 2015 11:06:50 (32-bit)
Copyright (c) 2002-2015 The Open Watcom Contributors. All Rights Reserved.
Portions Copyright (c) 1988-2002 Sybase, Inc. All Rights Reserved.
Source code is available under the Sybase Open Watcom Public License.
See http://www.openwatcom.org/ for details.
Usage: wcl386 [options] file(s)
Options: ( /option is also accepted )
-c compile only, no link
-cc treat source files as C code
-cc++ treat source files as C++ code
-y ignore the WCL386 environment variable
[ Processor options ]
-3r 386 register calling conventions -5r Pentium register calling conv.
-3s 386 stack calling conventions -5s Pentium stack calling conventions
-4r 486 register calling conventions -6r Pentium Pro register call conven.
-4s 486 stack calling conventions -6s Pentium Pro stack call conven.
[ Floating-point processor options ]
-fpc calls to floating-point library -fp2 generate 287 floating-point code
-fpd enable Pentium FDIV check -fp3 generate 387 floating-point code
-fpi inline 80x87 with emulation -fp5 optimize f-p for Pentium
-fpi87 inline 80x87 -fp6 optimize f-p for Pentium Pro
-fpr use old floating-point conventions
[ Compiler options ]
-bcl= compile and link for OS. -nt= set text segment name
-bt= compile for target OS. -q operate quietly
-db generate browsing information -r save/restore segregs across calls
-e= set error limit number -ri promote function args/rets to int
-ecc set calling conv. to __cdecl -s remove stack overflow checks
-ecd set calling conv. to __stdcall -sg generate calls to grow the stack
-ecf set calling conv. to __fastcall -st touch stack through SS first
-ecp set calling conv. to __pascal -v output func declarations to .def
-ecr set calling conv. to __fortran -vcap VC++ compat: alloca in arg lists
-ecs set calling conv. to __syscall -w= set warning level number
-ecw set calling conv. to __watcall -wcd= disable warning message
-ee call epilogue hook routine -wce= enable warning message
-ef full paths in messages -we treat all warnings as errors
-ei force enums to be type int -wx set warning level to max
-em minimum base type for enum is int -x preprocessor ignores env.variables
-en emit routine names in the code -xr (C++) enable RTTI
-ep[=] call prologue hook routine -z{a,e} disable/enable extensions
-eq do not display error messages -zc place strings in CODE segment
-et P5 profiling -zd{f,p} DS floats vs DS pegged to DGROUP
-ez generate PharLap EZ-OMF object -zdl load DS directly from DGROUP
-fh= pre-compiled headers -zf{f,p} FS floats vs FS pegged to seg
-fhq[=] fh without warnings -zg{f,p} GS floats vs GS pegged to seg
-fhr (C++) only read PCH -zg function prototype using base type
-fhw (C++) only write PCH -zk{0,0u,1,2,3,l} double-byte support
-fhwe (C++) don't count PCH warnings -zku= UNICODE support
-fi= force include of file -zl remove default library information
-fo= set object file name -zld remove file dependency information
-fr= set error file name -zm place functions in separate segments
-ft (C++) check for 8.3 file names -zmf (C++) zm with near calls allowed
-fx (C++) no check for 8.3 file names -zp{1,2,4,8,16} struct packing align.
-g= set code group name -zpw warning when padding a struct
-hc codeview debug format -zq operate quietly
-hd dwarf debug format -zs check syntax only
-hw watcom debug format -zt set data threshold
-j change char default to signed -zu SS != DGROUP
-m{f,s,m,c,l} memory model -zv (C++) enable virt. fun. removal opt
-nc= set CODE class name -zw generate code for MS Windows
-nd= set data segment name -zz remove @size from __stdcall func.
-nm= set module name
[ Debugging options ]
-d0 no debugging information -d2t (C++) d2 but without type names
-d1{+} line number debugging info. -d3 debug info with unref'd type names
-d2 full symbolic debugging info. -d3i (C++) d3 + inlines as COMDATs
-d2i (C++) d2 + inlines as COMDATs -d3s (C++) d3 + inlines as statics
-d2s (C++) d2 + inlines as statics
[ Optimization options ]
-oa relax alias checking -ol+ ol with loop unrolling
-ob branch prediction -om generate inline math functions
-oc disable call/ret optimization -on numerically unstable floating-point
-od disable optimizations -oo continue compile when low on memory
-oe[=num] expand functions inline -op improve floating-point consistency
-of[+] generate traceable stack frames-or re-order instructions to avoid stalls
-oh enable repeated optimizations -os optimize for space
-oi inline intrinsic functions -ot optimize for time
-oi+ (C++) oi with max inlining depth -ou ensure unique addresses for functions
-ok control flow entry/exit seq. -ox maximum optimization (-obmiler -s)
-ol perform loop optimizations
[ C++ exception handling options ]
-xd no exception handling -xs exception handling: balanced
-xds no exception handling: space -xss exception handling: space
-xdt no exception handling -xst exception handling: time
[ Preprocessor options ]
-d[=text] define a macro -u undefine macro name
-d+ extend syntax of -d option -pil ignore #line directives
-fo= set object file name -p{c,l,w=} preprocess source file
-i= include directory c -> preserve comments
-t= (C++) # of spaces in tab stop l -> insert #line directives
-tp= (C) set #pragma on( w= -> wrap output at column n
[ Linker options ]
-bd build Dynamic link library -fe= name executable file
-bm build Multi-thread application -fm[=] generate map file
-br build with dll run-time library -k set stack size
-bw build default Windowing app. -l= link for the specified OS
-bcl= compile and link for OS. @ additional directive file
-fd[=[.lnk]] write directives -""
Open Watcom v2.0.0 64-bit Options
Open Watcom C/C++ x86 32-bit Compile and Link Utility
Version 2.0 beta Apr 2 2015 10:17:07 (64-bit)
Copyright (c) 2002-2015 The Open Watcom Contributors. All Rights Reserved.
Portions Copyright (c) 1988-2002 Sybase, Inc. All Rights Reserved.
Source code is available under the Sybase Open Watcom Public License.
See http://www.openwatcom.org/ for details.
Usage: wcl386 [options] file(s)
Options: ( /option is also accepted )
-c compile only, no link
-cc treat source files as C code
-cc++ treat source files as C++ code
-y ignore the WCL386 environment variable
[ Processor options ]
-3r 386 register calling conventions -5r Pentium register calling conv.
-3s 386 stack calling conventions -5s Pentium stack calling conventions
-4r 486 register calling conventions -6r Pentium Pro register call conven.
-4s 486 stack calling conventions -6s Pentium Pro stack call conven.
[ Floating-point processor options ]
-fpc calls to floating-point library -fp2 generate 287 floating-point code
-fpd enable Pentium FDIV check -fp3 generate 387 floating-point code
-fpi inline 80x87 with emulation -fp5 optimize f-p for Pentium
-fpi87 inline 80x87 -fp6 optimize f-p for Pentium Pro
-fpr use old floating-point conventions
[ Compiler options ]
-bcl= compile and link for OS. -nt= set text segment name
-bt= compile for target OS. -q operate quietly
-db generate browsing information -r save/restore segregs across calls
-e= set error limit number -ri promote function args/rets to int
-ecc set calling conv. to __cdecl -s remove stack overflow checks
-ecd set calling conv. to __stdcall -sg generate calls to grow the stack
-ecf set calling conv. to __fastcall -st touch stack through SS first
-ecp set calling conv. to __pascal -v output func declarations to .def
-ecr set calling conv. to __fortran -vcap VC++ compat: alloca in arg lists
-ecs set calling conv. to __syscall -w= set warning level number
-ecw set calling conv. to __watcall -wcd= disable warning message
-ee call epilogue hook routine -wce= enable warning message
-ef full paths in messages -we treat all warnings as errors
-ei force enums to be type int -wx set warning level to max
-em minimum base type for enum is int -x preprocessor ignores env.variables
-en emit routine names in the code -xr (C++) enable RTTI
-ep[=] call prologue hook routine -z{a,e} disable/enable extensions
-eq do not display error messages -zc place strings in CODE segment
-et P5 profiling -zd{f,p} DS floats vs DS pegged to DGROUP
-ez generate PharLap EZ-OMF object -zdl load DS directly from DGROUP
-fh= pre-compiled headers -zf{f,p} FS floats vs FS pegged to seg
-fhq[=] fh without warnings -zg{f,p} GS floats vs GS pegged to seg
-fhr (C++) only read PCH -zg function prototype using base type
-fhw (C++) only write PCH -zk{0,0u,1,2,3,l} double-byte support
-fhwe (C++) don't count PCH warnings -zku= UNICODE support
-fi= force include of file -zl remove default library information
-fo= set object file name -zld remove file dependency information
-fr= set error file name -zm place functions in separate segments
-ft (C++) check for 8.3 file names -zmf (C++) zm with near calls allowed
-fx (C++) no check for 8.3 file names -zp{1,2,4,8,16} struct packing align.
-g= set code group name -zpw warning when padding a struct
-hc codeview debug format -zq operate quietly
-hd dwarf debug format -zs check syntax only
-hw watcom debug format -zt set data threshold
-j change char default to signed -zu SS != DGROUP
-m{f,s,m,c,l} memory model -zv (C++) enable virt. fun. removal opt
-nc= set CODE class name -zw generate code for MS Windows
-nd= set data segment name -zz remove @size from __stdcall func.
-nm= set module name
[ Debugging options ]
-d0 no debugging information -d2t (C++) d2 but without type names
-d1{+} line number debugging info. -d3 debug info with unref'd type names
-d2 full symbolic debugging info. -d3i (C++) d3 + inlines as COMDATs
-d2i (C++) d2 + inlines as COMDATs -d3s (C++) d3 + inlines as statics
-d2s (C++) d2 + inlines as statics
[ Optimization options ]
-oa relax alias checking -ol+ ol with loop unrolling
-ob branch prediction -om generate inline math functions
-oc disable call/ret optimization -on numerically unstable floating-point
-od disable optimizations -oo continue compile when low on memory
-oe[=num] expand functions inline -op improve floating-point consistency
-of[+] generate traceable stack frames -or re-order instructions to avoid stalls
-oh enable repeated optimizations -os optimize for space
-oi inline intrinsic functions -ot optimize for time
-oi+ (C++) oi with max inlining depth -ou ensure unique addresses for functions
-ok control flow entry/exit seq. -ox maximum optimization (-obmiler -s)
-ol perform loop optimizations
[ C++ exception handling options ]
-xd no exception handling -xs exception handling: balanced
-xds no exception handling: space -xss exception handling: space
-xdt no exception handling -xst exception handling: time
[ Preprocessor options ]
-d[=text] define a macro -u undefine macro name
-d+ extend syntax of -d option -pil ignore #line directives
-fo= set object file name -p{c,l,w=} preprocess source file
-i= include directory c -> preserve comments
-t= (C++) # of spaces in tab stop l -> insert #line directives
-tp= (C) set #pragma on( w= -> wrap output at column n
[ Linker options ]
-bd build Dynamic link library -fe= name executable file
-bm build Multi-thread application -fm[=] generate map file
-br build with dll run-time library -k set stack size
-bw build default Windowing app. -l= link for the specified OS
-bcl= compile and link for OS. @ additional directive file
-fd[=[.lnk]] write directives -""
VS1998PE 32-bit Options
C/C++ COMPILER OPTIONS
-OPTIMIZATION-
/O1 minimize space /Op[-] improve floating-pt consistency
/O2 maximize speed /Os favor code space
/Oa assume no aliasing /Ot favor code speed
/Ob inline expansion (default n=0) /Ow assume cross-function aliasing
/Od disable optimizations (default) /Ox maximum opts. (/Ogityb1 /Gs)
/Og enable global optimization /Oy[-] enable frame pointer omission
/Oi enable intrinsic functions
-CODE GENERATION-
/G3 optimize for 80386 /Gy separate functions for linker
/G4 optimize for 80486 /Ge force stack checking for all funcs
/G5 optimize for Pentium /Gs[num] disable stack checking calls
/G6 optimize for Pentium Pro /Gh enable hook function call
/GB optimize for blended model (default) /GR[-] enable C++ RTTI
/Gd __cdecl calling convention /GX[-] enable C++ EH (same as /EHsc)
/Gr __fastcall calling convention /Gi[-] enable incremental compilation
/Gz __stdcall calling convention /Gm[-] enable minimal rebuild
/GA optimize for Windows Application /EHs enable synchronous C++ EH
/GD optimize for Windows DLL /EHa enable asynchronous C++ EH
/Gf enable string pooling /EHc extern "C" defaults to nothrow
/GF enable read-only string pooling /QIfdiv[-] enable Pentium FDIV fix
/GZ enable runtime debug checks /QI0f[-] enable Pentium 0x0f fix
-OUTPUT FILES-
/Fa[file] name assembly listing file /Fo name object file
/FA[sc] configure assembly listing /Fp name precompiled header file
/Fd[file] name .PDB file /Fr[file] name source browser file
/Fe name executable file /FR[file] name extended .SBR file
/Fm[file] name map file
-PREPROCESSOR-
/C don't strip comments /FI name forced include file
/D{=|#} define macro /U remove predefined macro
/E preprocess to stdout /u remove all predefined macros
/EP preprocess to stdout, no #line /I add to include search path
/P preprocess to file /X ignore "standard places"
-LANGUAGE-
/Zi enable debugging information /Zl omit default library name in .OBJ
/ZI enable Edit and Continue debug info /Zg generate function prototypes
/Z7 enable old-style debug info /Zs syntax check only
/Zd line number debugging info only /vd{0|1} disable/enable vtordisp
/Zp pack structs on n-byte boundary /vm type of pointers to members
/Za disable extensions (implies /Op) /noBool disable "bool" keyword
/Ze enable extensions (default)
-MISCELLANEOUS-
/?, /help print this help message /V set version string
/c compile only, no link /w disable all warnings
/H max external name length /W set warning level (default n=1)
/J default char type is unsigned /WX treat warnings as errors
/nologo suppress copyright message /Yc[file] create .PCH file
/Tc compile file as .c /Yd put debug info in every .OBJ
/Tp compile file as .cpp /Yu[file] use .PCH file
/TC compile all files as .c /YX[file] automatic .PCH
/TP compile all files as .cpp /Zm max memory alloc (% of default)
-LINKING-
/MD link with MSVCRT.LIB /MDd link with MSVCRTD.LIB debug lib
/ML link with LIBC.LIB /MLd link with LIBCD.LIB debug lib
/MT link with LIBCMT.LIB /MTd link with LIBCMTD.LIB debug lib
/LD Create .DLL /F set stack size
/LDd Create .DLL debug libary /link [linker options and libraries]
VS2005PE 32-bit Options
C/C++ COMPILER OPTIONS
-OPTIMIZATION-
/O1 minimize space /O2 maximize speed
/Ob inline expansion (default n=0) /Od disable optimizations (default)
/Og enable global optimization /Oi[-] enable intrinsic functions
/Os favor code space /Ot favor code speed
/Ox maximum optimizations /Oy[-] enable frame pointer omission
-CODE GENERATION-
/GF enable read-only string pooling /Gm[-] enable minimal rebuild
/Gy[-] separate functions for linker /GS[-] enable security checks
/GR[-] enable C++ RTTI /GX[-] enable C++ EH (same as /EHsc)
/EHs enable C++ EH (no SEH exceptions) /EHa enable C++ EH (w/ SEH exceptions)
/EHc extern "C" defaults to nothrow
/fp: choose floating-point model:
except[-] - consider floating-point exceptions when generating code
fast - "fast" floating-point model; results are less predictable
precise - "precise" floating-point model; results are predictable
strict - "strict" floating-point model (implies /fp:except)
/GL[-] enable link-time code generation /GA optimize for Windows Application
/Ge force stack checking for all funcs /Gs[num] control stack checking calls
/Gh enable _penter function call /GH enable _pexit function call
/GT generate fiber-safe TLS accesses /RTC1 Enable fast checks (/RTCsu)
/RTCc Convert to smaller type checks /RTCs Stack Frame runtime checking
/RTCu Uninitialized local usage checks
/clr[:option] compile for common language runtime, where option is:
pure - produce IL-only output file (no native executable code)
safe - produce IL-only verifiable output file
oldSyntax - accept the Managed Extensions syntax from Visual C++ 2002/2003
initialAppDomain - enable initial AppDomain behavior of Visual C++ 2002
noAssembly - do not produce an assembly
/Gd __cdecl calling convention /Gr __fastcall calling convention
/Gz __stdcall calling convention /GZ Enable stack checks (/RTCs)
/QIfist[-] use FIST instead of ftol()
/hotpatch ensure function padding for hotpatchable images
/arch: minimum CPU architecture requirements, one of:
SSE - enable use of instructions available with SSE enabled CPUs
SSE2 - enable use of instructions available with SSE2 enabled CPUs
-OUTPUT FILES-
/Fa[file] name assembly listing file /FA[scu] configure assembly listing
/Fd[file] name .PDB file /Fe name executable file
/Fm[file] name map file /Fo name object file
/Fp name precompiled header file /Fr[file] name source browser file
/FR[file] name extended .SBR file
/doc[file] process XML documentation comments and optionally name the .xdc file
-PREPROCESSOR-
/AI add to assembly search path /FU forced using assembly/module
/C don't strip comments /D{=|#} define macro
/E preprocess to stdout /EP preprocess to stdout, no #line
/P preprocess to file /Fx merge injected code to file
/FI name forced include file /U remove predefined macro
/u remove all predefined macros /I add to include search path
/X ignore "standard places"
-LANGUAGE-
/Zi enable debugging information /Z7 enable old-style debug info
/Zp pack structs on n-byte boundary /Za disable extensions
/Ze enable extensions (default) /Zl omit default library name in .OBJ
/Zg generate function prototypes /Zs syntax check only
/vd{0|1|2} disable/enable vtordisp /vm type of pointers to members
/Zc:arg1[,arg2] C++ language conformance, where arguments can be:
forScope[-] - enforce Standard C++ for scoping rules
wchar_t[-] - wchar_t is the native type, not a typedef
/ZI enable Edit and Continue debug info
/openmp enable OpenMP 2.0 language extensions
-MISCELLANEOUS-
@ options response file /?, /help print this help message
/bigobj generate extended object format /c compile only, no link
/errorReport:option Report internal compiler errors to Microsoft
none - do not send report
prompt - prompt to immediately send report
queue - at next admin logon, prompt to send report (default)
send - send report automatically
/FC use full pathnames in diagnostics /H max external name length
/J default char type is unsigned /nologo suppress copyright message
/showIncludes show include file names /Tc compile file as .c
/Tp compile file as .cpp /TC compile all files as .c
/TP compile all files as .cpp /V set version string
/w disable all warnings /wd disable warning n
/we treat warning n as an error /wo issue warning n once
/w set warning level 1-4 for n /W set warning level (default n=1)
/Wall enable all warnings /WL enable one line diagnostics
/WX treat warnings as errors /Yc[file] create .PCH file
/Yd put debug info in every .OBJ /Yl[sym] inject .PCH ref for debug lib
/Yu[file] use .PCH file /Y- disable all PCH options
/Zm max memory alloc (% of default) /Wp64 enable 64 bit porting warnings
-LINKING-
/LD Create .DLL /LDd Create .DLL debug library
/LN Create a .netmodule /F set stack size
/link [linker options and libraries] /MD link with MSVCRT.LIB
/MT link with LIBCMT.LIB /MDd link with MSVCRTD.LIB debug lib
/MTd link with LIBCMTD.LIB debug lib
VS2005PE 64-bit Options
C/C++ COMPILER OPTIONS
-OPTIMIZATION-
/O1 minimize space /O2 maximize speed
/Ob inline expansion (default n=0) /Od disable optimizations (default)
/Og enable global optimization /Oi[-] enable intrinsic functions
/Os favor code space /Ot favor code speed
/Ox maximum optimizations
/favor: select processor to optimize for, one of:
blend - a combination of optimizations for several different x64 processors
AMD64 - 64-bit AMD processors
EM64T - Intel Pentium processors supporting EM64T
-CODE GENERATION-
/GF enable read-only string pooling /Gm[-] enable minimal rebuild
/Gy[-] separate functions for linker /GS[-] enable security checks
/GR[-] enable C++ RTTI /GX[-] enable C++ EH (same as /EHsc)
/EHs enable C++ EH (no SEH exceptions) /EHa enable C++ EH (w/ SEH exceptions)
/EHc extern "C" defaults to nothrow
/fp: choose floating-point model:
except[-] - consider floating-point exceptions when generating code
fast - "fast" floating-point model; results are less predictable
precise - "precise" floating-point model; results are predictable
strict - "strict" floating-point model (implies /fp:except)
/GL[-] enable link-time code generation /GA optimize for Windows Application
/Ge force stack checking for all funcs /Gs[num] control stack checking calls
/Gh enable _penter function call /GH enable _pexit function call
/GT generate fiber-safe TLS accesses /RTC1 Enable fast checks (/RTCsu)
/RTCc Convert to smaller type checks /RTCs Stack Frame runtime checking
/RTCu Uninitialized local usage checks
/clr[:option] compile for common language runtime, where option is:
pure - produce IL-only output file (no native executable code)
safe - produce IL-only verifiable output file
oldSyntax - accept the Managed Extensions syntax from Visual C++ 2002/2003
initialAppDomain - enable initial AppDomain behavior of Visual C++ 2002
noAssembly - do not produce an assembly
/homeparams Force parameters passed in registers to be written to the stack
/GZ Enable stack checks (/RTCs)
-OUTPUT FILES-
/Fa[file] name assembly listing file /FA[scu] configure assembly listing
/Fd[file] name .PDB file /Fe name executable file
/Fm[file] name map file /Fo name object file
/Fp name precompiled header file /Fr[file] name source browser file
/FR[file] name extended .SBR file
/doc[file] process XML documentation comments and optionally name the .xdc file
-PREPROCESSOR-
/AI add to assembly search path /FU forced using assembly/module
/C don't strip comments /D{=|#} define macro
/E preprocess to stdout /EP preprocess to stdout, no #line
/P preprocess to file /Fx merge injected code to file
/FI name forced include file /U remove predefined macro
/u remove all predefined macros /I add to include search path
/X ignore "standard places"
-LANGUAGE-
/Zi enable debugging information /Z7 enable old-style debug info
/Zp pack structs on n-byte boundary /Za disable extensions
/Ze enable extensions (default) /Zl omit default library name in .OBJ
/Zg generate function prototypes /Zs syntax check only
/vd{0|1|2} disable/enable vtordisp /vm type of pointers to members
/Zc:arg1[,arg2] C++ language conformance, where arguments can be:
forScope[-] - enforce Standard C++ for scoping rules
wchar_t[-] - wchar_t is the native type, not a typedef
/openmp enable OpenMP 2.0 language extensions
-MISCELLANEOUS-
@ options response file /?, /help print this help message
/bigobj generate extended object format /c compile only, no link
/errorReport:option Report internal compiler errors to Microsoft
none - do not send report
prompt - prompt to immediately send report
queue - at next admin logon, prompt to send report (default)
send - send report automatically
/FC use full pathnames in diagnostics /H max external name length
/J default char type is unsigned /nologo suppress copyright message
/showIncludes show include file names /Tc compile file as .c
/Tp compile file as .cpp /TC compile all files as .c
/TP compile all files as .cpp /V set version string
/w disable all warnings /wd disable warning n
/we treat warning n as an error /wo issue warning n once
/w set warning level 1-4 for n /W set warning level (default n=1)
/Wall enable all warnings /WL enable one line diagnostics
/WX treat warnings as errors /Yc[file] create .PCH file
/Yd put debug info in every .OBJ /Yl[sym] inject .PCH ref for debug lib
/Yu[file] use .PCH file /Y- disable all PCH options
/Zm max memory alloc (% of default) /Wp64 enable 64 bit porting warnings
-LINKING-
/LD Create .DLL /LDd Create .DLL debug library
/LN Create a .netmodule /F set stack size
/link [linker options and libraries] /MD link with MSVCRT.LIB
/MT link with LIBCMT.LIB /MDd link with MSVCRTD.LIB debug lib
/MTd link with LIBCMTD.LIB debug lib
VS2008EE 32-bit Options
C/C++ COMPILER OPTIONS
-OPTIMIZATION-
/O1 minimize space /O2 maximize speed
/Ob inline expansion (default n=0) /Od disable optimizations (default)
/Og enable global optimization /Oi[-] enable intrinsic functions
/Os favor code space /Ot favor code speed
/Ox maximum optimizations /Oy[-] enable frame pointer omission
-CODE GENERATION-
/GF enable read-only string pooling /Gm[-] enable minimal rebuild
/Gy[-] separate functions for linker /GS[-] enable security checks
/GR[-] enable C++ RTTI /GX[-] enable C++ EH (same as /EHsc)
/EHs enable C++ EH (no SEH exceptions) /EHa enable C++ EH (w/ SEH exceptions)
/EHc extern "C" defaults to nothrow
/fp: choose floating-point model:
except[-] - consider floating-point exceptions when generating code
fast - "fast" floating-point model; results are less predictable
precise - "precise" floating-point model; results are predictable
strict - "strict" floating-point model (implies /fp:except)
/Qfast_transcendentals generate inline FP intrinsics even with /fp:except
/GL[-] enable link-time code generation /GA optimize for Windows Application
/Ge force stack checking for all funcs /Gs[num] control stack checking calls
/Gh enable _penter function call /GH enable _pexit function call
/GT generate fiber-safe TLS accesses /RTC1 Enable fast checks (/RTCsu)
/RTCc Convert to smaller type checks /RTCs Stack Frame runtime checking
/RTCu Uninitialized local usage checks
/clr[:option] compile for common language runtime, where option is:
pure - produce IL-only output file (no native executable code)
safe - produce IL-only verifiable output file
oldSyntax - accept the Managed Extensions syntax from Visual C++ 2002/2003
initialAppDomain - enable initial AppDomain behavior of Visual C++ 2002
noAssembly - do not produce an assembly
/Gd __cdecl calling convention /Gr __fastcall calling convention
/Gz __stdcall calling convention /GZ Enable stack checks (/RTCs)
/QIfist[-] use FIST instead of ftol()
/hotpatch ensure function padding for hotpatchable images
/arch: minimum CPU architecture requirements, one of:
SSE - enable use of instructions available with SSE enabled CPUs
SSE2 - enable use of instructions available with SSE2 enabled CPUs
/Qimprecise_fwaits generate FWAITs only on "try" boundaries, not inside "try"
-OUTPUT FILES-
/Fa[file] name assembly listing file /FA[scu] configure assembly listing
/Fd[file] name .PDB file /Fe name executable file
/Fm[file] name map file /Fo name object file
/Fp name precompiled header file /Fr[file] name source browser file
/FR[file] name extended .SBR file
/doc[file] process XML documentation comments and optionally name the .xdc file
-PREPROCESSOR-
/AI add to assembly search path /FU forced using assembly/module
/C don't strip comments /D{=|#} define macro
/E preprocess to stdout /EP preprocess to stdout, no #line
/P preprocess to file /Fx merge injected code to file
/FI name forced include file /U remove predefined macro
/u remove all predefined macros /I add to include search path
/X ignore "standard places"
-LANGUAGE-
/Zi enable debugging information /Z7 enable old-style debug info
/Zp pack structs on n-byte boundary /Za disable extensions
/Ze enable extensions (default) /Zl omit default library name in .OBJ
/Zg generate function prototypes /Zs syntax check only
/vd{0|1|2} disable/enable vtordisp /vm type of pointers to members
/Zc:arg1[,arg2] C++ language conformance, where arguments can be:
forScope[-] - enforce Standard C++ for scoping rules
wchar_t[-] - wchar_t is the native type, not a typedef
/ZI enable Edit and Continue debug info
/openmp enable OpenMP 2.0 language extensions
-MISCELLANEOUS-
@ options response file /?, /help print this help message
/bigobj generate extended object format /c compile only, no link
/errorReport:option Report internal compiler errors to Microsoft
none - do not send report
prompt - prompt to immediately send report
queue - at next admin logon, prompt to send report (default)
send - send report automatically
/FC use full pathnames in diagnostics /H max external name length
/J default char type is unsigned
/MP use up to 'n' processes for compilation
/nologo suppress copyright message /showIncludes show include file names
/Tc compile file as .c /Tp compile file as .cpp
/TC compile all files as .c /TP compile all files as .cpp
/V set version string /w disable all warnings
/wd disable warning n /we treat warning n as an error
/wo issue warning n once /w set warning level 1-4 for n
/W set warning level (default n=1) /Wall enable all warnings
/WL enable one line diagnostics /WX treat warnings as errors
/Yc[file] create .PCH file /Yd put debug info in every .OBJ
/Yl[sym] inject .PCH ref for debug lib /Yu[file] use .PCH file
/Y- disable all PCH options /Zm max memory alloc (% of default)
/Wp64 enable 64 bit porting warnings
-LINKING-
/LD Create .DLL /LDd Create .DLL debug library
/LN Create a .netmodule /F set stack size
/link [linker options and libraries] /MD link with MSVCRT.LIB
/MT link with LIBCMT.LIB /MDd link with MSVCRTD.LIB debug lib
/MTd link with LIBCMTD.LIB debug lib
VS2008PE 32-bit Options
C/C++ COMPILER OPTIONS
-OPTIMIZATION-
/O1 minimize space /O2 maximize speed
/Ob inline expansion (default n=0) /Od disable optimizations (default)
/Og enable global optimization /Oi[-] enable intrinsic functions
/Os favor code space /Ot favor code speed
/Ox maximum optimizations /Oy[-] enable frame pointer omission
-CODE GENERATION-
/GF enable read-only string pooling /Gm[-] enable minimal rebuild
/Gy[-] separate functions for linker /GS[-] enable security checks
/GR[-] enable C++ RTTI /GX[-] enable C++ EH (same as /EHsc)
/EHs enable C++ EH (no SEH exceptions) /EHa enable C++ EH (w/ SEH exceptions)
/EHc extern "C" defaults to nothrow
/fp: choose floating-point model:
except[-] - consider floating-point exceptions when generating code
fast - "fast" floating-point model; results are less predictable
precise - "precise" floating-point model; results are predictable
strict - "strict" floating-point model (implies /fp:except)
/Qfast_transcendentals generate inline FP intrinsics even with /fp:except
/GL[-] enable link-time code generation /GA optimize for Windows Application
/Ge force stack checking for all funcs /Gs[num] control stack checking calls
/Gh enable _penter function call /GH enable _pexit function call
/GT generate fiber-safe TLS accesses /RTC1 Enable fast checks (/RTCsu)
/RTCc Convert to smaller type checks /RTCs Stack Frame runtime checking
/RTCu Uninitialized local usage checks
/clr[:option] compile for common language runtime, where option is:
pure - produce IL-only output file (no native executable code)
safe - produce IL-only verifiable output file
oldSyntax - accept the Managed Extensions syntax from Visual C++ 2002/2003
initialAppDomain - enable initial AppDomain behavior of Visual C++ 2002
noAssembly - do not produce an assembly
/Gd __cdecl calling convention /Gr __fastcall calling convention
/Gz __stdcall calling convention /GZ Enable stack checks (/RTCs)
/QIfist[-] use FIST instead of ftol()
/hotpatch ensure function padding for hotpatchable images
/arch: minimum CPU architecture requirements, one of:
SSE - enable use of instructions available with SSE enabled CPUs
SSE2 - enable use of instructions available with SSE2 enabled CPUs
/Qimprecise_fwaits generate FWAITs only on "try" boundaries, not inside "try"
-OUTPUT FILES-
/Fa[file] name assembly listing file /FA[scu] configure assembly listing
/Fd[file] name .PDB file /Fe name executable file
/Fm[file] name map file /Fo name object file
/Fp name precompiled header file /Fr[file] name source browser file
/FR[file] name extended .SBR file
/doc[file] process XML documentation comments and optionally name the .xdc file
-PREPROCESSOR-
/AI add to assembly search path /FU forced using assembly/module
/C don't strip comments /D{=|#} define macro
/E preprocess to stdout /EP preprocess to stdout, no #line
/P preprocess to file /Fx merge injected code to file
/FI name forced include file /U remove predefined macro
/u remove all predefined macros /I add to include search path
/X ignore "standard places"
-LANGUAGE-
/Zi enable debugging information /Z7 enable old-style debug info
/Zp pack structs on n-byte boundary /Za disable extensions
/Ze enable extensions (default) /Zl omit default library name in .OBJ
/Zg generate function prototypes /Zs syntax check only
/vd{0|1|2} disable/enable vtordisp /vm type of pointers to members
/Zc:arg1[,arg2] C++ language conformance, where arguments can be:
forScope[-] - enforce Standard C++ for scoping rules
wchar_t[-] - wchar_t is the native type, not a typedef
/ZI enable Edit and Continue debug info
/openmp enable OpenMP 2.0 language extensions
-MISCELLANEOUS-
@ options response file /?, /help print this help message
/bigobj generate extended object format /c compile only, no link
/errorReport:option Report internal compiler errors to Microsoft
none - do not send report
prompt - prompt to immediately send report
queue - at next admin logon, prompt to send report (default)
send - send report automatically
/FC use full pathnames in diagnostics /H max external name length
/J default char type is unsigned
/MP use up to 'n' processes for compilation
/nologo suppress copyright message /showIncludes show include file names
/Tc compile file as .c /Tp compile file as .cpp
/TC compile all files as .c /TP compile all files as .cpp
/V set version string /w disable all warnings
/wd disable warning n /we treat warning n as an error
/wo issue warning n once /w set warning level 1-4 for n
/W set warning level (default n=1) /Wall enable all warnings
/WL enable one line diagnostics /WX treat warnings as errors
/Yc[file] create .PCH file /Yd put debug info in every .OBJ
/Yl[sym] inject .PCH ref for debug lib /Yu[file] use .PCH file
/Y- disable all PCH options /Zm max memory alloc (% of default)
/Wp64 enable 64 bit porting warnings
-LINKING-
/LD Create .DLL /LDd Create .DLL debug library
/LN Create a .netmodule /F set stack size
/link [linker options and libraries] /MD link with MSVCRT.LIB
/MT link with LIBCMT.LIB /MDd link with MSVCRTD.LIB debug lib
/MTd link with LIBCMTD.LIB debug lib
VS2008PE 64-bit Options
C/C++ COMPILER OPTIONS
-OPTIMIZATION-
/O1 minimize space /O2 maximize speed
/Ob inline expansion (default n=0) /Od disable optimizations (default)
/Og enable global optimization /Oi[-] enable intrinsic functions
/Os favor code space /Ot favor code speed
/Ox maximum optimizations
/favor: select processor to optimize for, one of:
blend - a combination of optimizations for several different x64 processors
AMD64 - 64-bit AMD processors
INTEL64 - Intel(R)64 architecture processors
-CODE GENERATION-
/GF enable read-only string pooling /Gm[-] enable minimal rebuild
/Gy[-] separate functions for linker /GS[-] enable security checks
/GR[-] enable C++ RTTI /GX[-] enable C++ EH (same as /EHsc)
/EHs enable C++ EH (no SEH exceptions) /EHa enable C++ EH (w/ SEH exceptions)
/EHc extern "C" defaults to nothrow
/fp: choose floating-point model:
except[-] - consider floating-point exceptions when generating code
fast - "fast" floating-point model; results are less predictable
precise - "precise" floating-point model; results are predictable
strict - "strict" floating-point model (implies /fp:except)
/Qfast_transcendentals generate inline FP intrinsics even with /fp:except
/GL[-] enable link-time code generation /GA optimize for Windows Application
/Ge force stack checking for all funcs /Gs[num] control stack checking calls
/Gh enable _penter function call /GH enable _pexit function call
/GT generate fiber-safe TLS accesses /RTC1 Enable fast checks (/RTCsu)
/RTCc Convert to smaller type checks /RTCs Stack Frame runtime checking
/RTCu Uninitialized local usage checks
/clr[:option] compile for common language runtime, where option is:
pure - produce IL-only output file (no native executable code)
safe - produce IL-only verifiable output file
oldSyntax - accept the Managed Extensions syntax from Visual C++ 2002/2003
initialAppDomain - enable initial AppDomain behavior of Visual C++ 2002
noAssembly - do not produce an assembly
/homeparams Force parameters passed in registers to be written to the stack
/GZ Enable stack checks (/RTCs)
-OUTPUT FILES-
/Fa[file] name assembly listing file /FA[scu] configure assembly listing
/Fd[file] name .PDB file /Fe name executable file
/Fm[file] name map file /Fo name object file
/Fp name precompiled header file /Fr[file] name source browser file
/FR[file] name extended .SBR file
/doc[file] process XML documentation comments and optionally name the .xdc file
-PREPROCESSOR-
/AI add to assembly search path /FU forced using assembly/module
/C don't strip comments /D{=|#} define macro
/E preprocess to stdout /EP preprocess to stdout, no #line
/P preprocess to file /Fx merge injected code to file
/FI name forced include file /U remove predefined macro
/u remove all predefined macros /I add to include search path
/X ignore "standard places"
-LANGUAGE-
/Zi enable debugging information /Z7 enable old-style debug info
/Zp pack structs on n-byte boundary /Za disable extensions
/Ze enable extensions (default) /Zl omit default library name in .OBJ
/Zg generate function prototypes /Zs syntax check only
/vd{0|1|2} disable/enable vtordisp /vm type of pointers to members
/Zc:arg1[,arg2] C++ language conformance, where arguments can be:
forScope[-] - enforce Standard C++ for scoping rules
wchar_t[-] - wchar_t is the native type, not a typedef
/openmp enable OpenMP 2.0 language extensions
-MISCELLANEOUS-
@ options response file /?, /help print this help message
/bigobj generate extended object format /c compile only, no link
/errorReport:option Report internal compiler errors to Microsoft
none - do not send report
prompt - prompt to immediately send report
queue - at next admin logon, prompt to send report (default)
send - send report automatically
/FC use full pathnames in diagnostics /H max external name length
/J default char type is unsigned
/MP use up to 'n' processes for compilation
/nologo suppress copyright message /showIncludes show include file names
/Tc compile file as .c /Tp compile file as .cpp
/TC compile all files as .c /TP compile all files as .cpp
/V set version string /w disable all warnings
/wd disable warning n /we treat warning n as an error
/wo issue warning n once /w set warning level 1-4 for n
/W set warning level (default n=1) /Wall enable all warnings
/WL enable one line diagnostics /WX treat warnings as errors
/Yc[file] create .PCH file /Yd put debug info in every .OBJ
/Yl[sym] inject .PCH ref for debug lib /Yu[file] use .PCH file
/Y- disable all PCH options /Zm max memory alloc (% of default)
/Wp64 enable 64 bit porting warnings
-LINKING-
/LD Create .DLL /LDd Create .DLL debug library
/LN Create a .netmodule /F set stack size
/link [linker options and libraries] /MD link with MSVCRT.LIB
/MT link with LIBCMT.LIB /MDd link with MSVCRTD.LIB debug lib
/MTd link with LIBCMTD.LIB debug lib
