GNU Compiler Collection Flags

Do not rely on language constraints to derive bounds for the number of iterations of a loop.

Enables a range of optimizations that provide faster, though sometimes less precise, mathematical operations.

Tells GCC to use the GNU semantics for "inline" functions, that is, the behavior prior to the C99 standard. This switch may resolve duplicate symbol errors, as noted in the 502.gcc_r benchmark description.

Enable Link Time Optimization

Enable handling of OpenMP directives and generate parallel code.

Adds the plugin named. XXX this description needs to be expanded.

Enables prefetching of arrays used in loops.

Instruments code to collect information for profile-driven feedback. Information is collected regarding both code paths and data values.

Applies information from a profile run in order to improve optimization. Several optimizations are improved when profile data is available, including branch probabilities, loop peeling, and loop unrolling.

Disable optimizations for floating-point arithmetic that ignore the signedness of zero.

Enabled: Put all local arrays, even those of unknown size onto stack memory.
The -fno- form disables the behavior.

The language standards set aliasing requirements: programmers are expected to follow conventions so that the compiler can keep track of memory. If a program violates the requirements (for example, using pointer arithmetic), programs may crash, or (worse) wrong answers may be silently produced.

Unfortunately, the aliasing requirements from the standards are not always well understood.

Sometimes, the aliasing requirements are understood and nevertheless intentionally violated by smart programmers who know what they are doing, such as the programmer responsible for the inner workings of Perl storage allocation and variable handling.

The -fno-strict-aliasing switch instructs the optimizer that it must not assume that the aliasing requirements from the standard are met by the current program. You will probably need it for 500.perlbench_r and 600.perlbench_s. Note that this is an optimization switch, not a portability switch. When running SPECint2017_rate_base or SPECint2017_speed_base, you must use the same optimization switches for all the C modules in base; see http://www.spec.org/cpu2017/Docs/runrules.html#BaseFlags and http://www.spec.org/cpu2017/Docs/runrules.html#MustValidate.

There are a group of GCC optimizations invoked via -ftree-vectorize and related flags, as described at https://gcc.gnu.org/projects/tree-ssa/vectorization.html. During testing of SPEC CPU2017, for some versions of GCC on some chips, some benchmarks did not get correct answers when the vectorizor was enabled. These problems were to isolate, and it is possible that later versions of the compiler might not encounter them.

You can turn off loop vectorization with -fno-tree-loop-vectorize. Note that this is an optimization switch, not a portability switch. If it is needed, then in base you must use it consistently. See: http://www.spec.org/cpu2017/Docs/runrules.html#BaseFlags and http://www.spec.org/cpu2017/Docs/runrules.html#MustValidate.

Attempts to decompose loops in order to run them on multiple processors.

Tells the optimizer to unroll all loops.

Tells the optimizer to unroll loops whose number of iterations can be determined at compile time or upon entry to the loop.

The switch -funsafe-math-optimizations allows the compiler to make certain(*) aggressive assumptions, such as disregarding the programmer's intended order of operations. The run rules allow such re-ordering http://www.spec.org/cpu2017/Docs/runrules.html#reordering. The rules also point out that you must get answers that pass SPEC's validation requirements. In some cases, that will mean that some optimizations must be turned off.

-fno-unsafe-math-optimizations turns off these(*) optimizations. You may need to use this flag in order to get certain benchmarks to validate. Note that this is an optimization switch, not a portability switch. If it is needed, then in base you will need to use it consistently. See: http://www.spec.org/cpu2017/Docs/runrules.html#BaseFlags and http://www.spec.org/cpu2017/Docs/runrules.html#MustValidate.

(*) Much more detail about which optimizations is available.

Produce debugging information.

Add the specified path to the list of paths that the linker will search for archive libraries and control scripts.

Link with libjemalloc, a fast, arena-based memory allocator.

Compiles for a 32-bit (LP32) data model.

Compiles for a 64-bit (LP64) data model.

Generate code for ilp32 (int, long, pointer 32-bit) or lp64 (int 32-bit, longs and pointers 64-bit). With ilp32, int, long int and pointer are 32-bit; with lp64, int is 32-bit, but long int and pointer are 64-bit.

On x86 systems, allows use of instructions that require the listed architecture.

Generate code for processors that include the AVX extensions.

On SPARC systems, mcpu sets the available instruction set.
On x86 systems, mcpu is a deprecated synonym for mtune.

Generate code to take advantage of fused multiply-add

       -mrecip
           This option enables use of "RCPSS" and "RSQRTSS" instructions (and
           their vectorized variants "RCPPS" and "RSQRTPS") with an additional
           Newton-Raphson step to increase precision instead of "DIVSS" and
           "SQRTSS" (and their vectorized variants) for single-precision
           floating-point arguments.  These instructions are generated only when
           -funsafe-math-optimizations is enabled together with
           -finite-math-only and -fno-trapping-math.

       -mrecip=opt
           This option controls which reciprocal estimate instructions may be
           used.  opt is a comma-separated list of options, which may be
           preceded by a ! to invert the option:

           all
               Enable all estimate instructions.

           default
               Enable the default instructions, equivalent to -mrecip.

           none
               Disable all estimate instructions, equivalent to -mno-recip.

           div Enable the approximation for scalar division.

           vec-div
               Enable the approximation for vectorized division.

           sqrt
               Enable the approximation for scalar square root.

           vec-sqrt
               Enable the approximation for vectorized square root.

           So, for example, -mrecip=all,!sqrt enables all of the reciprocal
           approximations, except for square root.
   

Allows use of instructions that require the SIMD units of the indicated type.

Tunes code based on the timing characteristics of the listed processor.

Generate code to take advantage of version 3 of the SPARC Visual Instruction Set extensions

Enable all optimizations of -O3 plus optimizations that are not valid for standard-compliant programs, such as re-ordering operations without regard to parentheses.
Many more details are available.

Increases optimization levels: the higher the number, the more optimization is done. Higher levels of optimization may require additional compilation time, in the hopes of reducing execution time. At -O, basic optimizations are performed, such as constant merging and elimination of dead code. At -O2, additional optimizations are added, such as common subexpression elimination and strict aliasing. At -O3, even more optimizations are performed, such as function inlining and vectorization.
Many more details are available.

Same as -O1

Link the C++ library statically.

Sets the language dialect to include syntax from the C99 standard, such as bool and other features used in CPU2017 benchmarks.

Sets the language dialect to include syntax from the 1998 ISO C++ standard plus the 2003 technical corrigendum.

Sets the language dialect to include syntax from the Fortran 2003 standard.

Remove unused functions from the generated executable. Without this flag, on Mac OS X, you are likely to encounter duplicate symbols when linking 502.gcc_r or 602.gcc_s.

Note that this is an optimization switch, not a portability switch. If it is needed, then in base you must use it consistently. See: http://www.spec.org/cpu2017/Docs/runrules.html#BaseFlags and http://www.spec.org/cpu2017/Docs/runrules.html#MustValidate.

Add the specified directory to the runtime library search path used when linking an ELF executable with shared objects.

Add the linker flag that requests a large stack. This flag is likely to be important only to one or two of the floating point speed benchmarks. In accordance with the rules for Base, it is set for all of fpspeed in base. See: http://www.spec.org/cpu2017/Docs/runrules.html#BaseFlags.

Set the requested page size for the program to one of the available sizes for your system - for example 2M, 4M, 1G.

Allows links to proceed even if there are multiple definitions of some symbols. This switch may resolve duplicate symbol errors, as noted in the 502.gcc_r benchmark description.

Ensure that there are no surprises if the benchmarks are run in an environment where file system metadata uses 64 bits.

Use big-endian representation for unformatted files. This is important when reading 521.wrf_r, 621.wrf_s, and 628.pop2_s data files that were originally generated in big-endian format.

Let the type "char" be signed, like "signed char".

Do not transform names of entities specified in the Fortran source file by appending underscores to them.

Let the type "char" be unsigned, like "unsigned char".

Note: this particular portability flag is included for 526.blender_r per the recommendation in its documentation - see http://www.spec.org/cpu2017/Docs/benchmarks/526.blender_r.html.

Invokes the GNU C compiler.

Invokes the GNU Fortran compiler.

Invokes the GNU C++ compiler.

Allows source code in traditional (fixed-column) Fortran layout.

Enables warnings.

Do not warn about functions defined with a return type that defaults to "int" or which return something other than what they were declared to.