gcc/common.opt

   1 ; Options for the language- and target-independent parts of the compiler.
   2
   3 ; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
   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 Variable
  27 int target_flags
  28
  29 Variable
  30 int optimize
  31
  32 Variable
  33 int optimize_size
  34
  35 ; 0 means straightforward implementation of complex divide acceptable.
  36 ; 1 means wide ranges of inputs must work for complex divide.
  37 ; 2 means C99-like requirements for complex multiply and divide.
  38 Variable
  39 int flag_complex_method = 1
  40
  41 ; Nonzero if subexpressions must be evaluated from left-to-right.
  42 Variable
  43 int flag_evaluation_order = 0
  44
  45 ; Language specific warning pass for unused results.
  46 Variable
  47 bool flag_warn_unused_result = false
  48
  49 Variable
  50 int *param_values
  51
  52 ; Nonzero if we should write GIMPLE bytecode for link-time optimization.
  53 Variable
  54 int flag_generate_lto
  55
  56 ; True to warn about any objects definitions whose size is larger
  57 ; than N bytes.  Also want about function definitions whose returned
  58 ; values are larger than N bytes, where N is 'larger_than_size'.
  59 Variable
  60 bool warn_larger_than
  61
  62 Variable
  63 HOST_WIDE_INT larger_than_size
  64
  65 ; True to warn about any function whose frame size is larger
  66 ; than N bytes.
  67 Variable
  68 bool warn_frame_larger_than
  69
  70 Variable
  71 HOST_WIDE_INT frame_larger_than_size
  72
  73 ; Nonzero means we should be saving declaration info into a .X file.
  74 Variable
  75 int flag_gen_aux_info = 0
  76
  77 ; Nonzero if we are compiling code for a shared library, zero for
  78 ; executable.
  79 Variable
  80 int flag_shlib
  81
  82 ; These two are really VEC(char_p,heap) *.
  83
  84 Variable
  85 void *flag_instrument_functions_exclude_functions
  86
  87 Variable
  88 void *flag_instrument_functions_exclude_files
  89
  90 ; Generic structs (e.g. templates not explicitly specialized)
  91 ; may not have a compilation unit associated with them, and so
  92 ; may need to be treated differently from ordinary structs.
  93 ;
  94 ; Structs only handled by reference (indirectly), will also usually
  95 ; not need as much debugging information.
  96
  97 Variable
  98 enum debug_struct_file debug_struct_ordinary[DINFO_USAGE_NUM_ENUMS] = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY }
  99
 100 Variable
 101 enum debug_struct_file debug_struct_generic[DINFO_USAGE_NUM_ENUMS] = { DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY, DINFO_STRUCT_FILE_ANY }
 102
 103 ; True if we should exit after parsing options.
 104 Variable
 105 bool exit_after_options
 106
 107 ; Type(s) of debugging information we are producing (if any).  See
 108 ; flag-types.h for the definitions of the different possible types of
 109 ; debugging information.
 110 Variable
 111 enum debug_info_type write_symbols = NO_DEBUG
 112
 113 ; Level of debugging information we are producing.  See flag-types.h
 114 ; for the definitions of the different possible levels.
 115 Variable
 116 enum debug_info_levels debug_info_level = DINFO_LEVEL_NONE
 117
 118 ; Nonzero means use GNU-only extensions in the generated symbolic
 119 ; debugging information.  Currently, this only has an effect when
 120 ; write_symbols is set to DBX_DEBUG, XCOFF_DEBUG, or DWARF_DEBUG.
 121 Variable
 122 bool use_gnu_debug_info_extensions
 123
 124 ; Original value of maximum field alignment in bytes, specified via
 125 ; -fpack-struct=<value>.
 126 Variable
 127 unsigned int initial_max_fld_align = TARGET_DEFAULT_PACK_STRUCT
 128
 129 Variable
 130 enum vect_verbosity_levels user_vect_verbosity_level = MAX_VERBOSITY_LEVEL
 131
 132 ; Type of stack check.
 133 Variable
 134 enum stack_check_type flag_stack_check = NO_STACK_CHECK
 135
 136 ; -dA causes debug commentary information to be produced in
 137 ; the generated assembly code (to make it more readable).  This option
 138 ; is generally only of use to those who actually need to read the
 139 ; generated assembly code (perhaps while debugging the compiler itself).
 140 ; Currently, this switch is only used by dwarf2out.c; however, it is intended
 141 ; to be a catchall for printing debug information in the assembler file.
 142 Variable
 143 int flag_debug_asm
 144
 145 ; -dP causes the rtl to be emitted as a comment in assembly.
 146 Variable
 147 int flag_dump_rtl_in_asm
 148
 149 ; Whether -da was passed (used only in handle_common_deferred_options).
 150 Variable
 151 bool flag_dump_all_passed
 152
 153 ; Other flags saying which kinds of debugging dump have been requested.
 154
 155 Variable
 156 int rtl_dump_and_exit
 157
 158 Variable
 159 int flag_print_asm_name
 160
 161 Variable
 162 enum graph_dump_types graph_dump_format = no_graph
 163
 164 ; Name of top-level original source file (what was input to cpp).
 165 ; This comes from the #-command at the beginning of the actual input.
 166 ; If there isn't any there, then this is the cc1 input file name.
 167 Variable
 168 const char *main_input_filename
 169
 170 ; Pointer to base name in main_input_filename, with directories and a
 171 ; single final extension removed, and the length of this base
 172 ; name.
 173
 174 Variable
 175 const char *main_input_basename
 176
 177 Variable
 178 int main_input_baselength
 179
 180 ; Which options have been printed by --help.
 181 Variable
 182 char *help_printed
 183
 184 ; Which enums have been printed by --help.  0 = not printed, no
 185 ; relevant options seen, 1 = relevant option seen, not yet printed, 2
 186 ; = printed.
 187 Variable
 188 char *help_enum_printed
 189
 190 ; The number of columns for --help output.
 191 Variable
 192 unsigned int help_columns
 193
 194 ; Whether this options structure has been through finish_options
 195 Variable
 196 bool flag_opts_finished
 197
 198 ###
 199 Driver
 200
 201 -assemble
 202 Driver Alias(S)
 203
 204 -compile
 205 Driver Alias(c)
 206
 207 -coverage
 208 Driver Alias(coverage)
 209
 210 -debug
 211 Common Alias(g)
 212
 213 -dump
 214 Common Separate Alias(d)
 215
 216 -dump=
 217 Common Joined Alias(d)
 218
 219 -dumpbase
 220 Common Separate Alias(dumpbase)
 221
 222 -dumpdir
 223 Common Separate Alias(dumpdir)
 224
 225 -entry
 226 Driver Separate Alias(e)
 227
 228 -entry=
 229 Driver Joined Alias(e)
 230
 231 -extra-warnings
 232 Common Warning Alias(Wextra)
 233
 234 -for-assembler
 235 Driver Separate Alias(Xassembler)
 236
 237 -for-assembler=
 238 Driver JoinedOrMissing Alias(Xassembler)
 239
 240 -for-linker
 241 Driver Separate Alias(Xlinker)
 242
 243 -for-linker=
 244 Driver JoinedOrMissing Alias(Xlinker)
 245
 246 -force-link
 247 Driver Separate Alias(u)
 248
 249 -force-link=
 250 Driver Joined Alias(u)
 251
 252 -help
 253 Common Driver Var(help_flag)
 254 Display this information
 255
 256 -help=
 257 Common Driver Report Joined
 258 --help=<class>  Display descriptions of a specific class of options.  <class> is one or more of optimizers, target, warnings, undocumented, params
 259
 260 -language
 261 Driver Separate Alias(x)
 262
 263 -language=
 264 Driver Joined Alias(x)
 265
 266 -library-directory
 267 Driver Separate Alias(L)
 268
 269 -library-directory=
 270 Driver Joined Alias(L)
 271
 272 -no-canonical-prefixes
 273 Driver Alias(no-canonical-prefixes)
 274
 275 -no-standard-libraries
 276 Driver Alias(nostdlib)
 277
 278 -no-warnings
 279 Common Alias(w)
 280
 281 -optimize
 282 Common Alias(O)
 283
 284 -output
 285 Common Driver Separate Alias(o) MissingArgError(missing filename after %qs)
 286
 287 -output=
 288 Common Driver Joined Alias(o) MissingArgError(missing filename after %qs)
 289
 290 -pass-exit-codes
 291 Driver Alias(pass-exit-codes)
 292
 293 -pedantic
 294 Common Alias(pedantic)
 295
 296 -pedantic-errors
 297 Common Alias(pedantic-errors)
 298
 299 -pie
 300 Common Alias(pie)
 301
 302 -pipe
 303 Driver Alias(pipe)
 304
 305 -prefix
 306 Driver Separate Alias(B)
 307
 308 -prefix=
 309 Driver JoinedOrMissing Alias(B)
 310
 311 -preprocess
 312 Driver Alias(E)
 313
 314 -print-file-name
 315 Driver Separate Alias(print-file-name=)
 316
 317 -print-file-name=
 318 Driver JoinedOrMissing Alias(print-file-name=)
 319
 320 -print-libgcc-file-name
 321 Driver Alias(print-libgcc-file-name)
 322
 323 -print-multi-directory
 324 Driver Alias(print-multi-directory)
 325
 326 -print-multi-lib
 327 Driver Alias(print-multi-lib)
 328
 329 -print-multi-os-directory
 330 Driver Alias(print-multi-os-directory)
 331
 332 -print-prog-name
 333 Driver Separate Alias(print-prog-name=)
 334
 335 -print-prog-name=
 336 Driver JoinedOrMissing Alias(print-prog-name=)
 337
 338 -print-search-dirs
 339 Driver Alias(print-search-dirs)
 340
 341 -print-sysroot
 342 Driver Alias(print-sysroot)
 343
 344 -print-sysroot-headers-suffix
 345 Driver Alias(print-sysroot-headers-suffix)
 346
 347 -profile
 348 Common Alias(p)
 349
 350 -save-temps
 351 Driver Alias(save-temps)
 352
 353 -shared
 354 Common Alias(shared)
 355
 356 -specs
 357 Driver Separate Alias(specs=)
 358
 359 -specs=
 360 Driver Joined Alias(specs=)
 361
 362 -static
 363 Driver Alias(static)
 364
 365 -symbolic
 366 Driver Alias(symbolic)
 367
 368 -target-help
 369 Common Driver
 370 Alias for --help=target
 371
 372 -time
 373 Driver Alias(time)
 374
 375 -verbose
 376 Driver Alias(v)
 377
 378 ;; The driver used to convert options such as --help into forms such
 379 ;; as -fhelp; the following four entries are for compatibility with
 380 ;; any direct uses of those (undocumented) -f forms
 381 fhelp
 382 Common Driver Alias(-help)
 383
 384 fhelp=
 385 Common Driver Joined Alias(-help=)
 386
 387 ftarget-help
 388 Common Driver Alias(-target-help)
 389
 390 fversion
 391 Common Driver Alias(-version)
 392
 393 -param
 394 Common Separate
 395 --param <param>=<value> Set parameter <param> to value.  See below for a complete list of parameters
 396
 397 -param=
 398 Common Joined Alias(-param)
 399
 400 -sysroot
 401 Driver Separate Alias(-sysroot=)
 402
 403 -sysroot=
 404 Driver JoinedOrMissing
 405
 406 -version
 407 Common Driver
 408
 409 B
 410 Driver Joined Separate
 411
 412 E
 413 Driver
 414
 415 L
 416 Driver Joined Separate
 417
 418 N
 419 Driver
 420
 421 O
 422 Common JoinedOrMissing Optimization
 423 -O<number>      Set optimization level to <number>
 424
 425 Os
 426 Common Optimization
 427 Optimize for space rather than speed
 428
 429 Ofast
 430 Common Optimization
 431 Optimize for speed disregarding exact standards compliance
 432
 433 Q
 434 Driver
 435
 436 Qn
 437 Driver Negative(Qy)
 438
 439 Qy
 440 Driver Negative(Qn)
 441
 442 R
 443 Driver Joined Separate
 444
 445 S
 446 Driver
 447
 448 T
 449 Driver Joined Separate
 450
 451 Tbss
 452 Driver Separate
 453
 454 Tdata
 455 Driver Separate
 456
 457 Ttext
 458 Driver Separate
 459
 460 W
 461 Common RejectNegative Warning Alias(Wextra)
 462 This switch is deprecated; use -Wextra instead
 463
 464 Wa,
 465 Driver JoinedOrMissing
 466
 467 Wl,
 468 Driver JoinedOrMissing
 469
 470 Wp,
 471 Driver JoinedOrMissing
 472
 473 Waggregate-return
 474 Common Var(warn_aggregate_return) Warning
 475 Warn about returning structures, unions or arrays
 476
 477 Warray-bounds
 478 Common Var(warn_array_bounds) Warning
 479 Warn if an array is accessed out of bounds
 480
 481 Wattributes
 482 Common Var(warn_attributes) Init(1) Warning
 483 Warn about inappropriate attribute usage
 484
 485 Wcast-align
 486 Common Var(warn_cast_align) Warning
 487 Warn about pointer casts which increase alignment
 488
 489 Wcpp
 490 Common Var(warn_cpp) Init(1) Warning
 491 Warn when a #warning directive is encountered
 492
 493 Wdeprecated-declarations
 494 Common Var(warn_deprecated_decl) Init(1) Warning
 495 Warn about uses of __attribute__((deprecated)) declarations
 496
 497 Wdisabled-optimization
 498 Common Var(warn_disabled_optimization) Warning
 499 Warn when an optimization pass is disabled
 500
 501 Werror
 502 Common Var(warnings_are_errors)
 503 Treat all warnings as errors
 504
 505 Werror=
 506 Common Joined
 507 Treat specified warning as error
 508
 509 Wextra
 510 Common Var(extra_warnings) Warning
 511 Print extra (possibly unwanted) warnings
 512
 513 Wfatal-errors
 514 Common Var(flag_fatal_errors)
 515 Exit on the first error occurred
 516
 517 Wframe-larger-than=
 518 Common RejectNegative Joined UInteger
 519 -Wframe-larger-than=<number>    Warn if a function's stack frame requires more than <number> bytes
 520
 521 Winline
 522 Common Var(warn_inline) Warning
 523 Warn when an inlined function cannot be inlined
 524
 525 Wlarger-than-
 526 Common RejectNegative Joined Warning Undocumented Alias(Wlarger-than=)
 527
 528 Wlarger-than=
 529 Common RejectNegative Joined UInteger Warning
 530 -Wlarger-than=<number>  Warn if an object is larger than <number> bytes
 531
 532 Wunsafe-loop-optimizations
 533 Common Var(warn_unsafe_loop_optimizations) Warning
 534 Warn if the loop cannot be optimized due to nontrivial assumptions.
 535
 536 Wmissing-noreturn
 537 Common Var(warn_missing_noreturn) Warning
 538 Warn about functions which might be candidates for __attribute__((noreturn))
 539
 540 Wmudflap
 541 Common Var(warn_mudflap) Init(1) Warning
 542 Warn about constructs not instrumented by -fmudflap
 543
 544 Woverflow
 545 Common Var(warn_overflow) Init(1) Warning
 546 Warn about overflow in arithmetic expressions
 547
 548 Wpacked
 549 Common Var(warn_packed) Warning
 550 Warn when the packed attribute has no effect on struct layout
 551
 552 Wpadded
 553 Common Var(warn_padded) Warning
 554 Warn when padding is required to align structure members
 555
 556 Wshadow
 557 Common Var(warn_shadow) Warning
 558 Warn when one local variable shadows another
 559
 560 Wstack-protector
 561 Common Var(warn_stack_protect) Warning
 562 Warn when not issuing stack smashing protection for some reason
 563
 564 Wstrict-aliasing
 565 Common Warning
 566 Warn about code which might break strict aliasing rules
 567
 568 Wstrict-aliasing=
 569 Common Joined RejectNegative UInteger Var(warn_strict_aliasing) Init(-1) Warning
 570 Warn about code which might break strict aliasing rules
 571
 572 Wstrict-overflow
 573 Common Warning
 574 Warn about optimizations that assume that signed overflow is undefined
 575
 576 Wstrict-overflow=
 577 Common Joined RejectNegative UInteger Var(warn_strict_overflow) Init(-1) Warning
 578 Warn about optimizations that assume that signed overflow is undefined
 579
 580 Wsuggest-attribute=const
 581 Common Var(warn_suggest_attribute_const) Warning
 582 Warn about functions which might be candidates for __attribute__((const))
 583
 584 Wsuggest-attribute=pure
 585 Common Var(warn_suggest_attribute_pure) Warning
 586 Warn about functions which might be candidates for __attribute__((pure))
 587
 588 Wsuggest-attribute=noreturn
 589 Common Var(warn_suggest_attribute_noreturn) Warning
 590 Warn about functions which might be candidates for __attribute__((noreturn))
 591
 592 Wswitch
 593 Common Var(warn_switch) Warning
 594 Warn about enumerated switches, with no default, missing a case
 595
 596 Wswitch-default
 597 Common Var(warn_switch_default) Warning
 598 Warn about enumerated switches missing a \"default:\" statement
 599
 600 Wswitch-enum
 601 Common Var(warn_switch_enum) Warning
 602 Warn about all enumerated switches missing a specific case
 603
 604 Wsystem-headers
 605 Common Var(warn_system_headers) Warning
 606 Do not suppress warnings from system headers
 607
 608 Wtrampolines
 609 Common Var(warn_trampolines) Warning
 610 Warn whenever a trampoline is generated
 611
 612 Wtype-limits
 613 Common Var(warn_type_limits) Init(-1) Warning
 614 Warn if a comparison is always true or always false due to the limited range of the data type
 615
 616 Wuninitialized
 617 Common Var(warn_uninitialized) Init(-1) Warning
 618 Warn about uninitialized automatic variables
 619
 620 Wunreachable-code
 621 Common Ignore
 622 Does nothing. Preserved for backward compatibility.
 623
 624 Wunused
 625 Common Var(warn_unused) Init(0) Warning
 626 Enable all -Wunused- warnings
 627
 628 Wunused-but-set-parameter
 629 Common Var(warn_unused_but_set_parameter) Init(-1) Warning
 630 Warn when a function parameter is only set, otherwise unused
 631
 632 Wunused-but-set-variable
 633 Common Var(warn_unused_but_set_variable) Init(-1) Warning
 634 Warn when a variable is only set, otherwise unused
 635
 636 Wunused-function
 637 Common Var(warn_unused_function) Init(-1) Warning
 638 Warn when a function is unused
 639
 640 Wunused-label
 641 Common Var(warn_unused_label) Init(-1) Warning
 642 Warn when a label is unused
 643
 644 Wunused-parameter
 645 Common Var(warn_unused_parameter) Init(-1) Warning
 646 Warn when a function parameter is unused
 647
 648 Wunused-value
 649 Common Var(warn_unused_value) Init(-1) Warning
 650 Warn when an expression value is unused
 651
 652 Wunused-variable
 653 Common Var(warn_unused_variable) Init(-1) Warning
 654 Warn when a variable is unused
 655
 656 Wcoverage-mismatch
 657 Common Var(warn_coverage_mismatch) Init(1) Warning
 658 Warn in case profiles in -fprofile-use do not match
 659
 660 Xassembler
 661 Driver Separate
 662
 663 Xlinker
 664 Driver Separate
 665
 666 Xpreprocessor
 667 Driver Separate
 668
 669 Z
 670 Driver
 671
 672 aux-info
 673 Common Separate Var(aux_info_file_name)
 674 -aux-info <file>        Emit declaration information into <file>
 675
 676 aux-info=
 677 Common Joined Alias(aux-info)
 678
 679 auxbase
 680 Common Separate RejectDriver Var(aux_base_name)
 681
 682 auxbase-strip
 683 Common Separate RejectDriver
 684
 685 coverage
 686 Driver
 687
 688 c
 689 Driver
 690
 691 d
 692 Common Joined
 693 -d<letters>     Enable dumps from specific passes of the compiler
 694
 695 dumpbase
 696 Common Separate Var(dump_base_name)
 697 -dumpbase <file>        Set the file basename to be used for dumps
 698
 699 dumpdir
 700 Common Separate Var(dump_dir_name)
 701 -dumpdir <dir>  Set the directory name to be used for dumps
 702
 703 dumpmachine
 704 Driver
 705
 706 dumpspecs
 707 Driver
 708
 709 dumpversion
 710 Driver
 711
 712 e
 713 Driver Joined Separate
 714
 715 ; The version of the C++ ABI in use.  The following values are allowed:
 716 ;
 717 ; 0: The version of the ABI believed most conformant with the C++ ABI
 718 ;    specification.  This ABI may change as bugs are discovered and fixed.
 719 ;    Therefore, 0 will not necessarily indicate the same ABI in different
 720 ;    versions of G++.
 721 ;
 722 ; 1: The version of the ABI first used in G++ 3.2.
 723 ;
 724 ; 2: The version of the ABI first used in G++ 3.4 (and current default).
 725 ;
 726 ; 3: The version of the ABI that fixes the missing underscore
 727 ;    in template non-type arguments of pointer type.
 728 ;
 729 ; 4: The version of the ABI that introduces unambiguous mangling of
 730 ;    vector types.
 731 ;
 732 ; Additional positive integers will be assigned as new versions of
 733 ; the ABI become the default version of the ABI.
 734 fabi-version=
 735 Common Joined RejectNegative UInteger Var(flag_abi_version) Init(2)
 736
 737 falign-functions
 738 Common Report Var(align_functions,0) Optimization UInteger
 739 Align the start of functions
 740
 741 falign-functions=
 742 Common RejectNegative Joined UInteger Var(align_functions)
 743
 744 falign-jumps
 745 Common Report Var(align_jumps,0) Optimization UInteger
 746 Align labels which are only reached by jumping
 747
 748 falign-jumps=
 749 Common RejectNegative Joined UInteger Var(align_jumps)
 750
 751 falign-labels
 752 Common Report Var(align_labels,0) Optimization UInteger
 753 Align all labels
 754
 755 falign-labels=
 756 Common RejectNegative Joined UInteger Var(align_labels)
 757
 758 falign-loops
 759 Common Report Var(align_loops,0) Optimization UInteger
 760 Align the start of loops
 761
 762 falign-loops=
 763 Common RejectNegative Joined UInteger Var(align_loops)
 764
 765 fargument-alias
 766 Common Ignore
 767 Does nothing. Preserved for backward compatibility.
 768
 769 fargument-noalias
 770 Common Ignore
 771 Does nothing. Preserved for backward compatibility.
 772
 773 fargument-noalias-global
 774 Common Ignore
 775 Does nothing. Preserved for backward compatibility.
 776
 777 fargument-noalias-anything
 778 Common Ignore
 779 Does nothing. Preserved for backward compatibility.
 780
 781 fasynchronous-unwind-tables
 782 Common Report Var(flag_asynchronous_unwind_tables) Optimization
 783 Generate unwind tables that are exact at each instruction boundary
 784
 785 fauto-inc-dec
 786 Common Report Var(flag_auto_inc_dec) Init(1)
 787 Generate auto-inc/dec instructions
 788
 789 ; -fcheck-bounds causes gcc to generate array bounds checks.
 790 ; For C, C++ and ObjC: defaults off.
 791 ; For Java: defaults to on.
 792 ; For Fortran: defaults to off.
 793 fbounds-check
 794 Common Report Var(flag_bounds_check)
 795 Generate code to check bounds before indexing arrays
 796
 797 fbranch-count-reg
 798 Common Report Var(flag_branch_on_count_reg) Init(1) Optimization
 799 Replace add, compare, branch with branch on count register
 800
 801 fbranch-probabilities
 802 Common Report Var(flag_branch_probabilities) Optimization
 803 Use profiling information for branch probabilities
 804
 805 fbranch-target-load-optimize
 806 Common Report Var(flag_branch_target_load_optimize) Optimization
 807 Perform branch target load optimization before prologue / epilogue threading
 808
 809 fbranch-target-load-optimize2
 810 Common Report Var(flag_branch_target_load_optimize2) Optimization
 811 Perform branch target load optimization after prologue / epilogue threading
 812
 813 fbtr-bb-exclusive
 814 Common Report Var(flag_btr_bb_exclusive) Optimization
 815 Restrict target load migration not to re-use registers in any basic block
 816
 817 fcall-saved-
 818 Common Joined RejectNegative Var(common_deferred_options) Defer
 819 -fcall-saved-<register> Mark <register> as being preserved across functions
 820
 821 fcall-used-
 822 Common Joined RejectNegative Var(common_deferred_options) Defer
 823 -fcall-used-<register>  Mark <register> as being corrupted by function calls
 824
 825 ; Nonzero for -fcaller-saves: allocate values in regs that need to
 826 ; be saved across function calls, if that produces overall better code.
 827 ; Optional now, so people can test it.
 828 fcaller-saves
 829 Common Report Var(flag_caller_saves) Optimization
 830 Save registers around function calls
 831
 832 fcheck-data-deps
 833 Common Report Var(flag_check_data_deps)
 834 Compare the results of several data dependence analyzers.
 835
 836 fcombine-stack-adjustments
 837 Common Report Var(flag_combine_stack_adjustments) Optimization
 838 Looks for opportunities to reduce stack adjustments and stack references.
 839
 840 fcommon
 841 Common Report Var(flag_no_common,0) Optimization
 842 Do not put uninitialized globals in the common section
 843
 844 fcompare-debug
 845 Driver
 846 ; Converted by the driver to -fcompare-debug= options.
 847
 848 fcompare-debug=
 849 Common Driver JoinedOrMissing RejectNegative Var(flag_compare_debug_opt)
 850 -fcompare-debug[=<opts>]        Compile with and without e.g. -gtoggle, and compare the final-insns dump
 851
 852 fcompare-debug-second
 853 Common Driver RejectNegative Var(flag_compare_debug)
 854 Run only the second compilation of -fcompare-debug
 855
 856 fcompare-elim
 857 Common Report Var(flag_compare_elim_after_reload) Optimization
 858 Perform comparison elimination after register allocation has finished
 859
 860 fconserve-stack
 861 Common Var(flag_conserve_stack) Optimization
 862 Do not perform optimizations increasing noticeably stack usage
 863
 864 fcprop-registers
 865 Common Report Var(flag_cprop_registers) Optimization
 866 Perform a register copy-propagation optimization pass
 867
 868 fcrossjumping
 869 Common Report Var(flag_crossjumping) Optimization
 870 Perform cross-jumping optimization
 871
 872 fcse-follow-jumps
 873 Common Report Var(flag_cse_follow_jumps) Optimization
 874 When running CSE, follow jumps to their targets
 875
 876 fcse-skip-blocks
 877 Common Ignore
 878 Does nothing.  Preserved for backward compatibility.
 879
 880 fcx-limited-range
 881 Common Report Var(flag_cx_limited_range) Optimization SetByCombined
 882 Omit range reduction step when performing complex division
 883
 884 fcx-fortran-rules
 885 Common Report Var(flag_cx_fortran_rules) Optimization
 886 Complex multiplication and division follow Fortran rules
 887
 888 fdata-sections
 889 Common Report Var(flag_data_sections) Optimization
 890 Place data items into their own section
 891
 892 fdbg-cnt-list
 893 Common Report Var(common_deferred_options) Defer
 894 List all available debugging counters with their limits and counts.
 895
 896 fdbg-cnt=
 897 Common RejectNegative Joined Var(common_deferred_options) Defer
 898 -fdbg-cnt=<counter>:<limit>[,<counter>:<limit>,...]     Set the debug counter limit.
 899
 900 fdebug-prefix-map=
 901 Common Joined RejectNegative Var(common_deferred_options) Defer
 902 Map one directory name to another in debug information
 903
 904 ; Nonzero for -fdefer-pop: don't pop args after each function call
 905 ; instead save them up to pop many calls' args with one insns.
 906 fdefer-pop
 907 Common Report Var(flag_defer_pop) Optimization
 908 Defer popping functions args from stack until later
 909
 910 fdelayed-branch
 911 Common Report Var(flag_delayed_branch) Optimization
 912 Attempt to fill delay slots of branch instructions
 913
 914 fdelete-null-pointer-checks
 915 Common Report Var(flag_delete_null_pointer_checks) Init(1) Optimization
 916 Delete useless null pointer checks
 917
 918 fdevirtualize
 919 Common Report Var(flag_devirtualize) Optimization
 920 Try to convert virtual calls to direct ones.
 921
 922 fdiagnostics-show-location=
 923 Common Joined RejectNegative Enum(diagnostic_prefixing_rule)
 924 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
 925
 926 ; Required for these enum values.
 927 SourceInclude
 928 pretty-print.h
 929
 930 Enum
 931 Name(diagnostic_prefixing_rule) Type(int)
 932
 933 EnumValue
 934 Enum(diagnostic_prefixing_rule) String(once) Value(DIAGNOSTICS_SHOW_PREFIX_ONCE)
 935
 936 EnumValue
 937 Enum(diagnostic_prefixing_rule) String(every-line) Value(DIAGNOSTICS_SHOW_PREFIX_EVERY_LINE)
 938
 939 fdiagnostics-show-option
 940 Common Var(flag_diagnostics_show_option) Init(1)
 941 Amend appropriate diagnostic messages with the command line option that controls them
 942
 943 fdump-
 944 Common Joined RejectNegative Var(common_deferred_options) Defer
 945 -fdump-<type>   Dump various compiler internals to a file
 946
 947 fdump-final-insns
 948 Driver RejectNegative
 949
 950 fdump-final-insns=
 951 Common RejectNegative Joined Var(flag_dump_final_insns)
 952 -fdump-final-insns=filename     Dump to filename the insns at the end of translation
 953
 954 fdump-go-spec=
 955 Common RejectNegative Joined Var(flag_dump_go_spec)
 956 -fdump-go-spec=filename Write all declarations to file as Go code
 957
 958 fdump-noaddr
 959 Common Report Var(flag_dump_noaddr)
 960 Suppress output of addresses in debugging dumps
 961
 962 fdump-unnumbered
 963 Common Report Var(flag_dump_unnumbered)
 964 Suppress output of instruction numbers, line number notes and addresses in debugging dumps
 965
 966 fdump-unnumbered-links
 967 Common Report Var(flag_dump_unnumbered_links)
 968 Suppress output of previous and next insn numbers in debugging dumps
 969
 970 fdwarf2-cfi-asm
 971 Common Report Var(flag_dwarf2_cfi_asm) Init(HAVE_GAS_CFI_DIRECTIVE)
 972 Enable CFI tables via GAS assembler directives.
 973
 974 fearly-inlining
 975 Common Report Var(flag_early_inlining) Init(1) Optimization
 976 Perform early inlining
 977
 978 feliminate-dwarf2-dups
 979 Common Report Var(flag_eliminate_dwarf2_dups)
 980 Perform DWARF2 duplicate elimination
 981
 982 fipa-sra
 983 Common Report Var(flag_ipa_sra) Init(0) Optimization
 984 Perform interprocedural reduction of aggregates
 985
 986 feliminate-unused-debug-symbols
 987 Common Report Var(flag_debug_only_used_symbols)
 988 Perform unused type elimination in debug info
 989
 990 feliminate-unused-debug-types
 991 Common Report Var(flag_eliminate_unused_debug_types) Init(1)
 992 Perform unused type elimination in debug info
 993
 994 femit-class-debug-always
 995 Common Report Var(flag_emit_class_debug_always) Init(0)
 996 Do not suppress C++ class debug information.
 997
 998 fenable-icf-debug
 999 Common Report Var(flag_enable_icf_debug)
1000 Generate debug information to support Identical Code Folding (ICF)
1001
1002 fexceptions
1003 Common Report Var(flag_exceptions) Optimization
1004 Enable exception handling
1005
1006 fexpensive-optimizations
1007 Common Report Var(flag_expensive_optimizations) Optimization
1008 Perform a number of minor, expensive optimizations
1009
1010 fexcess-precision=
1011 Common Joined RejectNegative Enum(excess_precision) Var(flag_excess_precision_cmdline) Init(EXCESS_PRECISION_DEFAULT)
1012 -fexcess-precision=[fast|standard]      Specify handling of excess floating-point precision
1013
1014 Enum
1015 Name(excess_precision) Type(enum excess_precision) UnknownError(unknown excess precision style %qs)
1016
1017 EnumValue
1018 Enum(excess_precision) String(fast) Value(EXCESS_PRECISION_FAST)
1019
1020 EnumValue
1021 Enum(excess_precision) String(standard) Value(EXCESS_PRECISION_STANDARD)
1022
1023 ffast-math
1024 Common
1025
1026 ffinite-math-only
1027 Common Report Var(flag_finite_math_only) Optimization SetByCombined
1028 Assume no NaNs or infinities are generated
1029
1030 ffixed-
1031 Common Joined RejectNegative Var(common_deferred_options) Defer
1032 -ffixed-<register>      Mark <register> as being unavailable to the compiler
1033
1034 ffloat-store
1035 Common Report Var(flag_float_store) Optimization
1036 Don't allocate floats and doubles in extended-precision registers
1037
1038 fforce-addr
1039 Common Ignore
1040 Does nothing.  Preserved for backward compatibility.
1041
1042 fforward-propagate
1043 Common Report Var(flag_forward_propagate) Optimization
1044 Perform a forward propagation pass on RTL
1045
1046 ffp-contract=
1047 Common Joined RejectNegative Enum(fp_contract_mode) Var(flag_fp_contract_mode) Init(FP_CONTRACT_FAST)
1048 -ffp-contract=[off|on|fast] Perform floating-point expression contraction.
1049
1050 Enum
1051 Name(fp_contract_mode) Type(enum fp_contract_mode) UnknownError(unknown floating point contraction style %qs)
1052
1053 EnumValue
1054 Enum(fp_contract_mode) String(off) Value(FP_CONTRACT_OFF)
1055
1056 ; Not implemented, fall back to conservative FP_CONTRACT_OFF.
1057 EnumValue
1058 Enum(fp_contract_mode) String(on) Value(FP_CONTRACT_OFF)
1059
1060 EnumValue
1061 Enum(fp_contract_mode) String(fast) Value(FP_CONTRACT_FAST)
1062
1063 ; Nonzero means don't put addresses of constant functions in registers.
1064 ; Used for compiling the Unix kernel, where strange substitutions are
1065 ; done on the assembly output.
1066 ffunction-cse
1067 Common Report Var(flag_no_function_cse,0)
1068 Allow function addresses to be held in registers
1069
1070 ffunction-sections
1071 Common Report Var(flag_function_sections)
1072 Place each function into its own section
1073
1074 fgcse
1075 Common Report Var(flag_gcse) Optimization
1076 Perform global common subexpression elimination
1077
1078 fgcse-lm
1079 Common Report Var(flag_gcse_lm) Init(1) Optimization
1080 Perform enhanced load motion during global common subexpression elimination
1081
1082 fgcse-sm
1083 Common Report Var(flag_gcse_sm) Init(0) Optimization
1084 Perform store motion after global common subexpression elimination
1085
1086 fgcse-las
1087 Common Report Var(flag_gcse_las) Init(0) Optimization
1088 Perform redundant load after store elimination in global common subexpression
1089 elimination
1090
1091 fgcse-after-reload
1092 Common Report Var(flag_gcse_after_reload) Optimization
1093 Perform global common subexpression elimination after register allocation
1094 has finished
1095
1096 ; This option is not documented yet as its semantics will change.
1097 fgraphite
1098 Common Report Var(flag_graphite)
1099 Enable in and out of Graphite representation
1100
1101 fgraphite-identity
1102 Common Report Var(flag_graphite_identity) Optimization
1103 Enable Graphite Identity transformation
1104
1105 floop-parallelize-all
1106 Common Report Var(flag_loop_parallelize_all) Optimization
1107 Mark all loops as parallel
1108
1109 floop-strip-mine
1110 Common Report Var(flag_loop_strip_mine) Optimization
1111 Enable Loop Strip Mining transformation
1112
1113 floop-interchange
1114 Common Report Var(flag_loop_interchange) Optimization
1115 Enable Loop Interchange transformation
1116
1117 floop-block
1118 Common Report Var(flag_loop_block) Optimization
1119 Enable Loop Blocking transformation
1120
1121 floop-flatten
1122 Common Report Var(flag_loop_flatten) Optimization
1123 Enable Loop Flattening transformation
1124
1125 fstrict-volatile-bitfields
1126 Common Report Var(flag_strict_volatile_bitfields) Init(-1)
1127 Force bitfield accesses to match their type width
1128
1129 fguess-branch-probability
1130 Common Report Var(flag_guess_branch_prob) Optimization
1131 Enable guessing of branch probabilities
1132
1133 ; Nonzero means ignore `#ident' directives.  0 means handle them.
1134 ; Generate position-independent code for executables if possible
1135 ; On SVR4 targets, it also controls whether or not to emit a
1136 ; string identifying the compiler.
1137 fident
1138 Common Report Var(flag_no_ident,0)
1139 Process #ident directives
1140
1141 fif-conversion
1142 Common Report Var(flag_if_conversion) Optimization
1143 Perform conversion of conditional jumps to branchless equivalents
1144
1145 fif-conversion2
1146 Common Report Var(flag_if_conversion2) Optimization
1147 Perform conversion of conditional jumps to conditional execution
1148
1149 ftree-loop-if-convert
1150 Common Report Var(flag_tree_loop_if_convert) Init(-1) Optimization
1151 Convert conditional jumps in innermost loops to branchless equivalents
1152
1153 ftree-loop-if-convert-stores
1154 Common Report Var(flag_tree_loop_if_convert_stores) Optimization
1155 Also if-convert conditional jumps containing memory writes
1156
1157 ; -finhibit-size-directive inhibits output of .size for ELF.
1158 ; This is used only for compiling crtstuff.c,
1159 ; and it may be extended to other effects
1160 ; needed for crtstuff.c on other systems.
1161 finhibit-size-directive
1162 Common Report Var(flag_inhibit_size_directive)
1163 Do not generate .size directives
1164
1165 findirect-inlining
1166 Common Report Var(flag_indirect_inlining)
1167 Perform indirect inlining
1168
1169 ; Nonzero means that functions declared `inline' will be treated
1170 ; as `static'.  Prevents generation of zillions of copies of unused
1171 ; static inline functions; instead, `inlines' are written out
1172 ; only when actually used.  Used in conjunction with -g.  Also
1173 ; does the right thing with #pragma interface.
1174 finline
1175 Common Report Var(flag_no_inline,0) Init(0)
1176 Pay attention to the \"inline\" keyword
1177
1178 finline-small-functions
1179 Common Report Var(flag_inline_small_functions) Optimization
1180 Integrate simple functions into their callers when code size is known to not growth
1181
1182 finline-functions
1183 Common Report Var(flag_inline_functions) Optimization
1184 Integrate simple functions into their callers
1185
1186 finline-functions-called-once
1187 Common Report Var(flag_inline_functions_called_once) Init(1) Optimization
1188 Integrate functions called once into their callers
1189
1190 finline-limit-
1191 Common RejectNegative Joined Alias(finline-limit=)
1192
1193 finline-limit=
1194 Common RejectNegative Joined UInteger
1195 -finline-limit=<number> Limit the size of inlined functions to <number>
1196
1197 finstrument-functions
1198 Common Report Var(flag_instrument_function_entry_exit)
1199 Instrument function entry and exit with profiling calls
1200
1201 finstrument-functions-exclude-function-list=
1202 Common RejectNegative Joined
1203 -finstrument-functions-exclude-function-list=name,...  Do not instrument listed functions
1204
1205 finstrument-functions-exclude-file-list=
1206 Common RejectNegative Joined
1207 -finstrument-functions-exclude-file-list=filename,...  Do not instrument functions listed in files
1208
1209 fipa-cp
1210 Common Report Var(flag_ipa_cp) Optimization
1211 Perform Interprocedural constant propagation
1212
1213 fipa-cp-clone
1214 Common Report Var(flag_ipa_cp_clone) Optimization
1215 Perform cloning to make Interprocedural constant propagation stronger
1216
1217 fipa-profile
1218 Common Report Var(flag_ipa_profile) Init(0) Optimization
1219 Perform interprocedural profile propagation
1220
1221 fipa-pta
1222 Common Report Var(flag_ipa_pta) Init(0) Optimization
1223 Perform interprocedural points-to analysis
1224
1225 fipa-pure-const
1226 Common Report Var(flag_ipa_pure_const) Init(0) Optimization
1227 Discover pure and const functions
1228
1229 fipa-reference
1230 Common Report Var(flag_ipa_reference) Init(0) Optimization
1231 Discover readonly and non addressable static variables
1232
1233 fipa-matrix-reorg
1234 Common Report Var(flag_ipa_matrix_reorg) Optimization
1235 Perform matrix layout flattening and transposing based
1236 on profiling information.
1237
1238 fipa-struct-reorg
1239 Common Report Var(flag_ipa_struct_reorg)
1240 Perform structure layout optimizations based
1241 on profiling information.
1242
1243 fira-algorithm=
1244 Common Joined RejectNegative Enum(ira_algorithm) Var(flag_ira_algorithm) Init(IRA_ALGORITHM_CB)
1245 -fira-algorithm=[CB|priority] Set the used IRA algorithm
1246
1247 Enum
1248 Name(ira_algorithm) Type(enum ira_algorithm) UnknownError(unknown IRA algorithm %qs)
1249
1250 EnumValue
1251 Enum(ira_algorithm) String(CB) Value(IRA_ALGORITHM_CB)
1252
1253 EnumValue
1254 Enum(ira_algorithm) String(priority) Value(IRA_ALGORITHM_PRIORITY)
1255
1256 fira-region=
1257 Common Joined RejectNegative Enum(ira_region) Var(flag_ira_region) Init(IRA_REGION_MIXED)
1258 -fira-region=[one|all|mixed] Set regions for IRA
1259
1260 Enum
1261 Name(ira_region) Type(enum ira_region) UnknownError(unknown IRA region %qs)
1262
1263 EnumValue
1264 Enum(ira_region) String(one) Value(IRA_REGION_ONE)
1265
1266 EnumValue
1267 Enum(ira_region) String(all) Value(IRA_REGION_ALL)
1268
1269 EnumValue
1270 Enum(ira_region) String(mixed) Value(IRA_REGION_MIXED)
1271
1272 fira-loop-pressure
1273 Common Report Var(flag_ira_loop_pressure)
1274 Use IRA based register pressure calculation
1275 in RTL loop optimizations.
1276
1277 fira-share-save-slots
1278 Common Report Var(flag_ira_share_save_slots) Init(1)
1279 Share slots for saving different hard registers.
1280
1281 fira-share-spill-slots
1282 Common Report Var(flag_ira_share_spill_slots) Init(1)
1283 Share stack slots for spilled pseudo-registers.
1284
1285 fira-verbose=
1286 Common RejectNegative Joined UInteger Var(flag_ira_verbose) Init(5)
1287 -fira-verbose=<number>  Control IRA's level of diagnostic messages.
1288
1289 fivopts
1290 Common Report Var(flag_ivopts) Init(1) Optimization
1291 Optimize induction variables on trees
1292
1293 fjump-tables
1294 Common Var(flag_jump_tables) Init(1) Optimization
1295 Use jump tables for sufficiently large switch statements
1296
1297 fkeep-inline-functions
1298 Common Report Var(flag_keep_inline_functions)
1299 Generate code for functions even if they are fully inlined
1300
1301 fkeep-static-consts
1302 Common Report Var(flag_keep_static_consts) Init(1)
1303 Emit static const variables even if they are not used
1304
1305 fleading-underscore
1306 Common Report Var(flag_leading_underscore) Init(-1)
1307 Give external symbols a leading underscore
1308
1309 floop-optimize
1310 Common Ignore
1311 Does nothing.  Preserved for backward compatibility.
1312
1313 flto
1314 Common
1315 Enable link-time optimization.
1316
1317 flto=
1318 Common RejectNegative Joined Var(flag_lto)
1319 Link-time optimization with number of parallel jobs or jobserver.
1320
1321 flto-partition=1to1
1322 Common Var(flag_lto_partition_1to1)
1323 Partition functions and vars at linktime based on object files they originate from
1324
1325 flto-partition=balanced
1326 Common Var(flag_lto_partition_balanced)
1327 Partition functions and vars at linktime into approximately same sized buckets
1328
1329 flto-partition=none
1330 Common Var(flag_lto_partition_none)
1331 Disable partioning and streaming
1332
1333 ; The initial value of -1 comes from Z_DEFAULT_COMPRESSION in zlib.h.
1334 flto-compression-level=
1335 Common Joined RejectNegative UInteger Var(flag_lto_compression_level) Init(-1)
1336 -flto-compression-level=<number>        Use zlib compression level <number> for IL
1337
1338 flto-report
1339 Common Report Var(flag_lto_report) Init(0) Optimization
1340 Report various link-time optimization statistics
1341
1342 fmath-errno
1343 Common Report Var(flag_errno_math) Init(1) Optimization SetByCombined
1344 Set errno after built-in math functions
1345
1346 fmax-errors=
1347 Common Joined RejectNegative UInteger Var(flag_max_errors)
1348 -fmax-errors=<number>   Maximum number of errors to report
1349
1350 fmem-report
1351 Common Report Var(mem_report)
1352 Report on permanent memory allocation
1353
1354 ; This will attempt to merge constant section constants, if 1 only
1355 ; string constants and constants from constant pool, if 2 also constant
1356 ; variables.
1357 fmerge-all-constants
1358 Common Report Var(flag_merge_constants,2) Init(1) Optimization
1359 Attempt to merge identical constants and constant variables
1360
1361 fmerge-constants
1362 Common Report Var(flag_merge_constants,1) Optimization
1363 Attempt to merge identical constants across compilation units
1364
1365 fmerge-debug-strings
1366 Common Report Var(flag_merge_debug_strings) Init(1)
1367 Attempt to merge identical debug strings across compilation units
1368
1369 fmessage-length=
1370 Common RejectNegative Joined UInteger
1371 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
1372
1373 fmodulo-sched
1374 Common Report Var(flag_modulo_sched) Optimization
1375 Perform SMS based modulo scheduling before the first scheduling pass
1376
1377 fmodulo-sched-allow-regmoves
1378 Common Report Var(flag_modulo_sched_allow_regmoves)
1379 Perform SMS based modulo scheduling with register moves allowed
1380
1381 fmove-loop-invariants
1382 Common Report Var(flag_move_loop_invariants) Init(1) Optimization
1383 Move loop invariant computations out of loops
1384
1385 fmudflap
1386 Common RejectNegative Report Var(flag_mudflap)
1387 Add mudflap bounds-checking instrumentation for single-threaded program
1388
1389 fmudflapth
1390 Common RejectNegative Report Var(flag_mudflap,2)
1391 Add mudflap bounds-checking instrumentation for multi-threaded program
1392
1393 fmudflapir
1394 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
1395 Ignore read operations when inserting mudflap instrumentation
1396
1397 fdce
1398 Common Var(flag_dce) Init(1) Optimization
1399 Use the RTL dead code elimination pass
1400
1401 fdse
1402 Common Var(flag_dse) Init(1) Optimization
1403 Use the RTL dead store elimination pass
1404
1405 freschedule-modulo-scheduled-loops
1406 Common Report Var(flag_resched_modulo_sched) Optimization
1407 Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
1408
1409 fnon-call-exceptions
1410 Common Report Var(flag_non_call_exceptions) Optimization
1411 Support synchronous non-call exceptions
1412
1413 fomit-frame-pointer
1414 Common Report Var(flag_omit_frame_pointer) Optimization
1415 When possible do not generate stack frames
1416
1417 foptimize-register-move
1418 Common Report Var(flag_regmove) Optimization
1419 Do the full register move optimization pass
1420
1421 foptimize-sibling-calls
1422 Common Report Var(flag_optimize_sibling_calls) Optimization
1423 Optimize sibling and tail recursive calls
1424
1425 fpartial-inlining
1426 Common Report Var(flag_partial_inlining)
1427 Perform partial inlining
1428
1429 fpre-ipa-mem-report
1430 Common Report Var(pre_ipa_mem_report)
1431 Report on memory allocation before interprocedural optimization
1432
1433 fpost-ipa-mem-report
1434 Common Report Var(post_ipa_mem_report)
1435 Report on memory allocation before interprocedural optimization
1436
1437 fpack-struct
1438 Common Report Var(flag_pack_struct) Optimization
1439 Pack structure members together without holes
1440
1441 fpack-struct=
1442 Common RejectNegative Joined UInteger Optimization
1443 -fpack-struct=<number>  Set initial maximum structure member alignment
1444
1445 fpcc-struct-return
1446 Common Report Var(flag_pcc_struct_return,1) Init(DEFAULT_PCC_STRUCT_RETURN)
1447 Return small aggregates in memory, not registers
1448
1449 fpeel-loops
1450 Common Report Var(flag_peel_loops) Optimization
1451 Perform loop peeling
1452
1453 fpeephole
1454 Common Report Var(flag_no_peephole,0) Optimization
1455 Enable machine specific peephole optimizations
1456
1457 fpeephole2
1458 Common Report Var(flag_peephole2) Optimization
1459 Enable an RTL peephole pass before sched2
1460
1461 fPIC
1462 Common Report Var(flag_pic,2)
1463 Generate position-independent code if possible (large mode)
1464
1465 fPIE
1466 Common Report Var(flag_pie,2)
1467 Generate position-independent code for executables if possible (large mode)
1468
1469 fpic
1470 Common Report Var(flag_pic,1)
1471 Generate position-independent code if possible (small mode)
1472
1473 fpie
1474 Common Report Var(flag_pie,1)
1475 Generate position-independent code for executables if possible (small mode)
1476
1477 fplugin=
1478 Common Joined RejectNegative Var(common_deferred_options) Defer
1479 Specify a plugin to load
1480
1481 fplugin-arg-
1482 Common Joined RejectNegative Var(common_deferred_options) Defer
1483 -fplugin-arg-<name>-<key>[=<value>]     Specify argument <key>=<value> for plugin <name>
1484
1485 fpredictive-commoning
1486 Common Report Var(flag_predictive_commoning) Optimization
1487 Run predictive commoning optimization.
1488
1489 fprefetch-loop-arrays
1490 Common Report Var(flag_prefetch_loop_arrays) Init(-1) Optimization
1491 Generate prefetch instructions, if available, for arrays in loops
1492
1493 fprofile
1494 Common Report Var(profile_flag)
1495 Enable basic program profiling code
1496
1497 fprofile-arcs
1498 Common Report Var(profile_arc_flag)
1499 Insert arc-based program profiling code
1500
1501 fprofile-dir=
1502 Common Joined RejectNegative Var(profile_data_prefix)
1503 Set the top-level directory for storing the profile data.
1504 The default is 'pwd'.
1505
1506 fprofile-correction
1507 Common Report Var(flag_profile_correction)
1508 Enable correction of flow inconsistent profile data input
1509
1510 fprofile-generate
1511 Common
1512 Enable common options for generating profile info for profile feedback directed optimizations
1513
1514 fprofile-generate=
1515 Common Joined RejectNegative
1516 Enable common options for generating profile info for profile feedback directed optimizations, and set -fprofile-dir=
1517
1518 fprofile-use
1519 Common Var(flag_profile_use)
1520 Enable common options for performing profile feedback directed optimizations
1521
1522 fprofile-use=
1523 Common Joined RejectNegative
1524 Enable common options for performing profile feedback directed optimizations, and set -fprofile-dir=
1525
1526 fprofile-values
1527 Common Report Var(flag_profile_values)
1528 Insert code to profile values of expressions
1529
1530 frandom-seed
1531 Common Var(common_deferred_options) Defer
1532
1533 frandom-seed=
1534 Common Joined RejectNegative Var(common_deferred_options) Defer
1535 -frandom-seed=<string>  Make compile reproducible using <string>
1536
1537 ; This switch causes the command line that was used to create an
1538 ; object file to be recorded into the object file.  The exact format
1539 ; of this recording is target and binary file format dependent.
1540 ; It is related to the -fverbose-asm switch, but that switch only
1541 ; records information in the assembler output file as comments, so
1542 ; they never reach the object file.
1543 frecord-gcc-switches
1544 Common Report Var(flag_record_gcc_switches)
1545 Record gcc command line switches in the object file.
1546
1547 freg-struct-return
1548 Common Report Var(flag_pcc_struct_return,0) Optimization
1549 Return small aggregates in registers
1550
1551 fregmove
1552 Common Report Var(flag_regmove) Optimization
1553 Enables a register move optimization
1554
1555 frename-registers
1556 Common Report Var(flag_rename_registers) Init(2) Optimization
1557 Perform a register renaming optimization pass
1558
1559 freorder-blocks
1560 Common Report Var(flag_reorder_blocks) Optimization
1561 Reorder basic blocks to improve code placement
1562
1563 freorder-blocks-and-partition
1564 Common Report Var(flag_reorder_blocks_and_partition) Optimization
1565 Reorder basic blocks and partition into hot and cold sections
1566
1567 freorder-functions
1568 Common Report Var(flag_reorder_functions) Optimization
1569 Reorder functions to improve code placement
1570
1571 frerun-cse-after-loop
1572 Common Report Var(flag_rerun_cse_after_loop) Optimization
1573 Add a common subexpression elimination pass after loop optimizations
1574
1575 frerun-loop-opt
1576 Common Ignore
1577 Does nothing.  Preserved for backward compatibility.
1578
1579 frounding-math
1580 Common Report Var(flag_rounding_math) Optimization SetByCombined
1581 Disable optimizations that assume default FP rounding behavior
1582
1583 fsched-interblock
1584 Common Report Var(flag_schedule_interblock) Init(1) Optimization
1585 Enable scheduling across basic blocks
1586
1587 fsched-pressure
1588 Common Report Var(flag_sched_pressure) Init(0) Optimization
1589 Enable register pressure sensitive insn scheduling
1590
1591 fsched-spec
1592 Common Report Var(flag_schedule_speculative) Init(1) Optimization
1593 Allow speculative motion of non-loads
1594
1595 fsched-spec-load
1596 Common Report Var(flag_schedule_speculative_load) Optimization
1597 Allow speculative motion of some loads
1598
1599 fsched-spec-load-dangerous
1600 Common Report Var(flag_schedule_speculative_load_dangerous) Optimization
1601 Allow speculative motion of more loads
1602
1603 fsched-verbose=
1604 Common RejectNegative Joined UInteger Var(sched_verbose_param)
1605 -fsched-verbose=<number>        Set the verbosity level of the scheduler
1606
1607 fsched2-use-superblocks
1608 Common Report Var(flag_sched2_use_superblocks) Optimization
1609 If scheduling post reload, do superblock scheduling
1610
1611 fsched2-use-traces
1612 Common Ignore
1613 Does nothing.  Preserved for backward compatibility.
1614
1615 fschedule-insns
1616 Common Report Var(flag_schedule_insns) Optimization
1617 Reschedule instructions before register allocation
1618
1619 fschedule-insns2
1620 Common Report Var(flag_schedule_insns_after_reload) Optimization
1621 Reschedule instructions after register allocation
1622
1623 ; This flag should be on when a target implements non-trivial
1624 ; scheduling hooks, maybe saving some information for its own sake.
1625 ; On IA64, for example, this is used for correct bundling.
1626 fselective-scheduling
1627 Common Report Var(flag_selective_scheduling) Optimization
1628 Schedule instructions using selective scheduling algorithm
1629
1630 fselective-scheduling2
1631 Common Report Var(flag_selective_scheduling2) Optimization
1632 Run selective scheduling after reload
1633
1634 fsel-sched-pipelining
1635 Common Report Var(flag_sel_sched_pipelining) Init(0) Optimization
1636 Perform software pipelining of inner loops during selective scheduling
1637
1638 fsel-sched-pipelining-outer-loops
1639 Common Report Var(flag_sel_sched_pipelining_outer_loops) Init(0) Optimization
1640 Perform software pipelining of outer loops during selective scheduling
1641
1642 fsel-sched-reschedule-pipelined
1643 Common Report Var(flag_sel_sched_reschedule_pipelined) Init(0) Optimization
1644 Reschedule pipelined regions without pipelining
1645
1646 ; sched_stalled_insns means that insns can be moved prematurely from the queue
1647 ; of stalled insns into the ready list.
1648 fsched-stalled-insns
1649 Common Report Var(flag_sched_stalled_insns) Optimization UInteger
1650 Allow premature scheduling of queued insns
1651
1652 fsched-stalled-insns=
1653 Common RejectNegative Joined UInteger
1654 -fsched-stalled-insns=<number>  Set number of queued insns that can be prematurely scheduled
1655
1656 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
1657 ; be examined for a dependency on a stalled insn that is candidate for
1658 ; premature removal from the queue of stalled insns into the ready list (has
1659 ; an effect only if the flag 'sched_stalled_insns' is set).
1660 fsched-stalled-insns-dep
1661 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization UInteger
1662 Set dependence distance checking in premature scheduling of queued insns
1663
1664 fsched-stalled-insns-dep=
1665 Common RejectNegative Joined UInteger
1666 -fsched-stalled-insns-dep=<number>      Set dependence distance checking in premature scheduling of queued insns
1667
1668 fsched-group-heuristic
1669 Common Report Var(flag_sched_group_heuristic) Init(1) Optimization
1670 Enable the group heuristic in the scheduler
1671
1672 fsched-critical-path-heuristic
1673 Common Report Var(flag_sched_critical_path_heuristic) Init(1) Optimization
1674 Enable the critical path heuristic in the scheduler
1675
1676 fsched-spec-insn-heuristic
1677 Common Report Var(flag_sched_spec_insn_heuristic) Init(1) Optimization
1678 Enable the speculative instruction heuristic in the scheduler
1679
1680 fsched-rank-heuristic
1681 Common Report Var(flag_sched_rank_heuristic) Init(1) Optimization
1682 Enable the rank heuristic in the scheduler
1683
1684 fsched-last-insn-heuristic
1685 Common Report Var(flag_sched_last_insn_heuristic) Init(1) Optimization
1686 Enable the last instruction heuristic in the scheduler
1687
1688 fsched-dep-count-heuristic
1689 Common Report Var(flag_sched_dep_count_heuristic) Init(1) Optimization
1690 Enable the dependent count heuristic in the scheduler
1691
1692 fsection-anchors
1693 Common Report Var(flag_section_anchors) Optimization
1694 Access data in the same section from shared anchor points
1695
1696 fsee
1697 Common Ignore
1698 Does nothing.  Preserved for backward compatibility.
1699
1700 fzee
1701 Common Report Var(flag_zee) Init(0)
1702 Eliminate redundant zero extensions on targets that support implicit extensions.
1703
1704 fshow-column
1705 Common Report Var(flag_show_column) Init(1)
1706 Show column numbers in diagnostics, when available.  Default on
1707
1708 fsignaling-nans
1709 Common Report Var(flag_signaling_nans) Optimization SetByCombined
1710 Disable optimizations observable by IEEE signaling NaNs
1711
1712 fsigned-zeros
1713 Common Report Var(flag_signed_zeros) Init(1) Optimization SetByCombined
1714 Disable floating point optimizations that ignore the IEEE signedness of zero
1715
1716 fsingle-precision-constant
1717 Common Report Var(flag_single_precision_constant) Optimization
1718 Convert floating point constants to single precision constants
1719
1720 fsplit-ivs-in-unroller
1721 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
1722 Split lifetimes of induction variables when loops are unrolled
1723
1724 fsplit-stack
1725 Common Report Var(flag_split_stack) Init(-1)
1726 Generate discontiguous stack frames
1727
1728 fsplit-wide-types
1729 Common Report Var(flag_split_wide_types) Optimization
1730 Split wide types into independent registers
1731
1732 fvariable-expansion-in-unroller
1733 Common Report Var(flag_variable_expansion_in_unroller) Optimization
1734 Apply variable expansion when loops are unrolled
1735
1736 fstack-check=
1737 Common Report RejectNegative Joined
1738 -fstack-check=[no|generic|specific]     Insert stack checking code into the program
1739
1740 fstack-check
1741 Common Alias(fstack-check=, specific, no)
1742 Insert stack checking code into the program.  Same as -fstack-check=specific
1743
1744 fstack-limit
1745 Common Var(common_deferred_options) Defer
1746
1747 fstack-limit-register=
1748 Common RejectNegative Joined Var(common_deferred_options) Defer
1749 -fstack-limit-register=<register>       Trap if the stack goes past <register>
1750
1751 fstack-limit-symbol=
1752 Common RejectNegative Joined Var(common_deferred_options) Defer
1753 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
1754
1755 fstack-protector
1756 Common Report Var(flag_stack_protect, 1)
1757 Use propolice as a stack protection method
1758
1759 fstack-protector-all
1760 Common Report RejectNegative Var(flag_stack_protect, 2)
1761 Use a stack protection method for every function
1762
1763 fstack-usage
1764 Common RejectNegative Var(flag_stack_usage)
1765 Output stack usage information on a per-function basis
1766
1767 fstrength-reduce
1768 Common Ignore
1769 Does nothing.  Preserved for backward compatibility.
1770
1771 ; Nonzero if we should do (language-dependent) alias analysis.
1772 ; Typically, this analysis will assume that expressions of certain
1773 ; types do not alias expressions of certain other types.  Only used
1774 ; if alias analysis (in general) is enabled.
1775 fstrict-aliasing
1776 Common Report Var(flag_strict_aliasing) Optimization
1777 Assume strict aliasing rules apply
1778
1779 fstrict-overflow
1780 Common Report Var(flag_strict_overflow)
1781 Treat signed overflow as undefined
1782
1783 fsyntax-only
1784 Common Report Var(flag_syntax_only)
1785 Check for syntax errors, then stop
1786
1787 ftest-coverage
1788 Common Report Var(flag_test_coverage)
1789 Create data files needed by \"gcov\"
1790
1791 fthread-jumps
1792 Common Report Var(flag_thread_jumps) Optimization
1793 Perform jump threading optimizations
1794
1795 ftime-report
1796 Common Report Var(time_report)
1797 Report the time taken by each compiler pass
1798
1799 ftls-model=
1800 Common Joined RejectNegative Enum(tls_model) Var(flag_tls_default) Init(TLS_MODEL_GLOBAL_DYNAMIC)
1801 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
1802
1803 Enum
1804 Name(tls_model) Type(enum tls_model) UnknownError(unknown TLS model %qs)
1805
1806 EnumValue
1807 Enum(tls_model) String(global-dynamic) Value(TLS_MODEL_GLOBAL_DYNAMIC)
1808
1809 EnumValue
1810 Enum(tls_model) String(local-dynamic) Value(TLS_MODEL_LOCAL_DYNAMIC)
1811
1812 EnumValue
1813 Enum(tls_model) String(initial-exec) Value(TLS_MODEL_INITIAL_EXEC)
1814
1815 EnumValue
1816 Enum(tls_model) String(local-exec) Value(TLS_MODEL_LOCAL_EXEC)
1817
1818 ftoplevel-reorder
1819 Common Report Var(flag_toplevel_reorder) Init(2) Optimization
1820 Reorder top level functions, variables, and asms
1821
1822 ftracer
1823 Common Report Var(flag_tracer)
1824 Perform superblock formation via tail duplication
1825
1826 ; Zero means that floating-point math operations cannot generate a
1827 ; (user-visible) trap.  This is the case, for example, in nonstop
1828 ; IEEE 754 arithmetic.
1829 ftrapping-math
1830 Common Report Var(flag_trapping_math) Init(1) Optimization SetByCombined
1831 Assume floating-point operations can trap
1832
1833 ftrapv
1834 Common Report Var(flag_trapv) Optimization
1835 Trap for signed overflow in addition, subtraction and multiplication
1836
1837 ftree-ccp
1838 Common Report Var(flag_tree_ccp) Optimization
1839 Enable SSA-CCP optimization on trees
1840
1841 ftree-bit-ccp
1842 Common Report Var(flag_tree_bit_ccp) Optimization
1843 Enable SSA-BIT-CCP optimization on trees
1844
1845 ftree-store-ccp
1846 Common Ignore
1847 Does nothing.  Preserved for backward compatibility.
1848
1849 ftree-ch
1850 Common Report Var(flag_tree_ch) Optimization
1851 Enable loop header copying on trees
1852
1853 ftree-copyrename
1854 Common Report Var(flag_tree_copyrename) Optimization
1855 Replace SSA temporaries with better names in copies
1856
1857 ftree-copy-prop
1858 Common Report Var(flag_tree_copy_prop) Optimization
1859 Enable copy propagation on trees
1860
1861 ftree-store-copy-prop
1862 Common Ignore
1863 Does nothing.  Preserved for backward compatibility.
1864
1865 ftree-cselim
1866 Common Report Var(flag_tree_cselim) Init(2) Optimization
1867 Transform condition stores into unconditional ones
1868
1869 ftree-switch-conversion
1870 Common Report Var(flag_tree_switch_conversion) Optimization
1871 Perform conversions of switch initializations.
1872
1873 ftree-dce
1874 Common Report Var(flag_tree_dce) Optimization
1875 Enable SSA dead code elimination optimization on trees
1876
1877 ftree-dominator-opts
1878 Common Report Var(flag_tree_dom) Optimization
1879 Enable dominator optimizations
1880
1881 ftree-dse
1882 Common Report Var(flag_tree_dse) Optimization
1883 Enable dead store elimination
1884
1885 ftree-forwprop
1886 Common Report Var(flag_tree_forwprop) Init(1) Optimization
1887 Enable forward propagation on trees
1888
1889 ftree-fre
1890 Common Report Var(flag_tree_fre) Optimization
1891 Enable Full Redundancy Elimination (FRE) on trees
1892
1893 ftree-loop-distribution
1894 Common Report Var(flag_tree_loop_distribution) Optimization
1895 Enable loop distribution on trees
1896
1897 ftree-loop-distribute-patterns
1898 Common Report Var(flag_tree_loop_distribute_patterns) Optimization
1899 Enable loop distribution for patterns transformed into a library call
1900
1901 ftree-loop-im
1902 Common Report Var(flag_tree_loop_im) Init(1) Optimization
1903 Enable loop invariant motion on trees
1904
1905 ftree-loop-linear
1906 Common Alias(floop-interchange)
1907 Enable loop interchange transforms.  Same as -floop-interchange
1908
1909 ftree-loop-ivcanon
1910 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
1911 Create canonical induction variables in loops
1912
1913 ftree-loop-optimize
1914 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
1915 Enable loop optimizations on tree level
1916
1917 ftree-parallelize-loops=
1918 Common Report Joined RejectNegative UInteger Var(flag_tree_parallelize_loops) Init(1)
1919 Enable automatic parallelization of loops
1920
1921 ftree-phiprop
1922 Common Report Var(flag_tree_phiprop) Init(1) Optimization
1923 Enable hoisting loads from conditional pointers.
1924
1925 ftree-pre
1926 Common Report Var(flag_tree_pre) Optimization
1927 Enable SSA-PRE optimization on trees
1928
1929 ftree-pta
1930 Common Report Var(flag_tree_pta) Init(1) Optimization
1931 Perform function-local points-to analysis on trees.
1932
1933 ftree-reassoc
1934 Common Report Var(flag_tree_reassoc) Init(1) Optimization
1935 Enable reassociation on tree level
1936
1937 ftree-salias
1938 Common Ignore
1939 Does nothing.  Preserved for backward compatibility.
1940
1941 ftree-sink
1942 Common Report Var(flag_tree_sink) Optimization
1943 Enable SSA code sinking on trees
1944
1945 ftree-sra
1946 Common Report Var(flag_tree_sra) Optimization
1947 Perform scalar replacement of aggregates
1948
1949 ftree-ter
1950 Common Report Var(flag_tree_ter) Optimization
1951 Replace temporary expressions in the SSA->normal pass
1952
1953 ftree-lrs
1954 Common Report Var(flag_tree_live_range_split) Optimization
1955 Perform live range splitting during the SSA->normal pass
1956
1957 ftree-vrp
1958 Common Report Var(flag_tree_vrp) Init(0) Optimization
1959 Perform Value Range Propagation on trees
1960
1961 funit-at-a-time
1962 Common Report Var(flag_unit_at_a_time) Init(1) Optimization
1963 Compile whole compilation unit at a time
1964
1965 funroll-loops
1966 Common Report Var(flag_unroll_loops) Optimization
1967 Perform loop unrolling when iteration count is known
1968
1969 funroll-all-loops
1970 Common Report Var(flag_unroll_all_loops) Optimization
1971 Perform loop unrolling for all loops
1972
1973 ; Nonzero means that loop optimizer may assume that the induction variables
1974 ; that control loops do not overflow and that the loops with nontrivial
1975 ; exit condition are not infinite
1976 funsafe-loop-optimizations
1977 Common Report Var(flag_unsafe_loop_optimizations) Optimization
1978 Allow loop optimizations to assume that the loops behave in normal way
1979
1980 fassociative-math
1981 Common Report Var(flag_associative_math) SetByCombined
1982 Allow optimization for floating-point arithmetic which may change the
1983 result of the operation due to rounding.
1984
1985 freciprocal-math
1986 Common Report Var(flag_reciprocal_math) SetByCombined
1987 Same as -fassociative-math for expressions which include division.
1988
1989 ; Nonzero means that unsafe floating-point math optimizations are allowed
1990 ; for the sake of speed.  IEEE compliance is not guaranteed, and operations
1991 ; are allowed to assume that their arguments and results are "normal"
1992 ; (e.g., nonnegative for SQRT).
1993 funsafe-math-optimizations
1994 Common Report Var(flag_unsafe_math_optimizations) Optimization SetByCombined
1995 Allow math optimizations that may violate IEEE or ISO standards
1996
1997 funswitch-loops
1998 Common Report Var(flag_unswitch_loops) Optimization
1999 Perform loop unswitching
2000
2001 funwind-tables
2002 Common Report Var(flag_unwind_tables) Optimization
2003 Just generate unwind tables for exception handling
2004
2005 fuse-linker-plugin
2006 Common Undocumented
2007
2008 ; Positive if we should track variables, negative if we should run
2009 ; the var-tracking pass only to discard debug annotations, zero if
2010 ; we're not to run it.  When flag_var_tracking == 2 (AUTODETECT_VALUE) it
2011 ; will be set according to optimize, debug_info_level and debug_hooks
2012 ; in process_options ().
2013 fvar-tracking
2014 Common Report Var(flag_var_tracking) Init(2) Optimization
2015 Perform variable tracking
2016
2017 ; Positive if we should track variables at assignments, negative if
2018 ; we should run the var-tracking pass only to discard debug
2019 ; annotations.  When flag_var_tracking_assignments ==
2020 ; AUTODETECT_VALUE it will be set according to flag_var_tracking.
2021 fvar-tracking-assignments
2022 Common Report Var(flag_var_tracking_assignments) Init(2) Optimization
2023 Perform variable tracking by annotating assignments
2024
2025 ; Nonzero if we should toggle flag_var_tracking_assignments after
2026 ; processing options and computing its default.  */
2027 fvar-tracking-assignments-toggle
2028 Common Report Var(flag_var_tracking_assignments_toggle) Optimization
2029 Toggle -fvar-tracking-assignments
2030
2031 fvar-tracking-uninit
2032 Common Report Var(flag_var_tracking_uninit) Optimization
2033 Perform variable tracking and also tag variables that are uninitialized
2034
2035 ftree-vectorize
2036 Common Report Var(flag_tree_vectorize) Optimization
2037 Enable loop vectorization on trees
2038
2039 ftree-slp-vectorize
2040 Common Report Var(flag_tree_slp_vectorize) Init(2) Optimization
2041 Enable basic block vectorization (SLP) on trees
2042
2043 fvect-cost-model
2044 Common Report Var(flag_vect_cost_model) Optimization
2045 Enable use of cost model in vectorization
2046
2047 ftree-vect-loop-version
2048 Common Report Var(flag_tree_vect_loop_version) Init(1) Optimization
2049 Enable loop versioning when doing loop vectorization on trees
2050
2051 ftree-vectorizer-verbose=
2052 Common RejectNegative Joined UInteger
2053 -ftree-vectorizer-verbose=<number>      Set the verbosity level of the vectorizer
2054
2055 ftree-scev-cprop
2056 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
2057 Enable copy propagation of scalar-evolution information.
2058
2059 ; -fverbose-asm causes extra commentary information to be produced in
2060 ; the generated assembly code (to make it more readable).  This option
2061 ; is generally only of use to those who actually need to read the
2062 ; generated assembly code (perhaps while debugging the compiler itself).
2063 ; -fno-verbose-asm, the default, causes the extra information
2064 ; to not be added and is useful when comparing two assembler files.
2065 fverbose-asm
2066 Common Report Var(flag_verbose_asm)
2067 Add extra commentary to assembler output
2068
2069 fvisibility=
2070 Common Joined RejectNegative Enum(symbol_visibility) Var(default_visibility) Init(VISIBILITY_DEFAULT)
2071 -fvisibility=[default|internal|hidden|protected]        Set the default symbol visibility
2072
2073 Enum
2074 Name(symbol_visibility) Type(enum symbol_visibility) UnknownError(unrecognized visibility value %qs)
2075
2076 EnumValue
2077 Enum(symbol_visibility) String(default) Value(VISIBILITY_DEFAULT)
2078
2079 EnumValue
2080 Enum(symbol_visibility) String(internal) Value(VISIBILITY_INTERNAL)
2081
2082 EnumValue
2083 Enum(symbol_visibility) String(hidden) Value(VISIBILITY_HIDDEN)
2084
2085 EnumValue
2086 Enum(symbol_visibility) String(protected) Value(VISIBILITY_PROTECTED)
2087
2088 fvpt
2089 Common Report Var(flag_value_profile_transformations) Optimization
2090 Use expression value profiles in optimizations
2091
2092 fweb
2093 Common Report Var(flag_web) Init(2) Optimization
2094 Construct webs and split unrelated uses of single variable
2095
2096 ftree-builtin-call-dce
2097 Common Report Var(flag_tree_builtin_call_dce) Init(0) Optimization
2098 Enable conditional dead code elimination for builtin calls
2099
2100 fwhole-program
2101 Common Report Var(flag_whole_program) Init(0) Optimization
2102 Perform whole program optimizations
2103
2104 fwrapv
2105 Common Report Var(flag_wrapv) Optimization
2106 Assume signed arithmetic overflow wraps around
2107
2108 fzero-initialized-in-bss
2109 Common Report Var(flag_zero_initialized_in_bss) Init(1)
2110 Put zero initialized data in the bss section
2111
2112 g
2113 Common JoinedOrMissing
2114 Generate debug information in default format
2115
2116 gcoff
2117 Common JoinedOrMissing Negative(gdwarf-)
2118 Generate debug information in COFF format
2119
2120 gdwarf-
2121 Common Joined UInteger Var(dwarf_version) Init(2) Negative(gstabs)
2122 Generate debug information in DWARF v2 (or later) format
2123
2124 ggdb
2125 Common JoinedOrMissing
2126 Generate debug information in default extended format
2127
2128 gstabs
2129 Common JoinedOrMissing Negative(gstabs+)
2130 Generate debug information in STABS format
2131
2132 gstabs+
2133 Common JoinedOrMissing Negative(gvms)
2134 Generate debug information in extended STABS format
2135
2136 gno-strict-dwarf
2137 Common RejectNegative Var(dwarf_strict,0) Init(-1)
2138 Emit DWARF additions beyond selected version
2139
2140 gstrict-dwarf
2141 Common Report RejectNegative Var(dwarf_strict,1)
2142 Don't emit DWARF additions beyond selected version
2143
2144 gtoggle
2145 Common Report Var(flag_gtoggle)
2146 Toggle debug information generation
2147
2148 gvms
2149 Common JoinedOrMissing Negative(gxcoff)
2150 Generate debug information in VMS format
2151
2152 gxcoff
2153 Common JoinedOrMissing Negative(gxcoff+)
2154 Generate debug information in XCOFF format
2155
2156 gxcoff+
2157 Common JoinedOrMissing Negative(gcoff)
2158 Generate debug information in extended XCOFF format
2159
2160 h
2161 Driver Joined Separate
2162
2163 iplugindir=
2164 Common Joined Var(plugindir_string) Init(0)
2165 -iplugindir=<dir>       Set <dir> to be the default plugin directory
2166
2167 l
2168 Driver Joined Separate
2169
2170 n
2171 Driver
2172
2173 no-canonical-prefixes
2174 Driver
2175
2176 nodefaultlibs
2177 Driver
2178
2179 nostdlib
2180 Driver
2181
2182 o
2183 Common Driver Joined Separate Var(asm_file_name) MissingArgError(missing filename after %qs)
2184 -o <file>       Place output into <file>
2185
2186 p
2187 Common Var(profile_flag)
2188 Enable function profiling
2189
2190 pass-exit-codes
2191 Driver Var(pass_exit_codes)
2192
2193 pedantic
2194 Common Var(pedantic)
2195 Issue warnings needed for strict compliance to the standard
2196
2197 pedantic-errors
2198 Common Var(flag_pedantic_errors)
2199 Like -pedantic but issue them as errors
2200
2201 pg
2202 Driver
2203
2204 pipe
2205 Driver Var(use_pipes)
2206
2207 print-file-name=
2208 Driver JoinedOrMissing Var(print_file_name)
2209
2210 print-libgcc-file-name
2211 Driver
2212
2213 print-multi-directory
2214 Driver Var(print_multi_directory)
2215
2216 print-multi-lib
2217 Driver Var(print_multi_lib)
2218
2219 print-multi-os-directory
2220 Driver Var(print_multi_os_directory)
2221
2222 print-prog-name=
2223 Driver JoinedOrMissing Var(print_prog_name)
2224
2225 print-search-dirs
2226 Driver Var(print_search_dirs)
2227
2228 print-sysroot
2229 Driver Var(print_sysroot)
2230
2231 print-sysroot-headers-suffix
2232 Driver Var(print_sysroot_headers_suffix)
2233
2234 quiet
2235 Common Var(quiet_flag) RejectDriver
2236 Do not display functions compiled or elapsed time
2237
2238 r
2239 Driver
2240
2241 s
2242 Driver
2243
2244 save-temps
2245 Driver
2246
2247 save-temps=
2248 Driver Joined
2249
2250 t
2251 Driver
2252
2253 time
2254 Driver Var(report_times)
2255
2256 time=
2257 Driver JoinedOrMissing
2258
2259 u
2260 Driver Joined Separate
2261
2262 undef
2263 Driver
2264 ; C option, but driver must not handle as "-u ndef".
2265
2266 v
2267 Common Driver Var(verbose_flag)
2268 Enable verbose output
2269
2270 version
2271 Common Var(version_flag) RejectDriver
2272 Display the compiler's version
2273
2274 w
2275 Common Var(inhibit_warnings)
2276 Suppress warnings
2277
2278 wrapper
2279 Driver Separate Var(wrapper_string)
2280
2281 x
2282 Driver Joined Separate
2283
2284 shared
2285 Common RejectNegative Negative(pie)
2286 Create a shared library
2287
2288 shared-libgcc
2289 Driver
2290
2291 specs
2292 Driver Separate Alias(specs=)
2293
2294 specs=
2295 Driver Joined
2296
2297 static
2298 Driver
2299
2300 static-libgcc
2301 Driver
2302
2303 static-libgfortran
2304 Driver
2305 ; Documented for Fortran, but always accepted by driver.
2306
2307 static-libstdc++
2308 Driver
2309
2310 static-libgo
2311 Driver
2312 ; Documented for Go, but always accepted by driver.
2313
2314 symbolic
2315 Driver
2316
2317 pie
2318 Common RejectNegative Negative(shared)
2319 Create a position independent executable
2320
2321 z
2322 Driver Joined Separate
2323
2324 ; This comment is to ensure we retain the blank line above.