AMD Optimizing C/C++ Compiler Suite Version 3.0.0 Flag Descriptions

Set the optimization level to -O2.

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Means "no optimization". This level compiles the fastest and generates the most debuggable code.

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Somewhere between -O0 and -O2.

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Moderate level of optimization which enables most optimizations. This is the default when no "-O" option is specified, or if no value is specified (i.e. "-O").

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Like -O2, except that it enables optimizations that take longer to perform or that may generate larger code (in an attempt to make the program run faster).

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Like -O2 with extra optimizations to reduce code size.

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Like -Os (and thus -O2), but reduces code size further.

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Equivalent to -O3.

If multiple "O" options are used, with or without level numbers, the last such option is the one that is effective.

Enables all the optimizations from -O3 along with other aggressive optimizations that may violate strict compliance with language standards. Refer to the AOCC options document for the language you're using for more detailed documentation of optimizations enabled under -Ofast.

Specify that Clang should generate code for a specific processor family member and later. For example, if you specify -march=znver1, the compiler is allowed to generate instructions that are valid on AMD Zen processors, but which may not exist on earlier products.

(For C++ only) Enable generation of unwind information. This allows exceptions to be thrown through Clang compiled stack frames. This is on by default in x86-64. -fno-exceptions disables C++ exception handling.

Generate output files in LLVM formats suitable for link time optimization. When used with -S this generates LLVM intermediate language assembly files, otherwise this generates LLVM bitcode format object files (which may be passed to the linker depending on the stage selection options).

Generate code for a 32-bit environment. The 32-bit environment sets int, long and pointer to 32 bits and generates code that runs on any i386 system. The compiler generates x86 or IA32 32-bit ABI. The default on a 32-bit host is 32-bit ABI. The default on a 64-bit host is 64-bit ABI if the target platform specified is 64-bit, otherwise the default is 32-bit.

Generate code for a 64-bit environment. The 64-bit environment sets int to 32 bits and long and pointer to 64 bits and generates code for AMD's x86-64 architecture. The compiler generates AMD64, INTEL64, x86-64 64-bit ABI. The default on a 32-bit host is 32-bit ABI. The default on a 64-bit host is 64-bit ABI if the target platform specified is 64-bit, otherwise the default is 32-bit.

Instructs the compiler to use the LLVM linker and loader (lld) instead of the system linker when linking object files.

Instructs the compiler to use the GNU gold linker (gold) instead of the system linker when linking object files.

Instructs the compiler not to allocate arrays from the stack and instead use heap memory.

Given the expression "a = b / c", instructs the compiler to calculate "a = b * (1/c)".

Enables a range of optimizations that provide faster, though sometimes less precise, mathematical operations that may not conform to the IEEE-754 specifications. When this option is specified, the __STDC_IEC_559__ macro is ignored even if set by the system headers.

Enable handling of OpenMP directives and generate parallel code. The openmp library to be linked can be specified through -fopenmp=library option.

Do not allow optimizations for floating-point arithmetic that assume that arguments and results are not NaNs or +-Infs. The option instructs the compiler to follow exact implementation of IEEE or ISO rules/specifications for math functions.

This option enables floating-point expression contraction such as forming of fused multiply-add operations if the target has native support for them.

flang option to preserve array access information for linearized arrays.

Instructs the compiler to conform to the IEEE-754 specifications. The compiler will Perform floating-point operations in strict conformance with the IEEE 754 standard. Some optimizations are disabled when this option is specified

Instructs the compiler to link with system math libraries.

Instructs the compiler to link with AMD-supported optimized math library.

This option instructs the linker to link the executable with the pthread library.

This option instructs the linker to link the executable with libdl, the interface to the dynamic loader.

Instructs the linker to use the first definition encountered for a symbol, and ignore all others.

Use the jemalloc library, which is a general purpose malloc(3) implementation that emphasizes fragmentation avoidance and scalable concurrency support.

Instructs the compiler to link with the OpenMP runtime libraries.

Instructs the compiler to link with flang Fortran runtime libraries.

Instructs the compiler to link with flang Fortran runtime libraries.

The option combines compare/test instructions with branches wherever possible.

The induction variable simplification optimization transforms induction variables to simpler forms. The option disables this optimization.

Sets the default integer and logical types to an 8 byte type. It does not promote variables with explicit KIND declarations.

This option enables the GVN hoist pass, which is used to hoist computations from branches.

Run cleanup optimization passes after vectorization.

Sets the SIMD width. Zero is autoselect.

Sets the vectorization interleave count. For example, force-vector-interleave=1 is used to force the unroll factor in loop unrolling to 1. Zero is autoselect.

Certain loops with breaks may be vectorized by default at -O2 and above. In some extreme situations this may result in unsafe behavior. Use this option to disable vectorization of such loops.

Enables splitting of long live ranges of loop induction variables which span loop boundaries. This helps reduce register pressure and can help avoid needless spills to memory and reloads from memory.

This optimization does partial unswitching of loops where some part of the unswitched control flow remains in the loop.

This option enables aggressive loop unswitching heuristic (including -enable-partial-unswitch) based on the usage of the branch conditional values. Loop unswitching leads to code-bloat. Code-bloat can be minimized if the hoisted condition is executed more often. This heuristic prioritizes the conditions based on the number of times they are used within the loop. The heuristic can be controlled with the following options:

• -unswitch-identical-branches-min-count=<n>

  Enables unswitching of a loop with respect to a branch conditional value (B), where B appears in at least <n> compares in the loop. This option is enabled with -aggressive-loop-unswitch. Default value is 3.

  Usage: -mllvm -aggressive-loop-unswitch -mllvm -unswitch-identical-branches-min-count=<n> where n is a positive integer and lower value of <n> facilitates more unswitching

• -unswitch-identical-branches-max-count=<n>

  Enables unswitching of a loop with respect to a branch conditional value (B), where B appears in at most <n> compares in the loop. This option is enabled with -aggressive-loop-unswitch. Default value is 6.

  Usage: -mllvm -aggressive-loop-unswitch -mllvm -unswitch-identical-branches-max-count=<n> where n is a positive integer and higher value of <n> facilitates more unswitching

Note: These options may facilitate more unswitching in some of the workloads. Since loop-unswitching inherently leads to code bloat, facilitating more unswitching may significantly increase the code size and hence may also lead to longer compilation times.

This optimization enables generation of prefetch instructions for tightly coupled loops

This option enables an optimization that generates and calls specialized function versions when the loops inside function are vectorizable and the arguments are not aliased with each other. This optimization helps in function inlining and vectorization.

This option enables an optimization that generates and calls specialized function versions when they are called with constant arguments. This optimization helps in function inlining.

This option enables an optimization that does the slp vectorization across basic blocks. The SLP vectorizer vectorizes instructions within basic blocks. The global slp vectorizer analyzes instructions across basic blocks and vectorizes them.

Converts the call to floating point exponent version of pow to its integer exponent version if the floating-point exponent can be converted to integer. This option is set to true by default.

Enables estimation of the virtual register pressure before performing loop invariant code motion. This estimation is used to decide the invariants that will be hoisted during loop invariant code motion.

Enables fusion of adjacent tiled loops as a part of loop tiling transformation. This option is set to false by default.

This option enables an optimization that transforms the data layout of a single dimensional array to provide better cache locality by analysing the access patterns.

Enables dead virtual function elimination optimization. Requires -flto=full.

This flag enables vectorization of loops with complex control flow that can not be vectorized by loop and slp vectorizers.

This option eliminates the array computations based on their usage. The computations on unused array elements and computations on zero valued array elements are eliminated with this optimization. -flto as whole program analysis is required to perform this optimization.

Possible values:

• 1: Eliminates the computations on unused array elements
• 2: Eliminates the computations on zero valued array elements
• 3: Eliminates the computations on unused and zero valued array elements

Block Reordering

Possible values:

• none: No block reorder
• simple: Simple block reorder
• aggressive: Aggressive block reorder

This optimization also includes safety analysis which checks that it is safe to reorder basic blocks. However, when this optimization takes effect, the safety analysis ignores exceptions specifically within the call chain involved in the context of the blocks being reordered. This would be acceptable for most input programs, but if your program strictly needs to support throwing of exceptions at all points in the program, then it is advisable to avoid using this option.

Analyzes the whole program to determine if the structures in the code can be peeled and if pointer or integer fields in the structure can be compressed. If feasible, this optimization transforms the code to enable these improvements. This transformation is likely to improve cache utilization and memory bandwidth. This, in turn, is expected to improve the scalability of programs executed on multiple cores.

This is effective only under -flto as whole program analysis is required to perform this optimization. You can choose different levels of aggressiveness with which this optimization can be applied to your application with 1 being the least aggressive and 7 being the most aggressive level.

Possible values:

• fstruct-layout=1: enables structure peeling.
• fstruct-layout=2: enables structure peeling and selectively compresses self-referential pointers in these structures to 32-bit pointers wherever safe.
• fstruct-layout=3: enables structure peeling and selectively compresses self-referential pointers in these structures to 16-bit pointers wherever safe.
• fstruct-layout=4: enables structure peeling, pointer compression as in level 2 and further enables compression of structure fields which are of integer type. This is performed under a strict safety check.
• fstruct-layout=5: enables structure peeling, pointer compression as in level 3 and further enables compression of structure fields which are of integer type. This is performed under a strict safety check.
• fstruct-layout=6: enables structure peeling, pointer compression as in level 2 and further enables compression of structure fields which are of type 64-bit 'signed int' or 'unsigned Int'. The user needs to ensure that the values assigned to 64-bit 'signed int' fields are in range -(2^31 - 1) to +(2^31 - 1) and 64-bit 'unsigned int' fields are in range 0 to +(2^31 - 1), otherwise, incorrect results may be obtained. This compression is performed without considering any safety analysis and so the user needs to ensure the safety based on the program compiled.
• fstruct-layout=7: enables structure peeling, pointer compression as in level 3 and further enables compression of structure fields which are of type 64-bit 'signed int' or 'unsigned Int'. The user needs to ensure that the values assigned to 64-bit 'signed int' fields are in range -(2^31 - 1) to +(2^31 - 1) and 64-bit 'unsigned int' field are in range 0 to +(2^31 - 1) , otherwise, incorrect results may be obtained. This compression is performed without considering any safety analysis and so the user needs to ensure the safety based on the program compiled.

fstruct-layout=4 and fstruct-layout=5 are derived from fstruct-layout=2 and fstruct-layout=3 respectively with the added feature of safe compression of integer fields in structures. Going from fstruct-layout=4 to fstruct-layout=5 may result in higher performance if the pointer values are such that the pointers can be compressed to 16-bits.

fstruct-layout=6 and fstruct-layout=7 are derived from fstruct-layout=2 and fstruct-layout=3 respectively with the added feature of compression of integer fields in structures. These are similar to fstruct-layout=4 and fstruct-layout=5, but here, the integer fields of the structures are always compressed from 64-bits to 32-bits without any safety guarantee.

Turns on LLVM's instrumenation based profiling.

Uses the profiling files generated from a program compiled with -fprofile-instr-generate to guide optimization decisions.

In the 502/602.gcc benchmark description, "multiple definitions of symbols" is listed under the "Known Portability Issues" section, and this option is one of the suggested workarounds. This option causes Clang to revert to the same inlining behavior that GCC does when in pre-C99 mode.

Sets the compiler's inlining heuristics to an aggressive level by increasing the inline thresholds.

Sets the compiler's inlining threshold level to the value passed as the argument. The inline threshold is used in the inliner heuristics to decide which functions should be inlined.

Enables inlining for recursive functions based on heuristics, with level 4 being most aggressive. Higher levels may lead to code bloat due to expansion of recursive functions at call sites.

Levels:

• 0 [DEFAULT]: Disables inlining for recursive functions.
• 1: Enables inlining for recursive functions using heuristics with inline depth 1.
• 2: Same as level 1 but with more aggressive heuristics.
• 3: Enables inlining for all recursive functions with inline depth 1.
• 4: Enables inlining for all recursive function with inline depth 10.

This option enables aggressive loop unswitching heuristic based on usage of branch conditions.

Enables loop strength reduction for nested loop structures. By default, the compiler will do loop strength reduction only for the innermost loop.

Run the loop rerolling pass.

This optimization merges duplicate constant uses into a register to reduce instruction width.

Allocate local variables on the stack, thus allowing recursion. SAVEd, data-initialized, or namelist members are always allocated statically, regardless of the setting of this switch.

Disable generation of fma instructions when there is a chain of fma instructions and output of one fma instruction is used as input to other fma instruction.

This option enables AVX2 (Advanced Vector Extensions, 2nd generation) support.

This option enables generation of the adx instruction.

This option disables generation of the adx instruction.

This option enables the generation of SSE4a instructions.

This option disables the generation of SSE4a instructions.

Sets the limit at which loops will be unrolled. For example, if unroll threshold is set to 100 then only loops with 100 or fewer instructions will be unrolled.

Sets the limit at which loops will be unswitched. For example, if unswitch threshold is set to 100 then only loops with 100 or fewer instructions will be unswtched.

Enables aggressive heuristics to get loop unrolling.

The unroll count can be specified explicitly with -unroll_count=<value> where <value> is a positive integer. If this value is greater than the trip count, the loop will be fully unrolled.

This option instructs the compiler to unroll loops wherever possible.

Use the given vector functions library.

This option controls whether AOCC emits (true) or does not emit (false) a vzeroupper instruction before a transfer of control flow. Not emitting the vzeroupper instruction can help minimize the AVX to SSE transition penalty.

Force the alignment of all blocks that have no fall-through predecessors (i.e. don't add nops that are executed). In log2 format (e.g 4 means align on 16B boundaries).

Selects the C language dialect.

Selects the C++ language dialect.

Do not generate an error when linking multiple symbols of the same name.

Set the default symbol visibility for all global declarations.

The binary datasets for some of the Fortran benchmarks in the SPEC CPU suites are stored in big-endian format. This option is necessary for those datasets to be read in correctly.

The binary datasets for some of the Fortran benchmarks in the SPEC CPU suites are stored in big-endian format. This option is necessary for those datasets to be read in correctly.

Specifies size of off_t data type.

This option instructs the compiler to treat char type as unsigned.

clang is a C compiler which encompasses preprocessing, parsing, optimization, code generation, assembly, and linking. Depending on which high-level mode setting is passed, Clang will stop before doing a full link.

clang++ C++ compiler which encompasses preprocessing, parsing, optimization, code generation, assembly, and linking. Depending on which high-level mode setting is passed, Clang will stop before doing a full link.

flang is a Fortran compiler which encompasses parsing, optimization, code generation, assembly, and linking. Depending on which high-level mode setting is passed, Flang will stop before doing a full link.

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.

Do not warn about unused command line arguments.

Specifies a directory to search for libraries. Use -L to add directories to the search path for library files. Multiple -L options are valid. However, the position of multiple -L options is important relative to -l options supplied.

Specifies a directory to search for include files. Use -I to add directories to the search path for include files. Multiple -I options are valid.