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