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