PR 22591
[official-gcc.git] / gcc / common.opt
blob53e2a501d6a372ce58d2cf485d3713fdc07423a9
1 ; Options for the language- and target-independent parts of the compiler.
3 ; Copyright (C) 2003, 2004, 2005 Free Software Foundation, Inc.
5 ; This file is part of GCC.
7 ; GCC is free software; you can redistribute it and/or modify it under
8 ; the terms of the GNU General Public License as published by the Free
9 ; Software Foundation; either version 2, 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 COPYING.  If not, write to the Free
19 ; Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
20 ; 02110-1301, USA.
22 ; See the GCC internals manual for a description of this file's format.
24 ; Please try to keep this file in ASCII collating order.
26 -help
27 Common
28 Display this information
30 -param
31 Common Separate
32 --param <param>=<value> Set parameter <param> to value.  See below for a complete list of parameters
34 -target-help
35 Common
37 -version
38 Common
41 Common Joined Separate UInteger
42 -G<number>      Put global and static data smaller than <number> bytes into a special section (on some targets)
45 Common JoinedOrMissing
46 -O<number>      Set optimization level to <number>
49 Common
50 Optimize for space rather than speed
53 Common RejectNegative
54 This switch is deprecated; use -Wextra instead
56 Waggregate-return
57 Common Var(warn_aggregate_return)
58 Warn about returning structures, unions or arrays
60 Wattributes
61 Common Var(warn_attributes) Init(1)
62 Warn about inappropriate attribute usage
64 Wcast-align
65 Common Var(warn_cast_align)
66 Warn about pointer casts which increase alignment
68 Wdeprecated-declarations
69 Common Var(warn_deprecated_decl) Init(1)
70 Warn about uses of __attribute__((deprecated)) declarations
72 Wdisabled-optimization
73 Common Var(warn_disabled_optimization)
74 Warn when an optimization pass is disabled
76 Werror
77 Common Var(warnings_are_errors)
78 Treat all warnings as errors
80 Wextra
81 Common
82 Print extra (possibly unwanted) warnings
84 Wfatal-errors
85 Common Var(flag_fatal_errors)
86 Exit on the first error occurred
88 Winline
89 Common Var(warn_inline)
90 Warn when an inlined function cannot be inlined
92 Wlarger-than-
93 Common RejectNegative Joined UInteger
94 -Wlarger-than-<number>  Warn if an object is larger than <number> bytes
96 Wunsafe-loop-optimizations
97 Common Var(warn_unsafe_loop_optimizations)
98 Warn if the loop cannot be optimized due to nontrivial assumptions.
100 Wmissing-noreturn
101 Common Var(warn_missing_noreturn)
102 Warn about functions which might be candidates for __attribute__((noreturn))
104 Wpacked
105 Common Var(warn_packed)
106 Warn when the packed attribute has no effect on struct layout
108 Wpadded
109 Common Var(warn_padded)
110 Warn when padding is required to align structure members
112 Wshadow
113 Common Var(warn_shadow)
114 Warn when one local variable shadows another
116 Wstack-protector
117 Common Var(warn_stack_protect)
118 Warn when not issuing stack smashing protection for some reason
120 Wstrict-aliasing
121 Common
122 Warn about code which might break strict aliasing rules
124 Wstrict-aliasing=
125 Common Joined UInteger
126 Warn about code which might break strict aliasing rules
128 Wswitch
129 Common Var(warn_switch)
130 Warn about enumerated switches, with no default, missing a case
132 Wswitch-default
133 Common Var(warn_switch_default)
134 Warn about enumerated switches missing a \"default:\" statement
136 Wswitch-enum
137 Common Var(warn_switch_enum)
138 Warn about all enumerated switches missing a specific case
140 Wsystem-headers
141 Common Var(warn_system_headers)
142 Do not suppress warnings from system headers
144 Wuninitialized
145 Common Var(warn_uninitialized)
146 Warn about uninitialized automatic variables
148 Wunreachable-code
149 Common Var(warn_notreached)
150 Warn about code that will never be executed
152 Wunused
153 Common
154 Enable all -Wunused- warnings
156 Wunused-function
157 Common Var(warn_unused_function)
158 Warn when a function is unused
160 Wunused-label
161 Common Var(warn_unused_label)
162 Warn when a label is unused
164 Wunused-parameter
165 Common Var(warn_unused_parameter)
166 Warn when a function parameter is unused
168 Wunused-value
169 Common Var(warn_unused_value)
170 Warn when an expression value is unused
172 Wunused-variable
173 Common Var(warn_unused_variable)
174 Warn when a variable is unused
176 aux-info
177 Common Separate
178 -aux-info <file>        Emit declaration information into <file>
180 aux-info=
181 Common Joined
183 auxbase
184 Common Separate
186 auxbase-strip
187 Common Separate
190 Common Joined
191 -d<letters>     Enable dumps from specific passes of the compiler
193 dumpbase
194 Common Separate
195 -dumpbase <file>        Set the file basename to be used for dumps
197 ; The version of the C++ ABI in use.  The following values are allowed:
199 ; 0: The version of the ABI believed most conformant with the C++ ABI
200 ;    specification.  This ABI may change as bugs are discovered and fixed.
201 ;    Therefore, 0 will not necessarily indicate the same ABI in different
202 ;    versions of G++.
204 ; 1: The version of the ABI first used in G++ 3.2.
206 ; Additional positive integers will be assigned as new versions of
207 ; the ABI become the default version of the ABI.
208 fabi-version=
209 Common Joined UInteger Var(flag_abi_version) Init(2)
211 falign-functions
212 Common Report Var(align_functions,0)
213 Align the start of functions
215 falign-functions=
216 Common RejectNegative Joined UInteger
218 falign-jumps
219 Common Report Var(align_jumps,0)
220 Align labels which are only reached by jumping
222 falign-jumps=
223 Common RejectNegative Joined UInteger
225 falign-labels
226 Common Report Var(align_labels,0)
227 Align all labels
229 falign-labels=
230 Common RejectNegative Joined UInteger
232 falign-loops
233 Common Report Var(align_loops)
234 Align the start of loops
236 falign-loops=
237 Common RejectNegative Joined UInteger
239 ; This flag is only tested if alias checking is enabled.
240 ; 0 if pointer arguments may alias each other.  True in C.
241 ; 1 if pointer arguments may not alias each other but may alias
242 ;   global variables.
243 ; 2 if pointer arguments may not alias each other and may not
244 ;   alias global variables.  True in Fortran.
245 fargument-alias
246 Common Report Var(flag_argument_noalias,0)
247 Specify that arguments may alias each other and globals
249 fargument-noalias
250 Common Report Var(flag_argument_noalias,1) VarExists
251 Assume arguments may alias globals but not each other
253 fargument-noalias-global
254 Common Report Var(flag_argument_noalias,2) VarExists
255 Assume arguments alias neither each other nor globals
257 fasynchronous-unwind-tables
258 Common Report Var(flag_asynchronous_unwind_tables)
259 Generate unwind tables that are exact at each instruction boundary
261 ; -fcheck-bounds causes gcc to generate array bounds checks.
262 ; For C, C++ and ObjC: defaults off.
263 ; For Java: defaults to on.
264 ; For Fortran: defaults to off.
265 fbounds-check
266 Common Report Var(flag_bounds_check)
267 Generate code to check bounds before indexing arrays
269 fbranch-count-reg
270 Common Report Var(flag_branch_on_count_reg) Init(1)
271 Replace add, compare, branch with branch on count register
273 fbranch-probabilities
274 Common Report Var(flag_branch_probabilities)
275 Use profiling information for branch probabilities
277 fbranch-target-load-optimize
278 Common Report Var(flag_branch_target_load_optimize)
279 Perform branch target load optimization before prologue / epilogue threading
281 fbranch-target-load-optimize2
282 Common Report Var(flag_branch_target_load_optimize2)
283 Perform branch target load optimization after prologue / epilogue threading
285 fbtr-bb-exclusive
286 Common Report Var(flag_btr_bb_exclusive)
287 Restrict target load migration not to re-use registers in any basic block
289 fcall-saved-
290 Common Joined RejectNegative
291 -fcall-saved-<register> Mark <register> as being preserved across functions
293 fcall-used-
294 Common Joined RejectNegative
295 -fcall-used-<register>  Mark <register> as being corrupted by function calls
297 ; Nonzero for -fcaller-saves: allocate values in regs that need to
298 ; be saved across function calls, if that produces overall better code.
299 ; Optional now, so people can test it.
300 fcaller-saves
301 Common Report Var(flag_caller_saves)
302 Save registers around function calls
304 fcommon
305 Common Report Var(flag_no_common,0)
306 Do not put uninitialized globals in the common section
308 fcprop-registers
309 Common Report Var(flag_cprop_registers)
310 Perform a register copy-propagation optimization pass
312 fcrossjumping
313 Common Report Var(flag_crossjumping)
314 Perform cross-jumping optimization
316 fcse-follow-jumps
317 Common Report Var(flag_cse_follow_jumps)
318 When running CSE, follow jumps to their targets
320 fcse-skip-blocks
321 Common Report Var(flag_cse_skip_blocks)
322 When running CSE, follow conditional jumps
324 fcx-limited-range
325 Common Report Var(flag_cx_limited_range)
326 Omit range reduction step when performing complex division
328 fdata-sections
329 Common Report Var(flag_data_sections)
330 Place data items into their own section
332 ; Nonzero for -fdefer-pop: don't pop args after each function call
333 ; instead save them up to pop many calls' args with one insns.
334 fdefer-pop
335 Common Report Var(flag_defer_pop)
336 Defer popping functions args from stack until later
338 fdelayed-branch
339 Common Report Var(flag_delayed_branch)
340 Attempt to fill delay slots of branch instructions
342 fdelete-null-pointer-checks
343 Common Report Var(flag_delete_null_pointer_checks)
344 Delete useless null pointer checks
346 fdiagnostics-show-location=
347 Common Joined RejectNegative
348 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
350 fdiagnostics-show-option
351 Common
352 Amend appropriate diagnostic messages with the command line option that controls them
354 fdump-
355 Common Joined RejectNegative
356 -fdump-<type>   Dump various compiler internals to a file
358 fdump-unnumbered
359 Common Report Var(flag_dump_unnumbered) VarExists
360 Suppress output of instruction numbers and line number notes in debugging dumps
362 feliminate-dwarf2-dups
363 Common Report Var(flag_eliminate_dwarf2_dups)
364 Perform DWARF2 duplicate elimination
366 feliminate-unused-debug-symbols
367 Common Report Var(flag_debug_only_used_symbols)
368 Perform unused type elimination in debug info
370 feliminate-unused-debug-types
371 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
372 Perform unused type elimination in debug info
374 fexceptions
375 Common Report Var(flag_exceptions)
376 Enable exception handling
378 fexpensive-optimizations
379 Common Report Var(flag_expensive_optimizations)
380 Perform a number of minor, expensive optimizations
382 ffast-math
383 Common
385 ffinite-math-only
386 Common Report Var(flag_finite_math_only)
387 Assume no NaNs or infinities are generated
389 ffixed-
390 Common Joined RejectNegative
391 -ffixed-<register>      Mark <register> as being unavailable to the compiler
393 ffloat-store
394 Common Report Var(flag_float_store)
395 Don't allocate floats and doubles in extended-precision registers
397 ; Nonzero for -fforce-addr: load memory address into a register before
398 ; reference to memory.  This makes better cse but slower compilation.
399 fforce-addr
400 Common Report Var(flag_force_addr)
401 Copy memory address constants into registers before use
403 ; Nonzero for -fforce-mem: load memory value into a register
404 ; before arithmetic on it.  This makes better cse but slower compilation.
405 fforce-mem
406 Common Report Var(flag_force_mem)
407 Copy memory operands into registers before use
409 ; Nonzero means don't put addresses of constant functions in registers.
410 ; Used for compiling the Unix kernel, where strange substitutions are
411 ; done on the assembly output.
412 ffunction-cse
413 Common Report Var(flag_no_function_cse,0)
414 Allow function addresses to be held in registers
416 ffunction-sections
417 Common Report Var(flag_function_sections)
418 Place each function into its own section
420 fgcse
421 Common Report Var(flag_gcse)
422 Perform global common subexpression elimination
424 fgcse-lm
425 Common Report Var(flag_gcse_lm) Init(1)
426 Perform enhanced load motion during global common subexpression elimination
428 fgcse-sm
429 Common Report Var(flag_gcse_sm) Init(0)
430 Perform store motion after global common subexpression elimination
432 fgcse-las
433 Common Report Var(flag_gcse_las) Init(0)
434 Perform redundant load after store elimination in global common subexpression
435 elimination
437 fgcse-after-reload
438 Common Report Var(flag_gcse_after_reload) Init(2)
439 Perform global common subexpression elimination after register allocation
440 has finished
442 fguess-branch-probability
443 Common Report Var(flag_guess_branch_prob)
444 Enable guessing of branch probabilities
446 ; Nonzero means ignore `#ident' directives.  0 means handle them.
447 ; Generate position-independent code for executables if possible
448 ; On SVR4 targets, it also controls whether or not to emit a
449 ; string identifying the compiler.
450 fident
451 Common Report Var(flag_no_ident,0)
452 Process #ident directives
454 fif-conversion
455 Common Report Var(flag_if_conversion)
456 Perform conversion of conditional jumps to branchless equivalents
458 fif-conversion2
459 Common Report Var(flag_if_conversion2)
460 Perform conversion of conditional jumps to conditional execution
462 ; -finhibit-size-directive inhibits output of .size for ELF.
463 ; This is used only for compiling crtstuff.c,
464 ; and it may be extended to other effects
465 ; needed for crtstuff.c on other systems.
466 finhibit-size-directive
467 Common Report Var(flag_inhibit_size_directive)
468 Do not generate .size directives
470 ; Nonzero means that functions declared `inline' will be treated
471 ; as `static'.  Prevents generation of zillions of copies of unused
472 ; static inline functions; instead, `inlines' are written out
473 ; only when actually used.  Used in conjunction with -g.  Also
474 ; does the right thing with #pragma interface.
475 finline
476 Common Report Var(flag_no_inline,0) Init(2)
477 Pay attention to the \"inline\" keyword
479 finline-functions
480 Common Report Var(flag_inline_functions)
481 Integrate simple functions into their callers
483 fearly-inlining
484 Common Report Var(flag_early_inlining) Init(1)
485 Perform early inlining
487 finline-limit-
488 Common RejectNegative Joined UInteger
490 finline-limit=
491 Common RejectNegative Joined UInteger
492 -finline-limit=<number> Limit the size of inlined functions to <number>
494 finstrument-functions
495 Common Report Var(flag_instrument_function_entry_exit)
496 Instrument function entry and exit with profiling calls
498 fipa-pure-const
499 Common Report Var(flag_ipa_pure_const) Init(0)
500 Discover pure and const functions
502 fipa-reference
503 Common Report Var(flag_ipa_reference) Init(0)
504 Discover readonly and non addressable static variables
506 fipa-type-escape
507 Common Report Var(flag_ipa_type_escape) Init(0)
508 Type based escape and alias analysis
510 fivopts
511 Common Report Var(flag_ivopts) Init(1)
512 Optimize induction variables on trees
514 fjump-tables
515 Common Var(flag_jump_tables) Init(1)
516 Use jump tables for sufficiently large switch statements
518 fkeep-inline-functions
519 Common Report Var(flag_keep_inline_functions)
520 Generate code for functions even if they are fully inlined
522 fkeep-static-consts
523 Common Report Var(flag_keep_static_consts) Init(1)
524 Emit static const variables even if they are not used
526 fleading-underscore
527 Common Report Var(flag_leading_underscore) Init(-1)
528 Give external symbols a leading underscore
530 floop-optimize
531 Common Report Var(flag_loop_optimize)
532 Perform loop optimizations
534 floop-optimize2
535 Common Report Var(flag_loop_optimize2)
536 Perform loop optimizations using the new loop optimizer
538 fmath-errno
539 Common Report Var(flag_errno_math) Init(1)
540 Set errno after built-in math functions
542 fmem-report
543 Common Report Var(mem_report)
544 Report on permanent memory allocation
546 ; This will attempt to merge constant section constants, if 1 only
547 ; string constants and constants from constant pool, if 2 also constant
548 ; variables.
549 fmerge-all-constants
550 Common Report Var(flag_merge_constants,2) Init(1)
551 Attempt to merge identical constants and constant variables
553 fmerge-constants
554 Common Report Var(flag_merge_constants,1) VarExists
555 Attempt to merge identical constants across compilation units
557 fmessage-length=
558 Common RejectNegative Joined UInteger
559 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
561 fmodulo-sched
562 Common Report Var(flag_modulo_sched)
563 Perform SMS based modulo scheduling before the first scheduling pass
565 fmove-loop-invariants
566 Common Report Var(flag_move_loop_invariants)
567 Move loop invariant computations out of loops
569 fmudflap
570 Common RejectNegative Report Var(flag_mudflap)
571 Add mudflap bounds-checking instrumentation for single-threaded program
573 fmudflapth
574 Common RejectNegative Report Var(flag_mudflap_threads)
575 Add mudflap bounds-checking instrumentation for multi-threaded program
577 fmudflapir
578 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
579 Ignore read operations when inserting mudflap instrumentation
581 freschedule-modulo-scheduled-loops
582 Common Report Var(flag_resched_modulo_sched)
583 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
585 fnon-call-exceptions
586 Common Report Var(flag_non_call_exceptions)
587 Support synchronous non-call exceptions
589 fomit-frame-pointer
590 Common Report Var(flag_omit_frame_pointer)
591 When possible do not generate stack frames
593 foptimize-register-move
594 Common Report Var(flag_regmove)
595 Do the full register move optimization pass
597 foptimize-sibling-calls
598 Common Report Var(flag_optimize_sibling_calls)
599 Optimize sibling and tail recursive calls
601 fpack-struct
602 Common Report Var(flag_pack_struct)
603 Pack structure members together without holes
605 fpack-struct=
606 Common RejectNegative Joined UInteger
607 -fpack-struct=<number>  Set initial maximum structure member alignment
609 fpcc-struct-return
610 Common Report Var(flag_pcc_struct_return,1) VarExists
611 Return small aggregates in memory, not registers
613 fpeel-loops
614 Common Report Var(flag_peel_loops)
615 Perform loop peeling
617 fpeephole
618 Common Report Var(flag_no_peephole,0)
619 Enable machine specific peephole optimizations
621 fpeephole2
622 Common Report Var(flag_peephole2)
623 Enable an RTL peephole pass before sched2
625 fPIC
626 Common Report Var(flag_pic,2)
627 Generate position-independent code if possible (large mode)
629 fPIE
630 Common Report Var(flag_pie,2)
631 Generate position-independent code for executables if possible (large mode)
633 fpic
634 Common Report Var(flag_pic,1) VarExists
635 Generate position-independent code if possible (small mode)
637 fpie
638 Common Report Var(flag_pie,1) VarExists
639 Generate position-independent code for executables if possible (small mode)
641 fprefetch-loop-arrays
642 Common Report Var(flag_prefetch_loop_arrays)
643 Generate prefetch instructions, if available, for arrays in loops
645 fprofile
646 Common Report Var(profile_flag)
647 Enable basic program profiling code
649 fprofile-arcs
650 Common Report Var(profile_arc_flag)
651 Insert arc-based program profiling code
653 fprofile-generate
654 Common
655 Enable common options for generating profile info for profile feedback directed optimizations
657 fprofile-use
658 Common
659 Enable common options for performing profile feedback directed optimizations
661 fprofile-values
662 Common Report Var(flag_profile_values)
663 Insert code to profile values of expressions
665 frandom-seed
666 Common
668 frandom-seed=
669 Common Joined RejectNegative
670 -frandom-seed=<string>  Make compile reproducible using <string>
672 freg-struct-return
673 Common Report Var(flag_pcc_struct_return,0) VarExists
674 Return small aggregates in registers
676 fregmove
677 Common Report Var(flag_regmove)
678 Enables a register move optimization
680 frename-registers
681 Common Report Var(flag_rename_registers) Init(2)
682 Perform a register renaming optimization pass
684 freorder-blocks
685 Common Report Var(flag_reorder_blocks)
686 Reorder basic blocks to improve code placement
688 freorder-blocks-and-partition
689 Common Report Var(flag_reorder_blocks_and_partition)
690 Reorder basic blocks and partition into hot and cold sections
692 freorder-functions
693 Common Report Var(flag_reorder_functions)
694 Reorder functions to improve code placement
696 frerun-cse-after-loop
697 Common Report Var(flag_rerun_cse_after_loop)
698 Add a common subexpression elimination pass after loop optimizations
700 frerun-loop-opt
701 Common Report Var(flag_rerun_loop_opt)
702 Run the loop optimizer twice
704 frounding-math
705 Common Report Var(flag_rounding_math)
706 Disable optimizations that assume default FP rounding behavior
708 fsched-interblock
709 Common Report Var(flag_schedule_interblock) Init(1)
710 Enable scheduling across basic blocks
712 fsched-spec
713 Common Report Var(flag_schedule_speculative) Init(1)
714 Allow speculative motion of non-loads
716 fsched-spec-load
717 Common Report Var(flag_schedule_speculative_load)
718 Allow speculative motion of some loads
720 fsched-spec-load-dangerous
721 Common Report Var(flag_schedule_speculative_load_dangerous)
722 Allow speculative motion of more loads
724 fsched-verbose=
725 Common RejectNegative Joined
726 -fsched-verbose=<number>        Set the verbosity level of the scheduler
728 fsched2-use-superblocks
729 Common Report Var(flag_sched2_use_superblocks)
730 If scheduling post reload, do superblock scheduling
732 fsched2-use-traces
733 Common Report Var(flag_sched2_use_traces)
734 If scheduling post reload, do trace scheduling
736 fschedule-insns
737 Common Report Var(flag_schedule_insns)
738 Reschedule instructions before register allocation
740 fschedule-insns2
741 Common Report Var(flag_schedule_insns_after_reload)
742 Reschedule instructions after register allocation
744 ; sched_stalled_insns means that insns can be moved prematurely from the queue
745 ; of stalled insns into the ready list.
746 fsched-stalled-insns
747 Common Report Var(flag_sched_stalled_insns)
748 Allow premature scheduling of queued insns
750 fsched-stalled-insns=
751 Common RejectNegative Joined UInteger 
752 -fsched-stalled-insns=<number>  Set number of queued insns that can be prematurely scheduled
754 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
755 ; be examined for a dependency on a stalled insn that is candidate for
756 ; premature removal from the queue of stalled insns into the ready list (has
757 ; an effect only if the flag 'sched_stalled_insns' is set).
758 fsched-stalled-insns-dep
759 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1)
760 Set dependence distance checking in premature scheduling of queued insns
762 fsched-stalled-insns-dep=
763 Common RejectNegative Joined UInteger
764 -fsched-stalled-insns-dep=<number>      Set dependence distance checking in premature scheduling of queued insns
766 fshared-data
767 Common Report Var(flag_shared_data)
768 Mark data as shared rather than private
770 fshow-column
771 Common C ObjC C++ ObjC++ Report Var(flag_show_column) Init(1)
772 Show column numbers in diagnostics, when available.  Default on
774 fsignaling-nans
775 Common Report Var(flag_signaling_nans)
776 Disable optimizations observable by IEEE signaling NaNs
778 fsingle-precision-constant
779 Common Report Var(flag_single_precision_constant)
780 Convert floating point constants to single precision constants
782 fspeculative-prefetching
783 Common Report Var(flag_speculative_prefetching)
784 Use value profiling for speculative prefetching
786 fsplit-ivs-in-unroller
787 Common Report Var(flag_split_ivs_in_unroller) Init(1)
788 Split lifetimes of induction variables when loops are unrolled
790 fvariable-expansion-in-unroller
791 Common Report Var(flag_variable_expansion_in_unroller) 
792 Apply variable expansion when loops are unrolled
794 ; Emit code to probe the stack, to help detect stack overflow; also
795 ; may cause large objects to be allocated dynamically.
796 fstack-check
797 Common Report Var(flag_stack_check)
798 Insert stack checking code into the program
800 fstack-limit
801 Common
803 fstack-limit-register=
804 Common RejectNegative Joined
805 -fstack-limit-register=<register>       Trap if the stack goes past <register>
807 fstack-limit-symbol=
808 Common RejectNegative Joined
809 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
811 fstack-protector
812 Common Report Var(flag_stack_protect, 1)
813 Use propolice as a stack protection method
815 fstack-protector-all
816 Common Report RejectNegative Var(flag_stack_protect, 2) VarExists
817 Use a stack protection method for every function
819 fstrength-reduce
820 Common Report Var(flag_strength_reduce)
821 Perform strength reduction optimizations
823 ; Nonzero if we should do (language-dependent) alias analysis.
824 ; Typically, this analysis will assume that expressions of certain
825 ; types do not alias expressions of certain other types.  Only used
826 ; if alias analysis (in general) is enabled.
827 fstrict-aliasing
828 Common Report Var(flag_strict_aliasing)
829 Assume strict aliasing rules apply
831 fsyntax-only
832 Common Report Var(flag_syntax_only)
833 Check for syntax errors, then stop
835 ftest-coverage
836 Common Report Var(flag_test_coverage)
837 Create data files needed by \"gcov\"
839 fthread-jumps
840 Common Report Var(flag_thread_jumps)
841 Perform jump threading optimizations
843 ftime-report
844 Common Report Var(time_report)
845 Report the time taken by each compiler pass
847 ftls-model=
848 Common Joined RejectNegative
849 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
851 ftracer
852 Common Report Var(flag_tracer)
853 Perform superblock formation via tail duplication
855 ; Zero means that floating-point math operations cannot generate a
856 ; (user-visible) trap.  This is the case, for example, in nonstop
857 ; IEEE 754 arithmetic.
858 ftrapping-math
859 Common Report Var(flag_trapping_math) Init(1)
860 Assume floating-point operations can trap
862 ftrapv
863 Common Report Var(flag_trapv)
864 Trap for signed overflow in addition, subtraction and multiplication
866 ftree-based-profiling
867 Common Report Var(flag_tree_based_profiling)
868 Use tree-ssa based implementation of profiling
870 ftree-ccp
871 Common Report Var(flag_tree_ccp)
872 Enable SSA-CCP optimization on trees
874 ftree-store-ccp
875 Common Report Var(flag_tree_store_ccp)
876 Enable SSA-CCP optimization for stores and loads
878 ftree-ch
879 Common Report Var(flag_tree_ch)
880 Enable loop header copying on trees
882 ftree-combine-temps
883 Common Report Var(flag_tree_combine_temps)
884 Coalesce memory temporaries in the SSA->normal pass
886 ftree-copyrename
887 Common Report Var(flag_tree_copyrename)
888 Replace SSA temporaries with better names in copies
890 ftree-copy-prop
891 Common Report Var(flag_tree_copy_prop)
892 Enable copy propagation on trees
894 ftree-store-copy-prop
895 Common Report Var(flag_tree_store_copy_prop)
896 Enable copy propagation for stores and loads
898 ftree-dce
899 Common Report Var(flag_tree_dce)
900 Enable SSA dead code elimination optimization on trees
902 ftree-dominator-opts
903 Common Report Var(flag_tree_dom)
904 Enable dominator optimizations
906 ftree-dse
907 Common Report Var(flag_tree_dse)
908 Enable dead store elimination
910 ftree-fre
911 Common Report Var(flag_tree_fre)
912 Enable Full Redundancy Elimination (FRE) on trees
914 ftree-loop-im
915 Common Report Var(flag_tree_loop_im) Init(1)
916 Enable loop invariant motion on trees
918 ftree-loop-linear
919 Common Report Var(flag_tree_loop_linear)
920 Enable linear loop transforms on trees
922 ftree-loop-ivcanon
923 Common Report Var(flag_tree_loop_ivcanon) Init(1)
924 Create canonical induction variables in loops
926 ftree-loop-optimize
927 Common Report Var(flag_tree_loop_optimize) Init(1)
928 Enable loop optimizations on tree level
930 ftree-pre
931 Common Report Var(flag_tree_pre)
932 Enable SSA-PRE optimization on trees
934 ftree-salias
935 Common Report Var(flag_tree_salias)
936 Perform structural alias analysis
938 ftree-sink
939 Common Report Var(flag_tree_sink)
940 Enable SSA code sinking on trees
942 ftree-sra
943 Common Report Var(flag_tree_sra)
944 Perform scalar replacement of aggregates
946 ftree-ter
947 Common Report Var(flag_tree_ter)
948 Replace temporary expressions in the SSA->normal pass
950 ftree-lrs
951 Common Report Var(flag_tree_live_range_split)
952 Perform live range splitting during the SSA->normal pass
954 ftree-vrp
955 Common Report Var(flag_tree_vrp) Init(0)
956 Perform Value Range Propagation on trees
958 funit-at-a-time
959 Common Report Var(flag_unit_at_a_time)
960 Compile whole compilation unit at a time
962 funroll-loops
963 Common Report Var(flag_unroll_loops)
964 Perform loop unrolling when iteration count is known
966 funroll-all-loops
967 Common Report Var(flag_unroll_all_loops)
968 Perform loop unrolling for all loops
970 ; Nonzero means that loop optimizer may assume that the induction variables
971 ; that control loops do not overflow and that the loops with nontrivial
972 ; exit condition are not infinite
973 funsafe-loop-optimizations
974 Common Report Var(flag_unsafe_loop_optimizations)
975 Allow loop optimizations to assume that the loops behave in normal way
977 ; Nonzero means that unsafe floating-point math optimizations are allowed
978 ; for the sake of speed.  IEEE compliance is not guaranteed, and operations
979 ; are allowed to assume that their arguments and results are "normal"
980 ; (e.g., nonnegative for SQRT).
981 funsafe-math-optimizations
982 Common Report Var(flag_unsafe_math_optimizations)
983 Allow math optimizations that may violate IEEE or ISO standards
985 funswitch-loops
986 Common Report Var(flag_unswitch_loops)
987 Perform loop unswitching
989 funwind-tables
990 Common Report Var(flag_unwind_tables)
991 Just generate unwind tables for exception handling
993 fvar-tracking
994 Common Report Var(flag_var_tracking) VarExists
995 Perform variable tracking
997 ftree-vectorize
998 Common Report Var(flag_tree_vectorize)
999 Enable loop vectorization on trees
1001 ftree-vectorizer-verbose=
1002 Common RejectNegative Joined
1003 -ftree-vectorizer-verbose=<number>      Set the verbosity level of the vectorizer
1005 ; -fverbose-asm causes extra commentary information to be produced in
1006 ; the generated assembly code (to make it more readable).  This option
1007 ; is generally only of use to those who actually need to read the
1008 ; generated assembly code (perhaps while debugging the compiler itself).
1009 ; -fno-verbose-asm, the default, causes the extra information
1010 ; to not be added and is useful when comparing two assembler files.
1011 fverbose-asm
1012 Common Report Var(flag_verbose_asm)
1013 Add extra commentary to assembler output
1015 fvisibility=
1016 Common Joined RejectNegative
1017 -fvisibility=[default|internal|hidden|protected]        Set the default symbol visibility
1020 fvpt
1021 Common Report Var(flag_value_profile_transformations)
1022 Use expression value profiles in optimizations
1024 fweb
1025 Common Report Var(flag_web) Init(2)
1026 Construct webs and split unrelated uses of single variable
1028 fwhole-program
1029 Common Report Var(flag_whole_program) Init(0)
1030 Perform whole program optimizations
1032 fwrapv
1033 Common Report Var(flag_wrapv)
1034 Assume signed arithmetic overflow wraps around
1036 fzero-initialized-in-bss
1037 Common Report Var(flag_zero_initialized_in_bss) Init(1)
1038 Put zero initialized data in the bss section
1041 Common JoinedOrMissing
1042 Generate debug information in default format
1044 gcoff
1045 Common JoinedOrMissing
1046 Generate debug information in COFF format
1048 gdwarf-2
1049 Common JoinedOrMissing
1050 Generate debug information in DWARF v2 format
1052 ggdb
1053 Common JoinedOrMissing
1054 Generate debug information in default extended format
1056 gstabs
1057 Common JoinedOrMissing
1058 Generate debug information in STABS format
1060 gstabs+
1061 Common JoinedOrMissing
1062 Generate debug information in extended STABS format
1064 gvms
1065 Common JoinedOrMissing
1066 Generate debug information in VMS format
1068 gxcoff
1069 Common JoinedOrMissing
1070 Generate debug information in XCOFF format
1072 gxcoff+
1073 Common JoinedOrMissing
1074 Generate debug information in extended XCOFF format
1077 Common Joined Separate
1078 -o <file>       Place output into <file>
1081 Common Var(profile_flag)
1082 Enable function profiling
1084 pedantic
1085 Common Var(pedantic)
1086 Issue warnings needed for strict compliance to the standard
1088 pedantic-errors
1089 Common
1090 Like -pedantic but issue them as errors
1092 quiet
1093 Common Var(quiet_flag)
1094 Do not display functions compiled or elapsed time
1096 version
1097 Common Var(version_flag)
1098 Display the compiler's version
1101 Common Var(inhibit_warnings)
1102 Suppress warnings
1104 ; This comment is to ensure we retain the blank line above.