re PR c++/60517 (warning/error for taking address of member of a temporary object)
[gcc.git] / gcc / common.opt
1 ; Options for the language- and target-independent parts of the compiler.
2
3 ; Copyright (C) 2003-2014 Free Software Foundation, Inc.
4 ;
5 ; This file is part of GCC.
6 ;
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.
11 ;
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.
16 ;
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/>.
20
21 ; See the GCC internals manual (options.texi) for a description of this file's format.
22
23 ; Please try to keep this file in ASCII collating order.
24
25 Variable
26 int target_flags
27
28 Variable
29 int optimize
30
31 Variable
32 int optimize_size
33
34 Variable
35 int optimize_debug
36
37 ; Not used directly to control optimizations, only to save -Ofast
38 ; setting for "optimize" attributes.
39 Variable
40 int optimize_fast
41
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
48
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
54
55 ; Nonzero if subexpressions must be evaluated from left-to-right.
56 Variable
57 int flag_evaluation_order = 0
58
59 ; Language specific warning pass for unused results.
60 Variable
61 bool flag_warn_unused_result = false
62
63 Variable
64 int *param_values
65
66 ; Nonzero if we should write GIMPLE bytecode for link-time optimization.
67 Variable
68 int flag_generate_lto
69
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
75
76 Variable
77 HOST_WIDE_INT larger_than_size
78
79 ; True to warn about any function whose frame size is larger
80 ; than N bytes.
81 Variable
82 bool warn_frame_larger_than
83
84 Variable
85 HOST_WIDE_INT frame_larger_than_size
86
87 ; Nonzero means we should be saving declaration info into a .X file.
88 Variable
89 int flag_gen_aux_info = 0
90
91 ; Nonzero if we are compiling code for a shared library, zero for
92 ; executable.
93 Variable
94 int flag_shlib
95
96 ; These two are really VEC(char_p,heap) *.
97
98 Variable
99 void *flag_instrument_functions_exclude_functions
100
101 Variable
102 void *flag_instrument_functions_exclude_files
103
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.
107 ;
108 ; Structs only handled by reference (indirectly), will also usually
109 ; not need as much debugging information.
110
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 }
113
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 }
116
117 ; True if we should exit after parsing options.
118 Variable
119 bool exit_after_options
120
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
126
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
131
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
137
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
142
143 ; Type of stack check.
144 Variable
145 enum stack_check_type flag_stack_check = NO_STACK_CHECK
146
147 ; True if stack usage information needs to be computed.
148 Variable
149 bool flag_stack_usage_info = false
150
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
159
160 ; -dP causes the rtl to be emitted as a comment in assembly.
161 Variable
162 int flag_dump_rtl_in_asm
163
164 ; Whether -da was passed (used only in handle_common_deferred_options).
165 Variable
166 bool flag_dump_all_passed
167
168 ; Other flags saying which kinds of debugging dump have been requested.
169
170 Variable
171 int rtl_dump_and_exit
172
173 Variable
174 int flag_print_asm_name
175
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
181
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.
185
186 Variable
187 const char *main_input_basename
188
189 Variable
190 int main_input_baselength
191
192 ; Which options have been printed by --help.
193 Variable
194 char *help_printed
195
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
201
202 ; The number of columns for --help output.
203 Variable
204 unsigned int help_columns
205
206 ; Whether this options structure has been through finish_options
207 Variable
208 bool flag_opts_finished
209
210 ; What the sanitizer should instrument
211 Variable
212 unsigned int flag_sanitize
213
214 ; Flag whether a prefix has been added to dump_base_name
215 Variable
216 bool dump_base_name_prefixed = false
217
218 ###
219 Driver
220
221 -assemble
222 Driver Alias(S)
223
224 -compile
225 Driver Alias(c)
226
227 -coverage
228 Driver Alias(coverage)
229
230 -debug
231 Common Alias(g)
232
233 -dump
234 Common Separate Alias(d)
235
236 -dump=
237 Common Joined Alias(d)
238
239 -dumpbase
240 Common Separate Alias(dumpbase)
241
242 -dumpdir
243 Common Separate Alias(dumpdir)
244
245 -entry
246 Driver Separate Alias(e)
247
248 -entry=
249 Driver Joined Alias(e)
250
251 -extra-warnings
252 Common Warning Alias(Wextra)
253
254 -for-assembler
255 Driver Separate Alias(Xassembler)
256
257 -for-assembler=
258 Driver JoinedOrMissing Alias(Xassembler)
259
260 -for-linker
261 Driver Separate Alias(Xlinker)
262
263 -for-linker=
264 Driver JoinedOrMissing Alias(Xlinker)
265
266 -force-link
267 Driver Separate Alias(u)
268
269 -force-link=
270 Driver Joined Alias(u)
271
272 -help
273 Common Driver Var(help_flag)
274 Display this information
275
276 -help=
277 Common Driver Report Joined
278 --help=<class> Display descriptions of a specific class of options. <class> is one or more of optimizers, target, warnings, undocumented, params
279
280 -language
281 Driver Separate Alias(x)
282
283 -language=
284 Driver Joined Alias(x)
285
286 -library-directory
287 Driver Separate Alias(L)
288
289 -library-directory=
290 Driver Joined Alias(L)
291
292 -no-canonical-prefixes
293 Driver Alias(no-canonical-prefixes)
294
295 -no-standard-libraries
296 Driver Alias(nostdlib)
297
298 -no-sysroot-suffix
299 Driver Var(no_sysroot_suffix)
300
301 -no-warnings
302 Common Alias(w)
303
304 -optimize
305 Common Alias(O)
306
307 -output
308 Common Driver Separate Alias(o) MissingArgError(missing filename after %qs)
309
310 -output=
311 Common Driver Joined Alias(o) MissingArgError(missing filename after %qs)
312
313 -pass-exit-codes
314 Driver Alias(pass-exit-codes)
315
316 -pedantic
317 Common Alias(Wpedantic)
318
319 -pedantic-errors
320 Common Alias(pedantic-errors)
321
322 -pie
323 Driver Alias(pie)
324
325 -pipe
326 Driver Alias(pipe)
327
328 -prefix
329 Driver Separate Alias(B)
330
331 -prefix=
332 Driver JoinedOrMissing Alias(B)
333
334 -preprocess
335 Driver Alias(E)
336
337 -print-file-name
338 Driver Separate Alias(print-file-name=)
339
340 -print-file-name=
341 Driver JoinedOrMissing Alias(print-file-name=)
342
343 -print-libgcc-file-name
344 Driver Alias(print-libgcc-file-name)
345
346 -print-multi-directory
347 Driver Alias(print-multi-directory)
348
349 -print-multi-lib
350 Driver Alias(print-multi-lib)
351
352 -print-multi-os-directory
353 Driver Alias(print-multi-os-directory)
354
355 -print-multiarch
356 Driver Alias(print-multiarch)
357
358 -print-prog-name
359 Driver Separate Alias(print-prog-name=)
360
361 -print-prog-name=
362 Driver JoinedOrMissing Alias(print-prog-name=)
363
364 -print-search-dirs
365 Driver Alias(print-search-dirs)
366
367 -print-sysroot
368 Driver Alias(print-sysroot)
369
370 -print-sysroot-headers-suffix
371 Driver Alias(print-sysroot-headers-suffix)
372
373 -profile
374 Common Alias(p)
375
376 -save-temps
377 Driver Alias(save-temps)
378
379 -shared
380 Driver Alias(shared)
381
382 -specs
383 Driver Separate Alias(specs=)
384
385 -specs=
386 Driver Joined Alias(specs=)
387
388 -static
389 Driver Alias(static)
390
391 -symbolic
392 Driver Alias(symbolic)
393
394 -target-help
395 Common Driver
396 Alias for --help=target
397
398 -time
399 Driver Alias(time)
400
401 -verbose
402 Driver Alias(v)
403
404 ;; The driver used to convert options such as --help into forms such
405 ;; as -fhelp; the following four entries are for compatibility with
406 ;; any direct uses of those (undocumented) -f forms
407 fhelp
408 Common Driver Alias(-help)
409
410 fhelp=
411 Common Driver Joined Alias(-help=)
412
413 ftarget-help
414 Common Driver Alias(-target-help)
415
416 fversion
417 Common Driver Alias(-version)
418
419 -param
420 Common Separate
421 --param <param>=<value> Set parameter <param> to value. See below for a complete list of parameters
422
423 -param=
424 Common Joined Alias(-param)
425
426 -sysroot
427 Driver Separate Alias(-sysroot=)
428
429 -sysroot=
430 Driver JoinedOrMissing
431
432 -version
433 Common Driver
434
435 B
436 Driver Joined Separate
437
438 E
439 Driver
440
441 L
442 Driver Joined Separate
443
444 N
445 Driver
446
447 O
448 Common JoinedOrMissing Optimization
449 -O<number> Set optimization level to <number>
450
451 Os
452 Common Optimization
453 Optimize for space rather than speed
454
455 Ofast
456 Common Optimization
457 Optimize for speed disregarding exact standards compliance
458
459 Og
460 Common Optimization
461 Optimize for debugging experience rather than speed or size
462
463 Q
464 Driver
465
466 Qn
467 Driver Negative(Qy)
468
469 Qy
470 Driver Negative(Qn)
471
472 R
473 Driver Joined Separate
474
475 S
476 Driver
477
478 T
479 Driver Joined Separate
480
481 Tbss
482 Driver Separate
483
484 Tbss=
485 Driver Joined
486
487 Tdata
488 Driver Separate
489
490 Tdata=
491 Driver Joined
492
493 Ttext
494 Driver Separate
495
496 Ttext=
497 Driver Joined
498
499 W
500 Common RejectNegative Warning Alias(Wextra)
501 This switch is deprecated; use -Wextra instead
502
503 Wa,
504 Driver JoinedOrMissing
505
506 Wl,
507 Driver JoinedOrMissing
508
509 Wp,
510 Driver JoinedOrMissing
511
512 Waggregate-return
513 Common Var(warn_aggregate_return) Warning
514 Warn about returning structures, unions or arrays
515
516 Waggressive-loop-optimizations
517 Common Var(warn_aggressive_loop_optimizations) Init(1) Warning
518 Warn if a loop with constant number of iterations triggers undefined behavior
519
520 Warray-bounds
521 Common Var(warn_array_bounds) Warning
522 Warn if an array is accessed out of bounds
523
524 Wattributes
525 Common Var(warn_attributes) Init(1) Warning
526 Warn about inappropriate attribute usage
527
528 Wcast-align
529 Common Var(warn_cast_align) Warning
530 Warn about pointer casts which increase alignment
531
532 Wcpp
533 Common Var(warn_cpp) Init(1) Warning
534 Warn when a #warning directive is encountered
535
536 Wdeprecated-declarations
537 Common Var(warn_deprecated_decl) Init(1) Warning
538 Warn about uses of __attribute__((deprecated)) declarations
539
540 Wdisabled-optimization
541 Common Var(warn_disabled_optimization) Warning
542 Warn when an optimization pass is disabled
543
544 Werror
545 Common Var(warnings_are_errors)
546 Treat all warnings as errors
547
548 Werror=
549 Common Joined
550 Treat specified warning as error
551
552 Wextra
553 Common Var(extra_warnings) Warning
554 Print extra (possibly unwanted) warnings
555
556 Wfatal-errors
557 Common Var(flag_fatal_errors)
558 Exit on the first error occurred
559
560 Wframe-larger-than=
561 Common RejectNegative Joined UInteger
562 -Wframe-larger-than=<number> Warn if a function's stack frame requires more than <number> bytes
563
564 Wfree-nonheap-object
565 Common Var(warn_free_nonheap_object) Init(1) Warning
566 Warn when attempting to free a non-heap object
567
568 Winline
569 Common Var(warn_inline) Warning
570 Warn when an inlined function cannot be inlined
571
572 Winvalid-memory-model
573 Common Var(warn_invalid_memory_model) Init(1) Warning
574 Warn when an atomic memory model parameter is known to be outside the valid range.
575
576 Wlarger-than-
577 Common RejectNegative Joined Warning Undocumented Alias(Wlarger-than=)
578
579 Wlarger-than=
580 Common RejectNegative Joined UInteger Warning
581 -Wlarger-than=<number> Warn if an object is larger than <number> bytes
582
583 Wunsafe-loop-optimizations
584 Common Var(warn_unsafe_loop_optimizations) Warning
585 Warn if the loop cannot be optimized due to nontrivial assumptions.
586
587 Wmissing-noreturn
588 Common Alias(Wsuggest-attribute=noreturn)
589
590 Wodr
591 Common Var(warn_odr_violations) Init(1) Warning
592 Warn about some C++ One Definition Rule violations during link time optimization
593
594 Woverflow
595 Common Var(warn_overflow) Init(1) Warning
596 Warn about overflow in arithmetic expressions
597
598 Wpacked
599 Common Var(warn_packed) Warning
600 Warn when the packed attribute has no effect on struct layout
601
602 Wpadded
603 Common Var(warn_padded) Warning
604 Warn when padding is required to align structure members
605
606 Wpedantic
607 Common Var(pedantic) Warning
608 Issue warnings needed for strict compliance to the standard
609
610 Wreturn-local-addr
611 Common Var(warn_return_local_addr) Init(1) Warning
612 Warn about returning a pointer/reference to a local or temporary variable.
613
614 Wshadow
615 Common Var(warn_shadow) Warning
616 Warn when one local variable shadows another
617
618 Wstack-protector
619 Common Var(warn_stack_protect) Warning
620 Warn when not issuing stack smashing protection for some reason
621
622 Wstack-usage=
623 Common Joined RejectNegative UInteger Var(warn_stack_usage) Init(-1) Warning
624 Warn if stack usage might be larger than specified amount
625
626 Wstrict-aliasing
627 Common Warning
628 Warn about code which might break strict aliasing rules
629
630 Wstrict-aliasing=
631 Common Joined RejectNegative UInteger Var(warn_strict_aliasing) Warning
632 Warn about code which might break strict aliasing rules
633
634 Wstrict-overflow
635 Common Warning
636 Warn about optimizations that assume that signed overflow is undefined
637
638 Wstrict-overflow=
639 Common Joined RejectNegative UInteger Var(warn_strict_overflow) Warning
640 Warn about optimizations that assume that signed overflow is undefined
641
642 Wsuggest-attribute=const
643 Common Var(warn_suggest_attribute_const) Warning
644 Warn about functions which might be candidates for __attribute__((const))
645
646 Wsuggest-attribute=pure
647 Common Var(warn_suggest_attribute_pure) Warning
648 Warn about functions which might be candidates for __attribute__((pure))
649
650 Wsuggest-attribute=noreturn
651 Common Var(warn_suggest_attribute_noreturn) Warning
652 Warn about functions which might be candidates for __attribute__((noreturn))
653
654 Wsystem-headers
655 Common Var(warn_system_headers) Warning
656 Do not suppress warnings from system headers
657
658 Wtrampolines
659 Common Var(warn_trampolines) Warning
660 Warn whenever a trampoline is generated
661
662 Wtype-limits
663 Common Var(warn_type_limits) Warning EnabledBy(Wextra)
664 Warn if a comparison is always true or always false due to the limited range of the data type
665
666 Wuninitialized
667 Common Var(warn_uninitialized) Warning EnabledBy(Wextra)
668 Warn about uninitialized automatic variables
669
670 Wmaybe-uninitialized
671 Common Var(warn_maybe_uninitialized) Warning EnabledBy(Wuninitialized)
672 Warn about maybe uninitialized automatic variables
673
674 Wunreachable-code
675 Common Ignore
676 Does nothing. Preserved for backward compatibility.
677
678 Wunused
679 Common Var(warn_unused) Init(0) Warning
680 Enable all -Wunused- warnings
681
682 Wunused-but-set-parameter
683 Common Var(warn_unused_but_set_parameter) Warning EnabledBy(Wunused && Wextra)
684 Warn when a function parameter is only set, otherwise unused
685
686 Wunused-but-set-variable
687 Common Var(warn_unused_but_set_variable) Warning EnabledBy(Wunused)
688 Warn when a variable is only set, otherwise unused
689
690 Wunused-function
691 Common Var(warn_unused_function) Warning EnabledBy(Wunused)
692 Warn when a function is unused
693
694 Wunused-label
695 Common Var(warn_unused_label) Warning EnabledBy(Wunused)
696 Warn when a label is unused
697
698 Wunused-parameter
699 Common Var(warn_unused_parameter) Warning EnabledBy(Wunused && Wextra)
700 Warn when a function parameter is unused
701
702 Wunused-value
703 Common Var(warn_unused_value) Warning EnabledBy(Wunused)
704 Warn when an expression value is unused
705
706 Wunused-variable
707 Common Var(warn_unused_variable) Warning EnabledBy(Wunused)
708 Warn when a variable is unused
709
710 Wcoverage-mismatch
711 Common Var(warn_coverage_mismatch) Init(1) Warning
712 Warn in case profiles in -fprofile-use do not match
713
714 Wvector-operation-performance
715 Common Var(warn_vector_operation_performance) Warning
716 Warn when a vector operation is compiled outside the SIMD
717
718 Xassembler
719 Driver Separate
720
721 Xlinker
722 Driver Separate
723
724 Xpreprocessor
725 Driver Separate
726
727 Z
728 Driver
729
730 aux-info
731 Common Separate Var(aux_info_file_name)
732 -aux-info <file> Emit declaration information into <file>
733
734 aux-info=
735 Common Joined Alias(aux-info)
736
737 auxbase
738 Common Separate RejectDriver Var(aux_base_name)
739
740 auxbase-strip
741 Common Separate RejectDriver
742
743 coverage
744 Driver
745
746 c
747 Driver
748
749 d
750 Common Joined
751 -d<letters> Enable dumps from specific passes of the compiler
752
753 dumpbase
754 Common Separate Var(dump_base_name)
755 -dumpbase <file> Set the file basename to be used for dumps
756
757 dumpdir
758 Common Separate Var(dump_dir_name)
759 -dumpdir <dir> Set the directory name to be used for dumps
760
761 dumpmachine
762 Driver
763
764 dumpspecs
765 Driver
766
767 dumpversion
768 Driver
769
770 e
771 Driver Joined Separate
772
773 ; This option has historically been passed down to the linker by an
774 ; accident of a %{e*} spec, so ensure it continues to be passed down
775 ; as a single option. The supported option for this purpose is
776 ; -rdynamic. See PR 47390.
777 export-dynamic
778 Driver Undocumented
779
780 ; The version of the C++ ABI in use. The following values are allowed:
781 ;
782 ; 0: The version of the ABI believed most conformant with the C++ ABI
783 ; specification. This ABI may change as bugs are discovered and fixed.
784 ; Therefore, 0 will not necessarily indicate the same ABI in different
785 ; versions of G++.
786 ;
787 ; 1: The version of the ABI first used in G++ 3.2. No longer selectable.
788 ;
789 ; 2: The version of the ABI first used in G++ 3.4 (and current default).
790 ;
791 ; 3: The version of the ABI that fixes the missing underscore
792 ; in template non-type arguments of pointer type.
793 ;
794 ; 4: The version of the ABI that introduces unambiguous mangling of
795 ; vector types. First selectable in G++ 4.5.
796 ;
797 ; 5: The version of the ABI that ignores attribute const/noreturn
798 ; in function pointer mangling, and corrects mangling of decltype and
799 ; function parameters used in other parameters and the return type.
800 ; First selectable in G++ 4.6.
801 ;
802 ; 6: The version of the ABI that doesn't promote scoped enums to int and
803 ; changes the mangling of template argument packs, const/static_cast,
804 ; prefix ++ and --, and a class scope function used as a template
805 ; argument.
806 ; First selectable in G++ 4.7.
807 ;
808 ; 7: The version of the ABI that treats nullptr_t as a builtin type and
809 ; corrects the mangling of lambdas in default argument scope.
810 ; First selectable in G++ 4.8.
811 ;
812 ; 8: The version of the ABI that corrects the substitution behavior of
813 ; function types with function-cv-qualifiers.
814 ; First selectable in G++ 4.9.
815 ;
816 ; Additional positive integers will be assigned as new versions of
817 ; the ABI become the default version of the ABI.
818 fabi-version=
819 Common Joined RejectNegative UInteger Var(flag_abi_version) Init(0)
820 The version of the C++ ABI in use
821
822 faggressive-loop-optimizations
823 Common Report Var(flag_aggressive_loop_optimizations) Optimization Init(1)
824 Aggressively optimize loops using language constraints
825
826 falign-functions
827 Common Report Var(align_functions,0) Optimization UInteger
828 Align the start of functions
829
830 falign-functions=
831 Common RejectNegative Joined UInteger Var(align_functions)
832
833 falign-jumps
834 Common Report Var(align_jumps,0) Optimization UInteger
835 Align labels which are only reached by jumping
836
837 falign-jumps=
838 Common RejectNegative Joined UInteger Var(align_jumps)
839
840 falign-labels
841 Common Report Var(align_labels,0) Optimization UInteger
842 Align all labels
843
844 falign-labels=
845 Common RejectNegative Joined UInteger Var(align_labels)
846
847 falign-loops
848 Common Report Var(align_loops,0) Optimization UInteger
849 Align the start of loops
850
851 falign-loops=
852 Common RejectNegative Joined UInteger Var(align_loops)
853
854 fargument-alias
855 Common Ignore
856 Does nothing. Preserved for backward compatibility.
857
858 fargument-noalias
859 Common Ignore
860 Does nothing. Preserved for backward compatibility.
861
862 fargument-noalias-global
863 Common Ignore
864 Does nothing. Preserved for backward compatibility.
865
866 fargument-noalias-anything
867 Common Ignore
868 Does nothing. Preserved for backward compatibility.
869
870 fsanitize=
871 Common Driver Report Joined
872 Select what to sanitize
873
874 fsanitize-recover
875 Common Report Var(flag_sanitize_recover) Init(1)
876 After diagnosing undefined behavior attempt to continue execution
877
878 fsanitize-undefined-trap-on-error
879 Common Report Var(flag_sanitize_undefined_trap_on_error) Init(0)
880 Use trap instead of a library function for undefined behavior sanitization
881
882 fasynchronous-unwind-tables
883 Common Report Var(flag_asynchronous_unwind_tables) Optimization
884 Generate unwind tables that are exact at each instruction boundary
885
886 fauto-inc-dec
887 Common Report Var(flag_auto_inc_dec) Init(1)
888 Generate auto-inc/dec instructions
889
890 ; -fcheck-bounds causes gcc to generate array bounds checks.
891 ; For C, C++ and ObjC: defaults off.
892 ; For Java: defaults to on.
893 ; For Fortran: defaults to off.
894 fbounds-check
895 Common Report Var(flag_bounds_check)
896 Generate code to check bounds before indexing arrays
897
898 fbranch-count-reg
899 Common Report Var(flag_branch_on_count_reg) Optimization
900 Replace add, compare, branch with branch on count register
901
902 fbranch-probabilities
903 Common Report Var(flag_branch_probabilities) Optimization
904 Use profiling information for branch probabilities
905
906 fbranch-target-load-optimize
907 Common Report Var(flag_branch_target_load_optimize) Optimization
908 Perform branch target load optimization before prologue / epilogue threading
909
910 fbranch-target-load-optimize2
911 Common Report Var(flag_branch_target_load_optimize2) Optimization
912 Perform branch target load optimization after prologue / epilogue threading
913
914 fbtr-bb-exclusive
915 Common Report Var(flag_btr_bb_exclusive) Optimization
916 Restrict target load migration not to re-use registers in any basic block
917
918 fcall-saved-
919 Common Joined RejectNegative Var(common_deferred_options) Defer
920 -fcall-saved-<register> Mark <register> as being preserved across functions
921
922 fcall-used-
923 Common Joined RejectNegative Var(common_deferred_options) Defer
924 -fcall-used-<register> Mark <register> as being corrupted by function calls
925
926 ; Nonzero for -fcaller-saves: allocate values in regs that need to
927 ; be saved across function calls, if that produces overall better code.
928 ; Optional now, so people can test it.
929 fcaller-saves
930 Common Report Var(flag_caller_saves) Optimization
931 Save registers around function calls
932
933 fcheck-data-deps
934 Common Report Var(flag_check_data_deps)
935 Compare the results of several data dependence analyzers.
936
937 fcheck-new
938 Common Var(flag_check_new)
939 Check the return value of new in C++
940
941 fcombine-stack-adjustments
942 Common Report Var(flag_combine_stack_adjustments) Optimization
943 Looks for opportunities to reduce stack adjustments and stack references.
944
945 fcommon
946 Common Report Var(flag_no_common,0) Optimization
947 Do not put uninitialized globals in the common section
948
949 fcompare-debug
950 Driver
951 ; Converted by the driver to -fcompare-debug= options.
952
953 fcompare-debug=
954 Common Driver JoinedOrMissing RejectNegative Var(flag_compare_debug_opt)
955 -fcompare-debug[=<opts>] Compile with and without e.g. -gtoggle, and compare the final-insns dump
956
957 fcompare-debug-second
958 Common Driver RejectNegative Var(flag_compare_debug)
959 Run only the second compilation of -fcompare-debug
960
961 fcompare-elim
962 Common Report Var(flag_compare_elim_after_reload) Optimization
963 Perform comparison elimination after register allocation has finished
964
965 fconserve-stack
966 Common Var(flag_conserve_stack) Optimization
967 Do not perform optimizations increasing noticeably stack usage
968
969 fcprop-registers
970 Common Report Var(flag_cprop_registers) Optimization
971 Perform a register copy-propagation optimization pass
972
973 fcrossjumping
974 Common Report Var(flag_crossjumping) Optimization
975 Perform cross-jumping optimization
976
977 fcse-follow-jumps
978 Common Report Var(flag_cse_follow_jumps) Optimization
979 When running CSE, follow jumps to their targets
980
981 fcse-skip-blocks
982 Common Ignore
983 Does nothing. Preserved for backward compatibility.
984
985 fcx-limited-range
986 Common Report Var(flag_cx_limited_range) Optimization SetByCombined
987 Omit range reduction step when performing complex division
988
989 fcx-fortran-rules
990 Common Report Var(flag_cx_fortran_rules) Optimization
991 Complex multiplication and division follow Fortran rules
992
993 fdata-sections
994 Common Report Var(flag_data_sections) Optimization
995 Place data items into their own section
996
997 fdbg-cnt-list
998 Common Report Var(common_deferred_options) Defer
999 List all available debugging counters with their limits and counts.
1000
1001 fdbg-cnt=
1002 Common RejectNegative Joined Var(common_deferred_options) Defer
1003 -fdbg-cnt=<counter>:<limit>[,<counter>:<limit>,...] Set the debug counter limit.
1004
1005 fdebug-prefix-map=
1006 Common Joined RejectNegative Var(common_deferred_options) Defer
1007 Map one directory name to another in debug information
1008
1009 fdebug-types-section
1010 Common Report Var(flag_debug_types_section) Init(0)
1011 Output .debug_types section when using DWARF v4 debuginfo.
1012
1013 ; Nonzero for -fdefer-pop: don't pop args after each function call
1014 ; instead save them up to pop many calls' args with one insns.
1015 fdefer-pop
1016 Common Report Var(flag_defer_pop) Optimization
1017 Defer popping functions args from stack until later
1018
1019 fdelayed-branch
1020 Common Report Var(flag_delayed_branch) Optimization
1021 Attempt to fill delay slots of branch instructions
1022
1023 fdelete-dead-exceptions
1024 Common Report Var(flag_delete_dead_exceptions) Init(0)
1025 Delete dead instructions that may throw exceptions
1026
1027 fdelete-null-pointer-checks
1028 Common Report Var(flag_delete_null_pointer_checks) Init(1) Optimization
1029 Delete useless null pointer checks
1030
1031 fdevirtualize-speculatively
1032 Common Report Var(flag_devirtualize_speculatively) Optimization
1033 Perform speculative devirtualization
1034
1035 fdevirtualize
1036 Common Report Var(flag_devirtualize) Optimization
1037 Try to convert virtual calls to direct ones.
1038
1039 fdiagnostics-show-location=
1040 Common Joined RejectNegative Enum(diagnostic_prefixing_rule)
1041 -fdiagnostics-show-location=[once|every-line] How often to emit source location at the beginning of line-wrapped diagnostics
1042
1043 ; Required for these enum values.
1044 SourceInclude
1045 pretty-print.h
1046
1047 Enum
1048 Name(diagnostic_prefixing_rule) Type(int)
1049
1050 EnumValue
1051 Enum(diagnostic_prefixing_rule) String(once) Value(DIAGNOSTICS_SHOW_PREFIX_ONCE)
1052
1053 EnumValue
1054 Enum(diagnostic_prefixing_rule) String(every-line) Value(DIAGNOSTICS_SHOW_PREFIX_EVERY_LINE)
1055
1056 fdiagnostics-show-caret
1057 Common Var(flag_diagnostics_show_caret) Init(1)
1058 Show the source line with a caret indicating the column
1059
1060 fdiagnostics-color
1061 Common Alias(fdiagnostics-color=,always,never)
1062 ;
1063
1064 fdiagnostics-color=
1065 Common Joined RejectNegative Var(flag_diagnostics_show_color) Enum(diagnostic_color_rule) Init(DIAGNOSTICS_COLOR_NO)
1066 -fdiagnostics-color=[never|always|auto] Colorize diagnostics
1067
1068 ; Required for these enum values.
1069 SourceInclude
1070 diagnostic-color.h
1071
1072 Enum
1073 Name(diagnostic_color_rule) Type(int)
1074
1075 EnumValue
1076 Enum(diagnostic_color_rule) String(never) Value(DIAGNOSTICS_COLOR_NO)
1077
1078 EnumValue
1079 Enum(diagnostic_color_rule) String(always) Value(DIAGNOSTICS_COLOR_YES)
1080
1081 EnumValue
1082 Enum(diagnostic_color_rule) String(auto) Value(DIAGNOSTICS_COLOR_AUTO)
1083
1084 fdiagnostics-show-option
1085 Common Var(flag_diagnostics_show_option) Init(1)
1086 Amend appropriate diagnostic messages with the command line option that controls them
1087
1088 fdisable-
1089 Common Joined RejectNegative Var(common_deferred_options) Defer
1090 -fdisable-[tree|rtl|ipa]-<pass>=range1+range2 disables an optimization pass
1091
1092 fenable-
1093 Common Joined RejectNegative Var(common_deferred_options) Defer
1094 -fenable-[tree|rtl|ipa]-<pass>=range1+range2 enables an optimization pass
1095
1096 fdump-
1097 Common Joined RejectNegative Var(common_deferred_options) Defer
1098 -fdump-<type> Dump various compiler internals to a file
1099
1100 fdump-final-insns
1101 Driver RejectNegative
1102
1103 fdump-final-insns=
1104 Common RejectNegative Joined Var(flag_dump_final_insns)
1105 -fdump-final-insns=filename Dump to filename the insns at the end of translation
1106
1107 fdump-go-spec=
1108 Common RejectNegative Joined Var(flag_dump_go_spec)
1109 -fdump-go-spec=filename Write all declarations to file as Go code
1110
1111 fdump-noaddr
1112 Common Report Var(flag_dump_noaddr)
1113 Suppress output of addresses in debugging dumps
1114
1115 fdump-passes
1116 Common Var(flag_dump_passes) Init(0)
1117 Dump optimization passes
1118
1119 fdump-unnumbered
1120 Common Report Var(flag_dump_unnumbered)
1121 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
1122
1123 fdump-unnumbered-links
1124 Common Report Var(flag_dump_unnumbered_links)
1125 Suppress output of previous and next insn numbers in debugging dumps
1126
1127 fdwarf2-cfi-asm
1128 Common Report Var(flag_dwarf2_cfi_asm) Init(HAVE_GAS_CFI_DIRECTIVE)
1129 Enable CFI tables via GAS assembler directives.
1130
1131 fearly-inlining
1132 Common Report Var(flag_early_inlining) Init(1) Optimization
1133 Perform early inlining
1134
1135 feliminate-dwarf2-dups
1136 Common Report Var(flag_eliminate_dwarf2_dups)
1137 Perform DWARF2 duplicate elimination
1138
1139 fipa-sra
1140 Common Report Var(flag_ipa_sra) Init(0) Optimization
1141 Perform interprocedural reduction of aggregates
1142
1143 feliminate-unused-debug-symbols
1144 Common Report Var(flag_debug_only_used_symbols)
1145 Perform unused type elimination in debug info
1146
1147 feliminate-unused-debug-types
1148 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
1149 Perform unused type elimination in debug info
1150
1151 femit-class-debug-always
1152 Common Report Var(flag_emit_class_debug_always) Init(0)
1153 Do not suppress C++ class debug information.
1154
1155 fexceptions
1156 Common Report Var(flag_exceptions) Optimization
1157 Enable exception handling
1158
1159 fexpensive-optimizations
1160 Common Report Var(flag_expensive_optimizations) Optimization
1161 Perform a number of minor, expensive optimizations
1162
1163 fexcess-precision=
1164 Common Joined RejectNegative Enum(excess_precision) Var(flag_excess_precision_cmdline) Init(EXCESS_PRECISION_DEFAULT)
1165 -fexcess-precision=[fast|standard] Specify handling of excess floating-point precision
1166
1167 Enum
1168 Name(excess_precision) Type(enum excess_precision) UnknownError(unknown excess precision style %qs)
1169
1170 EnumValue
1171 Enum(excess_precision) String(fast) Value(EXCESS_PRECISION_FAST)
1172
1173 EnumValue
1174 Enum(excess_precision) String(standard) Value(EXCESS_PRECISION_STANDARD)
1175
1176 ffast-math
1177 Common
1178
1179 ffat-lto-objects
1180 Common Var(flag_fat_lto_objects)
1181 Output lto objects containing both the intermediate language and binary output.
1182
1183 ffinite-math-only
1184 Common Report Var(flag_finite_math_only) Optimization SetByCombined
1185 Assume no NaNs or infinities are generated
1186
1187 ffixed-
1188 Common Joined RejectNegative Var(common_deferred_options) Defer
1189 -ffixed-<register> Mark <register> as being unavailable to the compiler
1190
1191 ffloat-store
1192 Common Report Var(flag_float_store) Optimization
1193 Don't allocate floats and doubles in extended-precision registers
1194
1195 fforce-addr
1196 Common Ignore
1197 Does nothing. Preserved for backward compatibility.
1198
1199 fforward-propagate
1200 Common Report Var(flag_forward_propagate) Optimization
1201 Perform a forward propagation pass on RTL
1202
1203 ffp-contract=
1204 Common Joined RejectNegative Enum(fp_contract_mode) Var(flag_fp_contract_mode) Init(FP_CONTRACT_FAST)
1205 -ffp-contract=[off|on|fast] Perform floating-point expression contraction.
1206
1207 Enum
1208 Name(fp_contract_mode) Type(enum fp_contract_mode) UnknownError(unknown floating point contraction style %qs)
1209
1210 EnumValue
1211 Enum(fp_contract_mode) String(off) Value(FP_CONTRACT_OFF)
1212
1213 ; Not implemented, fall back to conservative FP_CONTRACT_OFF.
1214 EnumValue
1215 Enum(fp_contract_mode) String(on) Value(FP_CONTRACT_OFF)
1216
1217 EnumValue
1218 Enum(fp_contract_mode) String(fast) Value(FP_CONTRACT_FAST)
1219
1220 ; Nonzero means don't put addresses of constant functions in registers.
1221 ; Used for compiling the Unix kernel, where strange substitutions are
1222 ; done on the assembly output.
1223 ffunction-cse
1224 Common Report Var(flag_no_function_cse,0)
1225 Allow function addresses to be held in registers
1226
1227 ffunction-sections
1228 Common Report Var(flag_function_sections)
1229 Place each function into its own section
1230
1231 fgcse
1232 Common Report Var(flag_gcse) Optimization
1233 Perform global common subexpression elimination
1234
1235 fgcse-lm
1236 Common Report Var(flag_gcse_lm) Init(1) Optimization
1237 Perform enhanced load motion during global common subexpression elimination
1238
1239 fgcse-sm
1240 Common Report Var(flag_gcse_sm) Init(0) Optimization
1241 Perform store motion after global common subexpression elimination
1242
1243 fgcse-las
1244 Common Report Var(flag_gcse_las) Init(0) Optimization
1245 Perform redundant load after store elimination in global common subexpression
1246 elimination
1247
1248 fgcse-after-reload
1249 Common Report Var(flag_gcse_after_reload) Optimization
1250 Perform global common subexpression elimination after register allocation
1251 has finished
1252
1253 ; This option is not documented yet as its semantics will change.
1254 fgraphite
1255 Common Report Var(flag_graphite)
1256 Enable in and out of Graphite representation
1257
1258 fgraphite-identity
1259 Common Report Var(flag_graphite_identity) Optimization
1260 Enable Graphite Identity transformation
1261
1262 fgraphite-code-generator=
1263 Common Report RejectNegative Joined Optimization Enum(fgraphite_generator) Var(flag_graphite_code_gen) Init(FGRAPHITE_CODE_GEN_CLOOG)
1264 Choose code generator of Graphite
1265
1266 Enum
1267 Name(fgraphite_generator) Type(enum fgraphite_generator) UnknownError(unknown code generator of graphite %qs)
1268
1269 EnumValue
1270 Enum(fgraphite_generator) String(isl) Value(FGRAPHITE_CODE_GEN_ISL)
1271
1272 EnumValue
1273 Enum(fgraphite_generator) String(cloog) Value(FGRAPHITE_CODE_GEN_CLOOG)
1274
1275 fhoist-adjacent-loads
1276 Common Report Var(flag_hoist_adjacent_loads) Optimization
1277 Enable hoisting adjacent loads to encourage generating conditional move
1278 instructions
1279
1280 floop-parallelize-all
1281 Common Report Var(flag_loop_parallelize_all) Optimization
1282 Mark all loops as parallel
1283
1284 floop-strip-mine
1285 Common Report Var(flag_loop_strip_mine) Optimization
1286 Enable Loop Strip Mining transformation
1287
1288 floop-interchange
1289 Common Report Var(flag_loop_interchange) Optimization
1290 Enable Loop Interchange transformation
1291
1292 floop-block
1293 Common Report Var(flag_loop_block) Optimization
1294 Enable Loop Blocking transformation
1295
1296 fgnu-tm
1297 Common Report Var(flag_tm)
1298 Enable support for GNU transactional memory
1299
1300 fgnu-unique
1301 Common Report Var(flag_gnu_unique) Init(1)
1302 Use STB_GNU_UNIQUE if supported by the assembler
1303
1304 floop-flatten
1305 Common Ignore
1306 Does nothing. Preserved for backward compatibility.
1307
1308 floop-nest-optimize
1309 Common Report Var(flag_loop_optimize_isl) Optimization
1310 Enable the ISL based loop nest optimizer
1311
1312 fstrict-volatile-bitfields
1313 Common Report Var(flag_strict_volatile_bitfields) Init(-1)
1314 Force bitfield accesses to match their type width
1315
1316 fguess-branch-probability
1317 Common Report Var(flag_guess_branch_prob) Optimization
1318 Enable guessing of branch probabilities
1319
1320 ; Nonzero means ignore `#ident' directives. 0 means handle them.
1321 ; Generate position-independent code for executables if possible
1322 ; On SVR4 targets, it also controls whether or not to emit a
1323 ; string identifying the compiler.
1324 fident
1325 Common Report Var(flag_no_ident,0)
1326 Process #ident directives
1327
1328 fif-conversion
1329 Common Report Var(flag_if_conversion) Optimization
1330 Perform conversion of conditional jumps to branchless equivalents
1331
1332 fif-conversion2
1333 Common Report Var(flag_if_conversion2) Optimization
1334 Perform conversion of conditional jumps to conditional execution
1335
1336 fstack-reuse=
1337 Common Joined RejectNegative Enum(stack_reuse_level) Var(flag_stack_reuse) Init(SR_ALL)
1338 -fstack-reuse=[all|named_vars|none] Set stack reuse level for local variables.
1339
1340 Enum
1341 Name(stack_reuse_level) Type(enum stack_reuse_level) UnknownError(unknown Stack Reuse Level %qs)
1342
1343 EnumValue
1344 Enum(stack_reuse_level) String(all) Value(SR_ALL)
1345
1346 EnumValue
1347 Enum(stack_reuse_level) String(named_vars) Value(SR_NAMED_VARS)
1348
1349 EnumValue
1350 Enum(stack_reuse_level) String(none) Value(SR_NONE)
1351
1352 ftree-loop-if-convert
1353 Common Report Var(flag_tree_loop_if_convert) Init(-1) Optimization
1354 Convert conditional jumps in innermost loops to branchless equivalents
1355
1356 ftree-loop-if-convert-stores
1357 Common Report Var(flag_tree_loop_if_convert_stores) Optimization
1358 Also if-convert conditional jumps containing memory writes
1359
1360 ; -finhibit-size-directive inhibits output of .size for ELF.
1361 ; This is used only for compiling crtstuff.c,
1362 ; and it may be extended to other effects
1363 ; needed for crtstuff.c on other systems.
1364 finhibit-size-directive
1365 Common Report Var(flag_inhibit_size_directive)
1366 Do not generate .size directives
1367
1368 findirect-inlining
1369 Common Report Var(flag_indirect_inlining)
1370 Perform indirect inlining
1371
1372 ; General flag to enable inlining. Specifying -fno-inline will disable
1373 ; all inlining apart from always-inline functions.
1374 finline
1375 Common Report Var(flag_no_inline,0) Init(0) Optimization
1376 Enable inlining of function declared \"inline\", disabling disables all inlining
1377
1378 finline-small-functions
1379 Common Report Var(flag_inline_small_functions) Optimization
1380 Integrate functions into their callers when code size is known not to grow
1381
1382 finline-functions
1383 Common Report Var(flag_inline_functions) Optimization
1384 Integrate functions not declared \"inline\" into their callers when profitable
1385
1386 finline-functions-called-once
1387 Common Report Var(flag_inline_functions_called_once) Optimization
1388 Integrate functions only required by their single caller
1389
1390 finline-limit-
1391 Common RejectNegative Joined Alias(finline-limit=)
1392
1393 finline-limit=
1394 Common RejectNegative Joined UInteger
1395 -finline-limit=<number> Limit the size of inlined functions to <number>
1396
1397 finline-atomics
1398 Common Report Var(flag_inline_atomics) Init(1) Optimization
1399 Inline __atomic operations when a lock free instruction sequence is available.
1400
1401 finstrument-functions
1402 Common Report Var(flag_instrument_function_entry_exit)
1403 Instrument function entry and exit with profiling calls
1404
1405 finstrument-functions-exclude-function-list=
1406 Common RejectNegative Joined
1407 -finstrument-functions-exclude-function-list=name,... Do not instrument listed functions
1408
1409 finstrument-functions-exclude-file-list=
1410 Common RejectNegative Joined
1411 -finstrument-functions-exclude-file-list=filename,... Do not instrument functions listed in files
1412
1413 fipa-cp
1414 Common Report Var(flag_ipa_cp) Optimization
1415 Perform interprocedural constant propagation
1416
1417 fipa-cp-clone
1418 Common Report Var(flag_ipa_cp_clone) Optimization
1419 Perform cloning to make Interprocedural constant propagation stronger
1420
1421 fipa-profile
1422 Common Report Var(flag_ipa_profile) Init(0) Optimization
1423 Perform interprocedural profile propagation
1424
1425 fipa-pta
1426 Common Report Var(flag_ipa_pta) Init(0) Optimization
1427 Perform interprocedural points-to analysis
1428
1429 fipa-pure-const
1430 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
1431 Discover pure and const functions
1432
1433 fipa-reference
1434 Common Report Var(flag_ipa_reference) Init(0) Optimization
1435 Discover readonly and non addressable static variables
1436
1437 fipa-matrix-reorg
1438 Common Ignore
1439 Does nothing. Preserved for backward compatibility.
1440
1441 fipa-struct-reorg
1442 Common Ignore
1443 Does nothing. Preserved for backward compatibility.
1444
1445 fira-algorithm=
1446 Common Joined RejectNegative Enum(ira_algorithm) Var(flag_ira_algorithm) Init(IRA_ALGORITHM_CB)
1447 -fira-algorithm=[CB|priority] Set the used IRA algorithm
1448
1449 Enum
1450 Name(ira_algorithm) Type(enum ira_algorithm) UnknownError(unknown IRA algorithm %qs)
1451
1452 EnumValue
1453 Enum(ira_algorithm) String(CB) Value(IRA_ALGORITHM_CB)
1454
1455 EnumValue
1456 Enum(ira_algorithm) String(priority) Value(IRA_ALGORITHM_PRIORITY)
1457
1458 fira-region=
1459 Common Joined RejectNegative Enum(ira_region) Var(flag_ira_region) Init(IRA_REGION_AUTODETECT)
1460 -fira-region=[one|all|mixed] Set regions for IRA
1461
1462 Enum
1463 Name(ira_region) Type(enum ira_region) UnknownError(unknown IRA region %qs)
1464
1465 EnumValue
1466 Enum(ira_region) String(one) Value(IRA_REGION_ONE)
1467
1468 EnumValue
1469 Enum(ira_region) String(all) Value(IRA_REGION_ALL)
1470
1471 EnumValue
1472 Enum(ira_region) String(mixed) Value(IRA_REGION_MIXED)
1473
1474 fira-hoist-pressure
1475 Common Report Var(flag_ira_hoist_pressure) Init(1) Optimization
1476 Use IRA based register pressure calculation
1477 in RTL hoist optimizations.
1478
1479 fira-loop-pressure
1480 Common Report Var(flag_ira_loop_pressure) Optimization
1481 Use IRA based register pressure calculation
1482 in RTL loop optimizations.
1483
1484 fira-share-save-slots
1485 Common Report Var(flag_ira_share_save_slots) Init(1)
1486 Share slots for saving different hard registers.
1487
1488 fira-share-spill-slots
1489 Common Report Var(flag_ira_share_spill_slots) Init(1)
1490 Share stack slots for spilled pseudo-registers.
1491
1492 fira-verbose=
1493 Common RejectNegative Joined UInteger Var(flag_ira_verbose) Init(5)
1494 -fira-verbose=<number> Control IRA's level of diagnostic messages.
1495
1496 fivopts
1497 Common Report Var(flag_ivopts) Init(1) Optimization
1498 Optimize induction variables on trees
1499
1500 fjump-tables
1501 Common Var(flag_jump_tables) Init(1) Optimization
1502 Use jump tables for sufficiently large switch statements
1503
1504 fkeep-inline-functions
1505 Common Report Var(flag_keep_inline_functions)
1506 Generate code for functions even if they are fully inlined
1507
1508 fkeep-static-consts
1509 Common Report Var(flag_keep_static_consts) Init(1)
1510 Emit static const variables even if they are not used
1511
1512 fleading-underscore
1513 Common Report Var(flag_leading_underscore) Init(-1)
1514 Give external symbols a leading underscore
1515
1516 floop-optimize
1517 Common Ignore
1518 Does nothing. Preserved for backward compatibility.
1519
1520 flto
1521 Common
1522 Enable link-time optimization.
1523
1524 flto=
1525 Common RejectNegative Joined Var(flag_lto)
1526 Link-time optimization with number of parallel jobs or jobserver.
1527
1528 Enum
1529 Name(lto_partition_model) Type(enum lto_partition_model) UnknownError(unknown LTO partitioning model %qs)
1530
1531 EnumValue
1532 Enum(lto_partition_model) String(none) Value(LTO_PARTITION_NONE)
1533
1534 EnumValue
1535 Enum(lto_partition_model) String(one) Value(LTO_PARTITION_ONE)
1536
1537 EnumValue
1538 Enum(lto_partition_model) String(balanced) Value(LTO_PARTITION_BALANCED)
1539
1540 EnumValue
1541 Enum(lto_partition_model) String(1to1) Value(LTO_PARTITION_1TO1)
1542
1543 EnumValue
1544 Enum(lto_partition_model) String(max) Value(LTO_PARTITION_MAX)
1545
1546 flto-partition=
1547 Common Joined RejectNegative Enum(lto_partition_model) Var(flag_lto_partition) Init(LTO_PARTITION_BALANCED)
1548 Specify the algorithm to partition symbols and vars at linktime
1549
1550 ; The initial value of -1 comes from Z_DEFAULT_COMPRESSION in zlib.h.
1551 flto-compression-level=
1552 Common Joined RejectNegative UInteger Var(flag_lto_compression_level) Init(-1)
1553 -flto-compression-level=<number> Use zlib compression level <number> for IL
1554
1555 flto-report
1556 Common Report Var(flag_lto_report) Init(0)
1557 Report various link-time optimization statistics
1558
1559 flto-report-wpa
1560 Common Report Var(flag_lto_report_wpa) Init(0)
1561 Report various link-time optimization statistics for WPA only
1562
1563 fmath-errno
1564 Common Report Var(flag_errno_math) Init(1) Optimization SetByCombined
1565 Set errno after built-in math functions
1566
1567 fmax-errors=
1568 Common Joined RejectNegative UInteger Var(flag_max_errors)
1569 -fmax-errors=<number> Maximum number of errors to report
1570
1571 fmem-report
1572 Common Report Var(mem_report)
1573 Report on permanent memory allocation
1574
1575 fmem-report-wpa
1576 Common Report Var(mem_report_wpa)
1577 Report on permanent memory allocation in WPA only
1578
1579 ; This will attempt to merge constant section constants, if 1 only
1580 ; string constants and constants from constant pool, if 2 also constant
1581 ; variables.
1582 fmerge-all-constants
1583 Common Report Var(flag_merge_constants,2) Init(1) Optimization
1584 Attempt to merge identical constants and constant variables
1585
1586 fmerge-constants
1587 Common Report Var(flag_merge_constants,1) Optimization
1588 Attempt to merge identical constants across compilation units
1589
1590 fmerge-debug-strings
1591 Common Report Var(flag_merge_debug_strings) Init(1)
1592 Attempt to merge identical debug strings across compilation units
1593
1594 fmessage-length=
1595 Common RejectNegative Joined UInteger
1596 -fmessage-length=<number> Limit diagnostics to <number> characters per line. 0 suppresses line-wrapping
1597
1598 fmodulo-sched
1599 Common Report Var(flag_modulo_sched) Optimization
1600 Perform SMS based modulo scheduling before the first scheduling pass
1601
1602 fmodulo-sched-allow-regmoves
1603 Common Report Var(flag_modulo_sched_allow_regmoves)
1604 Perform SMS based modulo scheduling with register moves allowed
1605
1606 fmove-loop-invariants
1607 Common Report Var(flag_move_loop_invariants) Optimization
1608 Move loop invariant computations out of loops
1609
1610 fdce
1611 Common Var(flag_dce) Init(1) Optimization
1612 Use the RTL dead code elimination pass
1613
1614 fdse
1615 Common Var(flag_dse) Init(1) Optimization
1616 Use the RTL dead store elimination pass
1617
1618 freschedule-modulo-scheduled-loops
1619 Common Report Var(flag_resched_modulo_sched) Optimization
1620 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
1621
1622 fnon-call-exceptions
1623 Common Report Var(flag_non_call_exceptions) Optimization
1624 Support synchronous non-call exceptions
1625
1626 fomit-frame-pointer
1627 Common Report Var(flag_omit_frame_pointer) Optimization
1628 When possible do not generate stack frames
1629
1630 fopt-info
1631 Common Report Var(flag_opt_info) Optimization
1632 Enable all optimization info dumps on stderr
1633
1634 fopt-info-
1635 Common Joined RejectNegative Var(common_deferred_options) Defer
1636 -fopt-info[-<type>=filename] Dump compiler optimization details
1637
1638 foptimize-register-move
1639 Common Ignore
1640 Does nothing. Preserved for backward compatibility.
1641
1642 foptimize-sibling-calls
1643 Common Report Var(flag_optimize_sibling_calls) Optimization
1644 Optimize sibling and tail recursive calls
1645
1646 fpartial-inlining
1647 Common Report Var(flag_partial_inlining)
1648 Perform partial inlining
1649
1650 fpre-ipa-mem-report
1651 Common Report Var(pre_ipa_mem_report)
1652 Report on memory allocation before interprocedural optimization
1653
1654 fpost-ipa-mem-report
1655 Common Report Var(post_ipa_mem_report)
1656 Report on memory allocation before interprocedural optimization
1657
1658 fpack-struct
1659 Common Report Var(flag_pack_struct) Optimization
1660 Pack structure members together without holes
1661
1662 fpack-struct=
1663 Common RejectNegative Joined UInteger Optimization
1664 -fpack-struct=<number> Set initial maximum structure member alignment
1665
1666 fpcc-struct-return
1667 Common Report Var(flag_pcc_struct_return,1) Init(DEFAULT_PCC_STRUCT_RETURN)
1668 Return small aggregates in memory, not registers
1669
1670 fpeel-loops
1671 Common Report Var(flag_peel_loops) Optimization
1672 Perform loop peeling
1673
1674 fpeephole
1675 Common Report Var(flag_no_peephole,0) Optimization
1676 Enable machine specific peephole optimizations
1677
1678 fpeephole2
1679 Common Report Var(flag_peephole2) Optimization
1680 Enable an RTL peephole pass before sched2
1681
1682 fPIC
1683 Common Report Var(flag_pic,2) Negative(fPIE)
1684 Generate position-independent code if possible (large mode)
1685
1686 fPIE
1687 Common Report Var(flag_pie,2) Negative(fpic)
1688 Generate position-independent code for executables if possible (large mode)
1689
1690 fpic
1691 Common Report Var(flag_pic,1) Negative(fpie)
1692 Generate position-independent code if possible (small mode)
1693
1694 fpie
1695 Common Report Var(flag_pie,1) Negative(fPIC)
1696 Generate position-independent code for executables if possible (small mode)
1697
1698 fplugin=
1699 Common Joined RejectNegative Var(common_deferred_options) Defer
1700 Specify a plugin to load
1701
1702 fplugin-arg-
1703 Common Joined RejectNegative Var(common_deferred_options) Defer
1704 -fplugin-arg-<name>-<key>[=<value>] Specify argument <key>=<value> for plugin <name>
1705
1706 fpredictive-commoning
1707 Common Report Var(flag_predictive_commoning) Optimization
1708 Run predictive commoning optimization.
1709
1710 fprefetch-loop-arrays
1711 Common Report Var(flag_prefetch_loop_arrays) Init(-1) Optimization
1712 Generate prefetch instructions, if available, for arrays in loops
1713
1714 fprofile
1715 Common Report Var(profile_flag)
1716 Enable basic program profiling code
1717
1718 fprofile-arcs
1719 Common Report Var(profile_arc_flag)
1720 Insert arc-based program profiling code
1721
1722 fprofile-dir=
1723 Common Joined RejectNegative Var(profile_data_prefix)
1724 Set the top-level directory for storing the profile data.
1725 The default is 'pwd'.
1726
1727 fprofile-correction
1728 Common Report Var(flag_profile_correction)
1729 Enable correction of flow inconsistent profile data input
1730
1731 fprofile-generate
1732 Common
1733 Enable common options for generating profile info for profile feedback directed optimizations
1734
1735 fprofile-generate=
1736 Common Joined RejectNegative
1737 Enable common options for generating profile info for profile feedback directed optimizations, and set -fprofile-dir=
1738
1739 fprofile-use
1740 Common Var(flag_profile_use)
1741 Enable common options for performing profile feedback directed optimizations
1742
1743 fprofile-use=
1744 Common Joined RejectNegative
1745 Enable common options for performing profile feedback directed optimizations, and set -fprofile-dir=
1746
1747 fprofile-values
1748 Common Report Var(flag_profile_values)
1749 Insert code to profile values of expressions
1750
1751 fprofile-report
1752 Common Report Var(profile_report)
1753 Report on consistency of profile
1754
1755 fprofile-reorder-functions
1756 Common Report Var(flag_profile_reorder_functions)
1757 Enable function reordering that improves code placement
1758
1759 frandom-seed
1760 Common Var(common_deferred_options) Defer
1761
1762 frandom-seed=
1763 Common Joined RejectNegative Var(common_deferred_options) Defer
1764 -frandom-seed=<string> Make compile reproducible using <string>
1765
1766 ; This switch causes the command line that was used to create an
1767 ; object file to be recorded into the object file. The exact format
1768 ; of this recording is target and binary file format dependent.
1769 ; It is related to the -fverbose-asm switch, but that switch only
1770 ; records information in the assembler output file as comments, so
1771 ; they never reach the object file.
1772 frecord-gcc-switches
1773 Common Report Var(flag_record_gcc_switches)
1774 Record gcc command line switches in the object file.
1775
1776 freg-struct-return
1777 Common Report Var(flag_pcc_struct_return,0) Optimization
1778 Return small aggregates in registers
1779
1780 fregmove
1781 Common Ignore
1782 Does nothing. Preserved for backward compatibility.
1783
1784 flive-range-shrinkage
1785 Common Report Var(flag_live_range_shrinkage) Init(0) Optimization
1786 Relief of register pressure through live range shrinkage
1787
1788 frename-registers
1789 Common Report Var(flag_rename_registers) Init(2) Optimization
1790 Perform a register renaming optimization pass
1791
1792 freorder-blocks
1793 Common Report Var(flag_reorder_blocks) Optimization
1794 Reorder basic blocks to improve code placement
1795
1796 freorder-blocks-and-partition
1797 Common Report Var(flag_reorder_blocks_and_partition) Optimization
1798 Reorder basic blocks and partition into hot and cold sections
1799
1800 freorder-functions
1801 Common Report Var(flag_reorder_functions) Optimization
1802 Reorder functions to improve code placement
1803
1804 frerun-cse-after-loop
1805 Common Report Var(flag_rerun_cse_after_loop) Optimization
1806 Add a common subexpression elimination pass after loop optimizations
1807
1808 frerun-loop-opt
1809 Common Ignore
1810 Does nothing. Preserved for backward compatibility.
1811
1812 frounding-math
1813 Common Report Var(flag_rounding_math) Optimization SetByCombined
1814 Disable optimizations that assume default FP rounding behavior
1815
1816 fsched-interblock
1817 Common Report Var(flag_schedule_interblock) Init(1) Optimization
1818 Enable scheduling across basic blocks
1819
1820 fsched-pressure
1821 Common Report Var(flag_sched_pressure) Init(0) Optimization
1822 Enable register pressure sensitive insn scheduling
1823
1824 fsched-spec
1825 Common Report Var(flag_schedule_speculative) Init(1) Optimization
1826 Allow speculative motion of non-loads
1827
1828 fsched-spec-load
1829 Common Report Var(flag_schedule_speculative_load) Optimization
1830 Allow speculative motion of some loads
1831
1832 fsched-spec-load-dangerous
1833 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
1834 Allow speculative motion of more loads
1835
1836 fsched-verbose=
1837 Common RejectNegative Joined UInteger Var(sched_verbose_param)
1838 -fsched-verbose=<number> Set the verbosity level of the scheduler
1839
1840 fsched2-use-superblocks
1841 Common Report Var(flag_sched2_use_superblocks) Optimization
1842 If scheduling post reload, do superblock scheduling
1843
1844 fsched2-use-traces
1845 Common Ignore
1846 Does nothing. Preserved for backward compatibility.
1847
1848 fschedule-insns
1849 Common Report Var(flag_schedule_insns) Optimization
1850 Reschedule instructions before register allocation
1851
1852 fschedule-insns2
1853 Common Report Var(flag_schedule_insns_after_reload) Optimization
1854 Reschedule instructions after register allocation
1855
1856 ; This flag should be on when a target implements non-trivial
1857 ; scheduling hooks, maybe saving some information for its own sake.
1858 ; On IA64, for example, this is used for correct bundling.
1859 fselective-scheduling
1860 Common Report Var(flag_selective_scheduling) Optimization
1861 Schedule instructions using selective scheduling algorithm
1862
1863 fselective-scheduling2
1864 Common Report Var(flag_selective_scheduling2) Optimization
1865 Run selective scheduling after reload
1866
1867 fsel-sched-pipelining
1868 Common Report Var(flag_sel_sched_pipelining) Init(0) Optimization
1869 Perform software pipelining of inner loops during selective scheduling
1870
1871 fsel-sched-pipelining-outer-loops
1872 Common Report Var(flag_sel_sched_pipelining_outer_loops) Init(0) Optimization
1873 Perform software pipelining of outer loops during selective scheduling
1874
1875 fsel-sched-reschedule-pipelined
1876 Common Report Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization
1877 Reschedule pipelined regions without pipelining
1878
1879 fsemantic-interposition
1880 Common Report Var(flag_semantic_interposition) Init(1)
1881 Allow interposing function (or variables) by ones with different semantics (or initializer) respectively by dynamic linker
1882
1883 ; sched_stalled_insns means that insns can be moved prematurely from the queue
1884 ; of stalled insns into the ready list.
1885 fsched-stalled-insns
1886 Common Report Var(flag_sched_stalled_insns) Optimization UInteger
1887 Allow premature scheduling of queued insns
1888
1889 fsched-stalled-insns=
1890 Common RejectNegative Joined UInteger
1891 -fsched-stalled-insns=<number> Set number of queued insns that can be prematurely scheduled
1892
1893 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
1894 ; be examined for a dependency on a stalled insn that is candidate for
1895 ; premature removal from the queue of stalled insns into the ready list (has
1896 ; an effect only if the flag 'sched_stalled_insns' is set).
1897 fsched-stalled-insns-dep
1898 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization UInteger
1899 Set dependence distance checking in premature scheduling of queued insns
1900
1901 fsched-stalled-insns-dep=
1902 Common RejectNegative Joined UInteger
1903 -fsched-stalled-insns-dep=<number> Set dependence distance checking in premature scheduling of queued insns
1904
1905 fsched-group-heuristic
1906 Common Report Var(flag_sched_group_heuristic) Init(1) Optimization
1907 Enable the group heuristic in the scheduler
1908
1909 fsched-critical-path-heuristic
1910 Common Report Var(flag_sched_critical_path_heuristic) Init(1) Optimization
1911 Enable the critical path heuristic in the scheduler
1912
1913 fsched-spec-insn-heuristic
1914 Common Report Var(flag_sched_spec_insn_heuristic) Init(1) Optimization
1915 Enable the speculative instruction heuristic in the scheduler
1916
1917 fsched-rank-heuristic
1918 Common Report Var(flag_sched_rank_heuristic) Init(1) Optimization
1919 Enable the rank heuristic in the scheduler
1920
1921 fsched-last-insn-heuristic
1922 Common Report Var(flag_sched_last_insn_heuristic) Init(1) Optimization
1923 Enable the last instruction heuristic in the scheduler
1924
1925 fsched-dep-count-heuristic
1926 Common Report Var(flag_sched_dep_count_heuristic) Init(1) Optimization
1927 Enable the dependent count heuristic in the scheduler
1928
1929 fsection-anchors
1930 Common Report Var(flag_section_anchors) Optimization
1931 Access data in the same section from shared anchor points
1932
1933 fsee
1934 Common Ignore
1935 Does nothing. Preserved for backward compatibility.
1936
1937 fzee
1938 Common Ignore
1939 Does nothing. Preserved for backward compatibility.
1940
1941 free
1942 Common Report Var(flag_ree) Init(0)
1943 Turn on Redundant Extensions Elimination pass.
1944
1945 fshow-column
1946 Common Report Var(flag_show_column) Init(1)
1947 Show column numbers in diagnostics, when available. Default on
1948
1949 fshrink-wrap
1950 Common Report Var(flag_shrink_wrap) Optimization
1951 Emit function prologues only before parts of the function that need it,
1952 rather than at the top of the function.
1953
1954 fsignaling-nans
1955 Common Report Var(flag_signaling_nans) Optimization SetByCombined
1956 Disable optimizations observable by IEEE signaling NaNs
1957
1958 fsigned-zeros
1959 Common Report Var(flag_signed_zeros) Init(1) Optimization SetByCombined
1960 Disable floating point optimizations that ignore the IEEE signedness of zero
1961
1962 fsingle-precision-constant
1963 Common Report Var(flag_single_precision_constant) Optimization
1964 Convert floating point constants to single precision constants
1965
1966 fsplit-ivs-in-unroller
1967 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
1968 Split lifetimes of induction variables when loops are unrolled
1969
1970 fsplit-stack
1971 Common Report Var(flag_split_stack) Init(-1)
1972 Generate discontiguous stack frames
1973
1974 fsplit-wide-types
1975 Common Report Var(flag_split_wide_types) Optimization
1976 Split wide types into independent registers
1977
1978 fssa-phiopt
1979 Common Report Var(flag_ssa_phiopt) Optimization
1980 Optimize conditional patterns using SSA PHI nodes
1981
1982 fvariable-expansion-in-unroller
1983 Common Report Var(flag_variable_expansion_in_unroller) Optimization
1984 Apply variable expansion when loops are unrolled
1985
1986 fstack-check=
1987 Common Report RejectNegative Joined
1988 -fstack-check=[no|generic|specific] Insert stack checking code into the program
1989
1990 fstack-check
1991 Common Alias(fstack-check=, specific, no)
1992 Insert stack checking code into the program. Same as -fstack-check=specific
1993
1994 fstack-limit
1995 Common Var(common_deferred_options) Defer
1996
1997 fstack-limit-register=
1998 Common RejectNegative Joined Var(common_deferred_options) Defer
1999 -fstack-limit-register=<register> Trap if the stack goes past <register>
2000
2001 fstack-limit-symbol=
2002 Common RejectNegative Joined Var(common_deferred_options) Defer
2003 -fstack-limit-symbol=<name> Trap if the stack goes past symbol <name>
2004
2005 fstack-protector
2006 Common Report Var(flag_stack_protect, 1)
2007 Use propolice as a stack protection method
2008
2009 fstack-protector-all
2010 Common Report RejectNegative Var(flag_stack_protect, 2)
2011 Use a stack protection method for every function
2012
2013 fstack-protector-strong
2014 Common Report RejectNegative Var(flag_stack_protect, 3)
2015 Use a smart stack protection method for certain functions
2016
2017 fstack-usage
2018 Common RejectNegative Var(flag_stack_usage)
2019 Output stack usage information on a per-function basis
2020
2021 fstrength-reduce
2022 Common Ignore
2023 Does nothing. Preserved for backward compatibility.
2024
2025 ; Nonzero if we should do (language-dependent) alias analysis.
2026 ; Typically, this analysis will assume that expressions of certain
2027 ; types do not alias expressions of certain other types. Only used
2028 ; if alias analysis (in general) is enabled.
2029 fstrict-aliasing
2030 Common Report Var(flag_strict_aliasing) Optimization
2031 Assume strict aliasing rules apply
2032
2033 fstrict-overflow
2034 Common Report Var(flag_strict_overflow)
2035 Treat signed overflow as undefined
2036
2037 fsync-libcalls
2038 Common Report Var(flag_sync_libcalls) Init(1)
2039 Implement __atomic operations via libcalls to legacy __sync functions
2040
2041 fsyntax-only
2042 Common Report Var(flag_syntax_only)
2043 Check for syntax errors, then stop
2044
2045 ftest-coverage
2046 Common Report Var(flag_test_coverage)
2047 Create data files needed by \"gcov\"
2048
2049 fthread-jumps
2050 Common Report Var(flag_thread_jumps) Optimization
2051 Perform jump threading optimizations
2052
2053 ftime-report
2054 Common Report Var(time_report)
2055 Report the time taken by each compiler pass
2056
2057 ftls-model=
2058 Common Joined RejectNegative Enum(tls_model) Var(flag_tls_default) Init(TLS_MODEL_GLOBAL_DYNAMIC)
2059 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec] Set the default thread-local storage code generation model
2060
2061 Enum
2062 Name(tls_model) Type(enum tls_model) UnknownError(unknown TLS model %qs)
2063
2064 EnumValue
2065 Enum(tls_model) String(global-dynamic) Value(TLS_MODEL_GLOBAL_DYNAMIC)
2066
2067 EnumValue
2068 Enum(tls_model) String(local-dynamic) Value(TLS_MODEL_LOCAL_DYNAMIC)
2069
2070 EnumValue
2071 Enum(tls_model) String(initial-exec) Value(TLS_MODEL_INITIAL_EXEC)
2072
2073 EnumValue
2074 Enum(tls_model) String(local-exec) Value(TLS_MODEL_LOCAL_EXEC)
2075
2076 ftoplevel-reorder
2077 Common Report Var(flag_toplevel_reorder) Init(2) Optimization
2078 Reorder top level functions, variables, and asms
2079
2080 ftracer
2081 Common Report Var(flag_tracer)
2082 Perform superblock formation via tail duplication
2083
2084 ; Zero means that floating-point math operations cannot generate a
2085 ; (user-visible) trap. This is the case, for example, in nonstop
2086 ; IEEE 754 arithmetic.
2087 ftrapping-math
2088 Common Report Var(flag_trapping_math) Init(1) Optimization SetByCombined
2089 Assume floating-point operations can trap
2090
2091 ftrapv
2092 Common Report Var(flag_trapv) Optimization
2093 Trap for signed overflow in addition, subtraction and multiplication
2094
2095 ftree-ccp
2096 Common Report Var(flag_tree_ccp) Optimization
2097 Enable SSA-CCP optimization on trees
2098
2099 ftree-bit-ccp
2100 Common Report Var(flag_tree_bit_ccp) Optimization
2101 Enable SSA-BIT-CCP optimization on trees
2102
2103 ftree-store-ccp
2104 Common Ignore
2105 Does nothing. Preserved for backward compatibility.
2106
2107 ftree-ch
2108 Common Report Var(flag_tree_ch) Optimization
2109 Enable loop header copying on trees
2110
2111 ftree-coalesce-inlined-vars
2112 Common Report Var(flag_ssa_coalesce_vars,1) Init(2) RejectNegative Optimization
2113 Enable coalescing of copy-related user variables that are inlined
2114
2115 ftree-coalesce-vars
2116 Common Report Var(flag_ssa_coalesce_vars,2) Optimization
2117 Enable coalescing of all copy-related user variables
2118
2119 ftree-copyrename
2120 Common Report Var(flag_tree_copyrename) Optimization
2121 Replace SSA temporaries with better names in copies
2122
2123 ftree-copy-prop
2124 Common Report Var(flag_tree_copy_prop) Optimization
2125 Enable copy propagation on trees
2126
2127 ftree-store-copy-prop
2128 Common Ignore
2129 Does nothing. Preserved for backward compatibility.
2130
2131 ftree-cselim
2132 Common Report Var(flag_tree_cselim) Init(2) Optimization
2133 Transform condition stores into unconditional ones
2134
2135 ftree-switch-conversion
2136 Common Report Var(flag_tree_switch_conversion) Optimization
2137 Perform conversions of switch initializations.
2138
2139 ftree-dce
2140 Common Report Var(flag_tree_dce) Optimization
2141 Enable SSA dead code elimination optimization on trees
2142
2143 ftree-dominator-opts
2144 Common Report Var(flag_tree_dom) Optimization
2145 Enable dominator optimizations
2146
2147 ftree-tail-merge
2148 Common Report Var(flag_tree_tail_merge) Optimization
2149 Enable tail merging on trees
2150
2151 ftree-dse
2152 Common Report Var(flag_tree_dse) Optimization
2153 Enable dead store elimination
2154
2155 ftree-forwprop
2156 Common Report Var(flag_tree_forwprop) Init(1) Optimization
2157 Enable forward propagation on trees
2158
2159 ftree-fre
2160 Common Report Var(flag_tree_fre) Optimization
2161 Enable Full Redundancy Elimination (FRE) on trees
2162
2163 foptimize-strlen
2164 Common Report Var(flag_optimize_strlen) Optimization
2165 Enable string length optimizations on trees
2166
2167 fisolate-erroneous-paths-dereference
2168 Common Report Var(flag_isolate_erroneous_paths_dereference) Optimization
2169 Detect paths which trigger erroneous or undefined behaviour due to
2170 dereferencing a NULL pointer. Isolate those paths from the main control
2171 flow and turn the statement with erroneous or undefined behaviour into a trap.
2172
2173 fisolate-erroneous-paths-attribute
2174 Common Report Var(flag_isolate_erroneous_paths_attribute) Optimization
2175 Detect paths which trigger erroneous or undefined behaviour due a NULL value
2176 being used in a way which is forbidden by a returns_nonnull or nonnull
2177 attribute. Isolate those paths from the main control flow and turn the
2178 statement with erroneous or undefined behaviour into a trap.
2179
2180 ftree-loop-distribution
2181 Common Report Var(flag_tree_loop_distribution) Optimization
2182 Enable loop distribution on trees
2183
2184 ftree-loop-distribute-patterns
2185 Common Report Var(flag_tree_loop_distribute_patterns) Optimization
2186 Enable loop distribution for patterns transformed into a library call
2187
2188 ftree-loop-im
2189 Common Report Var(flag_tree_loop_im) Init(1) Optimization
2190 Enable loop invariant motion on trees
2191
2192 ftree-loop-linear
2193 Common Alias(floop-interchange)
2194 Enable loop interchange transforms. Same as -floop-interchange
2195
2196 ftree-loop-ivcanon
2197 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
2198 Create canonical induction variables in loops
2199
2200 ftree-loop-optimize
2201 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
2202 Enable loop optimizations on tree level
2203
2204 ftree-parallelize-loops=
2205 Common Report Joined RejectNegative UInteger Var(flag_tree_parallelize_loops) Init(1)
2206 Enable automatic parallelization of loops
2207
2208 ftree-phiprop
2209 Common Report Var(flag_tree_phiprop) Init(1) Optimization
2210 Enable hoisting loads from conditional pointers.
2211
2212 ftree-pre
2213 Common Report Var(flag_tree_pre) Optimization
2214 Enable SSA-PRE optimization on trees
2215
2216 ftree-partial-pre
2217 Common Report Var(flag_tree_partial_pre) Optimization
2218 In SSA-PRE optimization on trees, enable partial-partial redundancy elimination
2219
2220 ftree-pta
2221 Common Report Var(flag_tree_pta) Optimization
2222 Perform function-local points-to analysis on trees.
2223
2224 ftree-reassoc
2225 Common Report Var(flag_tree_reassoc) Init(1) Optimization
2226 Enable reassociation on tree level
2227
2228 ftree-salias
2229 Common Ignore
2230 Does nothing. Preserved for backward compatibility.
2231
2232 ftree-sink
2233 Common Report Var(flag_tree_sink) Optimization
2234 Enable SSA code sinking on trees
2235
2236 ftree-slsr
2237 Common Report Var(flag_tree_slsr) Optimization
2238 Perform straight-line strength reduction
2239
2240 ftree-sra
2241 Common Report Var(flag_tree_sra) Optimization
2242 Perform scalar replacement of aggregates
2243
2244 ftree-ter
2245 Common Report Var(flag_tree_ter) Optimization
2246 Replace temporary expressions in the SSA->normal pass
2247
2248 ftree-lrs
2249 Common Report Var(flag_tree_live_range_split) Optimization
2250 Perform live range splitting during the SSA->normal pass
2251
2252 ftree-vrp
2253 Common Report Var(flag_tree_vrp) Init(0) Optimization
2254 Perform Value Range Propagation on trees
2255
2256 funit-at-a-time
2257 Common Report Var(flag_unit_at_a_time) Init(1) Optimization
2258 Compile whole compilation unit at a time
2259
2260 funroll-loops
2261 Common Report Var(flag_unroll_loops) Optimization
2262 Perform loop unrolling when iteration count is known
2263
2264 funroll-all-loops
2265 Common Report Var(flag_unroll_all_loops) Optimization
2266 Perform loop unrolling for all loops
2267
2268 ; Nonzero means that loop optimizer may assume that the induction variables
2269 ; that control loops do not overflow and that the loops with nontrivial
2270 ; exit condition are not infinite
2271 funsafe-loop-optimizations
2272 Common Report Var(flag_unsafe_loop_optimizations) Optimization
2273 Allow loop optimizations to assume that the loops behave in normal way
2274
2275 fassociative-math
2276 Common Report Var(flag_associative_math) SetByCombined
2277 Allow optimization for floating-point arithmetic which may change the
2278 result of the operation due to rounding.
2279
2280 freciprocal-math
2281 Common Report Var(flag_reciprocal_math) SetByCombined
2282 Same as -fassociative-math for expressions which include division.
2283
2284 ; Nonzero means that unsafe floating-point math optimizations are allowed
2285 ; for the sake of speed. IEEE compliance is not guaranteed, and operations
2286 ; are allowed to assume that their arguments and results are "normal"
2287 ; (e.g., nonnegative for SQRT).
2288 funsafe-math-optimizations
2289 Common Report Var(flag_unsafe_math_optimizations) Optimization SetByCombined
2290 Allow math optimizations that may violate IEEE or ISO standards
2291
2292 funswitch-loops
2293 Common Report Var(flag_unswitch_loops) Optimization
2294 Perform loop unswitching
2295
2296 funwind-tables
2297 Common Report Var(flag_unwind_tables) Optimization
2298 Just generate unwind tables for exception handling
2299
2300 fuse-ld=bfd
2301 Common Driver Negative(fuse-ld=gold)
2302 Use the bfd linker instead of the default linker
2303
2304 fuse-ld=gold
2305 Common Driver Negative(fuse-ld=bfd)
2306 Use the gold linker instead of the default linker
2307
2308 fuse-linker-plugin
2309 Common Undocumented Var(flag_use_linker_plugin)
2310
2311 ; Positive if we should track variables, negative if we should run
2312 ; the var-tracking pass only to discard debug annotations, zero if
2313 ; we're not to run it. When flag_var_tracking == 2 (AUTODETECT_VALUE) it
2314 ; will be set according to optimize, debug_info_level and debug_hooks
2315 ; in process_options ().
2316 fvar-tracking
2317 Common Report Var(flag_var_tracking) Init(2) Optimization
2318 Perform variable tracking
2319
2320 ; Positive if we should track variables at assignments, negative if
2321 ; we should run the var-tracking pass only to discard debug
2322 ; annotations. When flag_var_tracking_assignments ==
2323 ; AUTODETECT_VALUE it will be set according to flag_var_tracking.
2324 fvar-tracking-assignments
2325 Common Report Var(flag_var_tracking_assignments) Init(2) Optimization
2326 Perform variable tracking by annotating assignments
2327
2328 ; Nonzero if we should toggle flag_var_tracking_assignments after
2329 ; processing options and computing its default. */
2330 fvar-tracking-assignments-toggle
2331 Common Report Var(flag_var_tracking_assignments_toggle) Optimization
2332 Toggle -fvar-tracking-assignments
2333
2334 ; Positive if we should track uninitialized variables, negative if
2335 ; we should run the var-tracking pass only to discard debug
2336 ; annotations. When flag_var_tracking_uninit == AUTODETECT_VALUE it
2337 ; will be set according to flag_var_tracking.
2338 fvar-tracking-uninit
2339 Common Report Var(flag_var_tracking_uninit) Optimization
2340 Perform variable tracking and also tag variables that are uninitialized
2341
2342 ftree-vectorize
2343 Common Report Var(flag_tree_vectorize) Optimization
2344 Enable vectorization on trees
2345
2346 ftree-vectorizer-verbose=
2347 Common Joined RejectNegative Ignore
2348 Does nothing. Preserved for backward compatibility.
2349
2350 ftree-loop-vectorize
2351 Common Report Var(flag_tree_loop_vectorize) Optimization
2352 Enable loop vectorization on trees
2353
2354 ftree-slp-vectorize
2355 Common Report Var(flag_tree_slp_vectorize) Optimization
2356 Enable basic block vectorization (SLP) on trees
2357
2358 fvect-cost-model=
2359 Common Joined RejectNegative Enum(vect_cost_model) Var(flag_vect_cost_model) Init(VECT_COST_MODEL_DEFAULT)
2360 Specifies the cost model for vectorization
2361
2362 fsimd-cost-model=
2363 Common Joined RejectNegative Enum(vect_cost_model) Var(flag_simd_cost_model) Init(VECT_COST_MODEL_UNLIMITED)
2364 Specifies the vectorization cost model for code marked with a simd directive
2365
2366 Enum
2367 Name(vect_cost_model) Type(enum vect_cost_model) UnknownError(unknown vectorizer cost model %qs)
2368
2369 EnumValue
2370 Enum(vect_cost_model) String(unlimited) Value(VECT_COST_MODEL_UNLIMITED)
2371
2372 EnumValue
2373 Enum(vect_cost_model) String(dynamic) Value(VECT_COST_MODEL_DYNAMIC)
2374
2375 EnumValue
2376 Enum(vect_cost_model) String(cheap) Value(VECT_COST_MODEL_CHEAP)
2377
2378 fvect-cost-model
2379 Common RejectNegative Alias(fvect-cost-model=,dynamic)
2380 Enables the dynamic vectorizer cost model. Preserved for backward compatibility.
2381
2382 fno-vect-cost-model
2383 Common RejectNegative Alias(fvect-cost-model=,unlimited)
2384 Enables the unlimited vectorizer cost model. Preserved for backward compatibility.
2385
2386 ftree-vect-loop-version
2387 Common Ignore
2388 Does nothing. Preserved for backward compatibility.
2389
2390 ftree-scev-cprop
2391 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
2392 Enable copy propagation of scalar-evolution information.
2393
2394 ; -fverbose-asm causes extra commentary information to be produced in
2395 ; the generated assembly code (to make it more readable). This option
2396 ; is generally only of use to those who actually need to read the
2397 ; generated assembly code (perhaps while debugging the compiler itself).
2398 ; -fno-verbose-asm, the default, causes the extra information
2399 ; to not be added and is useful when comparing two assembler files.
2400 fverbose-asm
2401 Common Report Var(flag_verbose_asm)
2402 Add extra commentary to assembler output
2403
2404 fvisibility=
2405 Common Joined RejectNegative Enum(symbol_visibility) Var(default_visibility) Init(VISIBILITY_DEFAULT)
2406 -fvisibility=[default|internal|hidden|protected] Set the default symbol visibility
2407
2408 Enum
2409 Name(symbol_visibility) Type(enum symbol_visibility) UnknownError(unrecognized visibility value %qs)
2410
2411 EnumValue
2412 Enum(symbol_visibility) String(default) Value(VISIBILITY_DEFAULT)
2413
2414 EnumValue
2415 Enum(symbol_visibility) String(internal) Value(VISIBILITY_INTERNAL)
2416
2417 EnumValue
2418 Enum(symbol_visibility) String(hidden) Value(VISIBILITY_HIDDEN)
2419
2420 EnumValue
2421 Enum(symbol_visibility) String(protected) Value(VISIBILITY_PROTECTED)
2422
2423 fvtable-verify=
2424 Common Joined RejectNegative Enum(vtv_priority) Var(flag_vtable_verify) Init(VTV_NO_PRIORITY)
2425 Validate vtable pointers before using them.
2426
2427 Enum
2428 Name(vtv_priority) Type(enum vtv_priority) UnknownError(unknown vtable verify initialization priority %qs)
2429
2430 EnumValue
2431 Enum(vtv_priority) String(none) Value(VTV_NO_PRIORITY)
2432
2433 EnumValue
2434 Enum(vtv_priority) String(std) Value(VTV_STANDARD_PRIORITY)
2435
2436 EnumValue
2437 Enum(vtv_priority) String(preinit) Value(VTV_PREINIT_PRIORITY)
2438
2439 fvtv-counts
2440 Common Var(flag_vtv_counts)
2441 Output vtable verification counters.
2442
2443 fvtv-debug
2444 Common Var(flag_vtv_debug)
2445 Output vtable verification pointer sets information.
2446
2447 fvpt
2448 Common Report Var(flag_value_profile_transformations) Optimization
2449 Use expression value profiles in optimizations
2450
2451 fweb
2452 Common Report Var(flag_web) Init(2) Optimization
2453 Construct webs and split unrelated uses of single variable
2454
2455 ftree-builtin-call-dce
2456 Common Report Var(flag_tree_builtin_call_dce) Init(0) Optimization
2457 Enable conditional dead code elimination for builtin calls
2458
2459 fwhole-program
2460 Common Report Var(flag_whole_program) Init(0) Optimization
2461 Perform whole program optimizations
2462
2463 fwrapv
2464 Common Report Var(flag_wrapv) Optimization
2465 Assume signed arithmetic overflow wraps around
2466
2467 fzero-initialized-in-bss
2468 Common Report Var(flag_zero_initialized_in_bss) Init(1)
2469 Put zero initialized data in the bss section
2470
2471 g
2472 Common JoinedOrMissing
2473 Generate debug information in default format
2474
2475 gcoff
2476 Common JoinedOrMissing Negative(gdwarf)
2477 Generate debug information in COFF format
2478
2479 gdwarf
2480 Common JoinedOrMissing Negative(gdwarf-)
2481 Generate debug information in default version of DWARF format
2482
2483 gdwarf-
2484 Common Joined UInteger Var(dwarf_version) Init(4) Negative(gstabs)
2485 Generate debug information in DWARF v2 (or later) format
2486
2487 ggdb
2488 Common JoinedOrMissing
2489 Generate debug information in default extended format
2490
2491 gno-pubnames
2492 Common Negative(gpubnames) Var(debug_generate_pub_sections, 0) Init(-1)
2493 Don't generate DWARF pubnames and pubtypes sections.
2494
2495 gpubnames
2496 Common Negative(ggnu-pubnames) Var(debug_generate_pub_sections, 1)
2497 Generate DWARF pubnames and pubtypes sections.
2498
2499 ggnu-pubnames
2500 Common Negative(gno-pubnames) Var(debug_generate_pub_sections, 2)
2501 Generate DWARF pubnames and pubtypes sections with GNU extensions.
2502
2503 gno-record-gcc-switches
2504 Common RejectNegative Var(dwarf_record_gcc_switches,0) Init(1)
2505 Don't record gcc command line switches in DWARF DW_AT_producer.
2506
2507 grecord-gcc-switches
2508 Common RejectNegative Var(dwarf_record_gcc_switches,1)
2509 Record gcc command line switches in DWARF DW_AT_producer.
2510
2511 gno-split-dwarf
2512 Common Driver RejectNegative Var(dwarf_split_debug_info,0) Init(0)
2513 Don't generate debug information in separate .dwo files
2514
2515 gsplit-dwarf
2516 Common Driver RejectNegative Var(dwarf_split_debug_info,1)
2517 Generate debug information in separate .dwo files
2518
2519 gstabs
2520 Common JoinedOrMissing Negative(gstabs+)
2521 Generate debug information in STABS format
2522
2523 gstabs+
2524 Common JoinedOrMissing Negative(gvms)
2525 Generate debug information in extended STABS format
2526
2527 gno-strict-dwarf
2528 Common RejectNegative Var(dwarf_strict,0) Init(0)
2529 Emit DWARF additions beyond selected version
2530
2531 gstrict-dwarf
2532 Common Report RejectNegative Var(dwarf_strict,1)
2533 Don't emit DWARF additions beyond selected version
2534
2535 gtoggle
2536 Common Report Var(flag_gtoggle)
2537 Toggle debug information generation
2538
2539 gvms
2540 Common JoinedOrMissing Negative(gxcoff)
2541 Generate debug information in VMS format
2542
2543 gxcoff
2544 Common JoinedOrMissing Negative(gxcoff+)
2545 Generate debug information in XCOFF format
2546
2547 gxcoff+
2548 Common JoinedOrMissing Negative(gcoff)
2549 Generate debug information in extended XCOFF format
2550
2551 Enum
2552 Name(compressed_debug_sections) Type(int)
2553
2554 ; Since -gz= is completely handled in specs, the values aren't used and we
2555 ; assign arbitrary constants.
2556 EnumValue
2557 Enum(compressed_debug_sections) String(none) Value(0)
2558
2559 EnumValue
2560 Enum(compressed_debug_sections) String(zlib) Value(1)
2561
2562 EnumValue
2563 Enum(compressed_debug_sections) String(zlib-gnu) Value(2)
2564
2565 gz
2566 Common Driver
2567 Generate compressed debug sections
2568
2569 gz=
2570 Common Driver Joined Enum(compressed_debug_sections)
2571 -gz=<format> Generate compressed debug sections in format <format>
2572
2573 h
2574 Driver Joined Separate
2575
2576 iplugindir=
2577 Common Joined Var(plugindir_string) Init(0)
2578 -iplugindir=<dir> Set <dir> to be the default plugin directory
2579
2580 imultiarch
2581 Common Joined Separate RejectDriver Var(imultiarch) Init(0)
2582 -imultiarch <dir> Set <dir> to be the multiarch include subdirectory
2583
2584 l
2585 Driver Joined Separate
2586
2587 n
2588 Driver
2589
2590 no-canonical-prefixes
2591 Driver
2592
2593 nodefaultlibs
2594 Driver
2595
2596 nostartfiles
2597 Driver
2598
2599 nostdlib
2600 Driver
2601
2602 o
2603 Common Driver Joined Separate Var(asm_file_name) MissingArgError(missing filename after %qs)
2604 -o <file> Place output into <file>
2605
2606 p
2607 Common Var(profile_flag)
2608 Enable function profiling
2609
2610 pass-exit-codes
2611 Driver Var(pass_exit_codes)
2612
2613 pedantic
2614 Common Alias(Wpedantic)
2615
2616 pedantic-errors
2617 Common Var(flag_pedantic_errors)
2618 Like -pedantic but issue them as errors
2619
2620 pg
2621 Driver
2622
2623 pipe
2624 Driver Var(use_pipes)
2625
2626 print-file-name=
2627 Driver JoinedOrMissing Var(print_file_name)
2628
2629 print-libgcc-file-name
2630 Driver
2631
2632 print-multi-directory
2633 Driver Var(print_multi_directory)
2634
2635 print-multi-lib
2636 Driver Var(print_multi_lib)
2637
2638 print-multi-os-directory
2639 Driver Var(print_multi_os_directory)
2640
2641 print-multiarch
2642 Driver Var(print_multiarch)
2643
2644 print-prog-name=
2645 Driver JoinedOrMissing Var(print_prog_name)
2646
2647 print-search-dirs
2648 Driver Var(print_search_dirs)
2649
2650 print-sysroot
2651 Driver Var(print_sysroot)
2652
2653 print-sysroot-headers-suffix
2654 Driver Var(print_sysroot_headers_suffix)
2655
2656 quiet
2657 Common Var(quiet_flag) RejectDriver
2658 Do not display functions compiled or elapsed time
2659
2660 r
2661 Driver
2662
2663 s
2664 Driver
2665
2666 save-temps
2667 Driver
2668
2669 save-temps=
2670 Driver Joined
2671
2672 t
2673 Driver
2674
2675 time
2676 Driver Var(report_times)
2677
2678 time=
2679 Driver JoinedOrMissing
2680
2681 u
2682 Driver Joined Separate
2683
2684 undef
2685 Driver
2686 ; C option, but driver must not handle as "-u ndef".
2687
2688 v
2689 Common Driver Var(verbose_flag)
2690 Enable verbose output
2691
2692 version
2693 Common Var(version_flag) RejectDriver
2694 Display the compiler's version
2695
2696 w
2697 Common Var(inhibit_warnings)
2698 Suppress warnings
2699
2700 wrapper
2701 Driver Separate Var(wrapper_string)
2702
2703 x
2704 Driver Joined Separate
2705
2706 shared
2707 Driver RejectNegative Negative(pie)
2708 Create a shared library
2709
2710 shared-libgcc
2711 Driver
2712
2713 specs
2714 Driver Separate Alias(specs=)
2715
2716 specs=
2717 Driver Joined
2718
2719 static
2720 Driver
2721
2722 static-libgcc
2723 Driver
2724
2725 static-libgfortran
2726 Driver
2727 ; Documented for Fortran, but always accepted by driver.
2728
2729 static-libstdc++
2730 Driver
2731
2732 static-libgo
2733 Driver
2734 ; Documented for Go, but always accepted by driver.
2735
2736 static-libasan
2737 Driver
2738
2739 static-libtsan
2740 Driver
2741
2742 static-liblsan
2743 Driver
2744
2745 static-libubsan
2746 Driver
2747
2748 symbolic
2749 Driver
2750
2751 pie
2752 Driver RejectNegative Negative(shared)
2753 Create a position independent executable
2754
2755 z
2756 Driver Joined Separate
2757
2758 fuse-caller-save
2759 Common Report Var(flag_use_caller_save) Optimization
2760 Use caller save register across calls if possible
2761
2762 ; This comment is to ensure we retain the blank line above.