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