aocc-rev-A2 AMD Optimizing C/C++ Compiler Suite Flag Descriptions One or more of the following may have been used in the run. If so, it will be listed in the notes sections. Here is a brief guide to understanding them:

]]>
Compilers: AMD Optimizing C/C++ Compiler Suite ]]>
Splitter rule for plugin arguments: -fplugin-arg-dragonegg-llvm-option="-flag[ -flag...]" Consumer rule for the tail of split up plugin arguments: -fplugin-arg-dragonegg-llvm-option="" -g Produce debugging information. -O 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.

]]> -O0 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.

]]> -O1 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.

]]> -O2 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.

]]> -O3 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.

]]> -Os 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.

]]> -Oz 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.

]]> -O4 Equivalent to -O3.

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

]]> -Ofast 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.

]]> -march=znver5 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.

]]> -flto Enables link-time optimization. When compiling, it causes output files to be generated 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. When linking, causes the optimization passes to happen.

]]> -flto=thin Enables link-time optimization. When compiling, it causes output files to be generated 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. When linking, causes the optimization passes to happen, with as much parallelism as the system and the code being optimized will allow.

]]> -flto=full Enables link-time optimization. When compiling, it causes output files to be generated 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. When linking, causes the optimization passes to happen.

]]> -m64 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.

]]> -ffast-math 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.

]]> -Kieee 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.

]]> -z muldefs Instructs the linker to use the first definition encountered for a symbol, and ignore all others.

]]> -lflang Instructs the compiler to link with flang Fortran runtime libraries.

]]> -fgnu89-inline This option causes Clang to revert to the same inlining behavior that GCC does when in pre-C99 mode.

]]> -std=gnu89 Selects the C language dialect.

]]> -std=c++98 Selects the C++ language dialect.

]]> -std=f2008 Selects the Fortran language dialect.

]]> Enables handling of OpenMP directives and generation of parallel code. Enable support for Posix Threads. Note that C++ programs using std::thread may require this flag.

]]> -fno-fast-math Do not allow any optimizations that provide faster, though sometimes less precise, mathematical operations that may not conform to the IEEE-754 specifications. Disables -ffast-math optimizations.

]]> -fno-finite-math-only -ffinite-math-only, which is implied by -ffast-math and -Ofast, allows optimizations for floating-point arithmetic that assume that arguments and results are not NaNs or +-Infs. Setting -fno-finite-math-only does the opposite: the compiler must prepare for the possible presence of NaNs and infinities.

]]> -fno-associative-math -fassociative-math allows the compiler to reassociate floating-point expressions. This means the compiler may change the grouping of operations (for example, transforming (a + b) + c into a + (b + c)) in order to enable better optimization. Such transformations may change numerical results due to rounding differences.

This option is implied by -ffast-math and -Ofast. Using -fno-associative-math preserves strict evaluation order and IEEE-compliant rounding behavior.

]]> -fno-reciprocal-math -freciprocal-math allows the compiler to replace floating-point division operations with multiplication by a reciprocal (for example, replacing x / y with x * (1.0 / y)). This can significantly improve performance on some architectures, but may reduce numerical accuracy.

This option is implied by -ffast-math and -Ofast. Using -fno-reciprocal-math forces the compiler to preserve exact division semantics.

]]> Disables a range of optimizations that provide faster, though sometimes less precise, mathematical operations.

A SPEC CPU config file might use this flag in combination with -Ofast, to specify that all the optimizations of -Ofast are desired, with the exception of -ffast-math.

]]> "-Mbyteswapio" Swap bytes from big-endian to little-endian or vice versa on input/output of unformatted FORTRAN data.

]]> -funsigned-char This option instructs the compiler to treat char type as unsigned.

]]> /path/to/{clang|clang++|flang|gfortran} This flag is just to trim the path from the compiler line. clang 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++ 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.

]]> flang 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.

]]> -L/path/to/libs 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.

]]> -I /path/to/include 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.

]]> -DUSE_OPENMP Switch to enable OpenMP.

]]>