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