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