Daily bump.
[official-gcc.git] / gcc / common.opt
blob784a4b0a05303d72a7b5e76dbf1a7d1044a7b578
1 ; Options for the language- and target-independent parts of the compiler.
3 ; Copyright (C) 2003-2014 Free Software Foundation, Inc.
5 ; This file is part of GCC.
7 ; GCC is free software; you can redistribute it and/or modify it under
8 ; the terms of the GNU General Public License as published by the Free
9 ; Software Foundation; either version 3, or (at your option) any later
10 ; version.
12 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 ; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
15 ; for more details.
17 ; You should have received a copy of the GNU General Public License
18 ; along with GCC; see the file COPYING3.  If not see
19 ; <http://www.gnu.org/licenses/>.
21 ; See the GCC internals manual (options.texi) for a description of this file's format.
23 ; Please try to keep this file in ASCII collating order.
25 Variable
26 int target_flags
28 Variable
29 int optimize
31 Variable
32 int optimize_size
34 Variable
35 int optimize_debug
37 ; Not used directly to control optimizations, only to save -Ofast
38 ; setting for "optimize" attributes.
39 Variable
40 int optimize_fast
42 ; True if this is the lto front end.  This is used to disable gimple
43 ; generation and lowering passes that are normally run on the output
44 ; of a front end.  These passes must be bypassed for lto since they
45 ; have already been done before the gimple was written.
46 Variable
47 bool in_lto_p = false
49 ; 0 means straightforward implementation of complex divide acceptable.
50 ; 1 means wide ranges of inputs must work for complex divide.
51 ; 2 means C99-like requirements for complex multiply and divide.
52 Variable
53 int flag_complex_method = 1
55 ; Nonzero if subexpressions must be evaluated from left-to-right.
56 Variable
57 int flag_evaluation_order = 0
59 ; Language specific warning pass for unused results.
60 Variable
61 bool flag_warn_unused_result = false
63 Variable
64 int *param_values
66 ; Nonzero if we should write GIMPLE bytecode for link-time optimization.
67 Variable
68 int flag_generate_lto
70 ; True to warn about any objects definitions whose size is larger
71 ; than N bytes.  Also want about function definitions whose returned
72 ; values are larger than N bytes, where N is 'larger_than_size'.
73 Variable
74 bool warn_larger_than
76 Variable
77 HOST_WIDE_INT larger_than_size
79 ; True to warn about any function whose frame size is larger
80 ; than N bytes.
81 Variable
82 bool warn_frame_larger_than
84 Variable
85 HOST_WIDE_INT frame_larger_than_size
87 ; Nonzero means we should be saving declaration info into a .X file.
88 Variable
89 int flag_gen_aux_info = 0
91 ; Nonzero if we are compiling code for a shared library, zero for
92 ; executable.
93 Variable
94 int flag_shlib
96 ; These two are really VEC(char_p,heap) *.
98 Variable
99 void *flag_instrument_functions_exclude_functions
101 Variable
102 void *flag_instrument_functions_exclude_files
104 ; Generic structs (e.g. templates not explicitly specialized)
105 ; may not have a compilation unit associated with them, and so
106 ; may need to be treated differently from ordinary structs.
108 ; Structs only handled by reference (indirectly), will also usually
109 ; not need as much debugging information.
111 Variable
112 enum debug_struct_file debug_struct_ordinary[DINFO_USAGE_NUM_ENUMS] = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY }
114 Variable
115 enum debug_struct_file debug_struct_generic[DINFO_USAGE_NUM_ENUMS] = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY }
117 ; True if we should exit after parsing options.
118 Variable
119 bool exit_after_options
121 ; Type(s) of debugging information we are producing (if any).  See
122 ; flag-types.h for the definitions of the different possible types of
123 ; debugging information.
124 Variable
125 enum debug_info_type write_symbols = NO_DEBUG
127 ; Level of debugging information we are producing.  See flag-types.h
128 ; for the definitions of the different possible levels.
129 Variable
130 enum debug_info_levels debug_info_level = DINFO_LEVEL_NONE
132 ; Nonzero means use GNU-only extensions in the generated symbolic
133 ; debugging information.  Currently, this only has an effect when
134 ; write_symbols is set to DBX_DEBUG, XCOFF_DEBUG, or DWARF_DEBUG.
135 Variable
136 bool use_gnu_debug_info_extensions
138 ; Original value of maximum field alignment in bytes, specified via
139 ; -fpack-struct=<value>.
140 Variable
141 unsigned int initial_max_fld_align = TARGET_DEFAULT_PACK_STRUCT
143 ; Type of stack check.
144 Variable
145 enum stack_check_type flag_stack_check = NO_STACK_CHECK
147 ; True if stack usage information needs to be computed.
148 Variable
149 bool flag_stack_usage_info = false
151 ; -dA causes debug commentary information to be produced in
152 ; the generated assembly code (to make it more readable).  This option
153 ; is generally only of use to those who actually need to read the
154 ; generated assembly code (perhaps while debugging the compiler itself).
155 ; Currently, this switch is only used by dwarf2out.c; however, it is intended
156 ; to be a catchall for printing debug information in the assembler file.
157 Variable
158 int flag_debug_asm
160 ; -dP causes the rtl to be emitted as a comment in assembly.
161 Variable
162 int flag_dump_rtl_in_asm
164 ; Whether -da was passed (used only in handle_common_deferred_options).
165 Variable
166 bool flag_dump_all_passed
168 ; Other flags saying which kinds of debugging dump have been requested.
170 Variable
171 int rtl_dump_and_exit
173 Variable
174 int flag_print_asm_name
176 ; Name of top-level original source file (what was input to cpp).
177 ; This comes from the #-command at the beginning of the actual input.
178 ; If there isn't any there, then this is the cc1 input file name.
179 Variable
180 const char *main_input_filename
182 ; Pointer to base name in main_input_filename, with directories and a
183 ; single final extension removed, and the length of this base
184 ; name.
186 Variable
187 const char *main_input_basename
189 Variable
190 int main_input_baselength
192 ; Which options have been printed by --help.
193 Variable
194 char *help_printed
196 ; Which enums have been printed by --help.  0 = not printed, no
197 ; relevant options seen, 1 = relevant option seen, not yet printed, 2
198 ; = printed.
199 Variable
200 char *help_enum_printed
202 ; The number of columns for --help output.
203 Variable
204 unsigned int help_columns
206 ; Whether this options structure has been through finish_options
207 Variable
208 bool flag_opts_finished
210 ; What the sanitizer should instrument
211 Variable
212 unsigned int flag_sanitize
214 ; What sanitizers should recover from errors
215 Variable
216 unsigned int flag_sanitize_recover = SANITIZE_UNDEFINED | SANITIZE_NONDEFAULT | SANITIZE_KERNEL_ADDRESS
218 ; Flag whether a prefix has been added to dump_base_name
219 Variable
220 bool dump_base_name_prefixed = false
223 Driver
225 -assemble
226 Driver Alias(S)
228 -compile
229 Driver Alias(c)
231 -coverage
232 Driver Alias(coverage)
234 -debug
235 Common Alias(g)
237 -dump
238 Common Separate Alias(d)
240 -dump=
241 Common Joined Alias(d)
243 -dumpbase
244 Common Separate Alias(dumpbase)
246 -dumpdir
247 Common Separate Alias(dumpdir)
249 -entry
250 Driver Separate Alias(e)
252 -entry=
253 Driver Joined Alias(e)
255 -extra-warnings
256 Common Warning Alias(Wextra)
258 -for-assembler
259 Driver Separate Alias(Xassembler)
261 -for-assembler=
262 Driver JoinedOrMissing Alias(Xassembler)
264 -for-linker
265 Driver Separate Alias(Xlinker)
267 -for-linker=
268 Driver JoinedOrMissing Alias(Xlinker)
270 -force-link
271 Driver Separate Alias(u)
273 -force-link=
274 Driver Joined Alias(u)
276 -help
277 Common Driver Var(help_flag)
278 Display this information
280 -help=
281 Common Driver Report Joined
282 --help=<class>  Display descriptions of a specific class of options.  <class> is one or more of optimizers, target, warnings, undocumented, params
284 -language
285 Driver Separate Alias(x)
287 -language=
288 Driver Joined Alias(x)
290 -library-directory
291 Driver Separate Alias(L)
293 -library-directory=
294 Driver Joined Alias(L)
296 -no-canonical-prefixes
297 Driver Alias(no-canonical-prefixes)
299 -no-standard-libraries
300 Driver Alias(nostdlib)
302 -no-sysroot-suffix
303 Driver Var(no_sysroot_suffix)
305 -no-warnings
306 Common Alias(w)
308 -optimize
309 Common Alias(O)
311 -output
312 Common Driver Separate Alias(o) MissingArgError(missing filename after %qs)
314 -output=
315 Common Driver Joined Alias(o) MissingArgError(missing filename after %qs)
317 -pass-exit-codes
318 Driver Alias(pass-exit-codes)
320 -pedantic
321 Common Alias(Wpedantic)
323 -pedantic-errors
324 Common Alias(pedantic-errors)
326 -pie
327 Driver Alias(pie)
329 -pipe
330 Driver Alias(pipe)
332 -prefix
333 Driver Separate Alias(B)
335 -prefix=
336 Driver JoinedOrMissing Alias(B)
338 -preprocess
339 Driver Alias(E)
341 -print-file-name
342 Driver Separate Alias(print-file-name=)
344 -print-file-name=
345 Driver JoinedOrMissing Alias(print-file-name=)
347 -print-libgcc-file-name
348 Driver Alias(print-libgcc-file-name)
350 -print-multi-directory
351 Driver Alias(print-multi-directory)
353 -print-multi-lib
354 Driver Alias(print-multi-lib)
356 -print-multi-os-directory
357 Driver Alias(print-multi-os-directory)
359 -print-multiarch
360 Driver Alias(print-multiarch)
362 -print-prog-name
363 Driver Separate Alias(print-prog-name=)
365 -print-prog-name=
366 Driver JoinedOrMissing Alias(print-prog-name=)
368 -print-search-dirs
369 Driver Alias(print-search-dirs)
371 -print-sysroot
372 Driver Alias(print-sysroot)
374 -print-sysroot-headers-suffix
375 Driver Alias(print-sysroot-headers-suffix)
377 -profile
378 Common Alias(p)
380 -save-temps
381 Driver Alias(save-temps)
383 -shared
384 Driver Alias(shared)
386 -specs
387 Driver Separate Alias(specs=)
389 -specs=
390 Driver Joined Alias(specs=)
392 -static
393 Driver Alias(static)
395 -symbolic
396 Driver Alias(symbolic)
398 -target-help
399 Common Driver
400 Alias for --help=target
402 -time
403 Driver Alias(time)
405 -verbose
406 Driver Alias(v)
408 ;; The driver used to convert options such as --help into forms such
409 ;; as -fhelp; the following four entries are for compatibility with
410 ;; any direct uses of those (undocumented) -f forms
411 fhelp
412 Common Driver Alias(-help)
414 fhelp=
415 Common Driver Joined Alias(-help=)
417 ftarget-help
418 Common Driver Alias(-target-help)
420 fversion
421 Common Driver Alias(-version)
423 -param
424 Common Separate
425 --param <param>=<value> Set parameter <param> to value.  See below for a complete list of parameters
427 -param=
428 Common Joined Alias(-param)
430 -sysroot
431 Driver Separate Alias(-sysroot=)
433 -sysroot=
434 Driver JoinedOrMissing
436 -version
437 Common Driver
440 Driver Joined Separate
443 Driver
446 Driver Joined Separate
449 Driver
452 Common JoinedOrMissing Optimization
453 -O<number>      Set optimization level to <number>
456 Common Optimization
457 Optimize for space rather than speed
459 Ofast
460 Common Optimization
461 Optimize for speed disregarding exact standards compliance
464 Common Optimization
465 Optimize for debugging experience rather than speed or size
468 Driver
471 Driver Negative(Qy)
474 Driver Negative(Qn)
477 Driver Joined Separate
480 Driver
483 Driver Joined Separate
485 Tbss
486 Driver Separate
488 Tbss=
489 Driver Joined
491 Tdata
492 Driver Separate
494 Tdata=
495 Driver Joined
497 Ttext
498 Driver Separate
500 Ttext=
501 Driver Joined
504 Common RejectNegative Warning Alias(Wextra)
505 This switch is deprecated; use -Wextra instead
508 Driver JoinedOrMissing
511 Driver JoinedOrMissing
514 Driver JoinedOrMissing
516 Waggregate-return
517 Common Var(warn_aggregate_return) Warning
518 Warn about returning structures, unions or arrays
520 Waggressive-loop-optimizations
521 Common Var(warn_aggressive_loop_optimizations) Init(1) Warning
522 Warn if a loop with constant number of iterations triggers undefined behavior
524 Warray-bounds
525 Common Var(warn_array_bounds) Warning
526 Warn if an array is accessed out of bounds
528 Wattributes
529 Common Var(warn_attributes) Init(1) Warning
530 Warn about inappropriate attribute usage
532 Wcast-align
533 Common Var(warn_cast_align) Warning
534 Warn about pointer casts which increase alignment
536 Wcpp
537 Common Var(warn_cpp) Init(1) Warning
538 Warn when a #warning directive is encountered
540 Wdeprecated-declarations
541 Common Var(warn_deprecated_decl) Init(1) Warning
542 Warn about uses of __attribute__((deprecated)) declarations
544 Wdisabled-optimization
545 Common Var(warn_disabled_optimization) Warning
546 Warn when an optimization pass is disabled
548 Werror
549 Common Var(warnings_are_errors)
550 Treat all warnings as errors
552 Werror=
553 Common Joined
554 Treat specified warning as error
556 Wextra
557 Common Var(extra_warnings) Warning
558 Print extra (possibly unwanted) warnings
560 Wfatal-errors
561 Common Var(flag_fatal_errors)
562 Exit on the first error occurred
564 Wframe-larger-than=
565 Common RejectNegative Joined UInteger
566 -Wframe-larger-than=<number>    Warn if a function's stack frame requires more than <number> bytes
568 Wfree-nonheap-object
569 Common Var(warn_free_nonheap_object) Init(1) Warning
570 Warn when attempting to free a non-heap object
572 Winline
573 Common Var(warn_inline) Warning
574 Warn when an inlined function cannot be inlined
576 Winvalid-memory-model
577 Common Var(warn_invalid_memory_model) Init(1) Warning
578 Warn when an atomic memory model parameter is known to be outside the valid range.
580 Wlarger-than-
581 Common RejectNegative Joined Warning Undocumented Alias(Wlarger-than=)
583 Wlarger-than=
584 Common RejectNegative Joined UInteger Warning
585 -Wlarger-than=<number>  Warn if an object is larger than <number> bytes
587 Wunsafe-loop-optimizations
588 Common Var(warn_unsafe_loop_optimizations) Warning
589 Warn if the loop cannot be optimized due to nontrivial assumptions.
591 Wmissing-noreturn
592 Common Alias(Wsuggest-attribute=noreturn)
594 Wodr
595 Common Var(warn_odr_violations) Init(1) Warning
596 Warn about some C++ One Definition Rule violations during link time optimization
598 Woverflow
599 Common Var(warn_overflow) Init(1) Warning
600 Warn about overflow in arithmetic expressions
602 Wpacked
603 Common Var(warn_packed) Warning
604 Warn when the packed attribute has no effect on struct layout
606 Wpadded
607 Common Var(warn_padded) Warning
608 Warn when padding is required to align structure members
610 Wpedantic
611 Common Var(pedantic) Init(0) Warning
612 Issue warnings needed for strict compliance to the standard
614 Wreturn-local-addr
615 Common Var(warn_return_local_addr) Init(1) Warning
616 Warn about returning a pointer/reference to a local or temporary variable.
618 Wshadow
619 Common Var(warn_shadow) Warning
620 Warn when one local variable shadows another
622 Wstack-protector
623 Common Var(warn_stack_protect) Warning
624 Warn when not issuing stack smashing protection for some reason
626 Wstack-usage=
627 Common Joined RejectNegative UInteger Var(warn_stack_usage) Init(-1) Warning
628 Warn if stack usage might be larger than specified amount
630 Wstrict-aliasing
631 Common Warning
632 Warn about code which might break strict aliasing rules
634 Wstrict-aliasing=
635 Common Joined RejectNegative UInteger Var(warn_strict_aliasing) Warning
636 Warn about code which might break strict aliasing rules
638 Wstrict-overflow
639 Common Warning
640 Warn about optimizations that assume that signed overflow is undefined
642 Wstrict-overflow=
643 Common Joined RejectNegative UInteger Var(warn_strict_overflow) Warning
644 Warn about optimizations that assume that signed overflow is undefined
646 Wsuggest-attribute=const
647 Common Var(warn_suggest_attribute_const) Warning
648 Warn about functions which might be candidates for __attribute__((const))
650 Wsuggest-attribute=pure
651 Common Var(warn_suggest_attribute_pure) Warning
652 Warn about functions which might be candidates for __attribute__((pure))
654 Wsuggest-attribute=noreturn
655 Common Var(warn_suggest_attribute_noreturn) Warning
656 Warn about functions which might be candidates for __attribute__((noreturn))
658 Wsuggest-final-types
659 Common Var(warn_suggest_final_types) Warning
660 Warn about C++ polymorphic types where adding final keyword would improve code quality
662 Wsuggest-final-methods
663 Common Var(warn_suggest_final_methods) Warning
664 Warn about C++ virtual methods where adding final keyword would improve code quality
666 Wsystem-headers
667 Common Var(warn_system_headers) Warning
668 Do not suppress warnings from system headers
670 Wtrampolines
671 Common Var(warn_trampolines) Warning
672 Warn whenever a trampoline is generated
674 Wtype-limits
675 Common Var(warn_type_limits) Warning EnabledBy(Wextra)
676 Warn if a comparison is always true or always false due to the limited range of the data type
678 Wuninitialized
679 Common Var(warn_uninitialized) Warning EnabledBy(Wextra)
680 Warn about uninitialized automatic variables
682 Wmaybe-uninitialized
683 Common Var(warn_maybe_uninitialized) Warning EnabledBy(Wuninitialized)
684 Warn about maybe uninitialized automatic variables
686 Wunreachable-code
687 Common Ignore
688 Does nothing. Preserved for backward compatibility.
690 Wunused
691 Common Var(warn_unused) Init(0) Warning
692 Enable all -Wunused- warnings
694 Wunused-but-set-parameter
695 Common Var(warn_unused_but_set_parameter) Warning EnabledBy(Wunused && Wextra)
696 Warn when a function parameter is only set, otherwise unused
698 Wunused-but-set-variable
699 Common Var(warn_unused_but_set_variable) Warning EnabledBy(Wunused)
700 Warn when a variable is only set, otherwise unused
702 Wunused-function
703 Common Var(warn_unused_function) Warning EnabledBy(Wunused)
704 Warn when a function is unused
706 Wunused-label
707 Common Var(warn_unused_label) Warning EnabledBy(Wunused)
708 Warn when a label is unused
710 Wunused-parameter
711 Common Var(warn_unused_parameter) Warning EnabledBy(Wunused && Wextra)
712 Warn when a function parameter is unused
714 Wunused-value
715 Common Var(warn_unused_value) Warning EnabledBy(Wunused)
716 Warn when an expression value is unused
718 Wunused-variable
719 Common Var(warn_unused_variable) Warning EnabledBy(Wunused)
720 Warn when a variable is unused
722 Wcoverage-mismatch
723 Common Var(warn_coverage_mismatch) Init(1) Warning
724 Warn in case profiles in -fprofile-use do not match
726 Wvector-operation-performance
727 Common Var(warn_vector_operation_performance) Warning
728 Warn when a vector operation is compiled outside the SIMD
730 Xassembler
731 Driver Separate
733 Xlinker
734 Driver Separate
736 Xpreprocessor
737 Driver Separate
740 Driver
742 aux-info
743 Common Separate Var(aux_info_file_name)
744 -aux-info <file>        Emit declaration information into <file>
746 aux-info=
747 Common Joined Alias(aux-info)
749 auxbase
750 Common Separate RejectDriver Var(aux_base_name)
752 auxbase-strip
753 Common Separate RejectDriver
755 coverage
756 Driver
759 Driver
762 Common Joined
763 -d<letters>     Enable dumps from specific passes of the compiler
765 dumpbase
766 Common Separate Var(dump_base_name)
767 -dumpbase <file>        Set the file basename to be used for dumps
769 dumpdir
770 Common Separate Var(dump_dir_name)
771 -dumpdir <dir>  Set the directory name to be used for dumps
773 dumpmachine
774 Driver
776 dumpspecs
777 Driver
779 dumpversion
780 Driver
783 Driver Joined Separate
785 ; This option has historically been passed down to the linker by an
786 ; accident of a %{e*} spec, so ensure it continues to be passed down
787 ; as a single option.  The supported option for this purpose is
788 ; -rdynamic.  See PR 47390.
789 export-dynamic
790 Driver Undocumented
792 ; The version of the C++ ABI in use.  The following values are allowed:
794 ; 0: The version of the ABI believed most conformant with the C++ ABI
795 ;    specification.  This ABI may change as bugs are discovered and fixed.
796 ;    Therefore, 0 will not necessarily indicate the same ABI in different
797 ;    versions of G++.
799 ; 1: The version of the ABI first used in G++ 3.2.  No longer selectable.
801 ; 2: The version of the ABI first used in G++ 3.4 (and current default).
803 ; 3: The version of the ABI that fixes the missing underscore
804 ;    in template non-type arguments of pointer type.
806 ; 4: The version of the ABI that introduces unambiguous mangling of
807 ;    vector types.  First selectable in G++ 4.5.
809 ; 5: The version of the ABI that ignores attribute const/noreturn
810 ;    in function pointer mangling, and corrects mangling of decltype and
811 ;    function parameters used in other parameters and the return type.
812 ;    First selectable in G++ 4.6.
814 ; 6: The version of the ABI that doesn't promote scoped enums to int and
815 ;    changes the mangling of template argument packs, const/static_cast,
816 ;    prefix ++ and --, and a class scope function used as a template
817 ;    argument.
818 ;    First selectable in G++ 4.7.
820 ; 7: The version of the ABI that treats nullptr_t as a builtin type and
821 ;    corrects the mangling of lambdas in default argument scope.
822 ;    First selectable in G++ 4.8.
824 ; 8: The version of the ABI that corrects the substitution behavior of
825 ;    function types with function-cv-qualifiers.
826 ;    First selectable in G++ 4.9.
828 ; Additional positive integers will be assigned as new versions of
829 ; the ABI become the default version of the ABI.
830 fabi-version=
831 Common Joined RejectNegative UInteger Var(flag_abi_version) Init(0)
832 The version of the C++ ABI in use
834 faggressive-loop-optimizations
835 Common Report Var(flag_aggressive_loop_optimizations) Optimization Init(1) 
836 Aggressively optimize loops using language constraints
838 falign-functions
839 Common Report Var(align_functions,0) Optimization UInteger
840 Align the start of functions
842 falign-functions=
843 Common RejectNegative Joined UInteger Var(align_functions)
845 falign-jumps
846 Common Report Var(align_jumps,0) Optimization UInteger
847 Align labels which are only reached by jumping
849 falign-jumps=
850 Common RejectNegative Joined UInteger Var(align_jumps)
852 falign-labels
853 Common Report Var(align_labels,0) Optimization UInteger
854 Align all labels
856 falign-labels=
857 Common RejectNegative Joined UInteger Var(align_labels)
859 falign-loops
860 Common Report Var(align_loops,0) Optimization UInteger
861 Align the start of loops
863 falign-loops=
864 Common RejectNegative Joined UInteger Var(align_loops)
866 fargument-alias
867 Common Ignore
868 Does nothing. Preserved for backward compatibility.
870 fargument-noalias
871 Common Ignore
872 Does nothing. Preserved for backward compatibility.
874 fargument-noalias-global
875 Common Ignore
876 Does nothing. Preserved for backward compatibility.
878 fargument-noalias-anything
879 Common Ignore
880 Does nothing. Preserved for backward compatibility.
882 fsanitize=
883 Common Driver Report Joined
884 Select what to sanitize
886 fasan-shadow-offset=
887 Common Joined RejectNegative Var(common_deferred_options) Defer
888 -fasan-shadow-offset=<number>   Use custom shadow memory offset.
890 fsanitize-recover=
891 Common Report Joined
892 After diagnosing undefined behavior attempt to continue execution
894 fsanitize-recover
895 Common Report
896 This switch is deprecated; use -fsanitize-recover= instead
898 fsanitize-undefined-trap-on-error
899 Common Report Var(flag_sanitize_undefined_trap_on_error) Init(0)
900 Use trap instead of a library function for undefined behavior sanitization
902 fasynchronous-unwind-tables
903 Common Report Var(flag_asynchronous_unwind_tables) Optimization
904 Generate unwind tables that are exact at each instruction boundary
906 fauto-inc-dec
907 Common Report Var(flag_auto_inc_dec) Init(1)
908 Generate auto-inc/dec instructions
910 fauto-profile
911 Common Report Var(flag_auto_profile) Optimization
912 Use sample profile information for call graph node weights. The default
913 profile file is fbdata.afdo in 'pwd'.
915 fauto-profile=
916 Common Joined RejectNegative Var(auto_profile_file)
917 Use sample profile information for call graph node weights. The profile
918 file is specified in the argument.
920 ; -fcheck-bounds causes gcc to generate array bounds checks.
921 ; For C, C++ and ObjC: defaults off.
922 ; For Java: defaults to on.
923 ; For Fortran: defaults to off.
924 fbounds-check
925 Common Report Var(flag_bounds_check)
926 Generate code to check bounds before indexing arrays
928 fbranch-count-reg
929 Common Report Var(flag_branch_on_count_reg) Optimization
930 Replace add, compare, branch with branch on count register
932 fbranch-probabilities
933 Common Report Var(flag_branch_probabilities) Optimization
934 Use profiling information for branch probabilities
936 fbranch-target-load-optimize
937 Common Report Var(flag_branch_target_load_optimize) Optimization
938 Perform branch target load optimization before prologue / epilogue threading
940 fbranch-target-load-optimize2
941 Common Report Var(flag_branch_target_load_optimize2) Optimization
942 Perform branch target load optimization after prologue / epilogue threading
944 fbtr-bb-exclusive
945 Common Report Var(flag_btr_bb_exclusive) Optimization
946 Restrict target load migration not to re-use registers in any basic block
948 fcall-saved-
949 Common Joined RejectNegative Var(common_deferred_options) Defer
950 -fcall-saved-<register> Mark <register> as being preserved across functions
952 fcall-used-
953 Common Joined RejectNegative Var(common_deferred_options) Defer
954 -fcall-used-<register>  Mark <register> as being corrupted by function calls
956 ; Nonzero for -fcaller-saves: allocate values in regs that need to
957 ; be saved across function calls, if that produces overall better code.
958 ; Optional now, so people can test it.
959 fcaller-saves
960 Common Report Var(flag_caller_saves) Optimization
961 Save registers around function calls
963 fcheck-data-deps
964 Common Report Var(flag_check_data_deps)
965 Compare the results of several data dependence analyzers.
967 fcheck-new
968 Common Var(flag_check_new)
969 Check the return value of new in C++
971 fcombine-stack-adjustments
972 Common Report Var(flag_combine_stack_adjustments) Optimization
973 Looks for opportunities to reduce stack adjustments and stack references.
975 fcommon
976 Common Report Var(flag_no_common,0) Optimization
977 Do not put uninitialized globals in the common section
979 fcompare-debug
980 Driver
981 ; Converted by the driver to -fcompare-debug= options.
983 fcompare-debug=
984 Common Driver JoinedOrMissing RejectNegative Var(flag_compare_debug_opt)
985 -fcompare-debug[=<opts>]        Compile with and without e.g. -gtoggle, and compare the final-insns dump
987 fcompare-debug-second
988 Common Driver RejectNegative Var(flag_compare_debug)
989 Run only the second compilation of -fcompare-debug
991 fcompare-elim
992 Common Report Var(flag_compare_elim_after_reload) Optimization
993 Perform comparison elimination after register allocation has finished
995 fconserve-stack
996 Common Var(flag_conserve_stack) Optimization
997 Do not perform optimizations increasing noticeably stack usage
999 fcprop-registers
1000 Common Report Var(flag_cprop_registers) Optimization
1001 Perform a register copy-propagation optimization pass
1003 fcrossjumping
1004 Common Report Var(flag_crossjumping) Optimization
1005 Perform cross-jumping optimization
1007 fcse-follow-jumps
1008 Common Report Var(flag_cse_follow_jumps) Optimization
1009 When running CSE, follow jumps to their targets
1011 fcse-skip-blocks
1012 Common Ignore
1013 Does nothing.  Preserved for backward compatibility.
1015 fcx-limited-range
1016 Common Report Var(flag_cx_limited_range) Optimization SetByCombined
1017 Omit range reduction step when performing complex division
1019 fcx-fortran-rules
1020 Common Report Var(flag_cx_fortran_rules) Optimization
1021 Complex multiplication and division follow Fortran rules
1023 fdata-sections
1024 Common Report Var(flag_data_sections) Optimization
1025 Place data items into their own section
1027 fdbg-cnt-list
1028 Common Report Var(common_deferred_options) Defer
1029 List all available debugging counters with their limits and counts.
1031 fdbg-cnt=
1032 Common RejectNegative Joined Var(common_deferred_options) Defer
1033 -fdbg-cnt=<counter>:<limit>[,<counter>:<limit>,...]     Set the debug counter limit.   
1035 fdebug-prefix-map=
1036 Common Joined RejectNegative Var(common_deferred_options) Defer
1037 Map one directory name to another in debug information
1039 fdebug-types-section
1040 Common Report Var(flag_debug_types_section) Init(0)
1041 Output .debug_types section when using DWARF v4 debuginfo.
1043 ; Nonzero for -fdefer-pop: don't pop args after each function call
1044 ; instead save them up to pop many calls' args with one insns.
1045 fdefer-pop
1046 Common Report Var(flag_defer_pop) Optimization
1047 Defer popping functions args from stack until later
1049 fdelayed-branch
1050 Common Report Var(flag_delayed_branch) Optimization
1051 Attempt to fill delay slots of branch instructions
1053 fdelete-dead-exceptions
1054 Common Report Var(flag_delete_dead_exceptions) Init(0)
1055 Delete dead instructions that may throw exceptions
1057 fdelete-null-pointer-checks
1058 Common Report Var(flag_delete_null_pointer_checks) Init(1) Optimization
1059 Delete useless null pointer checks
1061 fdevirtualize-speculatively
1062 Common Report Var(flag_devirtualize_speculatively) Optimization
1063 Perform speculative devirtualization
1065 fdevirtualize
1066 Common Report Var(flag_devirtualize) Optimization
1067 Try to convert virtual calls to direct ones.
1069 fdiagnostics-show-location=
1070 Common Joined RejectNegative Enum(diagnostic_prefixing_rule)
1071 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
1073 ; Required for these enum values.
1074 SourceInclude
1075 pretty-print.h
1077 Enum
1078 Name(diagnostic_prefixing_rule) Type(int)
1080 EnumValue
1081 Enum(diagnostic_prefixing_rule) String(once) Value(DIAGNOSTICS_SHOW_PREFIX_ONCE)
1083 EnumValue
1084 Enum(diagnostic_prefixing_rule) String(every-line) Value(DIAGNOSTICS_SHOW_PREFIX_EVERY_LINE)
1086 fdiagnostics-show-caret
1087 Common Var(flag_diagnostics_show_caret) Init(1)
1088 Show the source line with a caret indicating the column
1090 fdiagnostics-color
1091 Common Alias(fdiagnostics-color=,always,never)
1094 fdiagnostics-color=
1095 Common Joined RejectNegative Var(flag_diagnostics_show_color) Enum(diagnostic_color_rule) Init(DIAGNOSTICS_COLOR_NO)
1096 -fdiagnostics-color=[never|always|auto] Colorize diagnostics
1098 ; Required for these enum values.
1099 SourceInclude
1100 diagnostic-color.h
1102 Enum
1103 Name(diagnostic_color_rule) Type(int)
1105 EnumValue
1106 Enum(diagnostic_color_rule) String(never) Value(DIAGNOSTICS_COLOR_NO)
1108 EnumValue
1109 Enum(diagnostic_color_rule) String(always) Value(DIAGNOSTICS_COLOR_YES)
1111 EnumValue
1112 Enum(diagnostic_color_rule) String(auto) Value(DIAGNOSTICS_COLOR_AUTO)
1114 fdiagnostics-show-option
1115 Common Var(flag_diagnostics_show_option) Init(1)
1116 Amend appropriate diagnostic messages with the command line option that controls them
1118 fdisable-
1119 Common Joined RejectNegative Var(common_deferred_options) Defer
1120 -fdisable-[tree|rtl|ipa]-<pass>=range1+range2 disables an optimization pass
1122 fenable-
1123 Common Joined RejectNegative Var(common_deferred_options) Defer
1124 -fenable-[tree|rtl|ipa]-<pass>=range1+range2 enables an optimization pass
1126 fdump-
1127 Common Joined RejectNegative Var(common_deferred_options) Defer
1128 -fdump-<type>   Dump various compiler internals to a file
1130 fdump-final-insns
1131 Driver RejectNegative
1133 fdump-final-insns=
1134 Common RejectNegative Joined Var(flag_dump_final_insns)
1135 -fdump-final-insns=filename     Dump to filename the insns at the end of translation
1137 fdump-go-spec=
1138 Common RejectNegative Joined Var(flag_dump_go_spec)
1139 -fdump-go-spec=filename Write all declarations to file as Go code
1141 fdump-noaddr
1142 Common Report Var(flag_dump_noaddr)
1143 Suppress output of addresses in debugging dumps
1145 freport-bug
1146 Common Driver Var(flag_report_bug)
1147 Collect and dump debug information into temporary file if ICE in C/C++
1148 compiler occured.
1150 fdump-passes
1151 Common Var(flag_dump_passes) Init(0)
1152 Dump optimization passes
1154 fdump-unnumbered
1155 Common Report Var(flag_dump_unnumbered)
1156 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
1158 fdump-unnumbered-links
1159 Common Report Var(flag_dump_unnumbered_links)
1160 Suppress output of previous and next insn numbers in debugging dumps
1162 fdwarf2-cfi-asm
1163 Common Report Var(flag_dwarf2_cfi_asm) Init(HAVE_GAS_CFI_DIRECTIVE)
1164 Enable CFI tables via GAS assembler directives.
1166 fearly-inlining
1167 Common Report Var(flag_early_inlining) Init(1) Optimization
1168 Perform early inlining
1170 feliminate-dwarf2-dups
1171 Common Report Var(flag_eliminate_dwarf2_dups)
1172 Perform DWARF2 duplicate elimination
1174 fipa-sra
1175 Common Report Var(flag_ipa_sra) Init(0) Optimization
1176 Perform interprocedural reduction of aggregates
1178 feliminate-unused-debug-symbols
1179 Common Report Var(flag_debug_only_used_symbols)
1180 Perform unused type elimination in debug info
1182 feliminate-unused-debug-types
1183 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
1184 Perform unused type elimination in debug info
1186 femit-class-debug-always
1187 Common Report Var(flag_emit_class_debug_always) Init(0)
1188 Do not suppress C++ class debug information.
1190 fexceptions
1191 Common Report Var(flag_exceptions) Optimization
1192 Enable exception handling
1194 fexpensive-optimizations
1195 Common Report Var(flag_expensive_optimizations) Optimization
1196 Perform a number of minor, expensive optimizations
1198 fexcess-precision=
1199 Common Joined RejectNegative Enum(excess_precision) Var(flag_excess_precision_cmdline) Init(EXCESS_PRECISION_DEFAULT)
1200 -fexcess-precision=[fast|standard]      Specify handling of excess floating-point precision
1202 Enum
1203 Name(excess_precision) Type(enum excess_precision) UnknownError(unknown excess precision style %qs)
1205 EnumValue
1206 Enum(excess_precision) String(fast) Value(EXCESS_PRECISION_FAST)
1208 EnumValue
1209 Enum(excess_precision) String(standard) Value(EXCESS_PRECISION_STANDARD)
1211 ffast-math
1212 Common
1214 ffat-lto-objects
1215 Common Var(flag_fat_lto_objects)
1216 Output lto objects containing both the intermediate language and binary output.
1218 ffinite-math-only
1219 Common Report Var(flag_finite_math_only) Optimization SetByCombined
1220 Assume no NaNs or infinities are generated
1222 ffixed-
1223 Common Joined RejectNegative Var(common_deferred_options) Defer
1224 -ffixed-<register>      Mark <register> as being unavailable to the compiler
1226 ffloat-store
1227 Common Report Var(flag_float_store) Optimization
1228 Don't allocate floats and doubles in extended-precision registers
1230 fforce-addr
1231 Common Ignore
1232 Does nothing.  Preserved for backward compatibility.
1234 fforward-propagate
1235 Common Report Var(flag_forward_propagate) Optimization
1236 Perform a forward propagation pass on RTL
1238 ffp-contract=
1239 Common Joined RejectNegative Enum(fp_contract_mode) Var(flag_fp_contract_mode) Init(FP_CONTRACT_FAST)
1240 -ffp-contract=[off|on|fast] Perform floating-point expression contraction.
1242 Enum
1243 Name(fp_contract_mode) Type(enum fp_contract_mode) UnknownError(unknown floating point contraction style %qs)
1245 EnumValue
1246 Enum(fp_contract_mode) String(off) Value(FP_CONTRACT_OFF)
1248 ; Not implemented, fall back to conservative FP_CONTRACT_OFF.
1249 EnumValue
1250 Enum(fp_contract_mode) String(on) Value(FP_CONTRACT_OFF)
1252 EnumValue
1253 Enum(fp_contract_mode) String(fast) Value(FP_CONTRACT_FAST)
1255 ; Nonzero means don't put addresses of constant functions in registers.
1256 ; Used for compiling the Unix kernel, where strange substitutions are
1257 ; done on the assembly output.
1258 ffunction-cse
1259 Common Report Var(flag_no_function_cse,0)
1260 Allow function addresses to be held in registers
1262 ffunction-sections
1263 Common Report Var(flag_function_sections)
1264 Place each function into its own section
1266 fgcse
1267 Common Report Var(flag_gcse) Optimization
1268 Perform global common subexpression elimination
1270 fgcse-lm
1271 Common Report Var(flag_gcse_lm) Init(1) Optimization
1272 Perform enhanced load motion during global common subexpression elimination
1274 fgcse-sm
1275 Common Report Var(flag_gcse_sm) Init(0) Optimization
1276 Perform store motion after global common subexpression elimination
1278 fgcse-las
1279 Common Report Var(flag_gcse_las) Init(0) Optimization
1280 Perform redundant load after store elimination in global common subexpression
1281 elimination
1283 fgcse-after-reload
1284 Common Report Var(flag_gcse_after_reload) Optimization
1285 Perform global common subexpression elimination after register allocation
1286 has finished
1288 ; This option is not documented yet as its semantics will change.
1289 fgraphite
1290 Common Report Var(flag_graphite)
1291 Enable in and out of Graphite representation
1293 fgraphite-identity
1294 Common Report Var(flag_graphite_identity) Optimization
1295 Enable Graphite Identity transformation
1297 fhoist-adjacent-loads
1298 Common Report Var(flag_hoist_adjacent_loads) Optimization
1299 Enable hoisting adjacent loads to encourage generating conditional move
1300 instructions
1302 floop-parallelize-all
1303 Common Report Var(flag_loop_parallelize_all) Optimization
1304 Mark all loops as parallel
1306 floop-strip-mine
1307 Common Report Var(flag_loop_strip_mine) Optimization
1308 Enable Loop Strip Mining transformation
1310 floop-interchange
1311 Common Report Var(flag_loop_interchange) Optimization
1312 Enable Loop Interchange transformation
1314 floop-block
1315 Common Report Var(flag_loop_block) Optimization
1316 Enable Loop Blocking transformation
1318 fgnu-tm
1319 Common Report Var(flag_tm)
1320 Enable support for GNU transactional memory
1322 fgnu-unique
1323 Common Report Var(flag_gnu_unique) Init(1)
1324 Use STB_GNU_UNIQUE if supported by the assembler
1326 floop-flatten
1327 Common Ignore
1328 Does nothing. Preserved for backward compatibility.
1330 floop-nest-optimize
1331 Common Report Var(flag_loop_optimize_isl) Optimization
1332 Enable the ISL based loop nest optimizer
1334 fstrict-volatile-bitfields
1335 Common Report Var(flag_strict_volatile_bitfields) Init(-1)
1336 Force bitfield accesses to match their type width
1338 fguess-branch-probability
1339 Common Report Var(flag_guess_branch_prob) Optimization
1340 Enable guessing of branch probabilities
1342 ; Nonzero means ignore `#ident' directives.  0 means handle them.
1343 ; Generate position-independent code for executables if possible
1344 ; On SVR4 targets, it also controls whether or not to emit a
1345 ; string identifying the compiler.
1346 fident
1347 Common Report Var(flag_no_ident,0)
1348 Process #ident directives
1350 fif-conversion
1351 Common Report Var(flag_if_conversion) Optimization
1352 Perform conversion of conditional jumps to branchless equivalents
1354 fif-conversion2
1355 Common Report Var(flag_if_conversion2) Optimization
1356 Perform conversion of conditional jumps to conditional execution
1358 fstack-reuse=
1359 Common Joined RejectNegative Enum(stack_reuse_level) Var(flag_stack_reuse) Init(SR_ALL)
1360 -fstack-reuse=[all|named_vars|none] Set stack reuse level for local variables.
1362 Enum
1363 Name(stack_reuse_level) Type(enum stack_reuse_level) UnknownError(unknown Stack Reuse Level %qs)
1365 EnumValue
1366 Enum(stack_reuse_level) String(all) Value(SR_ALL)
1368 EnumValue
1369 Enum(stack_reuse_level) String(named_vars) Value(SR_NAMED_VARS)
1371 EnumValue
1372 Enum(stack_reuse_level) String(none) Value(SR_NONE)
1374 ftree-loop-if-convert
1375 Common Report Var(flag_tree_loop_if_convert) Init(-1) Optimization
1376 Convert conditional jumps in innermost loops to branchless equivalents
1378 ftree-loop-if-convert-stores
1379 Common Report Var(flag_tree_loop_if_convert_stores) Optimization
1380 Also if-convert conditional jumps containing memory writes
1382 ; -finhibit-size-directive inhibits output of .size for ELF.
1383 ; This is used only for compiling crtstuff.c,
1384 ; and it may be extended to other effects
1385 ; needed for crtstuff.c on other systems.
1386 finhibit-size-directive
1387 Common Report Var(flag_inhibit_size_directive)
1388 Do not generate .size directives
1390 findirect-inlining
1391 Common Report Var(flag_indirect_inlining)
1392 Perform indirect inlining
1394 ; General flag to enable inlining.  Specifying -fno-inline will disable
1395 ; all inlining apart from always-inline functions.
1396 finline
1397 Common Report Var(flag_no_inline,0) Init(0) Optimization
1398 Enable inlining of function declared \"inline\", disabling disables all inlining
1400 finline-small-functions
1401 Common Report Var(flag_inline_small_functions) Optimization
1402 Integrate functions into their callers when code size is known not to grow
1404 finline-functions
1405 Common Report Var(flag_inline_functions) Optimization
1406 Integrate functions not declared \"inline\" into their callers when profitable
1408 finline-functions-called-once
1409 Common Report Var(flag_inline_functions_called_once) Optimization
1410 Integrate functions only required by their single caller
1412 finline-limit-
1413 Common RejectNegative Joined Alias(finline-limit=)
1415 finline-limit=
1416 Common RejectNegative Joined UInteger
1417 -finline-limit=<number> Limit the size of inlined functions to <number>
1419 finline-atomics
1420 Common Report Var(flag_inline_atomics) Init(1) Optimization
1421 Inline __atomic operations when a lock free instruction sequence is available.
1423 finstrument-functions
1424 Common Report Var(flag_instrument_function_entry_exit)
1425 Instrument function entry and exit with profiling calls
1427 finstrument-functions-exclude-function-list=
1428 Common RejectNegative Joined
1429 -finstrument-functions-exclude-function-list=name,...  Do not instrument listed functions
1431 finstrument-functions-exclude-file-list=
1432 Common RejectNegative Joined
1433 -finstrument-functions-exclude-file-list=filename,...  Do not instrument functions listed in files
1435 fipa-cp
1436 Common Report Var(flag_ipa_cp) Optimization
1437 Perform interprocedural constant propagation
1439 fipa-cp-clone
1440 Common Report Var(flag_ipa_cp_clone) Optimization
1441 Perform cloning to make Interprocedural constant propagation stronger
1443 fipa-profile
1444 Common Report Var(flag_ipa_profile) Init(0) Optimization
1445 Perform interprocedural profile propagation
1447 fipa-pta
1448 Common Report Var(flag_ipa_pta) Init(0) Optimization
1449 Perform interprocedural points-to analysis
1451 fipa-pure-const
1452 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
1453 Discover pure and const functions
1455 fipa-icf
1456 Common Report Var(flag_ipa_icf) Optimization
1457 Perform Identical Code Folding for functions and read-only variables
1459 fipa-icf-functions
1460 Common Report Var(flag_ipa_icf_functions) Optimization
1461 Perform Identical Code Folding for functions
1463 fipa-icf-variables
1464 Common Report Var(flag_ipa_icf_variables) Optimization
1465 Perform Identical Code Folding for variables
1467 fipa-reference
1468 Common Report Var(flag_ipa_reference) Init(0) Optimization
1469 Discover readonly and non addressable static variables
1471 fipa-matrix-reorg
1472 Common Ignore
1473 Does nothing. Preserved for backward compatibility.
1475 fipa-struct-reorg
1476 Common Ignore
1477 Does nothing. Preserved for backward compatibility.
1479 fira-algorithm=
1480 Common Joined RejectNegative Enum(ira_algorithm) Var(flag_ira_algorithm) Init(IRA_ALGORITHM_CB)
1481 -fira-algorithm=[CB|priority] Set the used IRA algorithm
1483 Enum
1484 Name(ira_algorithm) Type(enum ira_algorithm) UnknownError(unknown IRA algorithm %qs)
1486 EnumValue
1487 Enum(ira_algorithm) String(CB) Value(IRA_ALGORITHM_CB)
1489 EnumValue
1490 Enum(ira_algorithm) String(priority) Value(IRA_ALGORITHM_PRIORITY)
1492 fira-region=
1493 Common Joined RejectNegative Enum(ira_region) Var(flag_ira_region) Init(IRA_REGION_AUTODETECT)
1494 -fira-region=[one|all|mixed] Set regions for IRA
1496 Enum
1497 Name(ira_region) Type(enum ira_region) UnknownError(unknown IRA region %qs)
1499 EnumValue
1500 Enum(ira_region) String(one) Value(IRA_REGION_ONE)
1502 EnumValue
1503 Enum(ira_region) String(all) Value(IRA_REGION_ALL)
1505 EnumValue
1506 Enum(ira_region) String(mixed) Value(IRA_REGION_MIXED)
1508 fira-hoist-pressure
1509 Common Report Var(flag_ira_hoist_pressure) Init(1) Optimization
1510 Use IRA based register pressure calculation
1511 in RTL hoist optimizations.
1513 fira-loop-pressure
1514 Common Report Var(flag_ira_loop_pressure) Optimization
1515 Use IRA based register pressure calculation
1516 in RTL loop optimizations.
1518 fira-share-save-slots
1519 Common Report Var(flag_ira_share_save_slots) Init(1)
1520 Share slots for saving different hard registers.
1522 fira-share-spill-slots
1523 Common Report Var(flag_ira_share_spill_slots) Init(1)
1524 Share stack slots for spilled pseudo-registers.
1526 fira-verbose=
1527 Common RejectNegative Joined UInteger Var(flag_ira_verbose) Init(5)
1528 -fira-verbose=<number>  Control IRA's level of diagnostic messages.
1530 fivopts
1531 Common Report Var(flag_ivopts) Init(1) Optimization
1532 Optimize induction variables on trees
1534 fjump-tables
1535 Common Var(flag_jump_tables) Init(1) Optimization
1536 Use jump tables for sufficiently large switch statements
1538 fkeep-inline-functions
1539 Common Report Var(flag_keep_inline_functions)
1540 Generate code for functions even if they are fully inlined
1542 fkeep-static-consts
1543 Common Report Var(flag_keep_static_consts) Init(1)
1544 Emit static const variables even if they are not used
1546 fleading-underscore
1547 Common Report Var(flag_leading_underscore) Init(-1)
1548 Give external symbols a leading underscore
1550 floop-optimize
1551 Common Ignore
1552 Does nothing.  Preserved for backward compatibility.
1554 flto
1555 Common
1556 Enable link-time optimization.
1558 flto=
1559 Common RejectNegative Joined Var(flag_lto)
1560 Link-time optimization with number of parallel jobs or jobserver.
1562 Enum
1563 Name(lto_partition_model) Type(enum lto_partition_model) UnknownError(unknown LTO partitioning model %qs)
1565 EnumValue
1566 Enum(lto_partition_model) String(none) Value(LTO_PARTITION_NONE)
1568 EnumValue
1569 Enum(lto_partition_model) String(one) Value(LTO_PARTITION_ONE)
1571 EnumValue
1572 Enum(lto_partition_model) String(balanced) Value(LTO_PARTITION_BALANCED)
1574 EnumValue
1575 Enum(lto_partition_model) String(1to1) Value(LTO_PARTITION_1TO1)
1577 EnumValue
1578 Enum(lto_partition_model) String(max) Value(LTO_PARTITION_MAX)
1580 flto-partition=
1581 Common Joined RejectNegative Enum(lto_partition_model) Var(flag_lto_partition) Init(LTO_PARTITION_BALANCED)
1582 Specify the algorithm to partition symbols and vars at linktime
1584 ; The initial value of -1 comes from Z_DEFAULT_COMPRESSION in zlib.h.
1585 flto-compression-level=
1586 Common Joined RejectNegative UInteger Var(flag_lto_compression_level) Init(-1)
1587 -flto-compression-level=<number>        Use zlib compression level <number> for IL
1589 flto-odr-type-merging
1590 Common Report Var(flag_lto_odr_type_mering) Init(1)
1591 Merge C++ types using One Definition Rule
1593 flto-report
1594 Common Report Var(flag_lto_report) Init(0)
1595 Report various link-time optimization statistics
1597 flto-report-wpa
1598 Common Report Var(flag_lto_report_wpa) Init(0)
1599 Report various link-time optimization statistics for WPA only
1601 fmath-errno
1602 Common Report Var(flag_errno_math) Init(1) Optimization SetByCombined
1603 Set errno after built-in math functions
1605 fmax-errors=
1606 Common Joined RejectNegative UInteger Var(flag_max_errors)
1607 -fmax-errors=<number>   Maximum number of errors to report
1609 fmem-report
1610 Common Report Var(mem_report)
1611 Report on permanent memory allocation
1613 fmem-report-wpa
1614 Common Report Var(mem_report_wpa)
1615 Report on permanent memory allocation in WPA only
1617 ; This will attempt to merge constant section constants, if 1 only
1618 ; string constants and constants from constant pool, if 2 also constant
1619 ; variables.
1620 fmerge-all-constants
1621 Common Report Var(flag_merge_constants,2) Init(1) Optimization
1622 Attempt to merge identical constants and constant variables
1624 fmerge-constants
1625 Common Report Var(flag_merge_constants,1) Optimization
1626 Attempt to merge identical constants across compilation units
1628 fmerge-debug-strings
1629 Common Report Var(flag_merge_debug_strings) Init(1)
1630 Attempt to merge identical debug strings across compilation units
1632 fmessage-length=
1633 Common RejectNegative Joined UInteger
1634 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
1636 fmodulo-sched
1637 Common Report Var(flag_modulo_sched) Optimization
1638 Perform SMS based modulo scheduling before the first scheduling pass
1640 fmodulo-sched-allow-regmoves
1641 Common Report Var(flag_modulo_sched_allow_regmoves)
1642 Perform SMS based modulo scheduling with register moves allowed
1644 fmove-loop-invariants
1645 Common Report Var(flag_move_loop_invariants) Optimization
1646 Move loop invariant computations out of loops
1648 fdce
1649 Common Var(flag_dce) Init(1) Optimization
1650 Use the RTL dead code elimination pass
1652 fdse
1653 Common Var(flag_dse) Init(1) Optimization
1654 Use the RTL dead store elimination pass
1656 freschedule-modulo-scheduled-loops
1657 Common Report Var(flag_resched_modulo_sched) Optimization
1658 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
1660 fnon-call-exceptions
1661 Common Report Var(flag_non_call_exceptions) Optimization
1662 Support synchronous non-call exceptions
1664 fomit-frame-pointer
1665 Common Report Var(flag_omit_frame_pointer) Optimization
1666 When possible do not generate stack frames
1668 fopt-info
1669 Common Report Var(flag_opt_info) Optimization
1670 Enable all optimization info dumps on stderr
1672 fopt-info-
1673 Common Joined RejectNegative Var(common_deferred_options) Defer
1674 -fopt-info[-<type>=filename]    Dump compiler optimization details
1676 foptimize-register-move
1677 Common Ignore
1678 Does nothing. Preserved for backward compatibility.
1680 foptimize-sibling-calls
1681 Common Report Var(flag_optimize_sibling_calls) Optimization
1682 Optimize sibling and tail recursive calls
1684 fpartial-inlining
1685 Common Report Var(flag_partial_inlining)
1686 Perform partial inlining
1688 fpre-ipa-mem-report
1689 Common Report Var(pre_ipa_mem_report)
1690 Report on memory allocation before interprocedural optimization
1692 fpost-ipa-mem-report
1693 Common Report Var(post_ipa_mem_report)
1694 Report on memory allocation before interprocedural optimization
1696 fpack-struct
1697 Common Report Var(flag_pack_struct) Optimization
1698 Pack structure members together without holes
1700 fpack-struct=
1701 Common RejectNegative Joined UInteger Optimization
1702 -fpack-struct=<number>  Set initial maximum structure member alignment
1704 fpcc-struct-return
1705 Common Report Var(flag_pcc_struct_return,1) Init(DEFAULT_PCC_STRUCT_RETURN)
1706 Return small aggregates in memory, not registers
1708 fpeel-loops
1709 Common Report Var(flag_peel_loops) Optimization
1710 Perform loop peeling
1712 fpeephole
1713 Common Report Var(flag_no_peephole,0) Optimization
1714 Enable machine specific peephole optimizations
1716 fpeephole2
1717 Common Report Var(flag_peephole2) Optimization
1718 Enable an RTL peephole pass before sched2
1720 fPIC
1721 Common Report Var(flag_pic,2) Negative(fPIE)
1722 Generate position-independent code if possible (large mode)
1724 fPIE
1725 Common Report Var(flag_pie,2) Negative(fpic)
1726 Generate position-independent code for executables if possible (large mode)
1728 fpic
1729 Common Report Var(flag_pic,1) Negative(fpie)
1730 Generate position-independent code if possible (small mode)
1732 fpie
1733 Common Report Var(flag_pie,1) Negative(fPIC)
1734 Generate position-independent code for executables if possible (small mode)
1736 fplugin=
1737 Common Joined RejectNegative Var(common_deferred_options) Defer
1738 Specify a plugin to load
1740 fplugin-arg-
1741 Common Joined RejectNegative Var(common_deferred_options) Defer
1742 -fplugin-arg-<name>-<key>[=<value>]     Specify argument <key>=<value> for plugin <name>
1744 fpredictive-commoning
1745 Common Report Var(flag_predictive_commoning) Optimization
1746 Run predictive commoning optimization.
1748 fprefetch-loop-arrays
1749 Common Report Var(flag_prefetch_loop_arrays) Init(-1) Optimization
1750 Generate prefetch instructions, if available, for arrays in loops
1752 fprofile
1753 Common Report Var(profile_flag)
1754 Enable basic program profiling code
1756 fprofile-arcs
1757 Common Report Var(profile_arc_flag)
1758 Insert arc-based program profiling code
1760 fprofile-dir=
1761 Common Joined RejectNegative Var(profile_data_prefix)
1762 Set the top-level directory for storing the profile data.
1763 The default is 'pwd'.
1765 fprofile-correction
1766 Common Report Var(flag_profile_correction)
1767 Enable correction of flow inconsistent profile data input
1769 fprofile-generate
1770 Common
1771 Enable common options for generating profile info for profile feedback directed optimizations
1773 fprofile-generate=
1774 Common Joined RejectNegative
1775 Enable common options for generating profile info for profile feedback directed optimizations, and set -fprofile-dir=
1777 fprofile-use
1778 Common Var(flag_profile_use)
1779 Enable common options for performing profile feedback directed optimizations
1781 fprofile-use=
1782 Common Joined RejectNegative
1783 Enable common options for performing profile feedback directed optimizations, and set -fprofile-dir=
1785 fprofile-values
1786 Common Report Var(flag_profile_values)
1787 Insert code to profile values of expressions
1789 fprofile-report
1790 Common Report Var(profile_report)
1791 Report on consistency of profile
1793 fprofile-reorder-functions
1794 Common Report Var(flag_profile_reorder_functions)
1795 Enable function reordering that improves code placement
1797 frandom-seed
1798 Common Var(common_deferred_options) Defer
1800 frandom-seed=
1801 Common Joined RejectNegative Var(common_deferred_options) Defer
1802 -frandom-seed=<number>  Make compile reproducible using <number>
1804 ; This switch causes the command line that was used to create an
1805 ; object file to be recorded into the object file.  The exact format
1806 ; of this recording is target and binary file format dependent.
1807 ; It is related to the -fverbose-asm switch, but that switch only
1808 ; records information in the assembler output file as comments, so
1809 ; they never reach the object file.
1810 frecord-gcc-switches
1811 Common Report Var(flag_record_gcc_switches)
1812 Record gcc command line switches in the object file.
1814 freg-struct-return
1815 Common Report Var(flag_pcc_struct_return,0) Optimization
1816 Return small aggregates in registers
1818 fregmove
1819 Common Ignore
1820 Does nothing. Preserved for backward compatibility.
1822 flive-range-shrinkage
1823 Common Report Var(flag_live_range_shrinkage) Init(0) Optimization
1824 Relief of register pressure through live range shrinkage
1826 frename-registers
1827 Common Report Var(flag_rename_registers) Init(2) Optimization
1828 Perform a register renaming optimization pass
1830 freorder-blocks
1831 Common Report Var(flag_reorder_blocks) Optimization
1832 Reorder basic blocks to improve code placement
1834 freorder-blocks-and-partition
1835 Common Report Var(flag_reorder_blocks_and_partition) Optimization
1836 Reorder basic blocks and partition into hot and cold sections
1838 freorder-functions
1839 Common Report Var(flag_reorder_functions) Optimization
1840 Reorder functions to improve code placement
1842 frerun-cse-after-loop
1843 Common Report Var(flag_rerun_cse_after_loop) Optimization
1844 Add a common subexpression elimination pass after loop optimizations
1846 frerun-loop-opt
1847 Common Ignore
1848 Does nothing.  Preserved for backward compatibility.
1850 frounding-math
1851 Common Report Var(flag_rounding_math) Optimization SetByCombined
1852 Disable optimizations that assume default FP rounding behavior
1854 fsched-interblock
1855 Common Report Var(flag_schedule_interblock) Init(1) Optimization
1856 Enable scheduling across basic blocks
1858 fsched-pressure
1859 Common Report Var(flag_sched_pressure) Init(0) Optimization
1860 Enable register pressure sensitive insn scheduling
1862 fsched-spec
1863 Common Report Var(flag_schedule_speculative) Init(1) Optimization
1864 Allow speculative motion of non-loads
1866 fsched-spec-load
1867 Common Report Var(flag_schedule_speculative_load) Optimization
1868 Allow speculative motion of some loads
1870 fsched-spec-load-dangerous
1871 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
1872 Allow speculative motion of more loads
1874 fsched-verbose=
1875 Common RejectNegative Joined UInteger Var(sched_verbose_param)
1876 -fsched-verbose=<number>        Set the verbosity level of the scheduler
1878 fsched2-use-superblocks
1879 Common Report Var(flag_sched2_use_superblocks) Optimization
1880 If scheduling post reload, do superblock scheduling
1882 fsched2-use-traces
1883 Common Ignore
1884 Does nothing.  Preserved for backward compatibility.
1886 fschedule-insns
1887 Common Report Var(flag_schedule_insns) Optimization
1888 Reschedule instructions before register allocation
1890 fschedule-insns2
1891 Common Report Var(flag_schedule_insns_after_reload) Optimization
1892 Reschedule instructions after register allocation
1894 ; This flag should be on when a target implements non-trivial
1895 ; scheduling hooks, maybe saving some information for its own sake.
1896 ; On IA64, for example, this is used for correct bundling. 
1897 fselective-scheduling
1898 Common Report Var(flag_selective_scheduling) Optimization
1899 Schedule instructions using selective scheduling algorithm
1901 fselective-scheduling2
1902 Common Report Var(flag_selective_scheduling2) Optimization 
1903 Run selective scheduling after reload
1905 fsel-sched-pipelining
1906 Common Report Var(flag_sel_sched_pipelining) Init(0) Optimization
1907 Perform software pipelining of inner loops during selective scheduling
1909 fsel-sched-pipelining-outer-loops
1910 Common Report Var(flag_sel_sched_pipelining_outer_loops) Init(0) Optimization
1911 Perform software pipelining of outer loops during selective scheduling
1913 fsel-sched-reschedule-pipelined
1914 Common Report Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization
1915 Reschedule pipelined regions without pipelining
1917 fsemantic-interposition
1918 Common Report Var(flag_semantic_interposition) Init(1)
1919 Allow interposing function (or variables) by ones with different semantics (or initializer) respectively by dynamic linker
1921 ; sched_stalled_insns means that insns can be moved prematurely from the queue
1922 ; of stalled insns into the ready list.
1923 fsched-stalled-insns
1924 Common Report Var(flag_sched_stalled_insns) Optimization UInteger
1925 Allow premature scheduling of queued insns
1927 fsched-stalled-insns=
1928 Common RejectNegative Joined UInteger
1929 -fsched-stalled-insns=<number>  Set number of queued insns that can be prematurely scheduled
1931 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
1932 ; be examined for a dependency on a stalled insn that is candidate for
1933 ; premature removal from the queue of stalled insns into the ready list (has
1934 ; an effect only if the flag 'sched_stalled_insns' is set).
1935 fsched-stalled-insns-dep
1936 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization UInteger
1937 Set dependence distance checking in premature scheduling of queued insns
1939 fsched-stalled-insns-dep=
1940 Common RejectNegative Joined UInteger
1941 -fsched-stalled-insns-dep=<number>      Set dependence distance checking in premature scheduling of queued insns
1943 fsched-group-heuristic
1944 Common Report Var(flag_sched_group_heuristic) Init(1) Optimization
1945 Enable the group heuristic in the scheduler
1947 fsched-critical-path-heuristic
1948 Common Report Var(flag_sched_critical_path_heuristic) Init(1) Optimization
1949 Enable the critical path heuristic in the scheduler
1951 fsched-spec-insn-heuristic
1952 Common Report Var(flag_sched_spec_insn_heuristic) Init(1) Optimization
1953 Enable the speculative instruction heuristic in the scheduler
1955 fsched-rank-heuristic
1956 Common Report Var(flag_sched_rank_heuristic) Init(1) Optimization
1957 Enable the rank heuristic in the scheduler
1959 fsched-last-insn-heuristic
1960 Common Report Var(flag_sched_last_insn_heuristic) Init(1) Optimization
1961 Enable the last instruction heuristic in the scheduler
1963 fsched-dep-count-heuristic
1964 Common Report Var(flag_sched_dep_count_heuristic) Init(1) Optimization
1965 Enable the dependent count heuristic in the scheduler
1967 fsection-anchors
1968 Common Report Var(flag_section_anchors) Optimization
1969 Access data in the same section from shared anchor points
1971 fsee
1972 Common Ignore
1973 Does nothing.  Preserved for backward compatibility.
1975 fzee
1976 Common Ignore
1977 Does nothing.  Preserved for backward compatibility.
1979 free
1980 Common Report Var(flag_ree) Init(0)
1981 Turn on Redundant Extensions Elimination pass.
1983 fshow-column
1984 Common Report Var(flag_show_column) Init(1)
1985 Show column numbers in diagnostics, when available.  Default on
1987 fshrink-wrap
1988 Common Report Var(flag_shrink_wrap) Optimization
1989 Emit function prologues only before parts of the function that need it,
1990 rather than at the top of the function.
1992 fsignaling-nans
1993 Common Report Var(flag_signaling_nans) Optimization SetByCombined
1994 Disable optimizations observable by IEEE signaling NaNs
1996 fsigned-zeros
1997 Common Report Var(flag_signed_zeros) Init(1) Optimization SetByCombined
1998 Disable floating point optimizations that ignore the IEEE signedness of zero
2000 fsingle-precision-constant
2001 Common Report Var(flag_single_precision_constant) Optimization
2002 Convert floating point constants to single precision constants
2004 fsplit-ivs-in-unroller
2005 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
2006 Split lifetimes of induction variables when loops are unrolled
2008 fsplit-stack
2009 Common Report Var(flag_split_stack) Init(-1)
2010 Generate discontiguous stack frames
2012 fsplit-wide-types
2013 Common Report Var(flag_split_wide_types) Optimization
2014 Split wide types into independent registers
2016 fssa-phiopt
2017 Common Report Var(flag_ssa_phiopt) Optimization
2018 Optimize conditional patterns using SSA PHI nodes
2020 fvariable-expansion-in-unroller
2021 Common Report Var(flag_variable_expansion_in_unroller) Optimization
2022 Apply variable expansion when loops are unrolled
2024 fstack-check=
2025 Common Report RejectNegative Joined
2026 -fstack-check=[no|generic|specific]     Insert stack checking code into the program
2028 fstack-check
2029 Common Alias(fstack-check=, specific, no)
2030 Insert stack checking code into the program.  Same as -fstack-check=specific
2032 fstack-limit
2033 Common Var(common_deferred_options) Defer
2035 fstack-limit-register=
2036 Common RejectNegative Joined Var(common_deferred_options) Defer
2037 -fstack-limit-register=<register>       Trap if the stack goes past <register>
2039 fstack-limit-symbol=
2040 Common RejectNegative Joined Var(common_deferred_options) Defer
2041 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
2043 fstack-protector
2044 Common Report Var(flag_stack_protect, 1)
2045 Use propolice as a stack protection method
2047 fstack-protector-all
2048 Common Report RejectNegative Var(flag_stack_protect, 2)
2049 Use a stack protection method for every function
2051 fstack-protector-strong
2052 Common Report RejectNegative Var(flag_stack_protect, 3)
2053 Use a smart stack protection method for certain functions
2055 fstack-usage
2056 Common RejectNegative Var(flag_stack_usage)
2057 Output stack usage information on a per-function basis
2059 fstrength-reduce
2060 Common Ignore
2061 Does nothing.  Preserved for backward compatibility.
2063 ; Nonzero if we should do (language-dependent) alias analysis.
2064 ; Typically, this analysis will assume that expressions of certain
2065 ; types do not alias expressions of certain other types.  Only used
2066 ; if alias analysis (in general) is enabled.
2067 fstrict-aliasing
2068 Common Report Var(flag_strict_aliasing) Optimization
2069 Assume strict aliasing rules apply
2071 fstrict-overflow
2072 Common Report Var(flag_strict_overflow)
2073 Treat signed overflow as undefined
2075 fsync-libcalls
2076 Common Report Var(flag_sync_libcalls) Init(1)
2077 Implement __atomic operations via libcalls to legacy __sync functions
2079 fsyntax-only
2080 Common Report Var(flag_syntax_only)
2081 Check for syntax errors, then stop
2083 ftest-coverage
2084 Common Report Var(flag_test_coverage)
2085 Create data files needed by \"gcov\"
2087 fthread-jumps
2088 Common Report Var(flag_thread_jumps) Optimization
2089 Perform jump threading optimizations
2091 ftime-report
2092 Common Report Var(time_report)
2093 Report the time taken by each compiler pass
2095 ftls-model=
2096 Common Joined RejectNegative Enum(tls_model) Var(flag_tls_default) Init(TLS_MODEL_GLOBAL_DYNAMIC)
2097 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
2099 Enum
2100 Name(tls_model) Type(enum tls_model) UnknownError(unknown TLS model %qs)
2102 EnumValue
2103 Enum(tls_model) String(global-dynamic) Value(TLS_MODEL_GLOBAL_DYNAMIC)
2105 EnumValue
2106 Enum(tls_model) String(local-dynamic) Value(TLS_MODEL_LOCAL_DYNAMIC)
2108 EnumValue
2109 Enum(tls_model) String(initial-exec) Value(TLS_MODEL_INITIAL_EXEC)
2111 EnumValue
2112 Enum(tls_model) String(local-exec) Value(TLS_MODEL_LOCAL_EXEC)
2114 ftoplevel-reorder
2115 Common Report Var(flag_toplevel_reorder) Init(2) Optimization
2116 Reorder top level functions, variables, and asms
2118 ftracer
2119 Common Report Var(flag_tracer)
2120 Perform superblock formation via tail duplication
2122 ; Zero means that floating-point math operations cannot generate a
2123 ; (user-visible) trap.  This is the case, for example, in nonstop
2124 ; IEEE 754 arithmetic.
2125 ftrapping-math
2126 Common Report Var(flag_trapping_math) Init(1) Optimization SetByCombined
2127 Assume floating-point operations can trap
2129 ftrapv
2130 Common Report Var(flag_trapv) Optimization
2131 Trap for signed overflow in addition, subtraction and multiplication
2133 ftree-ccp
2134 Common Report Var(flag_tree_ccp) Optimization
2135 Enable SSA-CCP optimization on trees
2137 ftree-bit-ccp
2138 Common Report Var(flag_tree_bit_ccp) Optimization
2139 Enable SSA-BIT-CCP optimization on trees
2141 ftree-store-ccp
2142 Common Ignore
2143 Does nothing.  Preserved for backward compatibility.
2145 ftree-ch
2146 Common Report Var(flag_tree_ch) Optimization
2147 Enable loop header copying on trees
2149 ftree-coalesce-inlined-vars
2150 Common Report Var(flag_ssa_coalesce_vars,1) Init(2) RejectNegative Optimization
2151 Enable coalescing of copy-related user variables that are inlined
2153 ftree-coalesce-vars
2154 Common Report Var(flag_ssa_coalesce_vars,2) Optimization
2155 Enable coalescing of all copy-related user variables
2157 ftree-copyrename
2158 Common Report Var(flag_tree_copyrename) Optimization
2159 Replace SSA temporaries with better names in copies
2161 ftree-copy-prop
2162 Common Report Var(flag_tree_copy_prop) Optimization
2163 Enable copy propagation on trees
2165 ftree-store-copy-prop
2166 Common Ignore
2167 Does nothing.  Preserved for backward compatibility.
2169 ftree-cselim
2170 Common Report Var(flag_tree_cselim) Init(2) Optimization
2171 Transform condition stores into unconditional ones
2173 ftree-switch-conversion
2174 Common Report Var(flag_tree_switch_conversion) Optimization
2175 Perform conversions of switch initializations.
2177 ftree-dce
2178 Common Report Var(flag_tree_dce) Optimization
2179 Enable SSA dead code elimination optimization on trees
2181 ftree-dominator-opts
2182 Common Report Var(flag_tree_dom) Optimization
2183 Enable dominator optimizations
2185 ftree-tail-merge
2186 Common Report Var(flag_tree_tail_merge) Optimization
2187 Enable tail merging on trees
2189 ftree-dse
2190 Common Report Var(flag_tree_dse) Optimization
2191 Enable dead store elimination
2193 ftree-forwprop
2194 Common Report Var(flag_tree_forwprop) Init(1) Optimization
2195 Enable forward propagation on trees
2197 ftree-fre
2198 Common Report Var(flag_tree_fre) Optimization
2199 Enable Full Redundancy Elimination (FRE) on trees
2201 foptimize-strlen
2202 Common Report Var(flag_optimize_strlen) Optimization
2203 Enable string length optimizations on trees
2205 fisolate-erroneous-paths-dereference
2206 Common Report Var(flag_isolate_erroneous_paths_dereference) Optimization
2207 Detect paths which trigger erroneous or undefined behaviour due to
2208 dereferencing a NULL pointer.  Isolate those paths from the main control
2209 flow and turn the statement with erroneous or undefined behaviour into a trap.
2211 fisolate-erroneous-paths-attribute
2212 Common Report Var(flag_isolate_erroneous_paths_attribute) Optimization
2213 Detect paths which trigger erroneous or undefined behaviour due a NULL value
2214 being used in a way which is forbidden by a returns_nonnull or nonnull
2215 attribute.  Isolate those paths from the main control flow and turn the
2216 statement with erroneous or undefined behaviour into a trap. 
2218 ftree-loop-distribution
2219 Common Report Var(flag_tree_loop_distribution) Optimization
2220 Enable loop distribution on trees
2222 ftree-loop-distribute-patterns
2223 Common Report Var(flag_tree_loop_distribute_patterns) Optimization
2224 Enable loop distribution for patterns transformed into a library call
2226 ftree-loop-im
2227 Common Report Var(flag_tree_loop_im) Init(1) Optimization
2228 Enable loop invariant motion on trees
2230 ftree-loop-linear
2231 Common Alias(floop-interchange)
2232 Enable loop interchange transforms.  Same as -floop-interchange
2234 ftree-loop-ivcanon
2235 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
2236 Create canonical induction variables in loops
2238 ftree-loop-optimize
2239 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
2240 Enable loop optimizations on tree level
2242 ftree-parallelize-loops=
2243 Common Report Joined RejectNegative UInteger Var(flag_tree_parallelize_loops) Init(1)
2244 Enable automatic parallelization of loops
2246 ftree-phiprop
2247 Common Report Var(flag_tree_phiprop) Init(1) Optimization
2248 Enable hoisting loads from conditional pointers.
2250 ftree-pre
2251 Common Report Var(flag_tree_pre) Optimization
2252 Enable SSA-PRE optimization on trees
2254 ftree-partial-pre
2255 Common Report Var(flag_tree_partial_pre) Optimization
2256 In SSA-PRE optimization on trees, enable partial-partial redundancy elimination
2258 ftree-pta
2259 Common Report Var(flag_tree_pta) Optimization
2260 Perform function-local points-to analysis on trees.
2262 ftree-reassoc
2263 Common Report Var(flag_tree_reassoc) Init(1) Optimization
2264 Enable reassociation on tree level
2266 ftree-salias
2267 Common Ignore
2268 Does nothing.  Preserved for backward compatibility.
2270 ftree-sink
2271 Common Report Var(flag_tree_sink) Optimization
2272 Enable SSA code sinking on trees
2274 ftree-slsr
2275 Common Report Var(flag_tree_slsr) Optimization
2276 Perform straight-line strength reduction
2278 ftree-sra
2279 Common Report Var(flag_tree_sra) Optimization
2280 Perform scalar replacement of aggregates
2282 ftree-ter
2283 Common Report Var(flag_tree_ter) Optimization
2284 Replace temporary expressions in the SSA->normal pass
2286 ftree-lrs
2287 Common Report Var(flag_tree_live_range_split) Optimization
2288 Perform live range splitting during the SSA->normal pass
2290 ftree-vrp
2291 Common Report Var(flag_tree_vrp) Init(0) Optimization
2292 Perform Value Range Propagation on trees
2294 funit-at-a-time
2295 Common Report Var(flag_unit_at_a_time) Init(1) Optimization
2296 Compile whole compilation unit at a time
2298 funroll-loops
2299 Common Report Var(flag_unroll_loops) Optimization
2300 Perform loop unrolling when iteration count is known
2302 funroll-all-loops
2303 Common Report Var(flag_unroll_all_loops) Optimization
2304 Perform loop unrolling for all loops
2306 ; Nonzero means that loop optimizer may assume that the induction variables
2307 ; that control loops do not overflow and that the loops with nontrivial
2308 ; exit condition are not infinite
2309 funsafe-loop-optimizations
2310 Common Report Var(flag_unsafe_loop_optimizations) Optimization
2311 Allow loop optimizations to assume that the loops behave in normal way
2313 fassociative-math
2314 Common Report Var(flag_associative_math) SetByCombined
2315 Allow optimization for floating-point arithmetic which may change the
2316 result of the operation due to rounding.
2318 freciprocal-math
2319 Common Report Var(flag_reciprocal_math) SetByCombined
2320 Same as -fassociative-math for expressions which include division.
2322 ; Nonzero means that unsafe floating-point math optimizations are allowed
2323 ; for the sake of speed.  IEEE compliance is not guaranteed, and operations
2324 ; are allowed to assume that their arguments and results are "normal"
2325 ; (e.g., nonnegative for SQRT).
2326 funsafe-math-optimizations
2327 Common Report Var(flag_unsafe_math_optimizations) Optimization SetByCombined
2328 Allow math optimizations that may violate IEEE or ISO standards
2330 funswitch-loops
2331 Common Report Var(flag_unswitch_loops) Optimization
2332 Perform loop unswitching
2334 funwind-tables
2335 Common Report Var(flag_unwind_tables) Optimization
2336 Just generate unwind tables for exception handling
2338 fuse-ld=bfd
2339 Common Driver Negative(fuse-ld=gold)
2340 Use the bfd linker instead of the default linker
2342 fuse-ld=gold
2343 Common Driver Negative(fuse-ld=bfd)
2344 Use the gold linker instead of the default linker
2346 fuse-linker-plugin
2347 Common Undocumented Var(flag_use_linker_plugin)
2349 ; Positive if we should track variables, negative if we should run
2350 ; the var-tracking pass only to discard debug annotations, zero if
2351 ; we're not to run it.  When flag_var_tracking == 2 (AUTODETECT_VALUE) it
2352 ; will be set according to optimize, debug_info_level and debug_hooks
2353 ; in process_options ().
2354 fvar-tracking
2355 Common Report Var(flag_var_tracking) Init(2) Optimization
2356 Perform variable tracking
2358 ; Positive if we should track variables at assignments, negative if
2359 ; we should run the var-tracking pass only to discard debug
2360 ; annotations.  When flag_var_tracking_assignments ==
2361 ; AUTODETECT_VALUE it will be set according to flag_var_tracking.
2362 fvar-tracking-assignments
2363 Common Report Var(flag_var_tracking_assignments) Init(2) Optimization
2364 Perform variable tracking by annotating assignments
2366 ; Nonzero if we should toggle flag_var_tracking_assignments after
2367 ; processing options and computing its default.  */
2368 fvar-tracking-assignments-toggle
2369 Common Report Var(flag_var_tracking_assignments_toggle) Optimization
2370 Toggle -fvar-tracking-assignments
2372 ; Positive if we should track uninitialized variables, negative if
2373 ; we should run the var-tracking pass only to discard debug
2374 ; annotations.  When flag_var_tracking_uninit == AUTODETECT_VALUE it
2375 ; will be set according to flag_var_tracking.
2376 fvar-tracking-uninit
2377 Common Report Var(flag_var_tracking_uninit) Optimization
2378 Perform variable tracking and also tag variables that are uninitialized
2380 ftree-vectorize
2381 Common Report Var(flag_tree_vectorize) Optimization
2382 Enable vectorization on trees
2384 ftree-vectorizer-verbose=
2385 Common Joined RejectNegative Ignore
2386 Does nothing.  Preserved for backward compatibility.
2388 ftree-loop-vectorize
2389 Common Report Var(flag_tree_loop_vectorize) Optimization
2390 Enable loop vectorization on trees
2392 ftree-slp-vectorize
2393 Common Report Var(flag_tree_slp_vectorize) Optimization
2394 Enable basic block vectorization (SLP) on trees
2396 fvect-cost-model=
2397 Common Joined RejectNegative Enum(vect_cost_model) Var(flag_vect_cost_model) Init(VECT_COST_MODEL_DEFAULT)
2398 Specifies the cost model for vectorization
2400 fsimd-cost-model=
2401 Common Joined RejectNegative Enum(vect_cost_model) Var(flag_simd_cost_model) Init(VECT_COST_MODEL_UNLIMITED)
2402 Specifies the vectorization cost model for code marked with a simd directive
2404 Enum
2405 Name(vect_cost_model) Type(enum vect_cost_model) UnknownError(unknown vectorizer cost model %qs)
2407 EnumValue
2408 Enum(vect_cost_model) String(unlimited) Value(VECT_COST_MODEL_UNLIMITED)
2410 EnumValue
2411 Enum(vect_cost_model) String(dynamic) Value(VECT_COST_MODEL_DYNAMIC)
2413 EnumValue
2414 Enum(vect_cost_model) String(cheap) Value(VECT_COST_MODEL_CHEAP)
2416 fvect-cost-model
2417 Common RejectNegative Alias(fvect-cost-model=,dynamic)
2418 Enables the dynamic vectorizer cost model.  Preserved for backward compatibility.
2420 fno-vect-cost-model
2421 Common RejectNegative Alias(fvect-cost-model=,unlimited)
2422 Enables the unlimited vectorizer cost model.  Preserved for backward compatibility.
2424 ftree-vect-loop-version
2425 Common Ignore
2426 Does nothing. Preserved for backward compatibility.
2428 ftree-scev-cprop
2429 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
2430 Enable copy propagation of scalar-evolution information.
2432 ; -fverbose-asm causes extra commentary information to be produced in
2433 ; the generated assembly code (to make it more readable).  This option
2434 ; is generally only of use to those who actually need to read the
2435 ; generated assembly code (perhaps while debugging the compiler itself).
2436 ; -fno-verbose-asm, the default, causes the extra information
2437 ; to not be added and is useful when comparing two assembler files.
2438 fverbose-asm
2439 Common Report Var(flag_verbose_asm)
2440 Add extra commentary to assembler output
2442 fvisibility=
2443 Common Joined RejectNegative Enum(symbol_visibility) Var(default_visibility) Init(VISIBILITY_DEFAULT)
2444 -fvisibility=[default|internal|hidden|protected]        Set the default symbol visibility
2446 Enum
2447 Name(symbol_visibility) Type(enum symbol_visibility) UnknownError(unrecognized visibility value %qs)
2449 EnumValue
2450 Enum(symbol_visibility) String(default) Value(VISIBILITY_DEFAULT)
2452 EnumValue
2453 Enum(symbol_visibility) String(internal) Value(VISIBILITY_INTERNAL)
2455 EnumValue
2456 Enum(symbol_visibility) String(hidden) Value(VISIBILITY_HIDDEN)
2458 EnumValue
2459 Enum(symbol_visibility) String(protected) Value(VISIBILITY_PROTECTED)
2461 fvtable-verify=
2462 Common Joined RejectNegative Enum(vtv_priority) Var(flag_vtable_verify) Init(VTV_NO_PRIORITY)
2463 Validate vtable pointers before using them.
2465 Enum
2466 Name(vtv_priority) Type(enum vtv_priority) UnknownError(unknown vtable verify initialization priority %qs)
2468 EnumValue
2469 Enum(vtv_priority) String(none) Value(VTV_NO_PRIORITY)
2471 EnumValue
2472 Enum(vtv_priority) String(std) Value(VTV_STANDARD_PRIORITY)
2474 EnumValue
2475 Enum(vtv_priority) String(preinit) Value(VTV_PREINIT_PRIORITY)
2477 fvtv-counts
2478 Common Var(flag_vtv_counts)
2479 Output vtable verification counters.
2481 fvtv-debug
2482 Common Var(flag_vtv_debug)
2483 Output vtable verification pointer sets information.
2485 fvpt
2486 Common Report Var(flag_value_profile_transformations) Optimization
2487 Use expression value profiles in optimizations
2489 fweb
2490 Common Report Var(flag_web) Init(2) Optimization
2491 Construct webs and split unrelated uses of single variable
2493 ftree-builtin-call-dce
2494 Common Report Var(flag_tree_builtin_call_dce) Init(0) Optimization
2495 Enable conditional dead code elimination for builtin calls
2497 fwhole-program
2498 Common Report Var(flag_whole_program) Init(0) Optimization
2499 Perform whole program optimizations
2501 fwrapv
2502 Common Report Var(flag_wrapv) Optimization
2503 Assume signed arithmetic overflow wraps around
2505 fzero-initialized-in-bss
2506 Common Report Var(flag_zero_initialized_in_bss) Init(1)
2507 Put zero initialized data in the bss section
2510 Common JoinedOrMissing
2511 Generate debug information in default format
2513 gcoff
2514 Common JoinedOrMissing Negative(gdwarf)
2515 Generate debug information in COFF format
2517 gdwarf
2518 Common JoinedOrMissing Negative(gdwarf-)
2519 Generate debug information in default version of DWARF format
2521 gdwarf-
2522 Common Joined UInteger Var(dwarf_version) Init(4) Negative(gstabs)
2523 Generate debug information in DWARF v2 (or later) format
2525 ggdb
2526 Common JoinedOrMissing
2527 Generate debug information in default extended format
2529 gno-pubnames
2530 Common Negative(gpubnames) Var(debug_generate_pub_sections, 0) Init(-1)
2531 Don't generate DWARF pubnames and pubtypes sections.
2533 gpubnames
2534 Common Negative(ggnu-pubnames) Var(debug_generate_pub_sections, 1)
2535 Generate DWARF pubnames and pubtypes sections.
2537 ggnu-pubnames
2538 Common Negative(gno-pubnames) Var(debug_generate_pub_sections, 2)
2539 Generate DWARF pubnames and pubtypes sections with GNU extensions.
2541 gno-record-gcc-switches
2542 Common RejectNegative Var(dwarf_record_gcc_switches,0) Init(1)
2543 Don't record gcc command line switches in DWARF DW_AT_producer.
2545 grecord-gcc-switches
2546 Common RejectNegative Var(dwarf_record_gcc_switches,1)
2547 Record gcc command line switches in DWARF DW_AT_producer.
2549 gno-split-dwarf
2550 Common Driver RejectNegative Var(dwarf_split_debug_info,0) Init(0)
2551 Don't generate debug information in separate .dwo files
2553 gsplit-dwarf
2554 Common Driver RejectNegative Var(dwarf_split_debug_info,1)
2555 Generate debug information in separate .dwo files
2557 gstabs
2558 Common JoinedOrMissing Negative(gstabs+)
2559 Generate debug information in STABS format
2561 gstabs+
2562 Common JoinedOrMissing Negative(gvms)
2563 Generate debug information in extended STABS format
2565 gno-strict-dwarf
2566 Common RejectNegative Var(dwarf_strict,0) Init(0)
2567 Emit DWARF additions beyond selected version
2569 gstrict-dwarf
2570 Common Report RejectNegative Var(dwarf_strict,1)
2571 Don't emit DWARF additions beyond selected version
2573 gtoggle
2574 Common Report Var(flag_gtoggle)
2575 Toggle debug information generation
2577 gvms
2578 Common JoinedOrMissing Negative(gxcoff)
2579 Generate debug information in VMS format
2581 gxcoff
2582 Common JoinedOrMissing Negative(gxcoff+)
2583 Generate debug information in XCOFF format
2585 gxcoff+
2586 Common JoinedOrMissing Negative(gcoff)
2587 Generate debug information in extended XCOFF format
2589 Enum
2590 Name(compressed_debug_sections) Type(int)
2592 ; Since -gz= is completely handled in specs, the values aren't used and we
2593 ; assign arbitrary constants.
2594 EnumValue
2595 Enum(compressed_debug_sections) String(none) Value(0)
2597 EnumValue
2598 Enum(compressed_debug_sections) String(zlib) Value(1)
2600 EnumValue
2601 Enum(compressed_debug_sections) String(zlib-gnu) Value(2)
2604 Common Driver
2605 Generate compressed debug sections
2608 Common Driver Joined Enum(compressed_debug_sections)
2609 -gz=<format>    Generate compressed debug sections in format <format>
2612 Driver Joined Separate
2614 iplugindir=
2615 Common Joined Var(plugindir_string) Init(0)
2616 -iplugindir=<dir>       Set <dir> to be the default plugin directory
2618 imultiarch
2619 Common Joined Separate RejectDriver Var(imultiarch) Init(0)
2620 -imultiarch <dir>       Set <dir> to be the multiarch include subdirectory
2623 Driver Joined Separate
2626 Driver
2628 no-canonical-prefixes
2629 Driver
2631 nodefaultlibs
2632 Driver
2634 nostartfiles
2635 Driver
2637 nostdlib
2638 Driver
2641 Common Driver Joined Separate Var(asm_file_name) MissingArgError(missing filename after %qs)
2642 -o <file>       Place output into <file>
2645 Common Var(profile_flag)
2646 Enable function profiling
2648 pass-exit-codes
2649 Driver Var(pass_exit_codes)
2651 pedantic
2652 Common Alias(Wpedantic)
2654 pedantic-errors
2655 Common Var(flag_pedantic_errors)
2656 Like -pedantic but issue them as errors
2659 Driver
2661 pipe
2662 Driver Var(use_pipes)
2664 print-file-name=
2665 Driver JoinedOrMissing Var(print_file_name)
2667 print-libgcc-file-name
2668 Driver
2670 print-multi-directory
2671 Driver Var(print_multi_directory)
2673 print-multi-lib
2674 Driver Var(print_multi_lib)
2676 print-multi-os-directory
2677 Driver Var(print_multi_os_directory)
2679 print-multiarch
2680 Driver Var(print_multiarch)
2682 print-prog-name=
2683 Driver JoinedOrMissing Var(print_prog_name)
2685 print-search-dirs
2686 Driver Var(print_search_dirs)
2688 print-sysroot
2689 Driver Var(print_sysroot)
2691 print-sysroot-headers-suffix
2692 Driver Var(print_sysroot_headers_suffix)
2694 quiet
2695 Common Var(quiet_flag) RejectDriver
2696 Do not display functions compiled or elapsed time
2699 Driver
2702 Driver
2704 save-temps
2705 Driver
2707 save-temps=
2708 Driver Joined
2711 Driver
2713 time
2714 Driver Var(report_times)
2716 time=
2717 Driver JoinedOrMissing
2720 Driver Joined Separate
2722 undef
2723 Driver
2724 ; C option, but driver must not handle as "-u ndef".
2727 Common Driver Var(verbose_flag)
2728 Enable verbose output
2730 version
2731 Common Var(version_flag) RejectDriver
2732 Display the compiler's version
2735 Common Var(inhibit_warnings)
2736 Suppress warnings
2738 wrapper
2739 Driver Separate Var(wrapper_string)
2742 Driver Joined Separate
2744 shared
2745 Driver RejectNegative Negative(pie)
2746 Create a shared library
2748 shared-libgcc
2749 Driver
2751 specs
2752 Driver Separate Alias(specs=)
2754 specs=
2755 Driver Joined
2757 static
2758 Driver
2760 static-libgcc
2761 Driver
2763 static-libgfortran
2764 Driver
2765 ; Documented for Fortran, but always accepted by driver.
2767 static-libstdc++
2768 Driver
2770 static-libgo
2771 Driver
2772 ; Documented for Go, but always accepted by driver.
2774 static-libasan
2775 Driver
2777 static-libtsan
2778 Driver
2780 static-liblsan
2781 Driver
2783 static-libubsan
2784 Driver
2786 symbolic
2787 Driver
2790 Driver RejectNegative Negative(shared)
2791 Create a position independent executable
2794 Driver Joined Separate
2796 fuse-caller-save
2797 Common Report Var(flag_use_caller_save) Optimization
2798 Use caller save register across calls if possible
2800 ; This comment is to ensure we retain the blank line above.