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