1 ; Options for the language- and target-independent parts of the compiler.
3 ; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
4 ; Free Software Foundation, Inc.
6 ; This file is part of GCC.
8 ; GCC is free software; you can redistribute it and/or modify it under
9 ; the terms of the GNU General Public License as published by the Free
10 ; Software Foundation; either version 3, or (at your option) any later
13 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 ; FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 ; You should have received a copy of the GNU General Public License
19 ; along with GCC; see the file COPYING3. If not see
20 ; <http://www.gnu.org/licenses/>.
22 ; See the GCC internals manual (options.texi) for a description of this file's format.
24 ; Please try to keep this file in ASCII collating order.
35 ; 0 means straightforward implementation of complex divide acceptable.
36 ; 1 means wide ranges of inputs must work for complex divide.
37 ; 2 means C99-like requirements for complex multiply and divide.
39 int flag_complex_method = 1
41 ; Nonzero if subexpressions must be evaluated from left-to-right.
43 int flag_evaluation_order = 0
45 ; Language specific warning pass for unused results.
47 bool flag_warn_unused_result = false
52 ; Nonzero if we should write GIMPLE bytecode for link-time optimization.
56 ; True to warn about any objects definitions whose size is larger
57 ; than N bytes. Also want about function definitions whose returned
58 ; values are larger than N bytes, where N is 'larger_than_size'.
63 HOST_WIDE_INT larger_than_size
65 ; True to warn about any function whose frame size is larger
68 bool warn_frame_larger_than
71 HOST_WIDE_INT frame_larger_than_size
73 ; Nonzero means we should be saving declaration info into a .X file.
75 int flag_gen_aux_info = 0
77 ; Nonzero if we are compiling code for a shared library, zero for
82 ; These two are really VEC(char_p,heap) *.
85 void *flag_instrument_functions_exclude_functions
88 void *flag_instrument_functions_exclude_files
90 ; Generic structs (e.g. templates not explicitly specialized)
91 ; may not have a compilation unit associated with them, and so
92 ; may need to be treated differently from ordinary structs.
94 ; Structs only handled by reference (indirectly), will also usually
95 ; not need as much debugging information.
98 enum debug_struct_file debug_struct_ordinary[DINFO_USAGE_NUM_ENUMS] = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY }
101 enum debug_struct_file debug_struct_generic[DINFO_USAGE_NUM_ENUMS] = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY }
103 ; True if we should exit after parsing options.
105 bool exit_after_options
107 ; Type(s) of debugging information we are producing (if any). See
108 ; flag-types.h for the definitions of the different possible types of
109 ; debugging information.
111 enum debug_info_type write_symbols = NO_DEBUG
113 ; Level of debugging information we are producing. See flag-types.h
114 ; for the definitions of the different possible levels.
116 enum debug_info_levels debug_info_level = DINFO_LEVEL_NONE
118 ; Nonzero means use GNU-only extensions in the generated symbolic
119 ; debugging information. Currently, this only has an effect when
120 ; write_symbols is set to DBX_DEBUG, XCOFF_DEBUG, or DWARF_DEBUG.
122 bool use_gnu_debug_info_extensions
124 ; Original value of maximum field alignment in bytes, specified via
125 ; -fpack-struct=<value>.
127 unsigned int initial_max_fld_align = TARGET_DEFAULT_PACK_STRUCT
130 enum vect_verbosity_levels user_vect_verbosity_level = MAX_VERBOSITY_LEVEL
132 ; Type of stack check.
134 enum stack_check_type flag_stack_check = NO_STACK_CHECK
136 ; -dA causes debug commentary information to be produced in
137 ; the generated assembly code (to make it more readable). This option
138 ; is generally only of use to those who actually need to read the
139 ; generated assembly code (perhaps while debugging the compiler itself).
140 ; Currently, this switch is only used by dwarf2out.c; however, it is intended
141 ; to be a catchall for printing debug information in the assembler file.
145 ; -dP causes the rtl to be emitted as a comment in assembly.
147 int flag_dump_rtl_in_asm
149 ; Whether -da was passed (used only in handle_common_deferred_options).
151 bool flag_dump_all_passed
153 ; Other flags saying which kinds of debugging dump have been requested.
156 int rtl_dump_and_exit
159 int flag_print_asm_name
162 enum graph_dump_types graph_dump_format = no_graph
164 ; Name of top-level original source file (what was input to cpp).
165 ; This comes from the #-command at the beginning of the actual input.
166 ; If there isn't any there, then this is the cc1 input file name.
168 const char *main_input_filename
170 ; Pointer to base name in main_input_filename, with directories and a
171 ; single final extension removed, and the length of this base
175 const char *main_input_basename
178 int main_input_baselength
180 ; Which options have been printed by --help.
184 ; Which enums have been printed by --help. 0 = not printed, no
185 ; relevant options seen, 1 = relevant option seen, not yet printed, 2
188 char *help_enum_printed
190 ; The number of columns for --help output.
192 unsigned int help_columns
194 ; Whether this options structure has been through finish_options
196 bool flag_opts_finished
208 Driver Alias(coverage)
214 Common Separate Alias(d)
217 Common Joined Alias(d)
220 Common Separate Alias(dumpbase)
223 Common Separate Alias(dumpdir)
226 Driver Separate Alias(e)
229 Driver Joined Alias(e)
232 Common Warning Alias(Wextra)
235 Driver Separate Alias(Xassembler)
238 Driver JoinedOrMissing Alias(Xassembler)
241 Driver Separate Alias(Xlinker)
244 Driver JoinedOrMissing Alias(Xlinker)
247 Driver Separate Alias(u)
250 Driver Joined Alias(u)
253 Common Driver Var(help_flag)
254 Display this information
257 Common Driver Report Joined
258 --help=<class> Display descriptions of a specific class of options. <class> is one or more of optimizers, target, warnings, undocumented, params
261 Driver Separate Alias(x)
264 Driver Joined Alias(x)
267 Driver Separate Alias(L)
270 Driver Joined Alias(L)
272 -no-canonical-prefixes
273 Driver Alias(no-canonical-prefixes)
275 -no-standard-libraries
276 Driver Alias(nostdlib)
285 Common Driver Separate Alias(o) MissingArgError(missing filename after %qs)
288 Common Driver Joined Alias(o) MissingArgError(missing filename after %qs)
291 Driver Alias(pass-exit-codes)
294 Common Alias(pedantic)
297 Common Alias(pedantic-errors)
306 Driver Separate Alias(B)
309 Driver JoinedOrMissing Alias(B)
315 Driver Separate Alias(print-file-name=)
318 Driver JoinedOrMissing Alias(print-file-name=)
320 -print-libgcc-file-name
321 Driver Alias(print-libgcc-file-name)
323 -print-multi-directory
324 Driver Alias(print-multi-directory)
327 Driver Alias(print-multi-lib)
329 -print-multi-os-directory
330 Driver Alias(print-multi-os-directory)
333 Driver Separate Alias(print-prog-name=)
336 Driver JoinedOrMissing Alias(print-prog-name=)
339 Driver Alias(print-search-dirs)
342 Driver Alias(print-sysroot)
344 -print-sysroot-headers-suffix
345 Driver Alias(print-sysroot-headers-suffix)
351 Driver Alias(save-temps)
357 Driver Separate Alias(specs=)
360 Driver Joined Alias(specs=)
366 Driver Alias(symbolic)
370 Alias for --help=target
378 ;; The driver used to convert options such as --help into forms such
379 ;; as -fhelp; the following four entries are for compatibility with
380 ;; any direct uses of those (undocumented) -f forms
382 Common Driver Alias(-help)
385 Common Driver Joined Alias(-help=)
388 Common Driver Alias(-target-help)
391 Common Driver Alias(-version)
395 --param <param>=<value> Set parameter <param> to value. See below for a complete list of parameters
398 Common Joined Alias(-param)
401 Driver Separate Alias(-sysroot=)
404 Driver JoinedOrMissing
410 Driver Joined Separate
416 Driver Joined Separate
419 Common JoinedOrMissing Optimization
420 -O<number> Set optimization level to <number>
424 Optimize for space rather than speed
428 Optimize for speed disregarding exact standards compliance
431 Driver Joined Separate
437 Driver Joined Separate
449 Common RejectNegative Warning Alias(Wextra)
450 This switch is deprecated; use -Wextra instead
453 Driver JoinedOrMissing
456 Driver JoinedOrMissing
459 Driver JoinedOrMissing
462 Common Var(warn_aggregate_return) Warning
463 Warn about returning structures, unions or arrays
466 Common Var(warn_array_bounds) Warning
467 Warn if an array is accessed out of bounds
470 Common Var(warn_attributes) Init(1) Warning
471 Warn about inappropriate attribute usage
474 Common Var(warn_cast_align) Warning
475 Warn about pointer casts which increase alignment
478 Common Var(warn_cpp) Init(1) Warning
479 Warn when a #warning directive is encountered
481 Wdeprecated-declarations
482 Common Var(warn_deprecated_decl) Init(1) Warning
483 Warn about uses of __attribute__((deprecated)) declarations
485 Wdisabled-optimization
486 Common Var(warn_disabled_optimization) Warning
487 Warn when an optimization pass is disabled
490 Common Var(warnings_are_errors)
491 Treat all warnings as errors
495 Treat specified warning as error
498 Common Var(extra_warnings) Warning
499 Print extra (possibly unwanted) warnings
502 Common Var(flag_fatal_errors)
503 Exit on the first error occurred
506 Common RejectNegative Joined UInteger
507 -Wframe-larger-than=<number> Warn if a function's stack frame requires more than <number> bytes
510 Common Var(warn_inline) Warning
511 Warn when an inlined function cannot be inlined
514 Common RejectNegative Joined Warning Undocumented Alias(Wlarger-than=)
517 Common RejectNegative Joined UInteger Warning
518 -Wlarger-than=<number> Warn if an object is larger than <number> bytes
520 Wunsafe-loop-optimizations
521 Common Var(warn_unsafe_loop_optimizations) Warning
522 Warn if the loop cannot be optimized due to nontrivial assumptions.
525 Common Var(warn_missing_noreturn) Warning
526 Warn about functions which might be candidates for __attribute__((noreturn))
529 Common Var(warn_mudflap) Init(1) Warning
530 Warn about constructs not instrumented by -fmudflap
533 Common Var(warn_overflow) Init(1) Warning
534 Warn about overflow in arithmetic expressions
537 Common Var(warn_packed) Warning
538 Warn when the packed attribute has no effect on struct layout
541 Common Var(warn_padded) Warning
542 Warn when padding is required to align structure members
545 Common Var(warn_shadow) Warning
546 Warn when one local variable shadows another
549 Common Var(warn_stack_protect) Warning
550 Warn when not issuing stack smashing protection for some reason
554 Warn about code which might break strict aliasing rules
557 Common Joined RejectNegative UInteger Var(warn_strict_aliasing) Init(-1) Warning
558 Warn about code which might break strict aliasing rules
562 Warn about optimizations that assume that signed overflow is undefined
565 Common Joined RejectNegative UInteger Var(warn_strict_overflow) Init(-1) Warning
566 Warn about optimizations that assume that signed overflow is undefined
568 Wsuggest-attribute=const
569 Common Var(warn_suggest_attribute_const) Warning
570 Warn about functions which might be candidates for __attribute__((const))
572 Wsuggest-attribute=pure
573 Common Var(warn_suggest_attribute_pure) Warning
574 Warn about functions which might be candidates for __attribute__((pure))
576 Wsuggest-attribute=noreturn
577 Common Var(warn_suggest_attribute_noreturn) Warning
578 Warn about functions which might be candidates for __attribute__((noreturn))
581 Common Var(warn_switch) Warning
582 Warn about enumerated switches, with no default, missing a case
585 Common Var(warn_switch_default) Warning
586 Warn about enumerated switches missing a \"default:\" statement
589 Common Var(warn_switch_enum) Warning
590 Warn about all enumerated switches missing a specific case
593 Common Var(warn_system_headers) Warning
594 Do not suppress warnings from system headers
597 Common Var(warn_trampolines) Warning
598 Warn whenever a trampoline is generated
601 Common Var(warn_type_limits) Init(-1) Warning
602 Warn if a comparison is always true or always false due to the limited range of the data type
605 Common Var(warn_uninitialized) Init(-1) Warning
606 Warn about uninitialized automatic variables
610 Does nothing. Preserved for backward compatibility.
613 Common Var(warn_unused) Init(0) Warning
614 Enable all -Wunused- warnings
616 Wunused-but-set-parameter
617 Common Var(warn_unused_but_set_parameter) Init(-1) Warning
618 Warn when a function parameter is only set, otherwise unused
620 Wunused-but-set-variable
621 Common Var(warn_unused_but_set_variable) Init(-1) Warning
622 Warn when a variable is only set, otherwise unused
625 Common Var(warn_unused_function) Init(-1) Warning
626 Warn when a function is unused
629 Common Var(warn_unused_label) Init(-1) Warning
630 Warn when a label is unused
633 Common Var(warn_unused_parameter) Init(-1) Warning
634 Warn when a function parameter is unused
637 Common Var(warn_unused_value) Init(-1) Warning
638 Warn when an expression value is unused
641 Common Var(warn_unused_variable) Init(-1) Warning
642 Warn when a variable is unused
645 Common Var(warn_coverage_mismatch) Init(1) Warning
646 Warn in case profiles in -fprofile-use do not match
658 Common Separate Var(aux_info_file_name)
659 -aux-info <file> Emit declaration information into <file>
662 Common Joined Alias(aux-info)
665 Common Separate RejectDriver Var(aux_base_name)
668 Common Separate RejectDriver
678 -d<letters> Enable dumps from specific passes of the compiler
681 Common Separate Var(dump_base_name)
682 -dumpbase <file> Set the file basename to be used for dumps
685 Common Separate Var(dump_dir_name)
686 -dumpdir <dir> Set the directory name to be used for dumps
698 Driver Joined Separate
700 ; The version of the C++ ABI in use. The following values are allowed:
702 ; 0: The version of the ABI believed most conformant with the C++ ABI
703 ; specification. This ABI may change as bugs are discovered and fixed.
704 ; Therefore, 0 will not necessarily indicate the same ABI in different
707 ; 1: The version of the ABI first used in G++ 3.2.
709 ; 2: The version of the ABI first used in G++ 3.4 (and current default).
711 ; 3: The version of the ABI that fixes the missing underscore
712 ; in template non-type arguments of pointer type.
714 ; 4: The version of the ABI that introduces unambiguous mangling of
717 ; Additional positive integers will be assigned as new versions of
718 ; the ABI become the default version of the ABI.
720 Common Joined RejectNegative UInteger Var(flag_abi_version) Init(2)
723 Common Report Var(align_functions,0) Optimization UInteger
724 Align the start of functions
727 Common RejectNegative Joined UInteger Var(align_functions)
730 Common Report Var(align_jumps,0) Optimization UInteger
731 Align labels which are only reached by jumping
734 Common RejectNegative Joined UInteger Var(align_jumps)
737 Common Report Var(align_labels,0) Optimization UInteger
741 Common RejectNegative Joined UInteger Var(align_labels)
744 Common Report Var(align_loops,0) Optimization UInteger
745 Align the start of loops
748 Common RejectNegative Joined UInteger Var(align_loops)
752 Does nothing. Preserved for backward compatibility.
756 Does nothing. Preserved for backward compatibility.
758 fargument-noalias-global
760 Does nothing. Preserved for backward compatibility.
762 fargument-noalias-anything
764 Does nothing. Preserved for backward compatibility.
766 fasynchronous-unwind-tables
767 Common Report Var(flag_asynchronous_unwind_tables) Optimization
768 Generate unwind tables that are exact at each instruction boundary
771 Common Report Var(flag_auto_inc_dec) Init(1)
772 Generate auto-inc/dec instructions
774 ; -fcheck-bounds causes gcc to generate array bounds checks.
775 ; For C, C++ and ObjC: defaults off.
776 ; For Java: defaults to on.
777 ; For Fortran: defaults to off.
779 Common Report Var(flag_bounds_check)
780 Generate code to check bounds before indexing arrays
783 Common Report Var(flag_branch_on_count_reg) Init(1) Optimization
784 Replace add, compare, branch with branch on count register
786 fbranch-probabilities
787 Common Report Var(flag_branch_probabilities) Optimization
788 Use profiling information for branch probabilities
790 fbranch-target-load-optimize
791 Common Report Var(flag_branch_target_load_optimize) Optimization
792 Perform branch target load optimization before prologue / epilogue threading
794 fbranch-target-load-optimize2
795 Common Report Var(flag_branch_target_load_optimize2) Optimization
796 Perform branch target load optimization after prologue / epilogue threading
799 Common Report Var(flag_btr_bb_exclusive) Optimization
800 Restrict target load migration not to re-use registers in any basic block
803 Common Joined RejectNegative Var(common_deferred_options) Defer
804 -fcall-saved-<register> Mark <register> as being preserved across functions
807 Common Joined RejectNegative Var(common_deferred_options) Defer
808 -fcall-used-<register> Mark <register> as being corrupted by function calls
810 ; Nonzero for -fcaller-saves: allocate values in regs that need to
811 ; be saved across function calls, if that produces overall better code.
812 ; Optional now, so people can test it.
814 Common Report Var(flag_caller_saves) Optimization
815 Save registers around function calls
818 Common Report Var(flag_check_data_deps)
819 Compare the results of several data dependence analyzers.
821 fcombine-stack-adjustments
822 Common Report Var(flag_combine_stack_adjustments) Optimization
823 Looks for opportunities to reduce stack adjustments and stack references.
826 Common Report Var(flag_no_common,0) Optimization
827 Do not put uninitialized globals in the common section
831 ; Converted by the driver to -fcompare-debug= options.
834 Common Driver JoinedOrMissing RejectNegative Var(flag_compare_debug_opt)
835 -fcompare-debug[=<opts>] Compile with and without e.g. -gtoggle, and compare the final-insns dump
837 fcompare-debug-second
838 Common Driver RejectNegative Var(flag_compare_debug)
839 Run only the second compilation of -fcompare-debug
842 Common Var(flag_conserve_stack) Optimization
843 Do not perform optimizations increasing noticeably stack usage
846 Common Report Var(flag_cprop_registers) Optimization
847 Perform a register copy-propagation optimization pass
850 Common Report Var(flag_crossjumping) Optimization
851 Perform cross-jumping optimization
854 Common Report Var(flag_cse_follow_jumps) Optimization
855 When running CSE, follow jumps to their targets
859 Does nothing. Preserved for backward compatibility.
862 Common Report Var(flag_cx_limited_range) Optimization
863 Omit range reduction step when performing complex division
866 Common Report Var(flag_cx_fortran_rules) Optimization
867 Complex multiplication and division follow Fortran rules
870 Common Report Var(flag_data_sections) Optimization
871 Place data items into their own section
874 Common Report Var(common_deferred_options) Defer
875 List all available debugging counters with their limits and counts.
878 Common RejectNegative Joined Var(common_deferred_options) Defer
879 -fdbg-cnt=<counter>:<limit>[,<counter>:<limit>,...] Set the debug counter limit.
882 Common Joined RejectNegative Var(common_deferred_options) Defer
883 Map one directory name to another in debug information
885 ; Nonzero for -fdefer-pop: don't pop args after each function call
886 ; instead save them up to pop many calls' args with one insns.
888 Common Report Var(flag_defer_pop) Optimization
889 Defer popping functions args from stack until later
892 Common Report Var(flag_delayed_branch) Optimization
893 Attempt to fill delay slots of branch instructions
895 fdelete-null-pointer-checks
896 Common Report Var(flag_delete_null_pointer_checks) Init(1) Optimization
897 Delete useless null pointer checks
899 fdiagnostics-show-location=
900 Common Joined RejectNegative Enum(diagnostic_prefixing_rule)
901 -fdiagnostics-show-location=[once|every-line] How often to emit source location at the beginning of line-wrapped diagnostics
903 ; Required for these enum values.
908 Name(diagnostic_prefixing_rule) Type(int)
911 Enum(diagnostic_prefixing_rule) String(once) Value(DIAGNOSTICS_SHOW_PREFIX_ONCE)
914 Enum(diagnostic_prefixing_rule) String(every-line) Value(DIAGNOSTICS_SHOW_PREFIX_EVERY_LINE)
916 fdiagnostics-show-option
917 Common Var(flag_diagnostics_show_option) Init(1)
918 Amend appropriate diagnostic messages with the command line option that controls them
921 Common Joined RejectNegative Var(common_deferred_options) Defer
922 -fdump-<type> Dump various compiler internals to a file
925 Driver RejectNegative
928 Common RejectNegative Joined Var(flag_dump_final_insns)
929 -fdump-final-insns=filename Dump to filename the insns at the end of translation
932 Common RejectNegative Joined Var(flag_dump_go_spec)
933 -fdump-go-spec=filename Write all declarations to file as Go code
936 Common Report Var(flag_dump_noaddr)
937 Suppress output of addresses in debugging dumps
940 Common Report Var(flag_dump_unnumbered)
941 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
943 fdump-unnumbered-links
944 Common Report Var(flag_dump_unnumbered_links)
945 Suppress output of previous and next insn numbers in debugging dumps
948 Common Report Var(flag_dwarf2_cfi_asm) Init(HAVE_GAS_CFI_DIRECTIVE)
949 Enable CFI tables via GAS assembler directives.
952 Common Report Var(flag_early_inlining) Init(1) Optimization
953 Perform early inlining
955 feliminate-dwarf2-dups
956 Common Report Var(flag_eliminate_dwarf2_dups)
957 Perform DWARF2 duplicate elimination
960 Common Report Var(flag_ipa_sra) Init(0) Optimization
961 Perform interprocedural reduction of aggregates
963 feliminate-unused-debug-symbols
964 Common Report Var(flag_debug_only_used_symbols)
965 Perform unused type elimination in debug info
967 feliminate-unused-debug-types
968 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
969 Perform unused type elimination in debug info
971 femit-class-debug-always
972 Common Report Var(flag_emit_class_debug_always) Init(0)
973 Do not suppress C++ class debug information.
976 Common Report Var(flag_enable_icf_debug)
977 Generate debug information to support Identical Code Folding (ICF)
980 Common Report Var(flag_exceptions) Optimization
981 Enable exception handling
983 fexpensive-optimizations
984 Common Report Var(flag_expensive_optimizations) Optimization
985 Perform a number of minor, expensive optimizations
988 Common Joined RejectNegative Enum(excess_precision) Var(flag_excess_precision_cmdline) Init(EXCESS_PRECISION_DEFAULT)
989 -fexcess-precision=[fast|standard] Specify handling of excess floating-point precision
992 Name(excess_precision) Type(enum excess_precision) UnknownError(unknown excess precision style %qs)
995 Enum(excess_precision) String(fast) Value(EXCESS_PRECISION_FAST)
998 Enum(excess_precision) String(standard) Value(EXCESS_PRECISION_STANDARD)
1004 Common Report Var(flag_finite_math_only) Optimization
1005 Assume no NaNs or infinities are generated
1008 Common Joined RejectNegative Var(common_deferred_options) Defer
1009 -ffixed-<register> Mark <register> as being unavailable to the compiler
1012 Common Report Var(flag_float_store) Optimization
1013 Don't allocate floats and doubles in extended-precision registers
1017 Does nothing. Preserved for backward compatibility.
1020 Common Report Var(flag_forward_propagate) Optimization
1021 Perform a forward propagation pass on RTL
1024 Common Joined RejectNegative Enum(fp_contract_mode) Var(flag_fp_contract_mode) Init(FP_CONTRACT_FAST)
1025 -ffp-contract=[off|on|fast] Perform floating-point expression contraction.
1028 Name(fp_contract_mode) Type(enum fp_contract_mode) UnknownError(unknown floating point contraction style %qs)
1031 Enum(fp_contract_mode) String(off) Value(FP_CONTRACT_OFF)
1033 ; Not implemented, fall back to conservative FP_CONTRACT_OFF.
1035 Enum(fp_contract_mode) String(on) Value(FP_CONTRACT_OFF)
1038 Enum(fp_contract_mode) String(fast) Value(FP_CONTRACT_FAST)
1040 ; Nonzero means don't put addresses of constant functions in registers.
1041 ; Used for compiling the Unix kernel, where strange substitutions are
1042 ; done on the assembly output.
1044 Common Report Var(flag_no_function_cse,0)
1045 Allow function addresses to be held in registers
1048 Common Report Var(flag_function_sections)
1049 Place each function into its own section
1052 Common Report Var(flag_gcse) Optimization
1053 Perform global common subexpression elimination
1056 Common Report Var(flag_gcse_lm) Init(1) Optimization
1057 Perform enhanced load motion during global common subexpression elimination
1060 Common Report Var(flag_gcse_sm) Init(0) Optimization
1061 Perform store motion after global common subexpression elimination
1064 Common Report Var(flag_gcse_las) Init(0) Optimization
1065 Perform redundant load after store elimination in global common subexpression
1069 Common Report Var(flag_gcse_after_reload) Optimization
1070 Perform global common subexpression elimination after register allocation
1073 ; This option is not documented yet as its semantics will change.
1075 Common Report Var(flag_graphite)
1076 Enable in and out of Graphite representation
1079 Common Report Var(flag_graphite_identity) Optimization
1080 Enable Graphite Identity transformation
1082 floop-parallelize-all
1083 Common Report Var(flag_loop_parallelize_all) Optimization
1084 Mark all loops as parallel
1087 Common Report Var(flag_loop_strip_mine) Optimization
1088 Enable Loop Strip Mining transformation
1091 Common Report Var(flag_loop_interchange) Optimization
1092 Enable Loop Interchange transformation
1095 Common Report Var(flag_loop_block) Optimization
1096 Enable Loop Blocking transformation
1099 Common Report Var(flag_loop_flatten) Optimization
1100 Enable Loop Flattening transformation
1102 fstrict-volatile-bitfields
1103 Common Report Var(flag_strict_volatile_bitfields) Init(-1)
1104 Force bitfield accesses to match their type width
1106 fguess-branch-probability
1107 Common Report Var(flag_guess_branch_prob) Optimization
1108 Enable guessing of branch probabilities
1110 ; Nonzero means ignore `#ident' directives. 0 means handle them.
1111 ; Generate position-independent code for executables if possible
1112 ; On SVR4 targets, it also controls whether or not to emit a
1113 ; string identifying the compiler.
1115 Common Report Var(flag_no_ident,0)
1116 Process #ident directives
1119 Common Report Var(flag_if_conversion) Optimization
1120 Perform conversion of conditional jumps to branchless equivalents
1123 Common Report Var(flag_if_conversion2) Optimization
1124 Perform conversion of conditional jumps to conditional execution
1126 ftree-loop-if-convert
1127 Common Report Var(flag_tree_loop_if_convert) Init(-1) Optimization
1128 Convert conditional jumps in innermost loops to branchless equivalents
1130 ftree-loop-if-convert-stores
1131 Common Report Var(flag_tree_loop_if_convert_stores) Optimization
1132 Also if-convert conditional jumps containing memory writes
1134 ; -finhibit-size-directive inhibits output of .size for ELF.
1135 ; This is used only for compiling crtstuff.c,
1136 ; and it may be extended to other effects
1137 ; needed for crtstuff.c on other systems.
1138 finhibit-size-directive
1139 Common Report Var(flag_inhibit_size_directive)
1140 Do not generate .size directives
1143 Common Report Var(flag_indirect_inlining)
1144 Perform indirect inlining
1146 ; Nonzero means that functions declared `inline' will be treated
1147 ; as `static'. Prevents generation of zillions of copies of unused
1148 ; static inline functions; instead, `inlines' are written out
1149 ; only when actually used. Used in conjunction with -g. Also
1150 ; does the right thing with #pragma interface.
1152 Common Report Var(flag_no_inline,0) Init(0)
1153 Pay attention to the \"inline\" keyword
1155 finline-small-functions
1156 Common Report Var(flag_inline_small_functions) Optimization
1157 Integrate simple functions into their callers when code size is known to not growth
1160 Common Report Var(flag_inline_functions) Optimization
1161 Integrate simple functions into their callers
1163 finline-functions-called-once
1164 Common Report Var(flag_inline_functions_called_once) Init(1) Optimization
1165 Integrate functions called once into their callers
1168 Common RejectNegative Joined Alias(finline-limit=)
1171 Common RejectNegative Joined UInteger
1172 -finline-limit=<number> Limit the size of inlined functions to <number>
1174 finstrument-functions
1175 Common Report Var(flag_instrument_function_entry_exit)
1176 Instrument function entry and exit with profiling calls
1178 finstrument-functions-exclude-function-list=
1179 Common RejectNegative Joined
1180 -finstrument-functions-exclude-function-list=name,... Do not instrument listed functions
1182 finstrument-functions-exclude-file-list=
1183 Common RejectNegative Joined
1184 -finstrument-functions-exclude-file-list=filename,... Do not instrument functions listed in files
1187 Common Report Var(flag_ipa_cp) Optimization
1188 Perform Interprocedural constant propagation
1191 Common Report Var(flag_ipa_cp_clone) Optimization
1192 Perform cloning to make Interprocedural constant propagation stronger
1195 Common Report Var(flag_ipa_profile) Init(0) Optimization
1196 Perform interprocedural profile propagation
1199 Common Report Var(flag_ipa_pta) Init(0) Optimization
1200 Perform interprocedural points-to analysis
1203 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
1204 Discover pure and const functions
1207 Common Report Var(flag_ipa_reference) Init(0) Optimization
1208 Discover readonly and non addressable static variables
1211 Common Report Var(flag_ipa_matrix_reorg) Optimization
1212 Perform matrix layout flattening and transposing based
1213 on profiling information.
1216 Common Report Var(flag_ipa_struct_reorg)
1217 Perform structure layout optimizations based
1218 on profiling information.
1221 Common Joined RejectNegative Enum(ira_algorithm) Var(flag_ira_algorithm) Init(IRA_ALGORITHM_CB)
1222 -fira-algorithm=[CB|priority] Set the used IRA algorithm
1225 Name(ira_algorithm) Type(enum ira_algorithm) UnknownError(unknown IRA algorithm %qs)
1228 Enum(ira_algorithm) String(CB) Value(IRA_ALGORITHM_CB)
1231 Enum(ira_algorithm) String(priority) Value(IRA_ALGORITHM_PRIORITY)
1234 Common Joined RejectNegative Enum(ira_region) Var(flag_ira_region) Init(IRA_REGION_MIXED)
1235 -fira-region=[one|all|mixed] Set regions for IRA
1238 Name(ira_region) Type(enum ira_region) UnknownError(unknown IRA region %qs)
1241 Enum(ira_region) String(one) Value(IRA_REGION_ONE)
1244 Enum(ira_region) String(all) Value(IRA_REGION_ALL)
1247 Enum(ira_region) String(mixed) Value(IRA_REGION_MIXED)
1250 Common Report Var(flag_ira_loop_pressure)
1251 Use IRA based register pressure calculation
1252 in RTL loop optimizations.
1254 fira-share-save-slots
1255 Common Report Var(flag_ira_share_save_slots) Init(1)
1256 Share slots for saving different hard registers.
1258 fira-share-spill-slots
1259 Common Report Var(flag_ira_share_spill_slots) Init(1)
1260 Share stack slots for spilled pseudo-registers.
1263 Common RejectNegative Joined UInteger Var(flag_ira_verbose) Init(5)
1264 -fira-verbose=<number> Control IRA's level of diagnostic messages.
1267 Common Report Var(flag_ivopts) Init(1) Optimization
1268 Optimize induction variables on trees
1271 Common Var(flag_jump_tables) Init(1) Optimization
1272 Use jump tables for sufficiently large switch statements
1274 fkeep-inline-functions
1275 Common Report Var(flag_keep_inline_functions)
1276 Generate code for functions even if they are fully inlined
1279 Common Report Var(flag_keep_static_consts) Init(1)
1280 Emit static const variables even if they are not used
1283 Common Report Var(flag_leading_underscore) Init(-1)
1284 Give external symbols a leading underscore
1288 Does nothing. Preserved for backward compatibility.
1292 Enable link-time optimization.
1295 Common RejectNegative Joined Var(flag_lto)
1296 Link-time optimization with number of parallel jobs or jobserver.
1299 Common Var(flag_lto_partition_1to1)
1300 Partition functions and vars at linktime based on object files they originate from
1302 flto-partition=balanced
1303 Common Var(flag_lto_partition_balanced)
1304 Partition functions and vars at linktime into approximately same sized buckets
1307 Common Var(flag_lto_partition_none)
1308 Disable partioning and streaming
1310 ; The initial value of -1 comes from Z_DEFAULT_COMPRESSION in zlib.h.
1311 flto-compression-level=
1312 Common Joined RejectNegative UInteger Var(flag_lto_compression_level) Init(-1)
1313 -flto-compression-level=<number> Use zlib compression level <number> for IL
1316 Common Report Var(flag_lto_report) Init(0) Optimization
1317 Report various link-time optimization statistics
1320 Common Report Var(flag_errno_math) Init(1) Optimization
1321 Set errno after built-in math functions
1324 Common Joined RejectNegative UInteger Var(flag_max_errors)
1325 -fmax-errors=<number> Maximum number of errors to report
1328 Common Report Var(mem_report)
1329 Report on permanent memory allocation
1331 ; This will attempt to merge constant section constants, if 1 only
1332 ; string constants and constants from constant pool, if 2 also constant
1334 fmerge-all-constants
1335 Common Report Var(flag_merge_constants,2) Init(1) Optimization
1336 Attempt to merge identical constants and constant variables
1339 Common Report Var(flag_merge_constants,1) Optimization
1340 Attempt to merge identical constants across compilation units
1342 fmerge-debug-strings
1343 Common Report Var(flag_merge_debug_strings) Init(1)
1344 Attempt to merge identical debug strings across compilation units
1347 Common RejectNegative Joined UInteger
1348 -fmessage-length=<number> Limit diagnostics to <number> characters per line. 0 suppresses line-wrapping
1351 Common Report Var(flag_modulo_sched) Optimization
1352 Perform SMS based modulo scheduling before the first scheduling pass
1354 fmodulo-sched-allow-regmoves
1355 Common Report Var(flag_modulo_sched_allow_regmoves)
1356 Perform SMS based modulo scheduling with register moves allowed
1358 fmove-loop-invariants
1359 Common Report Var(flag_move_loop_invariants) Init(1) Optimization
1360 Move loop invariant computations out of loops
1363 Common RejectNegative Report Var(flag_mudflap)
1364 Add mudflap bounds-checking instrumentation for single-threaded program
1367 Common RejectNegative Report Var(flag_mudflap,2)
1368 Add mudflap bounds-checking instrumentation for multi-threaded program
1371 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
1372 Ignore read operations when inserting mudflap instrumentation
1375 Common Var(flag_dce) Init(1) Optimization
1376 Use the RTL dead code elimination pass
1379 Common Var(flag_dse) Init(1) Optimization
1380 Use the RTL dead store elimination pass
1382 freschedule-modulo-scheduled-loops
1383 Common Report Var(flag_resched_modulo_sched) Optimization
1384 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
1386 fnon-call-exceptions
1387 Common Report Var(flag_non_call_exceptions) Optimization
1388 Support synchronous non-call exceptions
1391 Common Report Var(flag_omit_frame_pointer) Optimization
1392 When possible do not generate stack frames
1394 foptimize-register-move
1395 Common Report Var(flag_regmove) Optimization
1396 Do the full register move optimization pass
1398 foptimize-sibling-calls
1399 Common Report Var(flag_optimize_sibling_calls) Optimization
1400 Optimize sibling and tail recursive calls
1403 Common Report Var(flag_partial_inlining)
1404 Perform partial inlining
1407 Common Report Var(pre_ipa_mem_report)
1408 Report on memory allocation before interprocedural optimization
1410 fpost-ipa-mem-report
1411 Common Report Var(post_ipa_mem_report)
1412 Report on memory allocation before interprocedural optimization
1415 Common Report Var(flag_pack_struct) Optimization
1416 Pack structure members together without holes
1419 Common RejectNegative Joined UInteger Optimization
1420 -fpack-struct=<number> Set initial maximum structure member alignment
1423 Common Report Var(flag_pcc_struct_return,1) Init(DEFAULT_PCC_STRUCT_RETURN)
1424 Return small aggregates in memory, not registers
1427 Common Report Var(flag_peel_loops) Optimization
1428 Perform loop peeling
1431 Common Report Var(flag_no_peephole,0) Optimization
1432 Enable machine specific peephole optimizations
1435 Common Report Var(flag_peephole2) Optimization
1436 Enable an RTL peephole pass before sched2
1439 Common Report Var(flag_pic,2)
1440 Generate position-independent code if possible (large mode)
1443 Common Report Var(flag_pie,2)
1444 Generate position-independent code for executables if possible (large mode)
1447 Common Report Var(flag_pic,1)
1448 Generate position-independent code if possible (small mode)
1451 Common Report Var(flag_pie,1)
1452 Generate position-independent code for executables if possible (small mode)
1455 Common Joined RejectNegative Var(common_deferred_options) Defer
1456 Specify a plugin to load
1459 Common Joined RejectNegative Var(common_deferred_options) Defer
1460 -fplugin-arg-<name>-<key>[=<value>] Specify argument <key>=<value> for plugin <name>
1462 fpredictive-commoning
1463 Common Report Var(flag_predictive_commoning) Optimization
1464 Run predictive commoning optimization.
1466 fprefetch-loop-arrays
1467 Common Report Var(flag_prefetch_loop_arrays) Init(-1) Optimization
1468 Generate prefetch instructions, if available, for arrays in loops
1471 Common Report Var(profile_flag)
1472 Enable basic program profiling code
1475 Common Report Var(profile_arc_flag)
1476 Insert arc-based program profiling code
1479 Common Joined RejectNegative Var(profile_data_prefix)
1480 Set the top-level directory for storing the profile data.
1481 The default is 'pwd'.
1484 Common Report Var(flag_profile_correction)
1485 Enable correction of flow inconsistent profile data input
1489 Enable common options for generating profile info for profile feedback directed optimizations
1492 Common Joined RejectNegative
1493 Enable common options for generating profile info for profile feedback directed optimizations, and set -fprofile-dir=
1496 Common Var(flag_profile_use)
1497 Enable common options for performing profile feedback directed optimizations
1500 Common Joined RejectNegative
1501 Enable common options for performing profile feedback directed optimizations, and set -fprofile-dir=
1504 Common Report Var(flag_profile_values)
1505 Insert code to profile values of expressions
1508 Common Var(common_deferred_options) Defer
1511 Common Joined RejectNegative Var(common_deferred_options) Defer
1512 -frandom-seed=<string> Make compile reproducible using <string>
1514 ; This switch causes the command line that was used to create an
1515 ; object file to be recorded into the object file. The exact format
1516 ; of this recording is target and binary file format dependent.
1517 ; It is related to the -fverbose-asm switch, but that switch only
1518 ; records information in the assembler output file as comments, so
1519 ; they never reach the object file.
1520 frecord-gcc-switches
1521 Common Report Var(flag_record_gcc_switches)
1522 Record gcc command line switches in the object file.
1525 Common Report Var(flag_pcc_struct_return,0) Optimization
1526 Return small aggregates in registers
1529 Common Report Var(flag_regmove) Optimization
1530 Enables a register move optimization
1533 Common Report Var(flag_rename_registers) Init(2) Optimization
1534 Perform a register renaming optimization pass
1537 Common Report Var(flag_reorder_blocks) Optimization
1538 Reorder basic blocks to improve code placement
1540 freorder-blocks-and-partition
1541 Common Report Var(flag_reorder_blocks_and_partition) Optimization
1542 Reorder basic blocks and partition into hot and cold sections
1545 Common Report Var(flag_reorder_functions) Optimization
1546 Reorder functions to improve code placement
1548 frerun-cse-after-loop
1549 Common Report Var(flag_rerun_cse_after_loop) Optimization
1550 Add a common subexpression elimination pass after loop optimizations
1554 Does nothing. Preserved for backward compatibility.
1557 Common Report Var(flag_rounding_math) Optimization
1558 Disable optimizations that assume default FP rounding behavior
1561 Common Report Var(flag_schedule_interblock) Init(1) Optimization
1562 Enable scheduling across basic blocks
1565 Common Report Var(flag_sched_pressure) Init(0) Optimization
1566 Enable register pressure sensitive insn scheduling
1569 Common Report Var(flag_schedule_speculative) Init(1) Optimization
1570 Allow speculative motion of non-loads
1573 Common Report Var(flag_schedule_speculative_load) Optimization
1574 Allow speculative motion of some loads
1576 fsched-spec-load-dangerous
1577 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
1578 Allow speculative motion of more loads
1581 Common RejectNegative Joined UInteger Var(sched_verbose_param)
1582 -fsched-verbose=<number> Set the verbosity level of the scheduler
1584 fsched2-use-superblocks
1585 Common Report Var(flag_sched2_use_superblocks) Optimization
1586 If scheduling post reload, do superblock scheduling
1590 Does nothing. Preserved for backward compatibility.
1593 Common Report Var(flag_schedule_insns) Optimization
1594 Reschedule instructions before register allocation
1597 Common Report Var(flag_schedule_insns_after_reload) Optimization
1598 Reschedule instructions after register allocation
1600 ; This flag should be on when a target implements non-trivial
1601 ; scheduling hooks, maybe saving some information for its own sake.
1602 ; On IA64, for example, this is used for correct bundling.
1603 fselective-scheduling
1604 Common Report Var(flag_selective_scheduling) Optimization
1605 Schedule instructions using selective scheduling algorithm
1607 fselective-scheduling2
1608 Common Report Var(flag_selective_scheduling2) Optimization
1609 Run selective scheduling after reload
1611 fsel-sched-pipelining
1612 Common Report Var(flag_sel_sched_pipelining) Init(0) Optimization
1613 Perform software pipelining of inner loops during selective scheduling
1615 fsel-sched-pipelining-outer-loops
1616 Common Report Var(flag_sel_sched_pipelining_outer_loops) Init(0) Optimization
1617 Perform software pipelining of outer loops during selective scheduling
1619 fsel-sched-reschedule-pipelined
1620 Common Report Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization
1621 Reschedule pipelined regions without pipelining
1623 ; sched_stalled_insns means that insns can be moved prematurely from the queue
1624 ; of stalled insns into the ready list.
1625 fsched-stalled-insns
1626 Common Report Var(flag_sched_stalled_insns) Optimization UInteger
1627 Allow premature scheduling of queued insns
1629 fsched-stalled-insns=
1630 Common RejectNegative Joined UInteger
1631 -fsched-stalled-insns=<number> Set number of queued insns that can be prematurely scheduled
1633 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
1634 ; be examined for a dependency on a stalled insn that is candidate for
1635 ; premature removal from the queue of stalled insns into the ready list (has
1636 ; an effect only if the flag 'sched_stalled_insns' is set).
1637 fsched-stalled-insns-dep
1638 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization UInteger
1639 Set dependence distance checking in premature scheduling of queued insns
1641 fsched-stalled-insns-dep=
1642 Common RejectNegative Joined UInteger
1643 -fsched-stalled-insns-dep=<number> Set dependence distance checking in premature scheduling of queued insns
1645 fsched-group-heuristic
1646 Common Report Var(flag_sched_group_heuristic) Init(1) Optimization
1647 Enable the group heuristic in the scheduler
1649 fsched-critical-path-heuristic
1650 Common Report Var(flag_sched_critical_path_heuristic) Init(1) Optimization
1651 Enable the critical path heuristic in the scheduler
1653 fsched-spec-insn-heuristic
1654 Common Report Var(flag_sched_spec_insn_heuristic) Init(1) Optimization
1655 Enable the speculative instruction heuristic in the scheduler
1657 fsched-rank-heuristic
1658 Common Report Var(flag_sched_rank_heuristic) Init(1) Optimization
1659 Enable the rank heuristic in the scheduler
1661 fsched-last-insn-heuristic
1662 Common Report Var(flag_sched_last_insn_heuristic) Init(1) Optimization
1663 Enable the last instruction heuristic in the scheduler
1665 fsched-dep-count-heuristic
1666 Common Report Var(flag_sched_dep_count_heuristic) Init(1) Optimization
1667 Enable the dependent count heuristic in the scheduler
1670 Common Report Var(flag_section_anchors) Optimization
1671 Access data in the same section from shared anchor points
1675 Does nothing. Preserved for backward compatibility.
1678 Common Report Var(flag_zee) Init(0)
1679 Eliminate redundant zero extensions on targets that support implicit extensions.
1682 Common Report Var(flag_show_column) Init(1)
1683 Show column numbers in diagnostics, when available. Default on
1686 Common Report Var(flag_signaling_nans) Optimization
1687 Disable optimizations observable by IEEE signaling NaNs
1690 Common Report Var(flag_signed_zeros) Init(1) Optimization
1691 Disable floating point optimizations that ignore the IEEE signedness of zero
1693 fsingle-precision-constant
1694 Common Report Var(flag_single_precision_constant) Optimization
1695 Convert floating point constants to single precision constants
1697 fsplit-ivs-in-unroller
1698 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
1699 Split lifetimes of induction variables when loops are unrolled
1702 Common Report Var(flag_split_stack) Init(-1)
1703 Generate discontiguous stack frames
1706 Common Report Var(flag_split_wide_types) Optimization
1707 Split wide types into independent registers
1709 fvariable-expansion-in-unroller
1710 Common Report Var(flag_variable_expansion_in_unroller) Optimization
1711 Apply variable expansion when loops are unrolled
1714 Common Report RejectNegative Joined
1715 -fstack-check=[no|generic|specific] Insert stack checking code into the program
1718 Common Alias(fstack-check=, specific, no)
1719 Insert stack checking code into the program. Same as -fstack-check=specific
1722 Common Var(common_deferred_options) Defer
1724 fstack-limit-register=
1725 Common RejectNegative Joined Var(common_deferred_options) Defer
1726 -fstack-limit-register=<register> Trap if the stack goes past <register>
1728 fstack-limit-symbol=
1729 Common RejectNegative Joined Var(common_deferred_options) Defer
1730 -fstack-limit-symbol=<name> Trap if the stack goes past symbol <name>
1733 Common Report Var(flag_stack_protect, 1)
1734 Use propolice as a stack protection method
1736 fstack-protector-all
1737 Common Report RejectNegative Var(flag_stack_protect, 2)
1738 Use a stack protection method for every function
1741 Common RejectNegative Var(flag_stack_usage)
1742 Output stack usage information on a per-function basis
1746 Does nothing. Preserved for backward compatibility.
1748 ; Nonzero if we should do (language-dependent) alias analysis.
1749 ; Typically, this analysis will assume that expressions of certain
1750 ; types do not alias expressions of certain other types. Only used
1751 ; if alias analysis (in general) is enabled.
1753 Common Report Var(flag_strict_aliasing) Optimization
1754 Assume strict aliasing rules apply
1757 Common Report Var(flag_strict_overflow)
1758 Treat signed overflow as undefined
1761 Common Report Var(flag_syntax_only)
1762 Check for syntax errors, then stop
1765 Common Report Var(flag_test_coverage)
1766 Create data files needed by \"gcov\"
1769 Common Report Var(flag_thread_jumps) Optimization
1770 Perform jump threading optimizations
1773 Common Report Var(time_report)
1774 Report the time taken by each compiler pass
1777 Common Joined RejectNegative Enum(tls_model) Var(flag_tls_default) Init(TLS_MODEL_GLOBAL_DYNAMIC)
1778 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec] Set the default thread-local storage code generation model
1781 Name(tls_model) Type(enum tls_model) UnknownError(unknown TLS model %qs)
1784 Enum(tls_model) String(global-dynamic) Value(TLS_MODEL_GLOBAL_DYNAMIC)
1787 Enum(tls_model) String(local-dynamic) Value(TLS_MODEL_LOCAL_DYNAMIC)
1790 Enum(tls_model) String(initial-exec) Value(TLS_MODEL_INITIAL_EXEC)
1793 Enum(tls_model) String(local-exec) Value(TLS_MODEL_LOCAL_EXEC)
1796 Common Report Var(flag_toplevel_reorder) Init(2) Optimization
1797 Reorder top level functions, variables, and asms
1800 Common Report Var(flag_tracer)
1801 Perform superblock formation via tail duplication
1803 ; Zero means that floating-point math operations cannot generate a
1804 ; (user-visible) trap. This is the case, for example, in nonstop
1805 ; IEEE 754 arithmetic.
1807 Common Report Var(flag_trapping_math) Init(1) Optimization
1808 Assume floating-point operations can trap
1811 Common Report Var(flag_trapv) Optimization
1812 Trap for signed overflow in addition, subtraction and multiplication
1815 Common Report Var(flag_tree_ccp) Optimization
1816 Enable SSA-CCP optimization on trees
1819 Common Report Var(flag_tree_bit_ccp) Optimization
1820 Enable SSA-BIT-CCP optimization on trees
1824 Does nothing. Preserved for backward compatibility.
1827 Common Report Var(flag_tree_ch) Optimization
1828 Enable loop header copying on trees
1831 Common Report Var(flag_tree_copyrename) Optimization
1832 Replace SSA temporaries with better names in copies
1835 Common Report Var(flag_tree_copy_prop) Optimization
1836 Enable copy propagation on trees
1838 ftree-store-copy-prop
1840 Does nothing. Preserved for backward compatibility.
1843 Common Report Var(flag_tree_cselim) Init(2) Optimization
1844 Transform condition stores into unconditional ones
1846 ftree-switch-conversion
1847 Common Report Var(flag_tree_switch_conversion) Optimization
1848 Perform conversions of switch initializations.
1851 Common Report Var(flag_tree_dce) Optimization
1852 Enable SSA dead code elimination optimization on trees
1854 ftree-dominator-opts
1855 Common Report Var(flag_tree_dom) Optimization
1856 Enable dominator optimizations
1859 Common Report Var(flag_tree_dse) Optimization
1860 Enable dead store elimination
1863 Common Report Var(flag_tree_forwprop) Init(1) Optimization
1864 Enable forward propagation on trees
1867 Common Report Var(flag_tree_fre) Optimization
1868 Enable Full Redundancy Elimination (FRE) on trees
1870 ftree-loop-distribution
1871 Common Report Var(flag_tree_loop_distribution) Optimization
1872 Enable loop distribution on trees
1874 ftree-loop-distribute-patterns
1875 Common Report Var(flag_tree_loop_distribute_patterns) Optimization
1876 Enable loop distribution for patterns transformed into a library call
1879 Common Report Var(flag_tree_loop_im) Init(1) Optimization
1880 Enable loop invariant motion on trees
1883 Common Report Var(flag_tree_loop_linear) Optimization
1884 Enable linear loop transforms on trees
1887 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
1888 Create canonical induction variables in loops
1891 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
1892 Enable loop optimizations on tree level
1894 ftree-parallelize-loops=
1895 Common Report Joined RejectNegative UInteger Var(flag_tree_parallelize_loops) Init(1)
1896 Enable automatic parallelization of loops
1899 Common Report Var(flag_tree_phiprop) Init(1) Optimization
1900 Enable hoisting loads from conditional pointers.
1903 Common Report Var(flag_tree_pre) Optimization
1904 Enable SSA-PRE optimization on trees
1907 Common Report Var(flag_tree_pta) Init(1) Optimization
1908 Perform function-local points-to analysis on trees.
1911 Common Report Var(flag_tree_reassoc) Init(1) Optimization
1912 Enable reassociation on tree level
1916 Does nothing. Preserved for backward compatibility.
1919 Common Report Var(flag_tree_sink) Optimization
1920 Enable SSA code sinking on trees
1923 Common Report Var(flag_tree_sra) Optimization
1924 Perform scalar replacement of aggregates
1927 Common Report Var(flag_tree_ter) Optimization
1928 Replace temporary expressions in the SSA->normal pass
1931 Common Report Var(flag_tree_live_range_split) Optimization
1932 Perform live range splitting during the SSA->normal pass
1935 Common Report Var(flag_tree_vrp) Init(0) Optimization
1936 Perform Value Range Propagation on trees
1939 Common Report Var(flag_unit_at_a_time) Init(1) Optimization
1940 Compile whole compilation unit at a time
1943 Common Report Var(flag_unroll_loops) Optimization
1944 Perform loop unrolling when iteration count is known
1947 Common Report Var(flag_unroll_all_loops) Optimization
1948 Perform loop unrolling for all loops
1950 ; Nonzero means that loop optimizer may assume that the induction variables
1951 ; that control loops do not overflow and that the loops with nontrivial
1952 ; exit condition are not infinite
1953 funsafe-loop-optimizations
1954 Common Report Var(flag_unsafe_loop_optimizations) Optimization
1955 Allow loop optimizations to assume that the loops behave in normal way
1958 Common Report Var(flag_associative_math)
1959 Allow optimization for floating-point arithmetic which may change the
1960 result of the operation due to rounding.
1963 Common Report Var(flag_reciprocal_math)
1964 Same as -fassociative-math for expressions which include division.
1966 ; Nonzero means that unsafe floating-point math optimizations are allowed
1967 ; for the sake of speed. IEEE compliance is not guaranteed, and operations
1968 ; are allowed to assume that their arguments and results are "normal"
1969 ; (e.g., nonnegative for SQRT).
1970 funsafe-math-optimizations
1971 Common Report Var(flag_unsafe_math_optimizations) Optimization
1972 Allow math optimizations that may violate IEEE or ISO standards
1975 Common Report Var(flag_unswitch_loops) Optimization
1976 Perform loop unswitching
1979 Common Report Var(flag_unwind_tables) Optimization
1980 Just generate unwind tables for exception handling
1985 ; Positive if we should track variables, negative if we should run
1986 ; the var-tracking pass only to discard debug annotations, zero if
1987 ; we're not to run it. When flag_var_tracking == 2 (AUTODETECT_VALUE) it
1988 ; will be set according to optimize, debug_info_level and debug_hooks
1989 ; in process_options ().
1991 Common Report Var(flag_var_tracking) Init(2) Optimization
1992 Perform variable tracking
1994 ; Positive if we should track variables at assignments, negative if
1995 ; we should run the var-tracking pass only to discard debug
1996 ; annotations. When flag_var_tracking_assignments ==
1997 ; AUTODETECT_VALUE it will be set according to flag_var_tracking.
1998 fvar-tracking-assignments
1999 Common Report Var(flag_var_tracking_assignments) Init(2) Optimization
2000 Perform variable tracking by annotating assignments
2002 ; Nonzero if we should toggle flag_var_tracking_assignments after
2003 ; processing options and computing its default. */
2004 fvar-tracking-assignments-toggle
2005 Common Report Var(flag_var_tracking_assignments_toggle) Optimization
2006 Toggle -fvar-tracking-assignments
2008 fvar-tracking-uninit
2009 Common Report Var(flag_var_tracking_uninit) Optimization
2010 Perform variable tracking and also tag variables that are uninitialized
2013 Common Report Var(flag_tree_vectorize) Optimization
2014 Enable loop vectorization on trees
2017 Common Report Var(flag_tree_slp_vectorize) Init(2) Optimization
2018 Enable basic block vectorization (SLP) on trees
2021 Common Report Var(flag_vect_cost_model) Optimization
2022 Enable use of cost model in vectorization
2024 ftree-vect-loop-version
2025 Common Report Var(flag_tree_vect_loop_version) Init(1) Optimization
2026 Enable loop versioning when doing loop vectorization on trees
2028 ftree-vectorizer-verbose=
2029 Common RejectNegative Joined UInteger
2030 -ftree-vectorizer-verbose=<number> Set the verbosity level of the vectorizer
2033 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
2034 Enable copy propagation of scalar-evolution information.
2036 ; -fverbose-asm causes extra commentary information to be produced in
2037 ; the generated assembly code (to make it more readable). This option
2038 ; is generally only of use to those who actually need to read the
2039 ; generated assembly code (perhaps while debugging the compiler itself).
2040 ; -fno-verbose-asm, the default, causes the extra information
2041 ; to not be added and is useful when comparing two assembler files.
2043 Common Report Var(flag_verbose_asm)
2044 Add extra commentary to assembler output
2047 Common Joined RejectNegative Enum(symbol_visibility) Var(default_visibility) Init(VISIBILITY_DEFAULT)
2048 -fvisibility=[default|internal|hidden|protected] Set the default symbol visibility
2051 Name(symbol_visibility) Type(enum symbol_visibility) UnknownError(unrecognized visibility value %qs)
2054 Enum(symbol_visibility) String(default) Value(VISIBILITY_DEFAULT)
2057 Enum(symbol_visibility) String(internal) Value(VISIBILITY_INTERNAL)
2060 Enum(symbol_visibility) String(hidden) Value(VISIBILITY_HIDDEN)
2063 Enum(symbol_visibility) String(protected) Value(VISIBILITY_PROTECTED)
2066 Common Report Var(flag_value_profile_transformations) Optimization
2067 Use expression value profiles in optimizations
2070 Common Report Var(flag_web) Init(2) Optimization
2071 Construct webs and split unrelated uses of single variable
2073 ftree-builtin-call-dce
2074 Common Report Var(flag_tree_builtin_call_dce) Init(0) Optimization
2075 Enable conditional dead code elimination for builtin calls
2078 Common Report Var(flag_whole_program) Init(0) Optimization
2079 Perform whole program optimizations
2082 Common Report Var(flag_wrapv) Optimization
2083 Assume signed arithmetic overflow wraps around
2085 fzero-initialized-in-bss
2086 Common Report Var(flag_zero_initialized_in_bss) Init(1)
2087 Put zero initialized data in the bss section
2090 Common JoinedOrMissing
2091 Generate debug information in default format
2094 Common JoinedOrMissing Negative(gdwarf-)
2095 Generate debug information in COFF format
2098 Common Joined UInteger Var(dwarf_version) Init(2) Negative(gstabs)
2099 Generate debug information in DWARF v2 (or later) format
2102 Common JoinedOrMissing
2103 Generate debug information in default extended format
2106 Common JoinedOrMissing Negative(gstabs+)
2107 Generate debug information in STABS format
2110 Common JoinedOrMissing Negative(gvms)
2111 Generate debug information in extended STABS format
2114 Common RejectNegative Var(dwarf_strict,0) Init(-1)
2115 Emit DWARF additions beyond selected version
2118 Common Report RejectNegative Var(dwarf_strict,1)
2119 Don't emit DWARF additions beyond selected version
2122 Common Report Var(flag_gtoggle)
2123 Toggle debug information generation
2126 Common JoinedOrMissing Negative(gxcoff)
2127 Generate debug information in VMS format
2130 Common JoinedOrMissing Negative(gxcoff+)
2131 Generate debug information in XCOFF format
2134 Common JoinedOrMissing Negative(gcoff)
2135 Generate debug information in extended XCOFF format
2138 Driver Joined Separate
2141 Common Joined Var(plugindir_string) Init(0)
2142 -iplugindir=<dir> Set <dir> to be the default plugin directory
2145 Driver Joined Separate
2147 no-canonical-prefixes
2157 Common Driver Joined Separate Var(asm_file_name) MissingArgError(missing filename after %qs)
2158 -o <file> Place output into <file>
2161 Common Var(profile_flag)
2162 Enable function profiling
2165 Driver Var(pass_exit_codes)
2168 Common Var(pedantic)
2169 Issue warnings needed for strict compliance to the standard
2172 Common Var(flag_pedantic_errors)
2173 Like -pedantic but issue them as errors
2179 Driver Var(use_pipes)
2182 Driver JoinedOrMissing Var(print_file_name)
2184 print-libgcc-file-name
2187 print-multi-directory
2188 Driver Var(print_multi_directory)
2191 Driver Var(print_multi_lib)
2193 print-multi-os-directory
2194 Driver Var(print_multi_os_directory)
2197 Driver JoinedOrMissing Var(print_prog_name)
2200 Driver Var(print_search_dirs)
2203 Driver Var(print_sysroot)
2205 print-sysroot-headers-suffix
2206 Driver Var(print_sysroot_headers_suffix)
2209 Common Var(quiet_flag) RejectDriver
2210 Do not display functions compiled or elapsed time
2219 Driver Var(report_times)
2222 Driver JoinedOrMissing
2225 Driver Joined Separate
2229 ; C option, but driver must not handle as "-u ndef".
2232 Common Driver Var(verbose_flag)
2233 Enable verbose output
2236 Common Var(version_flag) RejectDriver
2237 Display the compiler's version
2240 Common Var(inhibit_warnings)
2244 Driver Separate Var(wrapper_string)
2247 Driver Joined Separate
2250 Common RejectNegative Negative(pie)
2251 Create a shared library
2257 Driver Separate Alias(specs=)
2270 ; Documented for Fortran, but always accepted by driver.
2279 Common RejectNegative Negative(shared)
2280 Create a position independent executable
2283 Driver Joined Separate
2285 ; This comment is to ensure we retain the blank line above.