gcc/common.opt

   1 ; Options for the language- and target-independent parts of the compiler.
   2
   3 ; Copyright (C) 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
   4 ;
   5 ; This file is part of GCC.
   6 ;
   7 ; GCC is free software; you can redistribute it and/or modify it under
   8 ; the terms of the GNU General Public License as published by the Free
   9 ; Software Foundation; either version 3, or (at your option) any later
  10 ; version.
  11 ;
  12 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 ; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 ; for more details.
  16 ;
  17 ; You should have received a copy of the GNU General Public License
  18 ; along with GCC; see the file COPYING3.  If not see
  19 ; <http://www.gnu.org/licenses/>.
  20
  21 ; See the GCC internals manual for a description of this file's format.
  22
  23 ; Please try to keep this file in ASCII collating order.
  24
  25 -help
  26 Common
  27 Display this information
  28
  29 -help=
  30 Common Report Joined
  31 --help=<class>  Display descriptions of a specific class of options.  <class> is one or more of optimizers, target, warnings, undocumented, params
  32
  33 -target-help
  34 Common
  35 Alias for --help=target
  36
  37 ;; The following three entries are to work around the gcc driver
  38 ;; program's insatiable desire to turn options starting with a
  39 ;; double dash (--) into options starting with a dash f (-f).
  40 fhelp
  41 Common
  42
  43 fhelp=
  44 Common Joined
  45
  46 ftarget-help
  47 Common
  48
  49 -param
  50 Common Separate
  51 --param <param>=<value> Set parameter <param> to value.  See below for a complete list of parameters
  52
  53 -version
  54 Common
  55
  56 G
  57 Common Joined Separate UInteger
  58 -G<number>      Put global and static data smaller than <number> bytes into a special section (on some targets)
  59
  60 O
  61 Common JoinedOrMissing
  62 -O<number>      Set optimization level to <number>
  63
  64 Os
  65 Common
  66 Optimize for space rather than speed
  67
  68 W
  69 Common RejectNegative
  70 This switch is deprecated; use -Wextra instead
  71
  72 Waggregate-return
  73 Common Var(warn_aggregate_return) Warning
  74 Warn about returning structures, unions or arrays
  75
  76 Warray-bounds
  77 Common Var(warn_array_bounds) Warning
  78 Warn if an array is accessed out of bounds
  79
  80 Wattributes
  81 Common Var(warn_attributes) Init(1) Warning
  82 Warn about inappropriate attribute usage
  83
  84 Wcast-align
  85 Common Var(warn_cast_align) Warning
  86 Warn about pointer casts which increase alignment
  87
  88 Wdeprecated-declarations
  89 Common Var(warn_deprecated_decl) Init(1) Warning
  90 Warn about uses of __attribute__((deprecated)) declarations
  91
  92 Wdisabled-optimization
  93 Common Var(warn_disabled_optimization) Warning
  94 Warn when an optimization pass is disabled
  95
  96 Werror
  97 Common Var(warnings_are_errors)
  98 Treat all warnings as errors
  99
 100 Werror=
 101 Common Joined
 102 Treat specified warning as error
 103
 104 Wextra
 105 Common Warning
 106 Print extra (possibly unwanted) warnings
 107
 108 Wfatal-errors
 109 Common Var(flag_fatal_errors)
 110 Exit on the first error occurred
 111
 112 Winline
 113 Common Var(warn_inline) Warning
 114 Warn when an inlined function cannot be inlined
 115
 116 Wlarger-than-
 117 Common RejectNegative Joined UInteger Warning
 118 -Wlarger-than-<number>  Warn if an object is larger than <number> bytes
 119
 120 Wlogical-op
 121 Common Warning Var(warn_logical_op)
 122 Warn when a logical operator is suspicously always evaluating to true or false
 123
 124 Wunsafe-loop-optimizations
 125 Common Var(warn_unsafe_loop_optimizations) Warning
 126 Warn if the loop cannot be optimized due to nontrivial assumptions.
 127
 128 Wmissing-noreturn
 129 Common Var(warn_missing_noreturn) Warning
 130 Warn about functions which might be candidates for __attribute__((noreturn))
 131
 132 Woverflow
 133 Common Var(warn_overflow) Init(1) Warning
 134 Warn about overflow in arithmetic expressions
 135
 136 Wpacked
 137 Common Var(warn_packed) Warning
 138 Warn when the packed attribute has no effect on struct layout
 139
 140 Wpadded
 141 Common Var(warn_padded) Warning
 142 Warn when padding is required to align structure members
 143
 144 Wshadow
 145 Common Var(warn_shadow) Warning
 146 Warn when one local variable shadows another
 147
 148 Wstack-protector
 149 Common Var(warn_stack_protect) Warning
 150 Warn when not issuing stack smashing protection for some reason
 151
 152 Wstrict-aliasing
 153 Common Warning
 154 Warn about code which might break strict aliasing rules
 155
 156 Wstrict-aliasing=
 157 Common Joined UInteger Warning
 158 Warn about code which might break strict aliasing rules
 159
 160 Wstrict-overflow
 161 Common Warning
 162 Warn about optimizations that assume that signed overflow is undefined
 163
 164 Wstrict-overflow=
 165 Common Joined UInteger Warning
 166 Warn about optimizations that assume that signed overflow is undefined
 167
 168 Wswitch
 169 Common Var(warn_switch) Warning
 170 Warn about enumerated switches, with no default, missing a case
 171
 172 Wswitch-default
 173 Common Var(warn_switch_default) Warning
 174 Warn about enumerated switches missing a \"default:\" statement
 175
 176 Wswitch-enum
 177 Common Var(warn_switch_enum) Warning
 178 Warn about all enumerated switches missing a specific case
 179
 180 Wsystem-headers
 181 Common Var(warn_system_headers) Warning
 182 Do not suppress warnings from system headers
 183
 184 Wuninitialized
 185 Common Var(warn_uninitialized) Warning
 186 Warn about uninitialized automatic variables
 187
 188 Wunreachable-code
 189 Common Var(warn_notreached) Warning
 190 Warn about code that will never be executed
 191
 192 Wunused
 193 Common Warning
 194 Enable all -Wunused- warnings
 195
 196 Wunused-function
 197 Common Var(warn_unused_function) Warning
 198 Warn when a function is unused
 199
 200 Wunused-label
 201 Common Var(warn_unused_label) Warning
 202 Warn when a label is unused
 203
 204 Wunused-parameter
 205 Common Var(warn_unused_parameter) Warning
 206 Warn when a function parameter is unused
 207
 208 Wunused-value
 209 Common Var(warn_unused_value) Warning
 210 Warn when an expression value is unused
 211
 212 Wunused-variable
 213 Common Var(warn_unused_variable) Warning
 214 Warn when a variable is unused
 215
 216 Wvolatile-register-var
 217 Common Var(warn_register_var) Warning
 218 Warn when a register variable is declared volatile
 219
 220 Wcoverage-mismatch
 221 Common RejectNegative Var(warn_coverage_mismatch) Warning
 222 Warn instead of error in case profiles in -fprofile-use do not match
 223
 224 aux-info
 225 Common Separate
 226 -aux-info <file>        Emit declaration information into <file>
 227
 228 aux-info=
 229 Common Joined
 230
 231 auxbase
 232 Common Separate
 233
 234 auxbase-strip
 235 Common Separate
 236
 237 d
 238 Common Joined
 239 -d<letters>     Enable dumps from specific passes of the compiler
 240
 241 dumpbase
 242 Common Separate
 243 -dumpbase <file>        Set the file basename to be used for dumps
 244
 245 ; The version of the C++ ABI in use.  The following values are allowed:
 246 ;
 247 ; 0: The version of the ABI believed most conformant with the C++ ABI
 248 ;    specification.  This ABI may change as bugs are discovered and fixed.
 249 ;    Therefore, 0 will not necessarily indicate the same ABI in different
 250 ;    versions of G++.
 251 ;
 252 ; 1: The version of the ABI first used in G++ 3.2.
 253 ;
 254 ; Additional positive integers will be assigned as new versions of
 255 ; the ABI become the default version of the ABI.
 256 fabi-version=
 257 Common Joined UInteger Var(flag_abi_version) Init(2)
 258
 259 falign-functions
 260 Common Report Var(align_functions,0)
 261 Align the start of functions
 262
 263 falign-functions=
 264 Common RejectNegative Joined UInteger
 265
 266 falign-jumps
 267 Common Report Var(align_jumps,0) Optimization
 268 Align labels which are only reached by jumping
 269
 270 falign-jumps=
 271 Common RejectNegative Joined UInteger
 272
 273 falign-labels
 274 Common Report Var(align_labels,0) Optimization
 275 Align all labels
 276
 277 falign-labels=
 278 Common RejectNegative Joined UInteger
 279
 280 falign-loops
 281 Common Report Var(align_loops) Optimization
 282 Align the start of loops
 283
 284 falign-loops=
 285 Common RejectNegative Joined UInteger
 286
 287 ; This flag is only tested if alias checking is enabled.
 288 ; 0 if pointer arguments may alias each other.  True in C.
 289 ; 1 if pointer arguments may not alias each other but may alias
 290 ;   global variables.
 291 ; 2 if pointer arguments may not alias each other and may not
 292 ;   alias global variables.
 293 ; 3 if pointer arguments may not alias anything.  True in Fortran.
 294 ;   Set by the front end.
 295 fargument-alias
 296 Common Report Var(flag_argument_noalias,0) Optimization
 297 Specify that arguments may alias each other and globals
 298
 299 fargument-noalias
 300 Common Report Var(flag_argument_noalias,1) VarExists Optimization
 301 Assume arguments may alias globals but not each other
 302
 303 fargument-noalias-global
 304 Common Report Var(flag_argument_noalias,2) VarExists Optimization
 305 Assume arguments alias neither each other nor globals
 306
 307 fargument-noalias-anything
 308 Common Report Var(flag_argument_noalias,3) VarExists Optimization
 309 Assume arguments alias no other storage
 310
 311 fasynchronous-unwind-tables
 312 Common Report Var(flag_asynchronous_unwind_tables) Optimization
 313 Generate unwind tables that are exact at each instruction boundary
 314
 315 fauto-inc-dec
 316 Common Report Var(flag_auto_inc_dec) Init(1)
 317 Generate auto-inc/dec instructions
 318
 319 ; -fcheck-bounds causes gcc to generate array bounds checks.
 320 ; For C, C++ and ObjC: defaults off.
 321 ; For Java: defaults to on.
 322 ; For Fortran: defaults to off.
 323 fbounds-check
 324 Common Report Var(flag_bounds_check)
 325 Generate code to check bounds before indexing arrays
 326
 327 fbranch-count-reg
 328 Common Report Var(flag_branch_on_count_reg) Init(1) Optimization
 329 Replace add, compare, branch with branch on count register
 330
 331 fbranch-probabilities
 332 Common Report Var(flag_branch_probabilities) Optimization
 333 Use profiling information for branch probabilities
 334
 335 fbranch-target-load-optimize
 336 Common Report Var(flag_branch_target_load_optimize) Optimization
 337 Perform branch target load optimization before prologue / epilogue threading
 338
 339 fbranch-target-load-optimize2
 340 Common Report Var(flag_branch_target_load_optimize2) Optimization
 341 Perform branch target load optimization after prologue / epilogue threading
 342
 343 fbtr-bb-exclusive
 344 Common Report Var(flag_btr_bb_exclusive) Optimization
 345 Restrict target load migration not to re-use registers in any basic block
 346
 347 fcall-saved-
 348 Common Joined RejectNegative
 349 -fcall-saved-<register> Mark <register> as being preserved across functions
 350
 351 fcall-used-
 352 Common Joined RejectNegative
 353 -fcall-used-<register>  Mark <register> as being corrupted by function calls
 354
 355 ; Nonzero for -fcaller-saves: allocate values in regs that need to
 356 ; be saved across function calls, if that produces overall better code.
 357 ; Optional now, so people can test it.
 358 fcaller-saves
 359 Common Report Var(flag_caller_saves) Optimization
 360 Save registers around function calls
 361
 362 fcheck-data-deps
 363 Common Report Var(flag_check_data_deps)
 364 Compare the results of several data dependence analyzers.
 365
 366 fcommon
 367 Common Report Var(flag_no_common,0) Optimization
 368 Do not put uninitialized globals in the common section
 369
 370 fcprop-registers
 371 Common Report Var(flag_cprop_registers) Optimization
 372 Perform a register copy-propagation optimization pass
 373
 374 fcrossjumping
 375 Common Report Var(flag_crossjumping) Optimization
 376 Perform cross-jumping optimization
 377
 378 fcse-follow-jumps
 379 Common Report Var(flag_cse_follow_jumps) Optimization
 380 When running CSE, follow jumps to their targets
 381
 382 fcse-skip-blocks
 383 Common Report Var(flag_cse_skip_blocks) Optimization
 384 When running CSE, follow conditional jumps
 385
 386 fcx-limited-range
 387 Common Report Var(flag_cx_limited_range) Optimization
 388 Omit range reduction step when performing complex division
 389
 390 fdata-sections
 391 Common Report Var(flag_data_sections) Optimization
 392 Place data items into their own section
 393
 394 fdbg-cnt-list
 395 Common Report
 396 List all available debugging counters with their limits and counts.
 397
 398 fdbg-cnt=
 399 Common RejectNegative Joined
 400 -fdbg-cnt=<counter>:<limit>[,<counter>:<limit>,...]    Set the debug counter limit.
 401
 402 fdebug-prefix-map=
 403 Common Joined RejectNegative
 404 Map one directory name to another in debug information
 405
 406 ; Nonzero for -fdefer-pop: don't pop args after each function call
 407 ; instead save them up to pop many calls' args with one insns.
 408 fdefer-pop
 409 Common Report Var(flag_defer_pop) Optimization
 410 Defer popping functions args from stack until later
 411
 412 fdelayed-branch
 413 Common Report Var(flag_delayed_branch) Optimization
 414 Attempt to fill delay slots of branch instructions
 415
 416 fdelete-null-pointer-checks
 417 Common Report Var(flag_delete_null_pointer_checks) Optimization
 418 Delete useless null pointer checks
 419
 420 fdiagnostics-show-location=
 421 Common Joined RejectNegative
 422 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
 423
 424 fdiagnostics-show-option
 425 Common
 426 Amend appropriate diagnostic messages with the command line option that controls them
 427
 428 fdump-
 429 Common Joined RejectNegative
 430 -fdump-<type>   Dump various compiler internals to a file
 431
 432 fdump-noaddr
 433 Common Report Var(flag_dump_noaddr)
 434 Suppress output of addresses in debugging dumps
 435
 436 fdump-unnumbered
 437 Common Report Var(flag_dump_unnumbered) VarExists
 438 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
 439
 440 fearly-inlining
 441 Common Report Var(flag_early_inlining) Init(1) Optimization
 442 Perform early inlining
 443
 444 feliminate-dwarf2-dups
 445 Common Report Var(flag_eliminate_dwarf2_dups)
 446 Perform DWARF2 duplicate elimination
 447
 448 feliminate-unused-debug-symbols
 449 Common Report Var(flag_debug_only_used_symbols)
 450 Perform unused type elimination in debug info
 451
 452 feliminate-unused-debug-types
 453 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
 454 Perform unused type elimination in debug info
 455
 456 femit-class-debug-always
 457 Common Report Var(flag_emit_class_debug_always) Init(1)
 458 Do not suppress C++ class debug information.
 459
 460 fexceptions
 461 Common Report Var(flag_exceptions) Optimization
 462 Enable exception handling
 463
 464 fexpensive-optimizations
 465 Common Report Var(flag_expensive_optimizations) Optimization
 466 Perform a number of minor, expensive optimizations
 467
 468 ffast-math
 469 Common
 470
 471 ffinite-math-only
 472 Common Report Var(flag_finite_math_only) Optimization
 473 Assume no NaNs or infinities are generated
 474
 475 ffixed-
 476 Common Joined RejectNegative
 477 -ffixed-<register>      Mark <register> as being unavailable to the compiler
 478
 479 ffloat-store
 480 Common Report Var(flag_float_store) Optimization
 481 Don't allocate floats and doubles in extended-precision registers
 482
 483 ; Nonzero for -fforce-addr: load memory address into a register before
 484 ; reference to memory.  This makes better cse but slower compilation.
 485 fforce-addr
 486 Common Report Var(flag_force_addr) Optimization
 487 Copy memory address constants into registers before use
 488
 489 fforward-propagate
 490 Common Report Var(flag_forward_propagate) Optimization
 491 Perform a forward propagation pass on RTL
 492
 493 ; Nonzero means don't put addresses of constant functions in registers.
 494 ; Used for compiling the Unix kernel, where strange substitutions are
 495 ; done on the assembly output.
 496 ffunction-cse
 497 Common Report Var(flag_no_function_cse,0)
 498 Allow function addresses to be held in registers
 499
 500 ffunction-sections
 501 Common Report Var(flag_function_sections)
 502 Place each function into its own section
 503
 504 fgcse
 505 Common Report Var(flag_gcse) Optimization
 506 Perform global common subexpression elimination
 507
 508 fgcse-lm
 509 Common Report Var(flag_gcse_lm) Init(1) Optimization
 510 Perform enhanced load motion during global common subexpression elimination
 511
 512 fgcse-sm
 513 Common Report Var(flag_gcse_sm) Init(0) Optimization
 514 Perform store motion after global common subexpression elimination
 515
 516 fgcse-las
 517 Common Report Var(flag_gcse_las) Init(0) Optimization
 518 Perform redundant load after store elimination in global common subexpression
 519 elimination
 520
 521 fgcse-after-reload
 522 Common Report Var(flag_gcse_after_reload) Optimization
 523 Perform global common subexpression elimination after register allocation
 524 has finished
 525
 526 fguess-branch-probability
 527 Common Report Var(flag_guess_branch_prob) Optimization
 528 Enable guessing of branch probabilities
 529
 530 ; Nonzero means ignore `#ident' directives.  0 means handle them.
 531 ; Generate position-independent code for executables if possible
 532 ; On SVR4 targets, it also controls whether or not to emit a
 533 ; string identifying the compiler.
 534 fident
 535 Common Report Var(flag_no_ident,0)
 536 Process #ident directives
 537
 538 fif-conversion
 539 Common Report Var(flag_if_conversion) Optimization
 540 Perform conversion of conditional jumps to branchless equivalents
 541
 542 fif-conversion2
 543 Common Report Var(flag_if_conversion2) Optimization
 544 Perform conversion of conditional jumps to conditional execution
 545
 546 ; -finhibit-size-directive inhibits output of .size for ELF.
 547 ; This is used only for compiling crtstuff.c,
 548 ; and it may be extended to other effects
 549 ; needed for crtstuff.c on other systems.
 550 finhibit-size-directive
 551 Common Report Var(flag_inhibit_size_directive)
 552 Do not generate .size directives
 553
 554 ; Nonzero means that functions declared `inline' will be treated
 555 ; as `static'.  Prevents generation of zillions of copies of unused
 556 ; static inline functions; instead, `inlines' are written out
 557 ; only when actually used.  Used in conjunction with -g.  Also
 558 ; does the right thing with #pragma interface.
 559 finline
 560 Common Report Var(flag_no_inline,0) Init(2)
 561 Pay attention to the \"inline\" keyword
 562
 563 finline-functions
 564 Common Report Var(flag_inline_functions) Optimization
 565 Integrate simple functions into their callers
 566
 567 finline-functions-called-once
 568 Common Report Var(flag_inline_functions_called_once) Init(1) Optimization
 569 Integrate functions called once into their callers
 570
 571 finline-limit-
 572 Common RejectNegative Joined UInteger
 573
 574 finline-limit=
 575 Common RejectNegative Joined UInteger
 576 -finline-limit=<number> Limit the size of inlined functions to <number>
 577
 578 finstrument-functions
 579 Common Report Var(flag_instrument_function_entry_exit)
 580 Instrument function entry and exit with profiling calls
 581
 582 finstrument-functions-exclude-function-list=
 583 Common RejectNegative Joined
 584 -finstrument-functions-exclude-function-list=name,...  Do not instrument listed functions
 585
 586 finstrument-functions-exclude-file-list=
 587 Common RejectNegative Joined
 588 -finstrument-functions-exclude-file-list=filename,...  Do not instrument functions listed in files
 589
 590 fipa-cp
 591 Common Report Var(flag_ipa_cp) Optimization
 592 Perform Interprocedural constant propagation
 593
 594 fipa-pure-const
 595 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
 596 Discover pure and const functions
 597
 598 fipa-pta
 599 Common Report Var(flag_ipa_pta) Init(0) Optimization
 600 Perform interprocedural points-to analysis
 601
 602 fipa-reference
 603 Common Report Var(flag_ipa_reference) Init(0) Optimization
 604 Discover readonly and non addressable static variables
 605
 606 fipa-type-escape
 607 Common Report Var(flag_ipa_type_escape) Init(0) Optimization
 608 Type based escape and alias analysis
 609
 610 fipa-matrix-reorg
 611 Common Report Var(flag_ipa_matrix_reorg) Optimization
 612 Perform matrix layout flattening and transposing based
 613 on profiling information.
 614
 615 fivopts
 616 Common Report Var(flag_ivopts) Init(1) Optimization
 617 Optimize induction variables on trees
 618
 619 fjump-tables
 620 Common Var(flag_jump_tables) Init(1) Optimization
 621 Use jump tables for sufficiently large switch statements
 622
 623 fkeep-inline-functions
 624 Common Report Var(flag_keep_inline_functions)
 625 Generate code for functions even if they are fully inlined
 626
 627 fkeep-static-consts
 628 Common Report Var(flag_keep_static_consts) Init(1)
 629 Emit static const variables even if they are not used
 630
 631 fleading-underscore
 632 Common Report Var(flag_leading_underscore) Init(-1)
 633 Give external symbols a leading underscore
 634
 635 floop-optimize
 636 Common
 637 Does nothing.  Preserved for backward compatibility.
 638
 639 fmath-errno
 640 Common Report Var(flag_errno_math) Init(1)
 641 Set errno after built-in math functions
 642
 643 fmem-report
 644 Common Report Var(mem_report)
 645 Report on permanent memory allocation
 646
 647 ; This will attempt to merge constant section constants, if 1 only
 648 ; string constants and constants from constant pool, if 2 also constant
 649 ; variables.
 650 fmerge-all-constants
 651 Common Report Var(flag_merge_constants,2) Init(1) Optimization
 652 Attempt to merge identical constants and constant variables
 653
 654 fmerge-constants
 655 Common Report Var(flag_merge_constants,1) VarExists Optimization
 656 Attempt to merge identical constants across compilation units
 657
 658 fmessage-length=
 659 Common RejectNegative Joined UInteger
 660 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
 661
 662 fmodulo-sched
 663 Common Report Var(flag_modulo_sched) Optimization
 664 Perform SMS based modulo scheduling before the first scheduling pass
 665
 666 fmodulo-sched-allow-regmoves
 667 Common Report Var(flag_modulo_sched_allow_regmoves)
 668 Perform SMS based modulo scheduling with register moves allowed
 669
 670 fmove-loop-invariants
 671 Common Report Var(flag_move_loop_invariants) Init(1) Optimization
 672 Move loop invariant computations out of loops
 673
 674 fmudflap
 675 Common RejectNegative Report Var(flag_mudflap)
 676 Add mudflap bounds-checking instrumentation for single-threaded program
 677
 678 fmudflapth
 679 Common RejectNegative Report VarExists Var(flag_mudflap,2)
 680 Add mudflap bounds-checking instrumentation for multi-threaded program
 681
 682 fmudflapir
 683 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
 684 Ignore read operations when inserting mudflap instrumentation
 685
 686 fdce
 687 Common Var(flag_dce) Init(1) Optimization
 688 Use the RTL dead code elimination pass
 689
 690 fdse
 691 Common Var(flag_dse) Init(1) Optimization
 692 Use the RTL dead store elimination pass
 693
 694 freschedule-modulo-scheduled-loops
 695 Common Report Var(flag_resched_modulo_sched) Optimization
 696 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
 697
 698 fnon-call-exceptions
 699 Common Report Var(flag_non_call_exceptions) Optimization
 700 Support synchronous non-call exceptions
 701
 702 fomit-frame-pointer
 703 Common Report Var(flag_omit_frame_pointer) Optimization
 704 When possible do not generate stack frames
 705
 706 foptimize-register-move
 707 Common Report Var(flag_regmove) Optimization
 708 Do the full register move optimization pass
 709
 710 foptimize-sibling-calls
 711 Common Report Var(flag_optimize_sibling_calls) Optimization
 712 Optimize sibling and tail recursive calls
 713
 714 fpre-ipa-mem-report
 715 Common Report Var(pre_ipa_mem_report)
 716 Report on memory allocation before interprocedural optimization
 717
 718 fpost-ipa-mem-report
 719 Common Report Var(post_ipa_mem_report)
 720 Report on memory allocation before interprocedural optimization
 721
 722 fpack-struct
 723 Common Report Var(flag_pack_struct) Optimization
 724 Pack structure members together without holes
 725
 726 fpack-struct=
 727 Common RejectNegative Joined UInteger Optimization
 728 -fpack-struct=<number>  Set initial maximum structure member alignment
 729
 730 fpcc-struct-return
 731 Common Report Var(flag_pcc_struct_return,1) VarExists
 732 Return small aggregates in memory, not registers
 733
 734 fpeel-loops
 735 Common Report Var(flag_peel_loops) Optimization
 736 Perform loop peeling
 737
 738 fpeephole
 739 Common Report Var(flag_no_peephole,0) Optimization
 740 Enable machine specific peephole optimizations
 741
 742 fpeephole2
 743 Common Report Var(flag_peephole2) Optimization
 744 Enable an RTL peephole pass before sched2
 745
 746 fPIC
 747 Common Report Var(flag_pic,2)
 748 Generate position-independent code if possible (large mode)
 749
 750 fPIE
 751 Common Report Var(flag_pie,2)
 752 Generate position-independent code for executables if possible (large mode)
 753
 754 fpic
 755 Common Report Var(flag_pic,1) VarExists
 756 Generate position-independent code if possible (small mode)
 757
 758 fpie
 759 Common Report Var(flag_pie,1) VarExists
 760 Generate position-independent code for executables if possible (small mode)
 761
 762 fpredictive-commoning
 763 Common Report Var(flag_predictive_commoning) Optimization
 764 Run predictive commoning optimization.
 765
 766 fprefetch-loop-arrays
 767 Common Report Var(flag_prefetch_loop_arrays) Optimization
 768 Generate prefetch instructions, if available, for arrays in loops
 769
 770 fprofile
 771 Common Report Var(profile_flag)
 772 Enable basic program profiling code
 773
 774 fprofile-arcs
 775 Common Report Var(profile_arc_flag)
 776 Insert arc-based program profiling code
 777
 778 fprofile-generate
 779 Common
 780 Enable common options for generating profile info for profile feedback directed optimizations
 781
 782 fprofile-use
 783 Common
 784 Enable common options for performing profile feedback directed optimizations
 785
 786 fprofile-values
 787 Common Report Var(flag_profile_values)
 788 Insert code to profile values of expressions
 789
 790 frandom-seed
 791 Common
 792
 793 frandom-seed=
 794 Common Joined RejectNegative
 795 -frandom-seed=<string>  Make compile reproducible using <string>
 796
 797 ; This switch causes the command line that was used to create an
 798 ; object file to be recorded into the object file.  The exact format
 799 ; of this recording is target and binary file format dependent.
 800 ; It is related to the -fverbose-asm switch, but that switch only
 801 ; records information in the assembler output file as comments, so
 802 ; they never reach the object file.
 803 frecord-gcc-switches
 804 Common Report Var(flag_record_gcc_switches)
 805 Record gcc command line switches in the object file.
 806
 807 freg-struct-return
 808 Common Report Var(flag_pcc_struct_return,0) VarExists Optimization
 809 Return small aggregates in registers
 810
 811 fregmove
 812 Common Report Var(flag_regmove) Optimization
 813 Enables a register move optimization
 814
 815 frename-registers
 816 Common Report Var(flag_rename_registers) Init(2) Optimization
 817 Perform a register renaming optimization pass
 818
 819 freorder-blocks
 820 Common Report Var(flag_reorder_blocks) Optimization
 821 Reorder basic blocks to improve code placement
 822
 823 freorder-blocks-and-partition
 824 Common Report Var(flag_reorder_blocks_and_partition) Optimization
 825 Reorder basic blocks and partition into hot and cold sections
 826
 827 freorder-functions
 828 Common Report Var(flag_reorder_functions) Optimization
 829 Reorder functions to improve code placement
 830
 831 frerun-cse-after-loop
 832 Common Report Var(flag_rerun_cse_after_loop) Init(2) Optimization
 833 Add a common subexpression elimination pass after loop optimizations
 834
 835 frerun-loop-opt
 836 Common
 837 Does nothing.  Preserved for backward compatibility.
 838
 839 frounding-math
 840 Common Report Var(flag_rounding_math) Optimization
 841 Disable optimizations that assume default FP rounding behavior
 842
 843 fsched-interblock
 844 Common Report Var(flag_schedule_interblock) Init(1) Optimization
 845 Enable scheduling across basic blocks
 846
 847 fsched-spec
 848 Common Report Var(flag_schedule_speculative) Init(1) Optimization
 849 Allow speculative motion of non-loads
 850
 851 fsched-spec-load
 852 Common Report Var(flag_schedule_speculative_load) Optimization
 853 Allow speculative motion of some loads
 854
 855 fsched-spec-load-dangerous
 856 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
 857 Allow speculative motion of more loads
 858
 859 fsched-verbose=
 860 Common RejectNegative Joined
 861 -fsched-verbose=<number>        Set the verbosity level of the scheduler
 862
 863 fsched2-use-superblocks
 864 Common Report Var(flag_sched2_use_superblocks) Optimization
 865 If scheduling post reload, do superblock scheduling
 866
 867 fsched2-use-traces
 868 Common Report Var(flag_sched2_use_traces) Optimization
 869 If scheduling post reload, do trace scheduling
 870
 871 fschedule-insns
 872 Common Report Var(flag_schedule_insns) Optimization
 873 Reschedule instructions before register allocation
 874
 875 fschedule-insns2
 876 Common Report Var(flag_schedule_insns_after_reload) Optimization
 877 Reschedule instructions after register allocation
 878
 879 ; sched_stalled_insns means that insns can be moved prematurely from the queue
 880 ; of stalled insns into the ready list.
 881 fsched-stalled-insns
 882 Common Report Var(flag_sched_stalled_insns) Optimization
 883 Allow premature scheduling of queued insns
 884
 885 fsched-stalled-insns=
 886 Common RejectNegative Joined UInteger
 887 -fsched-stalled-insns=<number>  Set number of queued insns that can be prematurely scheduled
 888
 889 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
 890 ; be examined for a dependency on a stalled insn that is candidate for
 891 ; premature removal from the queue of stalled insns into the ready list (has
 892 ; an effect only if the flag 'sched_stalled_insns' is set).
 893 fsched-stalled-insns-dep
 894 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization
 895 Set dependence distance checking in premature scheduling of queued insns
 896
 897 fsched-stalled-insns-dep=
 898 Common RejectNegative Joined UInteger
 899 -fsched-stalled-insns-dep=<number>      Set dependence distance checking in premature scheduling of queued insns
 900
 901 fsection-anchors
 902 Common Report Var(flag_section_anchors) Optimization
 903 Access data in the same section from shared anchor points
 904
 905 frtl-abstract-sequences
 906 Common Report Var(flag_rtl_seqabstr) Optimization
 907 Perform sequence abstraction optimization on RTL
 908
 909 fsee
 910 Common Report Var(flag_see) Init(0)
 911 Eliminate redundant sign extensions using LCM.
 912
 913 fshow-column
 914 Common C ObjC C++ ObjC++ Report Var(flag_show_column) Init(1)
 915 Show column numbers in diagnostics, when available.  Default on
 916
 917 fsignaling-nans
 918 Common Report Var(flag_signaling_nans) Optimization
 919 Disable optimizations observable by IEEE signaling NaNs
 920
 921 fsigned-zeros
 922 Common Report Var(flag_signed_zeros) Init(1) Optimization
 923 Disable floating point optimizations that ignore the IEEE signedness of zero
 924
 925 fsingle-precision-constant
 926 Common Report Var(flag_single_precision_constant) Optimization
 927 Convert floating point constants to single precision constants
 928
 929 fsplit-ivs-in-unroller
 930 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
 931 Split lifetimes of induction variables when loops are unrolled
 932
 933 fsplit-wide-types
 934 Common Report Var(flag_split_wide_types) Optimization
 935 Split wide types into independent registers
 936
 937 fvariable-expansion-in-unroller
 938 Common Report Var(flag_variable_expansion_in_unroller) Optimization
 939 Apply variable expansion when loops are unrolled
 940
 941 ; Emit code to probe the stack, to help detect stack overflow; also
 942 ; may cause large objects to be allocated dynamically.
 943 fstack-check
 944 Common Report Var(flag_stack_check)
 945 Insert stack checking code into the program
 946
 947 fstack-limit
 948 Common
 949
 950 fstack-limit-register=
 951 Common RejectNegative Joined
 952 -fstack-limit-register=<register>       Trap if the stack goes past <register>
 953
 954 fstack-limit-symbol=
 955 Common RejectNegative Joined
 956 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
 957
 958 fstack-protector
 959 Common Report Var(flag_stack_protect, 1)
 960 Use propolice as a stack protection method
 961
 962 fstack-protector-all
 963 Common Report RejectNegative Var(flag_stack_protect, 2) VarExists
 964 Use a stack protection method for every function
 965
 966 fstrength-reduce
 967 Common
 968 Does nothing.  Preserved for backward compatibility.
 969
 970 ; Nonzero if we should do (language-dependent) alias analysis.
 971 ; Typically, this analysis will assume that expressions of certain
 972 ; types do not alias expressions of certain other types.  Only used
 973 ; if alias analysis (in general) is enabled.
 974 fstrict-aliasing
 975 Common Report Var(flag_strict_aliasing) Optimization
 976 Assume strict aliasing rules apply
 977
 978 fstrict-overflow
 979 Common Report Var(flag_strict_overflow)
 980 Treat signed overflow as undefined
 981
 982 fsyntax-only
 983 Common Report Var(flag_syntax_only)
 984 Check for syntax errors, then stop
 985
 986 ftest-coverage
 987 Common Report Var(flag_test_coverage)
 988 Create data files needed by \"gcov\"
 989
 990 fthread-jumps
 991 Common Report Var(flag_thread_jumps) Optimization
 992 Perform jump threading optimizations
 993
 994 ftime-report
 995 Common Report Var(time_report)
 996 Report the time taken by each compiler pass
 997
 998 ftls-model=
 999 Common Joined RejectNegative
1000 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
1001
1002 ftoplevel-reorder
1003 Common Report Var(flag_toplevel_reorder) Init(1) Optimization
1004 Reorder top level functions, variables, and asms
1005
1006 ftracer
1007 Common Report Var(flag_tracer)
1008 Perform superblock formation via tail duplication
1009
1010 ; Zero means that floating-point math operations cannot generate a
1011 ; (user-visible) trap.  This is the case, for example, in nonstop
1012 ; IEEE 754 arithmetic.
1013 ftrapping-math
1014 Common Report Var(flag_trapping_math) Init(1) Optimization
1015 Assume floating-point operations can trap
1016
1017 ftrapv
1018 Common Report Var(flag_trapv) Optimization
1019 Trap for signed overflow in addition, subtraction and multiplication
1020
1021 ftree-ccp
1022 Common Report Var(flag_tree_ccp) Optimization
1023 Enable SSA-CCP optimization on trees
1024
1025 ftree-store-ccp
1026 Common Report Var(flag_tree_store_ccp) Optimization
1027 Enable SSA-CCP optimization for stores and loads
1028
1029 ftree-ch
1030 Common Report Var(flag_tree_ch) Optimization
1031 Enable loop header copying on trees
1032
1033 ftree-copyrename
1034 Common Report Var(flag_tree_copyrename) Optimization
1035 Replace SSA temporaries with better names in copies
1036
1037 ftree-copy-prop
1038 Common Report Var(flag_tree_copy_prop) Optimization
1039 Enable copy propagation on trees
1040
1041 ftree-store-copy-prop
1042 Common Report Var(flag_tree_store_copy_prop) Optimization
1043 Enable copy propagation for stores and loads
1044
1045 ftree-dce
1046 Common Report Var(flag_tree_dce) Optimization
1047 Enable SSA dead code elimination optimization on trees
1048
1049 ftree-dominator-opts
1050 Common Report Var(flag_tree_dom) Optimization
1051 Enable dominator optimizations
1052
1053 ftree-dse
1054 Common Report Var(flag_tree_dse) Optimization
1055 Enable dead store elimination
1056
1057 ftree-fre
1058 Common Report Var(flag_tree_fre) Optimization
1059 Enable Full Redundancy Elimination (FRE) on trees
1060
1061 ftree-loop-im
1062 Common Report Var(flag_tree_loop_im) Init(1) Optimization
1063 Enable loop invariant motion on trees
1064
1065 ftree-loop-linear
1066 Common Report Var(flag_tree_loop_linear) Optimization
1067 Enable linear loop transforms on trees
1068
1069 ftree-loop-ivcanon
1070 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
1071 Create canonical induction variables in loops
1072
1073 ftree-loop-optimize
1074 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
1075 Enable loop optimizations on tree level
1076
1077 ftree-pre
1078 Common Report Var(flag_tree_pre) Optimization
1079 Enable SSA-PRE optimization on trees
1080
1081 ftree-reassoc
1082 Common Report Var(flag_tree_reassoc) Init(1) Optimization
1083 Enable reassociation on tree level
1084
1085 ftree-salias
1086 Common Report Var(flag_tree_salias) Optimization
1087 Perform structural alias analysis
1088
1089 ftree-sink
1090 Common Report Var(flag_tree_sink) Optimization
1091 Enable SSA code sinking on trees
1092
1093 ftree-sra
1094 Common Report Var(flag_tree_sra) Optimization
1095 Perform scalar replacement of aggregates
1096
1097 ftree-ter
1098 Common Report Var(flag_tree_ter) Optimization
1099 Replace temporary expressions in the SSA->normal pass
1100
1101 ftree-lrs
1102 Common Report Var(flag_tree_live_range_split) Optimization
1103 Perform live range splitting during the SSA->normal pass
1104
1105 ftree-vrp
1106 Common Report Var(flag_tree_vrp) Init(0) Optimization
1107 Perform Value Range Propagation on trees
1108
1109 funit-at-a-time
1110 Common Report Var(flag_unit_at_a_time) Optimization
1111 Compile whole compilation unit at a time
1112
1113 funroll-loops
1114 Common Report Var(flag_unroll_loops) Optimization
1115 Perform loop unrolling when iteration count is known
1116
1117 funroll-all-loops
1118 Common Report Var(flag_unroll_all_loops) Optimization
1119 Perform loop unrolling for all loops
1120
1121 ; Nonzero means that loop optimizer may assume that the induction variables
1122 ; that control loops do not overflow and that the loops with nontrivial
1123 ; exit condition are not infinite
1124 funsafe-loop-optimizations
1125 Common Report Var(flag_unsafe_loop_optimizations) Optimization
1126 Allow loop optimizations to assume that the loops behave in normal way
1127
1128 ; Nonzero means that unsafe floating-point math optimizations are allowed
1129 ; for the sake of speed.  IEEE compliance is not guaranteed, and operations
1130 ; are allowed to assume that their arguments and results are "normal"
1131 ; (e.g., nonnegative for SQRT).
1132 funsafe-math-optimizations
1133 Common Report Var(flag_unsafe_math_optimizations) Optimization
1134 Allow math optimizations that may violate IEEE or ISO standards
1135
1136 funswitch-loops
1137 Common Report Var(flag_unswitch_loops) Optimization
1138 Perform loop unswitching
1139
1140 funwind-tables
1141 Common Report Var(flag_unwind_tables) Optimization
1142 Just generate unwind tables for exception handling
1143
1144 fvar-tracking
1145 Common Report Var(flag_var_tracking) VarExists Optimization
1146 Perform variable tracking
1147
1148 fvar-tracking-uninit
1149 Common Report Var(flag_var_tracking_uninit) Optimization
1150 Perform variable tracking and also tag variables that are uninitialized
1151
1152 ftree-vectorize
1153 Common Report Var(flag_tree_vectorize) Optimization
1154 Enable loop vectorization on trees
1155
1156 fvect-cost-model
1157 Common Report Var(flag_vect_cost_model) Optimization
1158 Enable use of cost model in vectorization
1159
1160 ftree-vect-loop-version
1161 Common Report Var(flag_tree_vect_loop_version) Init(1) Optimization
1162 Enable loop versioning when doing loop vectorization on trees
1163
1164 ftree-vectorizer-verbose=
1165 Common RejectNegative Joined
1166 -ftree-vectorizer-verbose=<number>      Set the verbosity level of the vectorizer
1167
1168 ftree-scev-cprop
1169 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
1170 Enable copy propagation of scalar-evolution information.
1171
1172 ; -fverbose-asm causes extra commentary information to be produced in
1173 ; the generated assembly code (to make it more readable).  This option
1174 ; is generally only of use to those who actually need to read the
1175 ; generated assembly code (perhaps while debugging the compiler itself).
1176 ; -fno-verbose-asm, the default, causes the extra information
1177 ; to not be added and is useful when comparing two assembler files.
1178 fverbose-asm
1179 Common Report Var(flag_verbose_asm)
1180 Add extra commentary to assembler output
1181
1182 fvisibility=
1183 Common Joined RejectNegative
1184 -fvisibility=[default|internal|hidden|protected]        Set the default symbol visibility
1185
1186
1187 fvpt
1188 Common Report Var(flag_value_profile_transformations) Optimization
1189 Use expression value profiles in optimizations
1190
1191 fweb
1192 Common Report Var(flag_web) Init(2) Optimization
1193 Construct webs and split unrelated uses of single variable
1194
1195 fwhole-program
1196 Common Report Var(flag_whole_program) Init(0) Optimization
1197 Perform whole program optimizations
1198
1199 fwrapv
1200 Common Report Var(flag_wrapv) Optimization
1201 Assume signed arithmetic overflow wraps around
1202
1203 fzero-initialized-in-bss
1204 Common Report Var(flag_zero_initialized_in_bss) Init(1)
1205 Put zero initialized data in the bss section
1206
1207 g
1208 Common JoinedOrMissing
1209 Generate debug information in default format
1210
1211 gcoff
1212 Common JoinedOrMissing Negative(gdwarf-2)
1213 Generate debug information in COFF format
1214
1215 gdwarf-2
1216 Common JoinedOrMissing Negative(gstabs)
1217 Generate debug information in DWARF v2 format
1218
1219 ggdb
1220 Common JoinedOrMissing
1221 Generate debug information in default extended format
1222
1223 gstabs
1224 Common JoinedOrMissing Negative(gstabs+)
1225 Generate debug information in STABS format
1226
1227 gstabs+
1228 Common JoinedOrMissing Negative(gvms)
1229 Generate debug information in extended STABS format
1230
1231 gvms
1232 Common JoinedOrMissing Negative(gxcoff)
1233 Generate debug information in VMS format
1234
1235 gxcoff
1236 Common JoinedOrMissing Negative(gxcoff+)
1237 Generate debug information in XCOFF format
1238
1239 gxcoff+
1240 Common JoinedOrMissing Negative(gcoff)
1241 Generate debug information in extended XCOFF format
1242
1243 o
1244 Common Joined Separate
1245 -o <file>       Place output into <file>
1246
1247 p
1248 Common Var(profile_flag)
1249 Enable function profiling
1250
1251 pedantic
1252 Common Var(pedantic)
1253 Issue warnings needed for strict compliance to the standard
1254
1255 pedantic-errors
1256 Common
1257 Like -pedantic but issue them as errors
1258
1259 quiet
1260 Common Var(quiet_flag)
1261 Do not display functions compiled or elapsed time
1262
1263 version
1264 Common Var(version_flag)
1265 Display the compiler's version
1266
1267 w
1268 Common Var(inhibit_warnings)
1269 Suppress warnings
1270
1271 ; This comment is to ensure we retain the blank line above.