2c1bd833f8a0910ba4d5b320d1e16bf6c70e3e35
[platform/upstream/gcc.git] / gcc / common.opt
1 ; Options for the language- and target-independent parts of the compiler.
2
3 ; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
4 ; Free Software Foundation, Inc.
5 ;
6 ; This file is part of GCC.
7 ;
8 ; GCC is free software; you can redistribute it and/or modify it under
9 ; the terms of the GNU General Public License as published by the Free
10 ; Software Foundation; either version 3, or (at your option) any later
11 ; version.
12 ;
13 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 ; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
16 ; for more details.
17 ;
18 ; You should have received a copy of the GNU General Public License
19 ; along with GCC; see the file COPYING3.  If not see
20 ; <http://www.gnu.org/licenses/>.
21
22 ; See the GCC internals manual (options.texi) for a description of this file's format.
23
24 ; Please try to keep this file in ASCII collating order.
25
26 Variable
27 int target_flags
28
29 Variable
30 int optimize
31
32 Variable
33 int optimize_size
34
35 ###
36 Driver
37
38 -assemble
39 Driver Alias(S)
40
41 -compile
42 Driver Alias(c)
43
44 -coverage
45 Driver Alias(coverage)
46
47 -debug
48 Common Alias(g)
49
50 -dump
51 Common Separate Alias(d)
52
53 -dump=
54 Common Joined Alias(d)
55
56 -dumpbase
57 Common Separate Alias(dumpbase)
58
59 -dumpdir
60 Common Separate Alias(dumpdir)
61
62 -entry
63 Driver Separate Alias(e)
64
65 -entry=
66 Driver Joined Alias(e)
67
68 -extra-warnings
69 Common Warning Alias(Wextra)
70
71 -for-assembler
72 Driver Separate Alias(Xassembler)
73
74 -for-assembler=
75 Driver JoinedOrMissing Alias(Xassembler)
76
77 -for-linker
78 Driver Separate Alias(Xlinker)
79
80 -for-linker=
81 Driver JoinedOrMissing Alias(Xlinker)
82
83 -force-link
84 Driver Separate Alias(u)
85
86 -force-link=
87 Driver Joined Alias(u)
88
89 -help
90 Common Driver Var(help_flag)
91 Display this information
92
93 -help=
94 Common Driver Report Joined
95 --help=<class>  Display descriptions of a specific class of options.  <class> is one or more of optimizers, target, warnings, undocumented, params
96
97 -language
98 Driver Separate Alias(x)
99
100 -language=
101 Driver Joined Alias(x)
102
103 -library-directory
104 Driver Separate Alias(L)
105
106 -library-directory=
107 Driver Joined Alias(L)
108
109 -no-canonical-prefixes
110 Driver Alias(no-canonical-prefixes)
111
112 -no-standard-libraries
113 Driver Alias(nostdlib)
114
115 -no-warnings
116 Common Alias(w)
117
118 -optimize
119 Common Alias(O)
120
121 -output
122 Common Driver Separate Alias(o) MissingArgError(missing filename after %qs)
123
124 -output=
125 Common Driver Joined Alias(o) MissingArgError(missing filename after %qs)
126
127 -pass-exit-codes
128 Driver Alias(pass-exit-codes)
129
130 -pedantic
131 Common Alias(pedantic)
132
133 -pedantic-errors
134 Common Alias(pedantic-errors)
135
136 -pie
137 Common Alias(pie)
138
139 -pipe
140 Driver Alias(pipe)
141
142 -prefix
143 Driver Separate Alias(B)
144
145 -prefix=
146 Driver JoinedOrMissing Alias(B)
147
148 -preprocess
149 Driver Alias(E)
150
151 -print-file-name
152 Driver Separate Alias(print-file-name=)
153
154 -print-file-name=
155 Driver JoinedOrMissing Alias(print-file-name=)
156
157 -print-libgcc-file-name
158 Driver Alias(print-libgcc-file-name)
159
160 -print-multi-directory
161 Driver Alias(print-multi-directory)
162
163 -print-multi-lib
164 Driver Alias(print-multi-lib)
165
166 -print-multi-os-directory
167 Driver Alias(print-multi-os-directory)
168
169 -print-prog-name
170 Driver Separate Alias(print-prog-name=)
171
172 -print-prog-name=
173 Driver JoinedOrMissing Alias(print-prog-name=)
174
175 -print-search-dirs
176 Driver Alias(print-search-dirs)
177
178 -print-sysroot
179 Driver Alias(print-sysroot)
180
181 -print-sysroot-headers-suffix
182 Driver Alias(print-sysroot-headers-suffix)
183
184 -profile
185 Common Alias(p)
186
187 -save-temps
188 Driver Alias(save-temps)
189
190 -shared
191 Common Alias(shared)
192
193 -specs
194 Driver Separate Alias(specs=)
195
196 -specs=
197 Driver Joined Alias(specs=)
198
199 -static
200 Driver Alias(static)
201
202 -symbolic
203 Driver Alias(symbolic)
204
205 -target-help
206 Common Driver
207 Alias for --help=target
208
209 -time
210 Driver Alias(time)
211
212 -verbose
213 Driver Alias(v)
214
215 ;; The driver used to convert options such as --help into forms such
216 ;; as -fhelp; the following four entries are for compatibility with
217 ;; any direct uses of those (undocumented) -f forms
218 fhelp
219 Common Driver Alias(-help)
220
221 fhelp=
222 Common Driver Joined Alias(-help=)
223
224 ftarget-help
225 Common Driver Alias(-target-help)
226
227 fversion
228 Common Driver Alias(-version)
229
230 -param
231 Common Separate
232 --param <param>=<value> Set parameter <param> to value.  See below for a complete list of parameters
233
234 -param=
235 Common Joined Alias(-param)
236
237 -sysroot
238 Driver Separate Alias(-sysroot=)
239
240 -sysroot=
241 Driver JoinedOrMissing
242
243 -version
244 Common Driver
245
246 B
247 Driver Joined Separate
248
249 E
250 Driver
251
252 L
253 Driver Joined Separate
254
255 O
256 Common JoinedOrMissing Optimization
257 -O<number>      Set optimization level to <number>
258
259 Os
260 Common Optimization
261 Optimize for space rather than speed
262
263 Ofast
264 Common Optimization
265 Optimize for speed disregarding exact standards compliance
266
267 S
268 Driver
269
270 W
271 Common RejectNegative Warning Alias(Wextra)
272 This switch is deprecated; use -Wextra instead
273
274 Wa,
275 Driver JoinedOrMissing
276
277 Wl,
278 Driver JoinedOrMissing
279
280 Wp,
281 Driver JoinedOrMissing
282
283 Waggregate-return
284 Common Var(warn_aggregate_return) Warning
285 Warn about returning structures, unions or arrays
286
287 Warray-bounds
288 Common Var(warn_array_bounds) Warning
289 Warn if an array is accessed out of bounds
290
291 Wattributes
292 Common Var(warn_attributes) Init(1) Warning
293 Warn about inappropriate attribute usage
294
295 Wcast-align
296 Common Var(warn_cast_align) Warning
297 Warn about pointer casts which increase alignment
298
299 Wcpp
300 Common Var(warn_cpp) Init(1) Warning
301 Warn when a #warning directive is encountered
302
303 Wdeprecated-declarations
304 Common Var(warn_deprecated_decl) Init(1) Warning
305 Warn about uses of __attribute__((deprecated)) declarations
306
307 Wdisabled-optimization
308 Common Var(warn_disabled_optimization) Warning
309 Warn when an optimization pass is disabled
310
311 Werror
312 Common Var(warnings_are_errors)
313 Treat all warnings as errors
314
315 Werror=
316 Common Joined
317 Treat specified warning as error
318
319 Wextra
320 Common Var(extra_warnings) Warning
321 Print extra (possibly unwanted) warnings
322
323 Wfatal-errors
324 Common Var(flag_fatal_errors)
325 Exit on the first error occurred
326
327 Wframe-larger-than=
328 Common RejectNegative Joined UInteger
329 -Wframe-larger-than=<number>    Warn if a function's stack frame requires more than <number> bytes
330
331 Winline
332 Common Var(warn_inline) Warning
333 Warn when an inlined function cannot be inlined
334
335 Wlarger-than-
336 Common RejectNegative Joined Warning Undocumented Alias(Wlarger-than=)
337
338 Wlarger-than=
339 Common RejectNegative Joined UInteger Warning
340 -Wlarger-than=<number>  Warn if an object is larger than <number> bytes
341
342 Wunsafe-loop-optimizations
343 Common Var(warn_unsafe_loop_optimizations) Warning
344 Warn if the loop cannot be optimized due to nontrivial assumptions.
345
346 Wmissing-noreturn
347 Common Var(warn_missing_noreturn) Warning
348 Warn about functions which might be candidates for __attribute__((noreturn))
349
350 Wmudflap
351 Common Var(warn_mudflap) Init(1) Warning
352 Warn about constructs not instrumented by -fmudflap
353
354 Woverflow
355 Common Var(warn_overflow) Init(1) Warning
356 Warn about overflow in arithmetic expressions
357
358 Wpacked
359 Common Var(warn_packed) Warning
360 Warn when the packed attribute has no effect on struct layout
361
362 Wpadded
363 Common Var(warn_padded) Warning
364 Warn when padding is required to align structure members
365
366 Wshadow
367 Common Var(warn_shadow) Warning
368 Warn when one local variable shadows another
369
370 Wstack-protector
371 Common Var(warn_stack_protect) Warning
372 Warn when not issuing stack smashing protection for some reason
373
374 Wstrict-aliasing
375 Common Warning
376 Warn about code which might break strict aliasing rules
377
378 Wstrict-aliasing=
379 Common Joined RejectNegative UInteger Var(warn_strict_aliasing) Init(-1) Warning
380 Warn about code which might break strict aliasing rules
381
382 Wstrict-overflow
383 Common Warning
384 Warn about optimizations that assume that signed overflow is undefined
385
386 Wstrict-overflow=
387 Common Joined RejectNegative UInteger Var(warn_strict_overflow) Init(-1) Warning
388 Warn about optimizations that assume that signed overflow is undefined
389
390 Wsuggest-attribute=const
391 Common Var(warn_suggest_attribute_const) Warning
392 Warn about functions which might be candidates for __attribute__((const))
393
394 Wsuggest-attribute=pure
395 Common Var(warn_suggest_attribute_pure) Warning
396 Warn about functions which might be candidates for __attribute__((pure))
397
398 Wsuggest-attribute=noreturn
399 Common Var(warn_suggest_attribute_noreturn) Warning
400 Warn about functions which might be candidates for __attribute__((noreturn))
401
402 Wswitch
403 Common Var(warn_switch) Warning
404 Warn about enumerated switches, with no default, missing a case
405
406 Wswitch-default
407 Common Var(warn_switch_default) Warning
408 Warn about enumerated switches missing a \"default:\" statement
409
410 Wswitch-enum
411 Common Var(warn_switch_enum) Warning
412 Warn about all enumerated switches missing a specific case
413
414 Wsystem-headers
415 Common Var(warn_system_headers) Warning
416 Do not suppress warnings from system headers
417
418 Wtrampolines
419 Common Var(warn_trampolines) Warning
420 Warn whenever a trampoline is generated
421
422 Wtype-limits
423 Common Var(warn_type_limits) Init(-1) Warning
424 Warn if a comparison is always true or always false due to the limited range of the data type
425
426 Wuninitialized
427 Common Var(warn_uninitialized) Init(-1) Warning
428 Warn about uninitialized automatic variables
429
430 Wunreachable-code
431 Common Ignore
432 Does nothing. Preserved for backward compatibility.
433
434 Wunused
435 Common Var(warn_unused) Init(0) Warning
436 Enable all -Wunused- warnings
437
438 Wunused-but-set-parameter
439 Common Var(warn_unused_but_set_parameter) Init(-1) Warning
440 Warn when a function parameter is only set, otherwise unused
441
442 Wunused-but-set-variable
443 Common Var(warn_unused_but_set_variable) Init(-1) Warning
444 Warn when a variable is only set, otherwise unused
445
446 Wunused-function
447 Common Var(warn_unused_function) Init(-1) Warning
448 Warn when a function is unused
449
450 Wunused-label
451 Common Var(warn_unused_label) Init(-1) Warning
452 Warn when a label is unused
453
454 Wunused-parameter
455 Common Var(warn_unused_parameter) Init(-1) Warning
456 Warn when a function parameter is unused
457
458 Wunused-value
459 Common Var(warn_unused_value) Init(-1) Warning
460 Warn when an expression value is unused
461
462 Wunused-variable
463 Common Var(warn_unused_variable) Init(-1) Warning
464 Warn when a variable is unused
465
466 Wcoverage-mismatch
467 Common Var(warn_coverage_mismatch) Init(1) Warning
468 Warn in case profiles in -fprofile-use do not match
469
470 Xassembler
471 Driver Separate
472
473 Xlinker
474 Driver Separate
475
476 Xpreprocessor
477 Driver Separate
478
479 aux-info
480 Common Separate
481 -aux-info <file>        Emit declaration information into <file>
482
483 aux-info=
484 Common Joined Alias(aux-info)
485
486 auxbase
487 Common Separate RejectDriver
488
489 auxbase-strip
490 Common Separate RejectDriver
491
492 coverage
493 Driver
494
495 c
496 Driver
497
498 d
499 Common Joined
500 -d<letters>     Enable dumps from specific passes of the compiler
501
502 dumpbase
503 Common Separate
504 -dumpbase <file>        Set the file basename to be used for dumps
505
506 dumpdir
507 Common Separate
508 -dumpdir <dir>  Set the directory name to be used for dumps
509
510 dumpmachine
511 Driver
512
513 dumpspecs
514 Driver
515
516 dumpversion
517 Driver
518
519 e
520 Driver Joined Separate
521
522 ; The version of the C++ ABI in use.  The following values are allowed:
523 ;
524 ; 0: The version of the ABI believed most conformant with the C++ ABI
525 ;    specification.  This ABI may change as bugs are discovered and fixed.
526 ;    Therefore, 0 will not necessarily indicate the same ABI in different
527 ;    versions of G++.
528 ;
529 ; 1: The version of the ABI first used in G++ 3.2.
530 ;
531 ; 2: The version of the ABI first used in G++ 3.4 (and current default).
532 ;
533 ; 3: The version of the ABI that fixes the missing underscore
534 ;    in template non-type arguments of pointer type.
535 ;
536 ; 4: The version of the ABI that introduces unambiguous mangling of
537 ;    vector types.
538 ;
539 ; Additional positive integers will be assigned as new versions of
540 ; the ABI become the default version of the ABI.
541 fabi-version=
542 Common Joined RejectNegative UInteger Var(flag_abi_version) Init(2)
543
544 falign-functions
545 Common Report Var(align_functions,0) Optimization UInteger
546 Align the start of functions
547
548 falign-functions=
549 Common RejectNegative Joined UInteger
550
551 falign-jumps
552 Common Report Var(align_jumps,0) Optimization UInteger
553 Align labels which are only reached by jumping
554
555 falign-jumps=
556 Common RejectNegative Joined UInteger
557
558 falign-labels
559 Common Report Var(align_labels,0) Optimization UInteger
560 Align all labels
561
562 falign-labels=
563 Common RejectNegative Joined UInteger
564
565 falign-loops
566 Common Report Var(align_loops) Optimization UInteger
567 Align the start of loops
568
569 falign-loops=
570 Common RejectNegative Joined UInteger
571
572 fargument-alias
573 Common Ignore
574 Does nothing. Preserved for backward compatibility.
575
576 fargument-noalias
577 Common Ignore
578 Does nothing. Preserved for backward compatibility.
579
580 fargument-noalias-global
581 Common Ignore
582 Does nothing. Preserved for backward compatibility.
583
584 fargument-noalias-anything
585 Common Ignore
586 Does nothing. Preserved for backward compatibility.
587
588 fasynchronous-unwind-tables
589 Common Report Var(flag_asynchronous_unwind_tables) Optimization
590 Generate unwind tables that are exact at each instruction boundary
591
592 fauto-inc-dec
593 Common Report Var(flag_auto_inc_dec) Init(1)
594 Generate auto-inc/dec instructions
595
596 ; -fcheck-bounds causes gcc to generate array bounds checks.
597 ; For C, C++ and ObjC: defaults off.
598 ; For Java: defaults to on.
599 ; For Fortran: defaults to off.
600 fbounds-check
601 Common Report Var(flag_bounds_check)
602 Generate code to check bounds before indexing arrays
603
604 fbranch-count-reg
605 Common Report Var(flag_branch_on_count_reg) Init(1) Optimization
606 Replace add, compare, branch with branch on count register
607
608 fbranch-probabilities
609 Common Report Var(flag_branch_probabilities) Optimization
610 Use profiling information for branch probabilities
611
612 fbranch-target-load-optimize
613 Common Report Var(flag_branch_target_load_optimize) Optimization
614 Perform branch target load optimization before prologue / epilogue threading
615
616 fbranch-target-load-optimize2
617 Common Report Var(flag_branch_target_load_optimize2) Optimization
618 Perform branch target load optimization after prologue / epilogue threading
619
620 fbtr-bb-exclusive
621 Common Report Var(flag_btr_bb_exclusive) Optimization
622 Restrict target load migration not to re-use registers in any basic block
623
624 fcall-saved-
625 Common Joined RejectNegative
626 -fcall-saved-<register> Mark <register> as being preserved across functions
627
628 fcall-used-
629 Common Joined RejectNegative
630 -fcall-used-<register>  Mark <register> as being corrupted by function calls
631
632 ; Nonzero for -fcaller-saves: allocate values in regs that need to
633 ; be saved across function calls, if that produces overall better code.
634 ; Optional now, so people can test it.
635 fcaller-saves
636 Common Report Var(flag_caller_saves) Optimization
637 Save registers around function calls
638
639 fcheck-data-deps
640 Common Report Var(flag_check_data_deps)
641 Compare the results of several data dependence analyzers.
642
643 fcombine-stack-adjustments
644 Common Report Var(flag_combine_stack_adjustments) Optimization
645 Looks for opportunities to reduce stack adjustments and stack references.
646
647 fcommon
648 Common Report Var(flag_no_common,0) Optimization
649 Do not put uninitialized globals in the common section
650
651 fcompare-debug
652 Driver
653 ; Converted by the driver to -fcompare-debug= options.
654
655 fcompare-debug=
656 Common Driver JoinedOrMissing RejectNegative Var(flag_compare_debug_opt)
657 -fcompare-debug[=<opts>]        Compile with and without e.g. -gtoggle, and compare the final-insns dump
658
659 fcompare-debug-second
660 Common Driver RejectNegative
661 Run only the second compilation of -fcompare-debug
662
663 fconserve-stack
664 Common Var(flag_conserve_stack) Optimization
665 Do not perform optimizations increasing noticeably stack usage
666
667 fcprop-registers
668 Common Report Var(flag_cprop_registers) Optimization
669 Perform a register copy-propagation optimization pass
670
671 fcrossjumping
672 Common Report Var(flag_crossjumping) Optimization
673 Perform cross-jumping optimization
674
675 fcse-follow-jumps
676 Common Report Var(flag_cse_follow_jumps) Optimization
677 When running CSE, follow jumps to their targets
678
679 fcse-skip-blocks
680 Common Ignore
681 Does nothing.  Preserved for backward compatibility.
682
683 fcx-limited-range
684 Common Report Var(flag_cx_limited_range) Optimization
685 Omit range reduction step when performing complex division
686
687 fcx-fortran-rules
688 Common Report Var(flag_cx_fortran_rules) Optimization
689 Complex multiplication and division follow Fortran rules
690
691 fdata-sections
692 Common Report Var(flag_data_sections) Optimization
693 Place data items into their own section
694
695 fdbg-cnt-list
696 Common Report
697 List all available debugging counters with their limits and counts.
698
699 fdbg-cnt=
700 Common RejectNegative Joined
701 -fdbg-cnt=<counter>:<limit>[,<counter>:<limit>,...]     Set the debug counter limit.   
702
703 fdebug-prefix-map=
704 Common Joined RejectNegative
705 Map one directory name to another in debug information
706
707 ; Nonzero for -fdefer-pop: don't pop args after each function call
708 ; instead save them up to pop many calls' args with one insns.
709 fdefer-pop
710 Common Report Var(flag_defer_pop) Optimization
711 Defer popping functions args from stack until later
712
713 fdelayed-branch
714 Common Report Var(flag_delayed_branch) Optimization
715 Attempt to fill delay slots of branch instructions
716
717 fdelete-null-pointer-checks
718 Common Report Var(flag_delete_null_pointer_checks) Init(1) Optimization
719 Delete useless null pointer checks
720
721 fdiagnostics-show-location=
722 Common Joined RejectNegative
723 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
724
725 fdiagnostics-show-option
726 Common Var(flag_diagnostics_show_option) Init(1)
727 Amend appropriate diagnostic messages with the command line option that controls them
728
729 fdump-
730 Common Joined RejectNegative
731 -fdump-<type>   Dump various compiler internals to a file
732
733 fdump-final-insns
734 Driver RejectNegative
735
736 fdump-final-insns=
737 Common RejectNegative Joined Var(flag_dump_final_insns)
738 -fdump-final-insns=filename     Dump to filename the insns at the end of translation
739
740 fdump-noaddr
741 Common Report Var(flag_dump_noaddr)
742 Suppress output of addresses in debugging dumps
743
744 fdump-unnumbered
745 Common Report Var(flag_dump_unnumbered)
746 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
747
748 fdump-unnumbered-links
749 Common Report Var(flag_dump_unnumbered_links)
750 Suppress output of previous and next insn numbers in debugging dumps
751
752 fdwarf2-cfi-asm
753 Common Report Var(flag_dwarf2_cfi_asm) Init(HAVE_GAS_CFI_DIRECTIVE)
754 Enable CFI tables via GAS assembler directives.
755
756 fearly-inlining
757 Common Report Var(flag_early_inlining) Init(1) Optimization
758 Perform early inlining
759
760 feliminate-dwarf2-dups
761 Common Report Var(flag_eliminate_dwarf2_dups)
762 Perform DWARF2 duplicate elimination
763
764 fipa-sra
765 Common Report Var(flag_ipa_sra) Init(0) Optimization
766 Perform interprocedural reduction of aggregates
767
768 feliminate-unused-debug-symbols
769 Common Report Var(flag_debug_only_used_symbols)
770 Perform unused type elimination in debug info
771
772 feliminate-unused-debug-types
773 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
774 Perform unused type elimination in debug info
775
776 femit-class-debug-always
777 Common Report Var(flag_emit_class_debug_always) Init(0)
778 Do not suppress C++ class debug information.
779
780 fenable-icf-debug
781 Common Report Var(flag_enable_icf_debug)
782 Generate debug information to support Identical Code Folding (ICF)
783
784 fexceptions
785 Common Report Var(flag_exceptions) Optimization
786 Enable exception handling
787
788 fexpensive-optimizations
789 Common Report Var(flag_expensive_optimizations) Optimization
790 Perform a number of minor, expensive optimizations
791
792 fexcess-precision=
793 Common Joined RejectNegative
794 -fexcess-precision=[fast|standard]      Specify handling of excess floating-point precision
795
796 ffast-math
797 Common
798
799 ffinite-math-only
800 Common Report Var(flag_finite_math_only) Optimization
801 Assume no NaNs or infinities are generated
802
803 ffixed-
804 Common Joined RejectNegative
805 -ffixed-<register>      Mark <register> as being unavailable to the compiler
806
807 ffloat-store
808 Common Report Var(flag_float_store) Optimization
809 Don't allocate floats and doubles in extended-precision registers
810
811 fforce-addr
812 Common Ignore
813 Does nothing.  Preserved for backward compatibility.
814
815 fforward-propagate
816 Common Report Var(flag_forward_propagate) Optimization
817 Perform a forward propagation pass on RTL
818
819 ; Nonzero means don't put addresses of constant functions in registers.
820 ; Used for compiling the Unix kernel, where strange substitutions are
821 ; done on the assembly output.
822 ffunction-cse
823 Common Report Var(flag_no_function_cse,0)
824 Allow function addresses to be held in registers
825
826 ffunction-sections
827 Common Report Var(flag_function_sections)
828 Place each function into its own section
829
830 fgcse
831 Common Report Var(flag_gcse) Optimization
832 Perform global common subexpression elimination
833
834 fgcse-lm
835 Common Report Var(flag_gcse_lm) Init(1) Optimization
836 Perform enhanced load motion during global common subexpression elimination
837
838 fgcse-sm
839 Common Report Var(flag_gcse_sm) Init(0) Optimization
840 Perform store motion after global common subexpression elimination
841
842 fgcse-las
843 Common Report Var(flag_gcse_las) Init(0) Optimization
844 Perform redundant load after store elimination in global common subexpression
845 elimination
846
847 fgcse-after-reload
848 Common Report Var(flag_gcse_after_reload) Optimization
849 Perform global common subexpression elimination after register allocation
850 has finished
851
852 ; This option is not documented yet as its semantics will change.
853 fgraphite
854 Common Report Var(flag_graphite)
855 Enable in and out of Graphite representation
856
857 fgraphite-identity
858 Common Report Var(flag_graphite_identity) Optimization
859 Enable Graphite Identity transformation
860
861 floop-parallelize-all
862 Common Report Var(flag_loop_parallelize_all) Optimization
863 Mark all loops as parallel
864
865 floop-strip-mine
866 Common Report Var(flag_loop_strip_mine) Optimization
867 Enable Loop Strip Mining transformation
868
869 floop-interchange
870 Common Report Var(flag_loop_interchange) Optimization
871 Enable Loop Interchange transformation
872
873 floop-block
874 Common Report Var(flag_loop_block) Optimization
875 Enable Loop Blocking transformation
876
877 floop-flatten
878 Common Report Var(flag_loop_flatten) Optimization
879 Enable Loop Flattening transformation
880
881 fstrict-volatile-bitfields
882 Common Report Var(flag_strict_volatile_bitfields) Init(-1)
883 Force bitfield accesses to match their type width
884
885 fguess-branch-probability
886 Common Report Var(flag_guess_branch_prob) Optimization
887 Enable guessing of branch probabilities
888
889 ; Nonzero means ignore `#ident' directives.  0 means handle them.
890 ; Generate position-independent code for executables if possible
891 ; On SVR4 targets, it also controls whether or not to emit a
892 ; string identifying the compiler.
893 fident
894 Common Report Var(flag_no_ident,0)
895 Process #ident directives
896
897 fif-conversion
898 Common Report Var(flag_if_conversion) Optimization
899 Perform conversion of conditional jumps to branchless equivalents
900
901 fif-conversion2
902 Common Report Var(flag_if_conversion2) Optimization
903 Perform conversion of conditional jumps to conditional execution
904
905 ftree-loop-if-convert
906 Common Report Var(flag_tree_loop_if_convert) Init(-1) Optimization
907 Convert conditional jumps in innermost loops to branchless equivalents
908
909 ftree-loop-if-convert-stores
910 Common Report Var(flag_tree_loop_if_convert_stores) Optimization
911 Also if-convert conditional jumps containing memory writes
912
913 ; -finhibit-size-directive inhibits output of .size for ELF.
914 ; This is used only for compiling crtstuff.c,
915 ; and it may be extended to other effects
916 ; needed for crtstuff.c on other systems.
917 finhibit-size-directive
918 Common Report Var(flag_inhibit_size_directive)
919 Do not generate .size directives
920
921 findirect-inlining
922 Common Report Var(flag_indirect_inlining)
923 Perform indirect inlining
924
925 ; Nonzero means that functions declared `inline' will be treated
926 ; as `static'.  Prevents generation of zillions of copies of unused
927 ; static inline functions; instead, `inlines' are written out
928 ; only when actually used.  Used in conjunction with -g.  Also
929 ; does the right thing with #pragma interface.
930 finline
931 Common Report Var(flag_no_inline,0) Init(0)
932 Pay attention to the \"inline\" keyword
933
934 finline-small-functions
935 Common Report Var(flag_inline_small_functions) Optimization
936 Integrate simple functions into their callers when code size is known to not growth
937
938 finline-functions
939 Common Report Var(flag_inline_functions) Optimization
940 Integrate simple functions into their callers
941
942 finline-functions-called-once
943 Common Report Var(flag_inline_functions_called_once) Init(1) Optimization
944 Integrate functions called once into their callers
945
946 finline-limit-
947 Common RejectNegative Joined Alias(finline-limit=)
948
949 finline-limit=
950 Common RejectNegative Joined UInteger
951 -finline-limit=<number> Limit the size of inlined functions to <number>
952
953 finstrument-functions
954 Common Report Var(flag_instrument_function_entry_exit)
955 Instrument function entry and exit with profiling calls
956
957 finstrument-functions-exclude-function-list=
958 Common RejectNegative Joined
959 -finstrument-functions-exclude-function-list=name,...  Do not instrument listed functions
960
961 finstrument-functions-exclude-file-list=
962 Common RejectNegative Joined
963 -finstrument-functions-exclude-file-list=filename,...  Do not instrument functions listed in files
964
965 fipa-cp
966 Common Report Var(flag_ipa_cp) Optimization
967 Perform Interprocedural constant propagation
968
969 fipa-cp-clone
970 Common Report Var(flag_ipa_cp_clone) Optimization
971 Perform cloning to make Interprocedural constant propagation stronger
972
973 fipa-profile
974 Common Report Var(flag_ipa_profile) Init(0) Optimization
975 Perform interprocedural profile propagation
976
977 fipa-pta
978 Common Report Var(flag_ipa_pta) Init(0) Optimization
979 Perform interprocedural points-to analysis
980
981 fipa-pure-const
982 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
983 Discover pure and const functions
984
985 fipa-reference
986 Common Report Var(flag_ipa_reference) Init(0) Optimization
987 Discover readonly and non addressable static variables
988
989 fipa-matrix-reorg
990 Common Report Var(flag_ipa_matrix_reorg) Optimization
991 Perform matrix layout flattening and transposing based
992 on profiling information.
993
994 fipa-struct-reorg
995 Common Report Var(flag_ipa_struct_reorg)
996 Perform structure layout optimizations based
997 on profiling information.
998
999 fira-algorithm=
1000 Common Joined RejectNegative
1001 -fira-algorithm=[CB|priority] Set the used IRA algorithm
1002
1003 fira-region=
1004 Common Joined RejectNegative
1005 -fira-region=[one|all|mixed] Set regions for IRA
1006
1007 fira-loop-pressure
1008 Common Report Var(flag_ira_loop_pressure)
1009 Use IRA based register pressure calculation
1010 in RTL loop optimizations.
1011
1012 fira-share-save-slots
1013 Common Report Var(flag_ira_share_save_slots) Init(1)
1014 Share slots for saving different hard registers.
1015
1016 fira-share-spill-slots
1017 Common Report Var(flag_ira_share_spill_slots) Init(1)
1018 Share stack slots for spilled pseudo-registers.
1019
1020 fira-verbose=
1021 Common RejectNegative Joined UInteger Var(flag_ira_verbose) Init(5)
1022 -fira-verbose=<number>  Control IRA's level of diagnostic messages.
1023
1024 fivopts
1025 Common Report Var(flag_ivopts) Init(1) Optimization
1026 Optimize induction variables on trees
1027
1028 fjump-tables
1029 Common Var(flag_jump_tables) Init(1) Optimization
1030 Use jump tables for sufficiently large switch statements
1031
1032 fkeep-inline-functions
1033 Common Report Var(flag_keep_inline_functions)
1034 Generate code for functions even if they are fully inlined
1035
1036 fkeep-static-consts
1037 Common Report Var(flag_keep_static_consts) Init(1)
1038 Emit static const variables even if they are not used
1039
1040 fleading-underscore
1041 Common Report Var(flag_leading_underscore) Init(-1)
1042 Give external symbols a leading underscore
1043
1044 floop-optimize
1045 Common Ignore
1046 Does nothing.  Preserved for backward compatibility.
1047
1048 flto
1049 Common Var(flag_lto)
1050 Enable link-time optimization.
1051
1052 ; The initial value of -1 comes from Z_DEFAULT_COMPRESSION in zlib.h.
1053 flto-compression-level=
1054 Common Joined RejectNegative UInteger Var(flag_lto_compression_level) Init(-1)
1055 -flto-compression-level=<number>        Use zlib compression level <number> for IL
1056
1057 flto-report
1058 Common Report Var(flag_lto_report) Init(0) Optimization
1059 Report various link-time optimization statistics
1060
1061 fmath-errno
1062 Common Report Var(flag_errno_math) Init(1) Optimization
1063 Set errno after built-in math functions
1064
1065 fmem-report
1066 Common Report Var(mem_report)
1067 Report on permanent memory allocation
1068
1069 ; This will attempt to merge constant section constants, if 1 only
1070 ; string constants and constants from constant pool, if 2 also constant
1071 ; variables.
1072 fmerge-all-constants
1073 Common Report Var(flag_merge_constants,2) Init(1) Optimization
1074 Attempt to merge identical constants and constant variables
1075
1076 fmerge-constants
1077 Common Report Var(flag_merge_constants,1) Optimization
1078 Attempt to merge identical constants across compilation units
1079
1080 fmerge-debug-strings
1081 Common Report Var(flag_merge_debug_strings) Init(1)
1082 Attempt to merge identical debug strings across compilation units
1083
1084 fmessage-length=
1085 Common RejectNegative Joined UInteger
1086 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
1087
1088 fmodulo-sched
1089 Common Report Var(flag_modulo_sched) Optimization
1090 Perform SMS based modulo scheduling before the first scheduling pass
1091
1092 fmodulo-sched-allow-regmoves
1093 Common Report Var(flag_modulo_sched_allow_regmoves)
1094 Perform SMS based modulo scheduling with register moves allowed
1095
1096 fmove-loop-invariants
1097 Common Report Var(flag_move_loop_invariants) Init(1) Optimization
1098 Move loop invariant computations out of loops
1099
1100 fmudflap
1101 Common RejectNegative Report Var(flag_mudflap)
1102 Add mudflap bounds-checking instrumentation for single-threaded program
1103
1104 fmudflapth
1105 Common RejectNegative Report Var(flag_mudflap,2)
1106 Add mudflap bounds-checking instrumentation for multi-threaded program
1107
1108 fmudflapir
1109 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
1110 Ignore read operations when inserting mudflap instrumentation
1111
1112 fdce
1113 Common Var(flag_dce) Init(1) Optimization
1114 Use the RTL dead code elimination pass
1115
1116 fdse
1117 Common Var(flag_dse) Init(1) Optimization
1118 Use the RTL dead store elimination pass
1119
1120 freschedule-modulo-scheduled-loops
1121 Common Report Var(flag_resched_modulo_sched) Optimization
1122 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
1123
1124 fnon-call-exceptions
1125 Common Report Var(flag_non_call_exceptions) Optimization
1126 Support synchronous non-call exceptions
1127
1128 fomit-frame-pointer
1129 Common Report Var(flag_omit_frame_pointer) Optimization
1130 When possible do not generate stack frames
1131
1132 foptimize-register-move
1133 Common Report Var(flag_regmove) Optimization
1134 Do the full register move optimization pass
1135
1136 foptimize-sibling-calls
1137 Common Report Var(flag_optimize_sibling_calls) Optimization
1138 Optimize sibling and tail recursive calls
1139
1140 fpartial-inlining
1141 Common Report Var(flag_partial_inlining)
1142 Perform partial inlining
1143
1144 fpre-ipa-mem-report
1145 Common Report Var(pre_ipa_mem_report)
1146 Report on memory allocation before interprocedural optimization
1147
1148 fpost-ipa-mem-report
1149 Common Report Var(post_ipa_mem_report)
1150 Report on memory allocation before interprocedural optimization
1151
1152 fpack-struct
1153 Common Report Var(flag_pack_struct) Optimization
1154 Pack structure members together without holes
1155
1156 fpack-struct=
1157 Common RejectNegative Joined UInteger Optimization
1158 -fpack-struct=<number>  Set initial maximum structure member alignment
1159
1160 fpcc-struct-return
1161 Common Report Var(flag_pcc_struct_return,1) Init(DEFAULT_PCC_STRUCT_RETURN)
1162 Return small aggregates in memory, not registers
1163
1164 fpeel-loops
1165 Common Report Var(flag_peel_loops) Optimization
1166 Perform loop peeling
1167
1168 fpeephole
1169 Common Report Var(flag_no_peephole,0) Optimization
1170 Enable machine specific peephole optimizations
1171
1172 fpeephole2
1173 Common Report Var(flag_peephole2) Optimization
1174 Enable an RTL peephole pass before sched2
1175
1176 fPIC
1177 Common Report Var(flag_pic,2)
1178 Generate position-independent code if possible (large mode)
1179
1180 fPIE
1181 Common Report Var(flag_pie,2)
1182 Generate position-independent code for executables if possible (large mode)
1183
1184 fpic
1185 Common Report Var(flag_pic,1)
1186 Generate position-independent code if possible (small mode)
1187
1188 fpie
1189 Common Report Var(flag_pie,1)
1190 Generate position-independent code for executables if possible (small mode)
1191
1192 fplugin=
1193 Common Joined RejectNegative
1194 Specify a plugin to load
1195
1196 fplugin-arg-
1197 Common Joined RejectNegative
1198 -fplugin-arg-<name>-<key>[=<value>]     Specify argument <key>=<value> for plugin <name>
1199
1200 fpredictive-commoning
1201 Common Report Var(flag_predictive_commoning) Optimization
1202 Run predictive commoning optimization.
1203
1204 fprefetch-loop-arrays
1205 Common Report Var(flag_prefetch_loop_arrays) Init(-1) Optimization
1206 Generate prefetch instructions, if available, for arrays in loops
1207
1208 fprofile
1209 Common Report Var(profile_flag)
1210 Enable basic program profiling code
1211
1212 fprofile-arcs
1213 Common Report Var(profile_arc_flag)
1214 Insert arc-based program profiling code
1215
1216 fprofile-dir=
1217 Common Joined RejectNegative
1218 Set the top-level directory for storing the profile data.
1219 The default is 'pwd'.
1220
1221 fprofile-correction
1222 Common Report Var(flag_profile_correction)
1223 Enable correction of flow inconsistent profile data input
1224
1225 fprofile-generate
1226 Common
1227 Enable common options for generating profile info for profile feedback directed optimizations
1228
1229 fprofile-generate=
1230 Common Joined RejectNegative
1231 Enable common options for generating profile info for profile feedback directed optimizations, and set -fprofile-dir=
1232
1233 fprofile-use
1234 Common Var(flag_profile_use)
1235 Enable common options for performing profile feedback directed optimizations
1236
1237 fprofile-use=
1238 Common Joined RejectNegative
1239 Enable common options for performing profile feedback directed optimizations, and set -fprofile-dir=
1240
1241 fprofile-values
1242 Common Report Var(flag_profile_values)
1243 Insert code to profile values of expressions
1244
1245 frandom-seed
1246 Common
1247
1248 frandom-seed=
1249 Common Joined RejectNegative
1250 -frandom-seed=<string>  Make compile reproducible using <string>
1251
1252 ; This switch causes the command line that was used to create an
1253 ; object file to be recorded into the object file.  The exact format
1254 ; of this recording is target and binary file format dependent.
1255 ; It is related to the -fverbose-asm switch, but that switch only
1256 ; records information in the assembler output file as comments, so
1257 ; they never reach the object file.
1258 frecord-gcc-switches
1259 Common Report Var(flag_record_gcc_switches)
1260 Record gcc command line switches in the object file.
1261
1262 freg-struct-return
1263 Common Report Var(flag_pcc_struct_return,0) Optimization
1264 Return small aggregates in registers
1265
1266 fregmove
1267 Common Report Var(flag_regmove) Optimization
1268 Enables a register move optimization
1269
1270 frename-registers
1271 Common Report Var(flag_rename_registers) Init(2) Optimization
1272 Perform a register renaming optimization pass
1273
1274 freorder-blocks
1275 Common Report Var(flag_reorder_blocks) Optimization
1276 Reorder basic blocks to improve code placement
1277
1278 freorder-blocks-and-partition
1279 Common Report Var(flag_reorder_blocks_and_partition) Optimization
1280 Reorder basic blocks and partition into hot and cold sections
1281
1282 freorder-functions
1283 Common Report Var(flag_reorder_functions) Optimization
1284 Reorder functions to improve code placement
1285
1286 frerun-cse-after-loop
1287 Common Report Var(flag_rerun_cse_after_loop) Init(2) Optimization
1288 Add a common subexpression elimination pass after loop optimizations
1289
1290 frerun-loop-opt
1291 Common Ignore
1292 Does nothing.  Preserved for backward compatibility.
1293
1294 frounding-math
1295 Common Report Var(flag_rounding_math) Optimization
1296 Disable optimizations that assume default FP rounding behavior
1297
1298 fsched-interblock
1299 Common Report Var(flag_schedule_interblock) Init(1) Optimization
1300 Enable scheduling across basic blocks
1301
1302 fsched-pressure
1303 Common Report Var(flag_sched_pressure) Init(0) Optimization
1304 Enable register pressure sensitive insn scheduling
1305
1306 fsched-spec
1307 Common Report Var(flag_schedule_speculative) Init(1) Optimization
1308 Allow speculative motion of non-loads
1309
1310 fsched-spec-load
1311 Common Report Var(flag_schedule_speculative_load) Optimization
1312 Allow speculative motion of some loads
1313
1314 fsched-spec-load-dangerous
1315 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
1316 Allow speculative motion of more loads
1317
1318 fsched-verbose=
1319 Common RejectNegative Joined
1320 -fsched-verbose=<number>        Set the verbosity level of the scheduler
1321
1322 fsched2-use-superblocks
1323 Common Report Var(flag_sched2_use_superblocks) Optimization
1324 If scheduling post reload, do superblock scheduling
1325
1326 fsched2-use-traces
1327 Common Ignore
1328 Does nothing.  Preserved for backward compatibility.
1329
1330 fschedule-insns
1331 Common Report Var(flag_schedule_insns) Optimization
1332 Reschedule instructions before register allocation
1333
1334 fschedule-insns2
1335 Common Report Var(flag_schedule_insns_after_reload) Optimization
1336 Reschedule instructions after register allocation
1337
1338 ; This flag should be on when a target implements non-trivial
1339 ; scheduling hooks, maybe saving some information for its own sake.
1340 ; On IA64, for example, this is used for correct bundling. 
1341 fselective-scheduling
1342 Common Report Var(flag_selective_scheduling) Optimization
1343 Schedule instructions using selective scheduling algorithm
1344
1345 fselective-scheduling2
1346 Common Report Var(flag_selective_scheduling2) Optimization 
1347 Run selective scheduling after reload
1348
1349 fsel-sched-pipelining
1350 Common Report Var(flag_sel_sched_pipelining) Init(0) Optimization
1351 Perform software pipelining of inner loops during selective scheduling
1352
1353 fsel-sched-pipelining-outer-loops
1354 Common Report Var(flag_sel_sched_pipelining_outer_loops) Init(0) Optimization
1355 Perform software pipelining of outer loops during selective scheduling
1356
1357 fsel-sched-reschedule-pipelined
1358 Common Report Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization
1359 Reschedule pipelined regions without pipelining
1360
1361 ; sched_stalled_insns means that insns can be moved prematurely from the queue
1362 ; of stalled insns into the ready list.
1363 fsched-stalled-insns
1364 Common Report Var(flag_sched_stalled_insns) Optimization UInteger
1365 Allow premature scheduling of queued insns
1366
1367 fsched-stalled-insns=
1368 Common RejectNegative Joined UInteger
1369 -fsched-stalled-insns=<number>  Set number of queued insns that can be prematurely scheduled
1370
1371 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
1372 ; be examined for a dependency on a stalled insn that is candidate for
1373 ; premature removal from the queue of stalled insns into the ready list (has
1374 ; an effect only if the flag 'sched_stalled_insns' is set).
1375 fsched-stalled-insns-dep
1376 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization UInteger
1377 Set dependence distance checking in premature scheduling of queued insns
1378
1379 fsched-stalled-insns-dep=
1380 Common RejectNegative Joined UInteger
1381 -fsched-stalled-insns-dep=<number>      Set dependence distance checking in premature scheduling of queued insns
1382
1383 fsched-group-heuristic
1384 Common Report Var(flag_sched_group_heuristic) Init(1) Optimization
1385 Enable the group heuristic in the scheduler
1386
1387 fsched-critical-path-heuristic
1388 Common Report Var(flag_sched_critical_path_heuristic) Init(1) Optimization
1389 Enable the critical path heuristic in the scheduler
1390
1391 fsched-spec-insn-heuristic
1392 Common Report Var(flag_sched_spec_insn_heuristic) Init(1) Optimization
1393 Enable the speculative instruction heuristic in the scheduler
1394
1395 fsched-rank-heuristic
1396 Common Report Var(flag_sched_rank_heuristic) Init(1) Optimization
1397 Enable the rank heuristic in the scheduler
1398
1399 fsched-last-insn-heuristic
1400 Common Report Var(flag_sched_last_insn_heuristic) Init(1) Optimization
1401 Enable the last instruction heuristic in the scheduler
1402
1403 fsched-dep-count-heuristic
1404 Common Report Var(flag_sched_dep_count_heuristic) Init(1) Optimization
1405 Enable the dependent count heuristic in the scheduler
1406
1407 fsection-anchors
1408 Common Report Var(flag_section_anchors) Optimization
1409 Access data in the same section from shared anchor points
1410
1411 fsee
1412 Common Ignore
1413 Does nothing.  Preserved for backward compatibility.
1414
1415 fzee
1416 Common Report Var(flag_zee) Init(0)
1417 Eliminate redundant zero extensions on targets that support implicit extensions.
1418
1419 fshow-column
1420 Common Report Var(flag_show_column) Init(1)
1421 Show column numbers in diagnostics, when available.  Default on
1422
1423 fsignaling-nans
1424 Common Report Var(flag_signaling_nans) Optimization
1425 Disable optimizations observable by IEEE signaling NaNs
1426
1427 fsigned-zeros
1428 Common Report Var(flag_signed_zeros) Init(1) Optimization
1429 Disable floating point optimizations that ignore the IEEE signedness of zero
1430
1431 fsingle-precision-constant
1432 Common Report Var(flag_single_precision_constant) Optimization
1433 Convert floating point constants to single precision constants
1434
1435 fsplit-ivs-in-unroller
1436 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
1437 Split lifetimes of induction variables when loops are unrolled
1438
1439 fsplit-stack
1440 Common Report Var(flag_split_stack) Init(-1)
1441 Generate discontiguous stack frames
1442
1443 fsplit-wide-types
1444 Common Report Var(flag_split_wide_types) Optimization
1445 Split wide types into independent registers
1446
1447 fvariable-expansion-in-unroller
1448 Common Report Var(flag_variable_expansion_in_unroller) Optimization
1449 Apply variable expansion when loops are unrolled
1450
1451 fstack-check=
1452 Common Report RejectNegative Joined
1453 -fstack-check=[no|generic|specific]     Insert stack checking code into the program
1454
1455 fstack-check
1456 Common Alias(fstack-check=, specific, no)
1457 Insert stack checking code into the program.  Same as -fstack-check=specific
1458
1459 fstack-limit
1460 Common
1461
1462 fstack-limit-register=
1463 Common RejectNegative Joined
1464 -fstack-limit-register=<register>       Trap if the stack goes past <register>
1465
1466 fstack-limit-symbol=
1467 Common RejectNegative Joined
1468 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
1469
1470 fstack-protector
1471 Common Report Var(flag_stack_protect, 1)
1472 Use propolice as a stack protection method
1473
1474 fstack-protector-all
1475 Common Report RejectNegative Var(flag_stack_protect, 2)
1476 Use a stack protection method for every function
1477
1478 fstack-usage
1479 Common RejectNegative Var(flag_stack_usage)
1480 Output stack usage information on a per-function basis
1481
1482 fstrength-reduce
1483 Common Ignore
1484 Does nothing.  Preserved for backward compatibility.
1485
1486 ; Nonzero if we should do (language-dependent) alias analysis.
1487 ; Typically, this analysis will assume that expressions of certain
1488 ; types do not alias expressions of certain other types.  Only used
1489 ; if alias analysis (in general) is enabled.
1490 fstrict-aliasing
1491 Common Report Var(flag_strict_aliasing) Optimization
1492 Assume strict aliasing rules apply
1493
1494 fstrict-overflow
1495 Common Report Var(flag_strict_overflow)
1496 Treat signed overflow as undefined
1497
1498 fsyntax-only
1499 Common Report Var(flag_syntax_only)
1500 Check for syntax errors, then stop
1501
1502 ftest-coverage
1503 Common Report Var(flag_test_coverage)
1504 Create data files needed by \"gcov\"
1505
1506 fthread-jumps
1507 Common Report Var(flag_thread_jumps) Optimization
1508 Perform jump threading optimizations
1509
1510 ftime-report
1511 Common Report Var(time_report)
1512 Report the time taken by each compiler pass
1513
1514 ftls-model=
1515 Common Joined RejectNegative
1516 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
1517
1518 ftoplevel-reorder
1519 Common Report Var(flag_toplevel_reorder) Init(2) Optimization
1520 Reorder top level functions, variables, and asms
1521
1522 ftracer
1523 Common Report Var(flag_tracer)
1524 Perform superblock formation via tail duplication
1525
1526 ; Zero means that floating-point math operations cannot generate a
1527 ; (user-visible) trap.  This is the case, for example, in nonstop
1528 ; IEEE 754 arithmetic.
1529 ftrapping-math
1530 Common Report Var(flag_trapping_math) Init(1) Optimization
1531 Assume floating-point operations can trap
1532
1533 ftrapv
1534 Common Report Var(flag_trapv) Optimization
1535 Trap for signed overflow in addition, subtraction and multiplication
1536
1537 ftree-ccp
1538 Common Report Var(flag_tree_ccp) Optimization
1539 Enable SSA-CCP optimization on trees
1540
1541 ftree-bit-ccp
1542 Common Report Var(flag_tree_bit_ccp) Optimization
1543 Enable SSA-BIT-CCP optimization on trees
1544
1545 ftree-store-ccp
1546 Common Ignore
1547 Does nothing.  Preserved for backward compatibility.
1548
1549 ftree-ch
1550 Common Report Var(flag_tree_ch) Optimization
1551 Enable loop header copying on trees
1552
1553 ftree-copyrename
1554 Common Report Var(flag_tree_copyrename) Optimization
1555 Replace SSA temporaries with better names in copies
1556
1557 ftree-copy-prop
1558 Common Report Var(flag_tree_copy_prop) Optimization
1559 Enable copy propagation on trees
1560
1561 ftree-store-copy-prop
1562 Common Ignore
1563 Does nothing.  Preserved for backward compatibility.
1564
1565 ftree-cselim
1566 Common Report Var(flag_tree_cselim) Init(2) Optimization
1567 Transform condition stores into unconditional ones
1568
1569 ftree-switch-conversion
1570 Common Report Var(flag_tree_switch_conversion) Optimization
1571 Perform conversions of switch initializations.
1572
1573 ftree-dce
1574 Common Report Var(flag_tree_dce) Optimization
1575 Enable SSA dead code elimination optimization on trees
1576
1577 ftree-dominator-opts
1578 Common Report Var(flag_tree_dom) Optimization
1579 Enable dominator optimizations
1580
1581 ftree-dse
1582 Common Report Var(flag_tree_dse) Optimization
1583 Enable dead store elimination
1584
1585 ftree-forwprop
1586 Common Report Var(flag_tree_forwprop) Init(1) Optimization
1587 Enable forward propagation on trees
1588
1589 ftree-fre
1590 Common Report Var(flag_tree_fre) Optimization
1591 Enable Full Redundancy Elimination (FRE) on trees
1592
1593 ftree-loop-distribution
1594 Common Report Var(flag_tree_loop_distribution) Optimization
1595 Enable loop distribution on trees
1596
1597 ftree-loop-distribute-patterns
1598 Common Report Var(flag_tree_loop_distribute_patterns) Optimization
1599 Enable loop distribution for patterns transformed into a library call
1600
1601 ftree-loop-im
1602 Common Report Var(flag_tree_loop_im) Init(1) Optimization
1603 Enable loop invariant motion on trees
1604
1605 ftree-loop-linear
1606 Common Report Var(flag_tree_loop_linear) Optimization
1607 Enable linear loop transforms on trees
1608
1609 ftree-loop-ivcanon
1610 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
1611 Create canonical induction variables in loops
1612
1613 ftree-loop-optimize
1614 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
1615 Enable loop optimizations on tree level
1616
1617 ftree-parallelize-loops=
1618 Common Report Joined RejectNegative UInteger Var(flag_tree_parallelize_loops) Init(1)
1619 Enable automatic parallelization of loops
1620
1621 ftree-phiprop
1622 Common Report Var(flag_tree_phiprop) Init(1) Optimization
1623 Enable hoisting loads from conditional pointers.
1624
1625 ftree-pre
1626 Common Report Var(flag_tree_pre) Optimization
1627 Enable SSA-PRE optimization on trees
1628
1629 ftree-pta
1630 Common Report Var(flag_tree_pta) Init(1) Optimization
1631 Perform function-local points-to analysis on trees.
1632
1633 ftree-reassoc
1634 Common Report Var(flag_tree_reassoc) Init(1) Optimization
1635 Enable reassociation on tree level
1636
1637 ftree-salias
1638 Common Ignore
1639 Does nothing.  Preserved for backward compatibility.
1640
1641 ftree-sink
1642 Common Report Var(flag_tree_sink) Optimization
1643 Enable SSA code sinking on trees
1644
1645 ftree-sra
1646 Common Report Var(flag_tree_sra) Optimization
1647 Perform scalar replacement of aggregates
1648
1649 ftree-ter
1650 Common Report Var(flag_tree_ter) Init(1) Optimization
1651 Replace temporary expressions in the SSA->normal pass
1652
1653 ftree-lrs
1654 Common Report Var(flag_tree_live_range_split) Optimization
1655 Perform live range splitting during the SSA->normal pass
1656
1657 ftree-vrp
1658 Common Report Var(flag_tree_vrp) Init(0) Optimization
1659 Perform Value Range Propagation on trees
1660
1661 funit-at-a-time
1662 Common Report Var(flag_unit_at_a_time) Init(1) Optimization
1663 Compile whole compilation unit at a time
1664
1665 funroll-loops
1666 Common Report Var(flag_unroll_loops) Optimization
1667 Perform loop unrolling when iteration count is known
1668
1669 funroll-all-loops
1670 Common Report Var(flag_unroll_all_loops) Optimization
1671 Perform loop unrolling for all loops
1672
1673 ; Nonzero means that loop optimizer may assume that the induction variables
1674 ; that control loops do not overflow and that the loops with nontrivial
1675 ; exit condition are not infinite
1676 funsafe-loop-optimizations
1677 Common Report Var(flag_unsafe_loop_optimizations) Optimization
1678 Allow loop optimizations to assume that the loops behave in normal way
1679
1680 fassociative-math
1681 Common Report Var(flag_associative_math)
1682 Allow optimization for floating-point arithmetic which may change the
1683 result of the operation due to rounding.
1684
1685 freciprocal-math
1686 Common Report Var(flag_reciprocal_math)
1687 Same as -fassociative-math for expressions which include division.
1688
1689 ; Nonzero means that unsafe floating-point math optimizations are allowed
1690 ; for the sake of speed.  IEEE compliance is not guaranteed, and operations
1691 ; are allowed to assume that their arguments and results are "normal"
1692 ; (e.g., nonnegative for SQRT).
1693 funsafe-math-optimizations
1694 Common Report Var(flag_unsafe_math_optimizations) Optimization
1695 Allow math optimizations that may violate IEEE or ISO standards
1696
1697 funswitch-loops
1698 Common Report Var(flag_unswitch_loops) Optimization
1699 Perform loop unswitching
1700
1701 funwind-tables
1702 Common Report Var(flag_unwind_tables) Optimization
1703 Just generate unwind tables for exception handling
1704
1705 fuse-linker-plugin
1706 Common Undocumented
1707
1708 ; Positive if we should track variables, negative if we should run
1709 ; the var-tracking pass only to discard debug annotations, zero if
1710 ; we're not to run it.  When flag_var_tracking == 2 (AUTODETECT_VALUE) it
1711 ; will be set according to optimize, debug_info_level and debug_hooks
1712 ; in process_options ().
1713 fvar-tracking
1714 Common Report Var(flag_var_tracking) Init(2) Optimization
1715 Perform variable tracking
1716
1717 ; Positive if we should track variables at assignments, negative if
1718 ; we should run the var-tracking pass only to discard debug
1719 ; annotations.  When flag_var_tracking_assignments ==
1720 ; AUTODETECT_VALUE it will be set according to flag_var_tracking.
1721 fvar-tracking-assignments
1722 Common Report Var(flag_var_tracking_assignments) Init(2) Optimization
1723 Perform variable tracking by annotating assignments
1724
1725 ; Nonzero if we should toggle flag_var_tracking_assignments after
1726 ; processing options and computing its default.  */
1727 fvar-tracking-assignments-toggle
1728 Common Report Var(flag_var_tracking_assignments_toggle) Optimization
1729 Toggle -fvar-tracking-assignments
1730
1731 fvar-tracking-uninit
1732 Common Report Var(flag_var_tracking_uninit) Optimization
1733 Perform variable tracking and also tag variables that are uninitialized
1734
1735 ftree-vectorize
1736 Common Report Var(flag_tree_vectorize) Optimization
1737 Enable loop vectorization on trees
1738
1739 ftree-slp-vectorize
1740 Common Report Var(flag_tree_slp_vectorize) Init(2) Optimization
1741 Enable basic block vectorization (SLP) on trees
1742
1743 fvect-cost-model
1744 Common Report Var(flag_vect_cost_model) Optimization
1745 Enable use of cost model in vectorization
1746
1747 ftree-vect-loop-version
1748 Common Report Var(flag_tree_vect_loop_version) Init(1) Optimization
1749 Enable loop versioning when doing loop vectorization on trees
1750
1751 ftree-vectorizer-verbose=
1752 Common RejectNegative Joined
1753 -ftree-vectorizer-verbose=<number>      Set the verbosity level of the vectorizer
1754
1755 ftree-scev-cprop
1756 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
1757 Enable copy propagation of scalar-evolution information.
1758
1759 ; -fverbose-asm causes extra commentary information to be produced in
1760 ; the generated assembly code (to make it more readable).  This option
1761 ; is generally only of use to those who actually need to read the
1762 ; generated assembly code (perhaps while debugging the compiler itself).
1763 ; -fno-verbose-asm, the default, causes the extra information
1764 ; to not be added and is useful when comparing two assembler files.
1765 fverbose-asm
1766 Common Report Var(flag_verbose_asm)
1767 Add extra commentary to assembler output
1768
1769 fvisibility=
1770 Common Joined RejectNegative
1771 -fvisibility=[default|internal|hidden|protected]        Set the default symbol visibility
1772
1773
1774 fvpt
1775 Common Report Var(flag_value_profile_transformations) Optimization
1776 Use expression value profiles in optimizations
1777
1778 fweb
1779 Common Report Var(flag_web) Init(2) Optimization
1780 Construct webs and split unrelated uses of single variable
1781
1782 fwhopr
1783 Common
1784 Enable partitioned link-time optimization
1785
1786 fwhopr=
1787 Common RejectNegative Joined Var(flag_whopr)
1788 Partitioned link-time optimization with number of parallel jobs or jobserver.
1789
1790 ftree-builtin-call-dce
1791 Common Report Var(flag_tree_builtin_call_dce) Init(0) Optimization
1792 Enable conditional dead code elimination for builtin calls
1793
1794 fwhole-program
1795 Common Report Var(flag_whole_program) Init(0) Optimization
1796 Perform whole program optimizations
1797
1798 fwrapv
1799 Common Report Var(flag_wrapv) Optimization
1800 Assume signed arithmetic overflow wraps around
1801
1802 fzero-initialized-in-bss
1803 Common Report Var(flag_zero_initialized_in_bss) Init(1)
1804 Put zero initialized data in the bss section
1805
1806 g
1807 Common JoinedOrMissing
1808 Generate debug information in default format
1809
1810 gcoff
1811 Common JoinedOrMissing Negative(gdwarf-)
1812 Generate debug information in COFF format
1813
1814 gdwarf-
1815 Common Joined UInteger Var(dwarf_version) Init(2) Negative(gstabs)
1816 Generate debug information in DWARF v2 (or later) format
1817
1818 ggdb
1819 Common JoinedOrMissing
1820 Generate debug information in default extended format
1821
1822 gstabs
1823 Common JoinedOrMissing Negative(gstabs+)
1824 Generate debug information in STABS format
1825
1826 gstabs+
1827 Common JoinedOrMissing Negative(gvms)
1828 Generate debug information in extended STABS format
1829
1830 gno-strict-dwarf
1831 Common RejectNegative Var(dwarf_strict,0) Init(-1)
1832 Emit DWARF additions beyond selected version
1833
1834 gstrict-dwarf
1835 Common Report RejectNegative Var(dwarf_strict,1)
1836 Don't emit DWARF additions beyond selected version
1837
1838 gtoggle
1839 Common Report Var(flag_gtoggle)
1840 Toggle debug information generation
1841
1842 gvms
1843 Common JoinedOrMissing Negative(gxcoff)
1844 Generate debug information in VMS format
1845
1846 gxcoff
1847 Common JoinedOrMissing Negative(gxcoff+)
1848 Generate debug information in XCOFF format
1849
1850 gxcoff+
1851 Common JoinedOrMissing Negative(gcoff)
1852 Generate debug information in extended XCOFF format
1853
1854 iplugindir=
1855 Common Joined Var(plugindir_string) Init(0)
1856 -iplugindir=<dir>       Set <dir> to be the default plugin directory
1857
1858 l
1859 Driver Joined Separate
1860
1861 no-canonical-prefixes
1862 Driver
1863
1864 nodefaultlibs
1865 Driver
1866
1867 nostdlib
1868 Driver
1869
1870 o
1871 Common Driver Joined Separate MissingArgError(missing filename after %qs)
1872 -o <file>       Place output into <file>
1873
1874 p
1875 Common Var(profile_flag)
1876 Enable function profiling
1877
1878 pass-exit-codes
1879 Driver Var(pass_exit_codes)
1880
1881 pedantic
1882 Common Var(pedantic)
1883 Issue warnings needed for strict compliance to the standard
1884
1885 pedantic-errors
1886 Common
1887 Like -pedantic but issue them as errors
1888
1889 pg
1890 Driver
1891
1892 pipe
1893 Driver Var(use_pipes)
1894
1895 print-file-name=
1896 Driver JoinedOrMissing Var(print_file_name)
1897
1898 print-libgcc-file-name
1899 Driver
1900
1901 print-multi-directory
1902 Driver Var(print_multi_directory)
1903
1904 print-multi-lib
1905 Driver Var(print_multi_lib)
1906
1907 print-multi-os-directory
1908 Driver Var(print_multi_os_directory)
1909
1910 print-prog-name=
1911 Driver JoinedOrMissing Var(print_prog_name)
1912
1913 print-search-dirs
1914 Driver Var(print_search_dirs)
1915
1916 print-sysroot
1917 Driver Var(print_sysroot)
1918
1919 print-sysroot-headers-suffix
1920 Driver Var(print_sysroot_headers_suffix)
1921
1922 quiet
1923 Common Var(quiet_flag) RejectDriver
1924 Do not display functions compiled or elapsed time
1925
1926 save-temps
1927 Driver
1928
1929 save-temps=
1930 Driver Joined
1931
1932 time
1933 Driver Var(report_times)
1934
1935 time=
1936 Driver JoinedOrMissing
1937
1938 u
1939 Driver Joined Separate
1940
1941 undef
1942 Driver
1943 ; C option, but driver must not handle as "-u ndef".
1944
1945 v
1946 Driver
1947
1948 version
1949 Common Var(version_flag) RejectDriver
1950 Display the compiler's version
1951
1952 w
1953 Common Var(inhibit_warnings)
1954 Suppress warnings
1955
1956 wrapper
1957 Driver Separate Var(wrapper_string)
1958
1959 x
1960 Driver Joined Separate
1961
1962 shared
1963 Common RejectNegative Negative(pie)
1964 Create a shared library
1965
1966 shared-libgcc
1967 Driver
1968
1969 specs
1970 Driver Separate Alias(specs=)
1971
1972 specs=
1973 Driver Joined
1974
1975 static
1976 Driver
1977
1978 static-libgcc
1979 Driver
1980
1981 static-libgfortran
1982 Driver
1983 ; Documented for Fortran, but always accepted by driver.
1984
1985 static-libstdc++
1986 Driver
1987
1988 symbolic
1989 Driver
1990
1991 pie
1992 Common RejectNegative Negative(shared)
1993 Create a position independent executable
1994
1995 ; This comment is to ensure we retain the blank line above.