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 ; Nonzero for -fdefer-pop: don't pop args after each function call
 403 ; instead save them up to pop many calls' args with one insns.
 404 fdefer-pop
 405 Common Report Var(flag_defer_pop) Optimization
 406 Defer popping functions args from stack until later
 407
 408 fdelayed-branch
 409 Common Report Var(flag_delayed_branch) Optimization
 410 Attempt to fill delay slots of branch instructions
 411
 412 fdelete-null-pointer-checks
 413 Common Report Var(flag_delete_null_pointer_checks) Optimization
 414 Delete useless null pointer checks
 415
 416 fdiagnostics-show-location=
 417 Common Joined RejectNegative
 418 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
 419
 420 fdiagnostics-show-option
 421 Common
 422 Amend appropriate diagnostic messages with the command line option that controls them
 423
 424 fdump-
 425 Common Joined RejectNegative
 426 -fdump-<type>   Dump various compiler internals to a file
 427
 428 fdump-noaddr
 429 Common Report Var(flag_dump_noaddr)
 430 Suppress output of addresses in debugging dumps
 431
 432 fdump-unnumbered
 433 Common Report Var(flag_dump_unnumbered) VarExists
 434 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
 435
 436 fearly-inlining
 437 Common Report Var(flag_early_inlining) Init(1) Optimization
 438 Perform early inlining
 439
 440 feliminate-dwarf2-dups
 441 Common Report Var(flag_eliminate_dwarf2_dups)
 442 Perform DWARF2 duplicate elimination
 443
 444 feliminate-unused-debug-symbols
 445 Common Report Var(flag_debug_only_used_symbols)
 446 Perform unused type elimination in debug info
 447
 448 feliminate-unused-debug-types
 449 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
 450 Perform unused type elimination in debug info
 451
 452 femit-class-debug-always
 453 Common Report Var(flag_emit_class_debug_always) Init(1)
 454 Do not suppress C++ class debug information.
 455
 456 fexceptions
 457 Common Report Var(flag_exceptions) Optimization
 458 Enable exception handling
 459
 460 fexpensive-optimizations
 461 Common Report Var(flag_expensive_optimizations) Optimization
 462 Perform a number of minor, expensive optimizations
 463
 464 ffast-math
 465 Common
 466
 467 ffinite-math-only
 468 Common Report Var(flag_finite_math_only) Optimization
 469 Assume no NaNs or infinities are generated
 470
 471 ffixed-
 472 Common Joined RejectNegative
 473 -ffixed-<register>      Mark <register> as being unavailable to the compiler
 474
 475 ffloat-store
 476 Common Report Var(flag_float_store) Optimization
 477 Don't allocate floats and doubles in extended-precision registers
 478
 479 ; Nonzero for -fforce-addr: load memory address into a register before
 480 ; reference to memory.  This makes better cse but slower compilation.
 481 fforce-addr
 482 Common Report Var(flag_force_addr) Optimization
 483 Copy memory address constants into registers before use
 484
 485 fforward-propagate
 486 Common Report Var(flag_forward_propagate) Optimization
 487 Perform a forward propagation pass on RTL
 488
 489 ; Nonzero means don't put addresses of constant functions in registers.
 490 ; Used for compiling the Unix kernel, where strange substitutions are
 491 ; done on the assembly output.
 492 ffunction-cse
 493 Common Report Var(flag_no_function_cse,0)
 494 Allow function addresses to be held in registers
 495
 496 ffunction-sections
 497 Common Report Var(flag_function_sections)
 498 Place each function into its own section
 499
 500 fgcse
 501 Common Report Var(flag_gcse) Optimization
 502 Perform global common subexpression elimination
 503
 504 fgcse-lm
 505 Common Report Var(flag_gcse_lm) Init(1) Optimization
 506 Perform enhanced load motion during global common subexpression elimination
 507
 508 fgcse-sm
 509 Common Report Var(flag_gcse_sm) Init(0) Optimization
 510 Perform store motion after global common subexpression elimination
 511
 512 fgcse-las
 513 Common Report Var(flag_gcse_las) Init(0) Optimization
 514 Perform redundant load after store elimination in global common subexpression
 515 elimination
 516
 517 fgcse-after-reload
 518 Common Report Var(flag_gcse_after_reload) Optimization
 519 Perform global common subexpression elimination after register allocation
 520 has finished
 521
 522 fguess-branch-probability
 523 Common Report Var(flag_guess_branch_prob) Optimization
 524 Enable guessing of branch probabilities
 525
 526 ; Nonzero means ignore `#ident' directives.  0 means handle them.
 527 ; Generate position-independent code for executables if possible
 528 ; On SVR4 targets, it also controls whether or not to emit a
 529 ; string identifying the compiler.
 530 fident
 531 Common Report Var(flag_no_ident,0)
 532 Process #ident directives
 533
 534 fif-conversion
 535 Common Report Var(flag_if_conversion) Optimization
 536 Perform conversion of conditional jumps to branchless equivalents
 537
 538 fif-conversion2
 539 Common Report Var(flag_if_conversion2) Optimization
 540 Perform conversion of conditional jumps to conditional execution
 541
 542 ; -finhibit-size-directive inhibits output of .size for ELF.
 543 ; This is used only for compiling crtstuff.c,
 544 ; and it may be extended to other effects
 545 ; needed for crtstuff.c on other systems.
 546 finhibit-size-directive
 547 Common Report Var(flag_inhibit_size_directive)
 548 Do not generate .size directives
 549
 550 ; Nonzero means that functions declared `inline' will be treated
 551 ; as `static'.  Prevents generation of zillions of copies of unused
 552 ; static inline functions; instead, `inlines' are written out
 553 ; only when actually used.  Used in conjunction with -g.  Also
 554 ; does the right thing with #pragma interface.
 555 finline
 556 Common Report Var(flag_no_inline,0) Init(2)
 557 Pay attention to the \"inline\" keyword
 558
 559 finline-functions
 560 Common Report Var(flag_inline_functions) Optimization
 561 Integrate simple functions into their callers
 562
 563 finline-functions-called-once
 564 Common Report Var(flag_inline_functions_called_once) Init(1) Optimization
 565 Integrate functions called once into their callers
 566
 567 finline-limit-
 568 Common RejectNegative Joined UInteger
 569
 570 finline-limit=
 571 Common RejectNegative Joined UInteger
 572 -finline-limit=<number> Limit the size of inlined functions to <number>
 573
 574 finstrument-functions
 575 Common Report Var(flag_instrument_function_entry_exit)
 576 Instrument function entry and exit with profiling calls
 577
 578 fipa-cp
 579 Common Report Var(flag_ipa_cp) Optimization
 580 Perform Interprocedural constant propagation
 581
 582 fipa-pure-const
 583 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
 584 Discover pure and const functions
 585
 586 fipa-pta
 587 Common Report Var(flag_ipa_pta) Init(0) Optimization
 588 Perform interprocedural points-to analysis
 589
 590 fipa-reference
 591 Common Report Var(flag_ipa_reference) Init(0) Optimization
 592 Discover readonly and non addressable static variables
 593
 594 fipa-type-escape
 595 Common Report Var(flag_ipa_type_escape) Init(0) Optimization
 596 Type based escape and alias analysis
 597
 598 fipa-matrix-reorg
 599 Common Report Var(flag_ipa_matrix_reorg) Optimization
 600 Perform matrix layout flattening and transposing based
 601 on profiling information.
 602
 603 fivopts
 604 Common Report Var(flag_ivopts) Init(1) Optimization
 605 Optimize induction variables on trees
 606
 607 fjump-tables
 608 Common Var(flag_jump_tables) Init(1) Optimization
 609 Use jump tables for sufficiently large switch statements
 610
 611 fkeep-inline-functions
 612 Common Report Var(flag_keep_inline_functions)
 613 Generate code for functions even if they are fully inlined
 614
 615 fkeep-static-consts
 616 Common Report Var(flag_keep_static_consts) Init(1)
 617 Emit static const variables even if they are not used
 618
 619 fleading-underscore
 620 Common Report Var(flag_leading_underscore) Init(-1)
 621 Give external symbols a leading underscore
 622
 623 floop-optimize
 624 Common
 625 Does nothing.  Preserved for backward compatibility.
 626
 627 fmath-errno
 628 Common Report Var(flag_errno_math) Init(1)
 629 Set errno after built-in math functions
 630
 631 fmem-report
 632 Common Report Var(mem_report)
 633 Report on permanent memory allocation
 634
 635 ; This will attempt to merge constant section constants, if 1 only
 636 ; string constants and constants from constant pool, if 2 also constant
 637 ; variables.
 638 fmerge-all-constants
 639 Common Report Var(flag_merge_constants,2) Init(1) Optimization
 640 Attempt to merge identical constants and constant variables
 641
 642 fmerge-constants
 643 Common Report Var(flag_merge_constants,1) VarExists Optimization
 644 Attempt to merge identical constants across compilation units
 645
 646 fmessage-length=
 647 Common RejectNegative Joined UInteger
 648 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
 649
 650 fmodulo-sched
 651 Common Report Var(flag_modulo_sched) Optimization
 652 Perform SMS based modulo scheduling before the first scheduling pass
 653
 654 fmodulo-sched-allow-regmoves
 655 Common Report Var(flag_modulo_sched_allow_regmoves)
 656 Perform SMS based modulo scheduling with register moves allowed
 657
 658 fmove-loop-invariants
 659 Common Report Var(flag_move_loop_invariants) Init(1) Optimization
 660 Move loop invariant computations out of loops
 661
 662 fmudflap
 663 Common RejectNegative Report Var(flag_mudflap)
 664 Add mudflap bounds-checking instrumentation for single-threaded program
 665
 666 fmudflapth
 667 Common RejectNegative Report VarExists Var(flag_mudflap,2)
 668 Add mudflap bounds-checking instrumentation for multi-threaded program
 669
 670 fmudflapir
 671 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
 672 Ignore read operations when inserting mudflap instrumentation
 673
 674 fdce
 675 Common Var(flag_dce) Init(1) Optimization
 676 Use the RTL dead code elimination pass
 677
 678 fdse
 679 Common Var(flag_dse) Init(1) Optimization
 680 Use the RTL dead store elimination pass
 681
 682 freschedule-modulo-scheduled-loops
 683 Common Report Var(flag_resched_modulo_sched) Optimization
 684 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
 685
 686 fnon-call-exceptions
 687 Common Report Var(flag_non_call_exceptions) Optimization
 688 Support synchronous non-call exceptions
 689
 690 fomit-frame-pointer
 691 Common Report Var(flag_omit_frame_pointer) Optimization
 692 When possible do not generate stack frames
 693
 694 foptimize-register-move
 695 Common Report Var(flag_regmove) Optimization
 696 Do the full register move optimization pass
 697
 698 foptimize-sibling-calls
 699 Common Report Var(flag_optimize_sibling_calls) Optimization
 700 Optimize sibling and tail recursive calls
 701
 702 fpre-ipa-mem-report
 703 Common Report Var(pre_ipa_mem_report)
 704 Report on memory allocation before interprocedural optimization
 705
 706 fpost-ipa-mem-report
 707 Common Report Var(post_ipa_mem_report)
 708 Report on memory allocation before interprocedural optimization
 709
 710 fpack-struct
 711 Common Report Var(flag_pack_struct) Optimization
 712 Pack structure members together without holes
 713
 714 fpack-struct=
 715 Common RejectNegative Joined UInteger Optimization
 716 -fpack-struct=<number>  Set initial maximum structure member alignment
 717
 718 fpcc-struct-return
 719 Common Report Var(flag_pcc_struct_return,1) VarExists
 720 Return small aggregates in memory, not registers
 721
 722 fpeel-loops
 723 Common Report Var(flag_peel_loops) Optimization
 724 Perform loop peeling
 725
 726 fpeephole
 727 Common Report Var(flag_no_peephole,0) Optimization
 728 Enable machine specific peephole optimizations
 729
 730 fpeephole2
 731 Common Report Var(flag_peephole2) Optimization
 732 Enable an RTL peephole pass before sched2
 733
 734 fPIC
 735 Common Report Var(flag_pic,2)
 736 Generate position-independent code if possible (large mode)
 737
 738 fPIE
 739 Common Report Var(flag_pie,2)
 740 Generate position-independent code for executables if possible (large mode)
 741
 742 fpic
 743 Common Report Var(flag_pic,1) VarExists
 744 Generate position-independent code if possible (small mode)
 745
 746 fpie
 747 Common Report Var(flag_pie,1) VarExists
 748 Generate position-independent code for executables if possible (small mode)
 749
 750 fpredictive-commoning
 751 Common Report Var(flag_predictive_commoning) Optimization
 752 Run predictive commoning optimization.
 753
 754 fprefetch-loop-arrays
 755 Common Report Var(flag_prefetch_loop_arrays) Optimization
 756 Generate prefetch instructions, if available, for arrays in loops
 757
 758 fprofile
 759 Common Report Var(profile_flag)
 760 Enable basic program profiling code
 761
 762 fprofile-arcs
 763 Common Report Var(profile_arc_flag)
 764 Insert arc-based program profiling code
 765
 766 fprofile-generate
 767 Common
 768 Enable common options for generating profile info for profile feedback directed optimizations
 769
 770 fprofile-use
 771 Common
 772 Enable common options for performing profile feedback directed optimizations
 773
 774 fprofile-values
 775 Common Report Var(flag_profile_values)
 776 Insert code to profile values of expressions
 777
 778 frandom-seed
 779 Common
 780
 781 frandom-seed=
 782 Common Joined RejectNegative
 783 -frandom-seed=<string>  Make compile reproducible using <string>
 784
 785 ; This switch causes the command line that was used to create an
 786 ; object file to be recorded into the object file.  The exact format
 787 ; of this recording is target and binary file format dependent.
 788 ; It is related to the -fverbose-asm switch, but that switch only
 789 ; records information in the assembler output file as comments, so
 790 ; they never reach the object file.
 791 frecord-gcc-switches
 792 Common Report Var(flag_record_gcc_switches)
 793 Record gcc command line switches in the object file.
 794
 795 freg-struct-return
 796 Common Report Var(flag_pcc_struct_return,0) VarExists Optimization
 797 Return small aggregates in registers
 798
 799 fregmove
 800 Common Report Var(flag_regmove) Optimization
 801 Enables a register move optimization
 802
 803 frename-registers
 804 Common Report Var(flag_rename_registers) Init(2) Optimization
 805 Perform a register renaming optimization pass
 806
 807 freorder-blocks
 808 Common Report Var(flag_reorder_blocks) Optimization
 809 Reorder basic blocks to improve code placement
 810
 811 freorder-blocks-and-partition
 812 Common Report Var(flag_reorder_blocks_and_partition) Optimization
 813 Reorder basic blocks and partition into hot and cold sections
 814
 815 freorder-functions
 816 Common Report Var(flag_reorder_functions) Optimization
 817 Reorder functions to improve code placement
 818
 819 frerun-cse-after-loop
 820 Common Report Var(flag_rerun_cse_after_loop) Init(2) Optimization
 821 Add a common subexpression elimination pass after loop optimizations
 822
 823 frerun-loop-opt
 824 Common
 825 Does nothing.  Preserved for backward compatibility.
 826
 827 frounding-math
 828 Common Report Var(flag_rounding_math) Optimization
 829 Disable optimizations that assume default FP rounding behavior
 830
 831 fsched-interblock
 832 Common Report Var(flag_schedule_interblock) Init(1) Optimization
 833 Enable scheduling across basic blocks
 834
 835 fsched-spec
 836 Common Report Var(flag_schedule_speculative) Init(1) Optimization
 837 Allow speculative motion of non-loads
 838
 839 fsched-spec-load
 840 Common Report Var(flag_schedule_speculative_load) Optimization
 841 Allow speculative motion of some loads
 842
 843 fsched-spec-load-dangerous
 844 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
 845 Allow speculative motion of more loads
 846
 847 fsched-verbose=
 848 Common RejectNegative Joined
 849 -fsched-verbose=<number>        Set the verbosity level of the scheduler
 850
 851 fsched2-use-superblocks
 852 Common Report Var(flag_sched2_use_superblocks) Optimization
 853 If scheduling post reload, do superblock scheduling
 854
 855 fsched2-use-traces
 856 Common Report Var(flag_sched2_use_traces) Optimization
 857 If scheduling post reload, do trace scheduling
 858
 859 fschedule-insns
 860 Common Report Var(flag_schedule_insns) Optimization
 861 Reschedule instructions before register allocation
 862
 863 fschedule-insns2
 864 Common Report Var(flag_schedule_insns_after_reload) Optimization
 865 Reschedule instructions after register allocation
 866
 867 ; sched_stalled_insns means that insns can be moved prematurely from the queue
 868 ; of stalled insns into the ready list.
 869 fsched-stalled-insns
 870 Common Report Var(flag_sched_stalled_insns) Optimization
 871 Allow premature scheduling of queued insns
 872
 873 fsched-stalled-insns=
 874 Common RejectNegative Joined UInteger
 875 -fsched-stalled-insns=<number>  Set number of queued insns that can be prematurely scheduled
 876
 877 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
 878 ; be examined for a dependency on a stalled insn that is candidate for
 879 ; premature removal from the queue of stalled insns into the ready list (has
 880 ; an effect only if the flag 'sched_stalled_insns' is set).
 881 fsched-stalled-insns-dep
 882 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization
 883 Set dependence distance checking in premature scheduling of queued insns
 884
 885 fsched-stalled-insns-dep=
 886 Common RejectNegative Joined UInteger
 887 -fsched-stalled-insns-dep=<number>      Set dependence distance checking in premature scheduling of queued insns
 888
 889 fsection-anchors
 890 Common Report Var(flag_section_anchors) Optimization
 891 Access data in the same section from shared anchor points
 892
 893 frtl-abstract-sequences
 894 Common Report Var(flag_rtl_seqabstr) Optimization
 895 Perform sequence abstraction optimization on RTL
 896
 897 fsee
 898 Common Report Var(flag_see) Init(0)
 899 Eliminate redundant sign extensions using LCM.
 900
 901 fshow-column
 902 Common C ObjC C++ ObjC++ Report Var(flag_show_column) Init(1)
 903 Show column numbers in diagnostics, when available.  Default on
 904
 905 fsignaling-nans
 906 Common Report Var(flag_signaling_nans) Optimization
 907 Disable optimizations observable by IEEE signaling NaNs
 908
 909 fsigned-zeros
 910 Common Report Var(flag_signed_zeros) Init(1) Optimization
 911 Disable floating point optimizations that ignore the IEEE signedness of zero
 912
 913 fsingle-precision-constant
 914 Common Report Var(flag_single_precision_constant) Optimization
 915 Convert floating point constants to single precision constants
 916
 917 fsplit-ivs-in-unroller
 918 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
 919 Split lifetimes of induction variables when loops are unrolled
 920
 921 fsplit-wide-types
 922 Common Report Var(flag_split_wide_types) Optimization
 923 Split wide types into independent registers
 924
 925 fvariable-expansion-in-unroller
 926 Common Report Var(flag_variable_expansion_in_unroller) Optimization
 927 Apply variable expansion when loops are unrolled
 928
 929 ; Emit code to probe the stack, to help detect stack overflow; also
 930 ; may cause large objects to be allocated dynamically.
 931 fstack-check
 932 Common Report Var(flag_stack_check)
 933 Insert stack checking code into the program
 934
 935 fstack-limit
 936 Common
 937
 938 fstack-limit-register=
 939 Common RejectNegative Joined
 940 -fstack-limit-register=<register>       Trap if the stack goes past <register>
 941
 942 fstack-limit-symbol=
 943 Common RejectNegative Joined
 944 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
 945
 946 fstack-protector
 947 Common Report Var(flag_stack_protect, 1)
 948 Use propolice as a stack protection method
 949
 950 fstack-protector-all
 951 Common Report RejectNegative Var(flag_stack_protect, 2) VarExists
 952 Use a stack protection method for every function
 953
 954 fstrength-reduce
 955 Common
 956 Does nothing.  Preserved for backward compatibility.
 957
 958 ; Nonzero if we should do (language-dependent) alias analysis.
 959 ; Typically, this analysis will assume that expressions of certain
 960 ; types do not alias expressions of certain other types.  Only used
 961 ; if alias analysis (in general) is enabled.
 962 fstrict-aliasing
 963 Common Report Var(flag_strict_aliasing) Optimization
 964 Assume strict aliasing rules apply
 965
 966 fstrict-overflow
 967 Common Report Var(flag_strict_overflow)
 968 Treat signed overflow as undefined
 969
 970 fsyntax-only
 971 Common Report Var(flag_syntax_only)
 972 Check for syntax errors, then stop
 973
 974 ftest-coverage
 975 Common Report Var(flag_test_coverage)
 976 Create data files needed by \"gcov\"
 977
 978 fthread-jumps
 979 Common Report Var(flag_thread_jumps) Optimization
 980 Perform jump threading optimizations
 981
 982 ftime-report
 983 Common Report Var(time_report)
 984 Report the time taken by each compiler pass
 985
 986 ftls-model=
 987 Common Joined RejectNegative
 988 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
 989
 990 ftoplevel-reorder
 991 Common Report Var(flag_toplevel_reorder) Init(1) Optimization
 992 Reorder top level functions, variables, and asms
 993
 994 ftracer
 995 Common Report Var(flag_tracer)
 996 Perform superblock formation via tail duplication
 997
 998 ; Zero means that floating-point math operations cannot generate a
 999 ; (user-visible) trap.  This is the case, for example, in nonstop
1000 ; IEEE 754 arithmetic.
1001 ftrapping-math
1002 Common Report Var(flag_trapping_math) Init(1) Optimization
1003 Assume floating-point operations can trap
1004
1005 ftrapv
1006 Common Report Var(flag_trapv) Optimization
1007 Trap for signed overflow in addition, subtraction and multiplication
1008
1009 ftree-ccp
1010 Common Report Var(flag_tree_ccp) Optimization
1011 Enable SSA-CCP optimization on trees
1012
1013 ftree-store-ccp
1014 Common Report Var(flag_tree_store_ccp) Optimization
1015 Enable SSA-CCP optimization for stores and loads
1016
1017 ftree-ch
1018 Common Report Var(flag_tree_ch) Optimization
1019 Enable loop header copying on trees
1020
1021 ftree-copyrename
1022 Common Report Var(flag_tree_copyrename) Optimization
1023 Replace SSA temporaries with better names in copies
1024
1025 ftree-copy-prop
1026 Common Report Var(flag_tree_copy_prop) Optimization
1027 Enable copy propagation on trees
1028
1029 ftree-store-copy-prop
1030 Common Report Var(flag_tree_store_copy_prop) Optimization
1031 Enable copy propagation for stores and loads
1032
1033 ftree-dce
1034 Common Report Var(flag_tree_dce) Optimization
1035 Enable SSA dead code elimination optimization on trees
1036
1037 ftree-dominator-opts
1038 Common Report Var(flag_tree_dom) Optimization
1039 Enable dominator optimizations
1040
1041 ftree-dse
1042 Common Report Var(flag_tree_dse) Optimization
1043 Enable dead store elimination
1044
1045 ftree-fre
1046 Common Report Var(flag_tree_fre) Optimization
1047 Enable Full Redundancy Elimination (FRE) on trees
1048
1049 ftree-loop-im
1050 Common Report Var(flag_tree_loop_im) Init(1) Optimization
1051 Enable loop invariant motion on trees
1052
1053 ftree-loop-linear
1054 Common Report Var(flag_tree_loop_linear) Optimization
1055 Enable linear loop transforms on trees
1056
1057 ftree-loop-ivcanon
1058 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
1059 Create canonical induction variables in loops
1060
1061 ftree-loop-optimize
1062 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
1063 Enable loop optimizations on tree level
1064
1065 ftree-pre
1066 Common Report Var(flag_tree_pre) Optimization
1067 Enable SSA-PRE optimization on trees
1068
1069 ftree-reassoc
1070 Common Report Var(flag_tree_reassoc) Init(1) Optimization
1071 Enable reassociation on tree level
1072
1073 ftree-salias
1074 Common Report Var(flag_tree_salias) Optimization
1075 Perform structural alias analysis
1076
1077 ftree-sink
1078 Common Report Var(flag_tree_sink) Optimization
1079 Enable SSA code sinking on trees
1080
1081 ftree-sra
1082 Common Report Var(flag_tree_sra) Optimization
1083 Perform scalar replacement of aggregates
1084
1085 ftree-ter
1086 Common Report Var(flag_tree_ter) Optimization
1087 Replace temporary expressions in the SSA->normal pass
1088
1089 ftree-lrs
1090 Common Report Var(flag_tree_live_range_split) Optimization
1091 Perform live range splitting during the SSA->normal pass
1092
1093 ftree-vrp
1094 Common Report Var(flag_tree_vrp) Init(0) Optimization
1095 Perform Value Range Propagation on trees
1096
1097 funit-at-a-time
1098 Common Report Var(flag_unit_at_a_time) Optimization
1099 Compile whole compilation unit at a time
1100
1101 funroll-loops
1102 Common Report Var(flag_unroll_loops) Optimization
1103 Perform loop unrolling when iteration count is known
1104
1105 funroll-all-loops
1106 Common Report Var(flag_unroll_all_loops) Optimization
1107 Perform loop unrolling for all loops
1108
1109 ; Nonzero means that loop optimizer may assume that the induction variables
1110 ; that control loops do not overflow and that the loops with nontrivial
1111 ; exit condition are not infinite
1112 funsafe-loop-optimizations
1113 Common Report Var(flag_unsafe_loop_optimizations) Optimization
1114 Allow loop optimizations to assume that the loops behave in normal way
1115
1116 ; Nonzero means that unsafe floating-point math optimizations are allowed
1117 ; for the sake of speed.  IEEE compliance is not guaranteed, and operations
1118 ; are allowed to assume that their arguments and results are "normal"
1119 ; (e.g., nonnegative for SQRT).
1120 funsafe-math-optimizations
1121 Common Report Var(flag_unsafe_math_optimizations) Optimization
1122 Allow math optimizations that may violate IEEE or ISO standards
1123
1124 funswitch-loops
1125 Common Report Var(flag_unswitch_loops) Optimization
1126 Perform loop unswitching
1127
1128 funwind-tables
1129 Common Report Var(flag_unwind_tables) Optimization
1130 Just generate unwind tables for exception handling
1131
1132 fvar-tracking
1133 Common Report Var(flag_var_tracking) VarExists Optimization
1134 Perform variable tracking
1135
1136 fvar-tracking-uninit
1137 Common Report Var(flag_var_tracking_uninit) Optimization
1138 Perform variable tracking and also tag variables that are uninitialized
1139
1140 ftree-vectorize
1141 Common Report Var(flag_tree_vectorize) Optimization
1142 Enable loop vectorization on trees
1143
1144 fvect-cost-model
1145 Common Report Var(flag_vect_cost_model) Optimization
1146 Enable use of cost model in vectorization
1147
1148 ftree-vect-loop-version
1149 Common Report Var(flag_tree_vect_loop_version) Init(1) Optimization
1150 Enable loop versioning when doing loop vectorization on trees
1151
1152 ftree-vectorizer-verbose=
1153 Common RejectNegative Joined
1154 -ftree-vectorizer-verbose=<number>      Set the verbosity level of the vectorizer
1155
1156 ftree-scev-cprop
1157 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
1158 Enable copy propagation of scalar-evolution information.
1159
1160 ; -fverbose-asm causes extra commentary information to be produced in
1161 ; the generated assembly code (to make it more readable).  This option
1162 ; is generally only of use to those who actually need to read the
1163 ; generated assembly code (perhaps while debugging the compiler itself).
1164 ; -fno-verbose-asm, the default, causes the extra information
1165 ; to not be added and is useful when comparing two assembler files.
1166 fverbose-asm
1167 Common Report Var(flag_verbose_asm)
1168 Add extra commentary to assembler output
1169
1170 fvisibility=
1171 Common Joined RejectNegative
1172 -fvisibility=[default|internal|hidden|protected]        Set the default symbol visibility
1173
1174
1175 fvpt
1176 Common Report Var(flag_value_profile_transformations) Optimization
1177 Use expression value profiles in optimizations
1178
1179 fweb
1180 Common Report Var(flag_web) Init(2) Optimization
1181 Construct webs and split unrelated uses of single variable
1182
1183 fwhole-program
1184 Common Report Var(flag_whole_program) Init(0) Optimization
1185 Perform whole program optimizations
1186
1187 fwrapv
1188 Common Report Var(flag_wrapv) Optimization
1189 Assume signed arithmetic overflow wraps around
1190
1191 fzero-initialized-in-bss
1192 Common Report Var(flag_zero_initialized_in_bss) Init(1)
1193 Put zero initialized data in the bss section
1194
1195 g
1196 Common JoinedOrMissing
1197 Generate debug information in default format
1198
1199 gcoff
1200 Common JoinedOrMissing Negative(gdwarf-2)
1201 Generate debug information in COFF format
1202
1203 gdwarf-2
1204 Common JoinedOrMissing Negative(gstabs)
1205 Generate debug information in DWARF v2 format
1206
1207 ggdb
1208 Common JoinedOrMissing
1209 Generate debug information in default extended format
1210
1211 gstabs
1212 Common JoinedOrMissing Negative(gstabs+)
1213 Generate debug information in STABS format
1214
1215 gstabs+
1216 Common JoinedOrMissing Negative(gvms)
1217 Generate debug information in extended STABS format
1218
1219 gvms
1220 Common JoinedOrMissing Negative(gxcoff)
1221 Generate debug information in VMS format
1222
1223 gxcoff
1224 Common JoinedOrMissing Negative(gxcoff+)
1225 Generate debug information in XCOFF format
1226
1227 gxcoff+
1228 Common JoinedOrMissing Negative(gcoff)
1229 Generate debug information in extended XCOFF format
1230
1231 o
1232 Common Joined Separate
1233 -o <file>       Place output into <file>
1234
1235 p
1236 Common Var(profile_flag)
1237 Enable function profiling
1238
1239 pedantic
1240 Common Var(pedantic)
1241 Issue warnings needed for strict compliance to the standard
1242
1243 pedantic-errors
1244 Common
1245 Like -pedantic but issue them as errors
1246
1247 quiet
1248 Common Var(quiet_flag)
1249 Do not display functions compiled or elapsed time
1250
1251 version
1252 Common Var(version_flag)
1253 Display the compiler's version
1254
1255 w
1256 Common Var(inhibit_warnings)
1257 Suppress warnings
1258
1259 ; This comment is to ensure we retain the blank line above.