gcc/common.opt

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