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 ; sched_stalled_insns means that insns can be moved prematurely from the queue
1859 ; of stalled insns into the ready list.
1860 fsched-stalled-insns
1861 Common Report Var(flag_sched_stalled_insns) Optimization UInteger
1862 Allow premature scheduling of queued insns
1863
1864 fsched-stalled-insns=
1865 Common RejectNegative Joined UInteger
1866 -fsched-stalled-insns=<number>  Set number of queued insns that can be prematurely scheduled
1867
1868 ; sched_stalled_insns_dep controls how many recently scheduled cycles will
1869 ; be examined for a dependency on a stalled insn that is candidate for
1870 ; premature removal from the queue of stalled insns into the ready list (has
1871 ; an effect only if the flag 'sched_stalled_insns' is set).
1872 fsched-stalled-insns-dep
1873 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1) Optimization UInteger
1874 Set dependence distance checking in premature scheduling of queued insns
1875
1876 fsched-stalled-insns-dep=
1877 Common RejectNegative Joined UInteger
1878 -fsched-stalled-insns-dep=<number>      Set dependence distance checking in premature scheduling of queued insns
1879
1880 fsched-group-heuristic
1881 Common Report Var(flag_sched_group_heuristic) Init(1) Optimization
1882 Enable the group heuristic in the scheduler
1883
1884 fsched-critical-path-heuristic
1885 Common Report Var(flag_sched_critical_path_heuristic) Init(1) Optimization
1886 Enable the critical path heuristic in the scheduler
1887
1888 fsched-spec-insn-heuristic
1889 Common Report Var(flag_sched_spec_insn_heuristic) Init(1) Optimization
1890 Enable the speculative instruction heuristic in the scheduler
1891
1892 fsched-rank-heuristic
1893 Common Report Var(flag_sched_rank_heuristic) Init(1) Optimization
1894 Enable the rank heuristic in the scheduler
1895
1896 fsched-last-insn-heuristic
1897 Common Report Var(flag_sched_last_insn_heuristic) Init(1) Optimization
1898 Enable the last instruction heuristic in the scheduler
1899
1900 fsched-dep-count-heuristic
1901 Common Report Var(flag_sched_dep_count_heuristic) Init(1) Optimization
1902 Enable the dependent count heuristic in the scheduler
1903
1904 fsection-anchors
1905 Common Report Var(flag_section_anchors) Optimization
1906 Access data in the same section from shared anchor points
1907
1908 fsee
1909 Common Ignore
1910 Does nothing.  Preserved for backward compatibility.
1911
1912 fzee
1913 Common Ignore
1914 Does nothing.  Preserved for backward compatibility.
1915
1916 free
1917 Common Report Var(flag_ree) Init(0)
1918 Turn on Redundant Extensions Elimination pass.
1919
1920 fshow-column
1921 Common Report Var(flag_show_column) Init(1)
1922 Show column numbers in diagnostics, when available.  Default on
1923
1924 fshrink-wrap
1925 Common Report Var(flag_shrink_wrap) Optimization
1926 Emit function prologues only before parts of the function that need it,
1927 rather than at the top of the function.
1928
1929 fsignaling-nans
1930 Common Report Var(flag_signaling_nans) Optimization SetByCombined
1931 Disable optimizations observable by IEEE signaling NaNs
1932
1933 fsigned-zeros
1934 Common Report Var(flag_signed_zeros) Init(1) Optimization SetByCombined
1935 Disable floating point optimizations that ignore the IEEE signedness of zero
1936
1937 fsingle-precision-constant
1938 Common Report Var(flag_single_precision_constant) Optimization
1939 Convert floating point constants to single precision constants
1940
1941 fsplit-ivs-in-unroller
1942 Common Report Var(flag_split_ivs_in_unroller) Init(1) Optimization
1943 Split lifetimes of induction variables when loops are unrolled
1944
1945 fsplit-stack
1946 Common Report Var(flag_split_stack) Init(-1)
1947 Generate discontiguous stack frames
1948
1949 fsplit-wide-types
1950 Common Report Var(flag_split_wide_types) Optimization
1951 Split wide types into independent registers
1952
1953 fvariable-expansion-in-unroller
1954 Common Report Var(flag_variable_expansion_in_unroller) Optimization
1955 Apply variable expansion when loops are unrolled
1956
1957 fstack-check=
1958 Common Report RejectNegative Joined
1959 -fstack-check=[no|generic|specific]     Insert stack checking code into the program
1960
1961 fstack-check
1962 Common Alias(fstack-check=, specific, no)
1963 Insert stack checking code into the program.  Same as -fstack-check=specific
1964
1965 fstack-limit
1966 Common Var(common_deferred_options) Defer
1967
1968 fstack-limit-register=
1969 Common RejectNegative Joined Var(common_deferred_options) Defer
1970 -fstack-limit-register=<register>       Trap if the stack goes past <register>
1971
1972 fstack-limit-symbol=
1973 Common RejectNegative Joined Var(common_deferred_options) Defer
1974 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
1975
1976 fstack-protector
1977 Common Report Var(flag_stack_protect, 1)
1978 Use propolice as a stack protection method
1979
1980 fstack-protector-all
1981 Common Report RejectNegative Var(flag_stack_protect, 2)
1982 Use a stack protection method for every function
1983
1984 fstack-protector-strong
1985 Common Report RejectNegative Var(flag_stack_protect, 3)
1986 Use a smart stack protection method for certain functions
1987
1988 fstack-usage
1989 Common RejectNegative Var(flag_stack_usage)
1990 Output stack usage information on a per-function basis
1991
1992 fstrength-reduce
1993 Common Ignore
1994 Does nothing.  Preserved for backward compatibility.
1995
1996 ; Nonzero if we should do (language-dependent) alias analysis.
1997 ; Typically, this analysis will assume that expressions of certain
1998 ; types do not alias expressions of certain other types.  Only used
1999 ; if alias analysis (in general) is enabled.
2000 fstrict-aliasing
2001 Common Report Var(flag_strict_aliasing) Optimization
2002 Assume strict aliasing rules apply
2003
2004 fstrict-overflow
2005 Common Report Var(flag_strict_overflow)
2006 Treat signed overflow as undefined
2007
2008 fsync-libcalls
2009 Common Report Var(flag_sync_libcalls) Init(1)
2010 Implement __atomic operations via libcalls to legacy __sync functions
2011
2012 fsyntax-only
2013 Common Report Var(flag_syntax_only)
2014 Check for syntax errors, then stop
2015
2016 ftest-coverage
2017 Common Report Var(flag_test_coverage)
2018 Create data files needed by \"gcov\"
2019
2020 fthread-jumps
2021 Common Report Var(flag_thread_jumps) Optimization
2022 Perform jump threading optimizations
2023
2024 ftime-report
2025 Common Report Var(time_report)
2026 Report the time taken by each compiler pass
2027
2028 ftls-model=
2029 Common Joined RejectNegative Enum(tls_model) Var(flag_tls_default) Init(TLS_MODEL_GLOBAL_DYNAMIC)
2030 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
2031
2032 Enum
2033 Name(tls_model) Type(enum tls_model) UnknownError(unknown TLS model %qs)
2034
2035 EnumValue
2036 Enum(tls_model) String(global-dynamic) Value(TLS_MODEL_GLOBAL_DYNAMIC)
2037
2038 EnumValue
2039 Enum(tls_model) String(local-dynamic) Value(TLS_MODEL_LOCAL_DYNAMIC)
2040
2041 EnumValue
2042 Enum(tls_model) String(initial-exec) Value(TLS_MODEL_INITIAL_EXEC)
2043
2044 EnumValue
2045 Enum(tls_model) String(local-exec) Value(TLS_MODEL_LOCAL_EXEC)
2046
2047 ftoplevel-reorder
2048 Common Report Var(flag_toplevel_reorder) Init(2) Optimization
2049 Reorder top level functions, variables, and asms
2050
2051 ftracer
2052 Common Report Var(flag_tracer)
2053 Perform superblock formation via tail duplication
2054
2055 ; Zero means that floating-point math operations cannot generate a
2056 ; (user-visible) trap.  This is the case, for example, in nonstop
2057 ; IEEE 754 arithmetic.
2058 ftrapping-math
2059 Common Report Var(flag_trapping_math) Init(1) Optimization SetByCombined
2060 Assume floating-point operations can trap
2061
2062 ftrapv
2063 Common Report Var(flag_trapv) Optimization
2064 Trap for signed overflow in addition, subtraction and multiplication
2065
2066 ftree-ccp
2067 Common Report Var(flag_tree_ccp) Optimization
2068 Enable SSA-CCP optimization on trees
2069
2070 ftree-bit-ccp
2071 Common Report Var(flag_tree_bit_ccp) Optimization
2072 Enable SSA-BIT-CCP optimization on trees
2073
2074 ftree-store-ccp
2075 Common Ignore
2076 Does nothing.  Preserved for backward compatibility.
2077
2078 ftree-ch
2079 Common Report Var(flag_tree_ch) Optimization
2080 Enable loop header copying on trees
2081
2082 ftree-coalesce-inlined-vars
2083 Common Report Var(flag_ssa_coalesce_vars,1) Init(2) RejectNegative Optimization
2084 Enable coalescing of copy-related user variables that are inlined
2085
2086 ftree-coalesce-vars
2087 Common Report Var(flag_ssa_coalesce_vars,2) Optimization
2088 Enable coalescing of all copy-related user variables
2089
2090 ftree-copyrename
2091 Common Report Var(flag_tree_copyrename) Optimization
2092 Replace SSA temporaries with better names in copies
2093
2094 ftree-copy-prop
2095 Common Report Var(flag_tree_copy_prop) Optimization
2096 Enable copy propagation on trees
2097
2098 ftree-store-copy-prop
2099 Common Ignore
2100 Does nothing.  Preserved for backward compatibility.
2101
2102 ftree-cselim
2103 Common Report Var(flag_tree_cselim) Init(2) Optimization
2104 Transform condition stores into unconditional ones
2105
2106 ftree-switch-conversion
2107 Common Report Var(flag_tree_switch_conversion) Optimization
2108 Perform conversions of switch initializations.
2109
2110 ftree-dce
2111 Common Report Var(flag_tree_dce) Optimization
2112 Enable SSA dead code elimination optimization on trees
2113
2114 ftree-dominator-opts
2115 Common Report Var(flag_tree_dom) Optimization
2116 Enable dominator optimizations
2117
2118 ftree-tail-merge
2119 Common Report Var(flag_tree_tail_merge) Optimization
2120 Enable tail merging on trees
2121
2122 ftree-dse
2123 Common Report Var(flag_tree_dse) Optimization
2124 Enable dead store elimination
2125
2126 ftree-forwprop
2127 Common Report Var(flag_tree_forwprop) Init(1) Optimization
2128 Enable forward propagation on trees
2129
2130 ftree-fre
2131 Common Report Var(flag_tree_fre) Optimization
2132 Enable Full Redundancy Elimination (FRE) on trees
2133
2134 foptimize-strlen
2135 Common Report Var(flag_optimize_strlen) Optimization
2136 Enable string length optimizations on trees
2137
2138 fisolate-erroneous-paths-dereference
2139 Common Report Var(flag_isolate_erroneous_paths_dereference) Optimization
2140 Detect paths which trigger erroneous or undefined behaviour due to
2141 dereferencing a NULL pointer.  Isolate those paths from the main control
2142 flow and turn the statement with erroneous or undefined behaviour into a trap.
2143
2144 fisolate-erroneous-paths-attribute
2145 Common Report Var(flag_isolate_erroneous_paths_attribute) Optimization
2146 Detect paths which trigger erroneous or undefined behaviour due a NULL value
2147 being used in a way which is forbidden by a returns_nonnull or nonnull
2148 attribute.  Isolate those paths from the main control flow and turn the
2149 statement with erroneous or undefined behaviour into a trap.
2150
2151 ftree-loop-distribution
2152 Common Report Var(flag_tree_loop_distribution) Optimization
2153 Enable loop distribution on trees
2154
2155 ftree-loop-distribute-patterns
2156 Common Report Var(flag_tree_loop_distribute_patterns) Optimization
2157 Enable loop distribution for patterns transformed into a library call
2158
2159 ftree-loop-im
2160 Common Report Var(flag_tree_loop_im) Init(1) Optimization
2161 Enable loop invariant motion on trees
2162
2163 ftree-loop-linear
2164 Common Alias(floop-interchange)
2165 Enable loop interchange transforms.  Same as -floop-interchange
2166
2167 ftree-loop-ivcanon
2168 Common Report Var(flag_tree_loop_ivcanon) Init(1) Optimization
2169 Create canonical induction variables in loops
2170
2171 ftree-loop-optimize
2172 Common Report Var(flag_tree_loop_optimize) Init(1) Optimization
2173 Enable loop optimizations on tree level
2174
2175 ftree-parallelize-loops=
2176 Common Report Joined RejectNegative UInteger Var(flag_tree_parallelize_loops) Init(1)
2177 Enable automatic parallelization of loops
2178
2179 ftree-phiprop
2180 Common Report Var(flag_tree_phiprop) Init(1) Optimization
2181 Enable hoisting loads from conditional pointers.
2182
2183 ftree-pre
2184 Common Report Var(flag_tree_pre) Optimization
2185 Enable SSA-PRE optimization on trees
2186
2187 ftree-partial-pre
2188 Common Report Var(flag_tree_partial_pre) Optimization
2189 In SSA-PRE optimization on trees, enable partial-partial redundancy elimination
2190
2191 ftree-pta
2192 Common Report Var(flag_tree_pta) Optimization
2193 Perform function-local points-to analysis on trees.
2194
2195 ftree-reassoc
2196 Common Report Var(flag_tree_reassoc) Init(1) Optimization
2197 Enable reassociation on tree level
2198
2199 ftree-salias
2200 Common Ignore
2201 Does nothing.  Preserved for backward compatibility.
2202
2203 ftree-sink
2204 Common Report Var(flag_tree_sink) Optimization
2205 Enable SSA code sinking on trees
2206
2207 ftree-slsr
2208 Common Report Var(flag_tree_slsr) Optimization
2209 Perform straight-line strength reduction
2210
2211 ftree-sra
2212 Common Report Var(flag_tree_sra) Optimization
2213 Perform scalar replacement of aggregates
2214
2215 ftree-ter
2216 Common Report Var(flag_tree_ter) Optimization
2217 Replace temporary expressions in the SSA->normal pass
2218
2219 ftree-lrs
2220 Common Report Var(flag_tree_live_range_split) Optimization
2221 Perform live range splitting during the SSA->normal pass
2222
2223 ftree-vrp
2224 Common Report Var(flag_tree_vrp) Init(0) Optimization
2225 Perform Value Range Propagation on trees
2226
2227 funit-at-a-time
2228 Common Report Var(flag_unit_at_a_time) Init(1) Optimization
2229 Compile whole compilation unit at a time
2230
2231 funroll-loops
2232 Common Report Var(flag_unroll_loops) Optimization
2233 Perform loop unrolling when iteration count is known
2234
2235 funroll-all-loops
2236 Common Report Var(flag_unroll_all_loops) Optimization
2237 Perform loop unrolling for all loops
2238
2239 ; Nonzero means that loop optimizer may assume that the induction variables
2240 ; that control loops do not overflow and that the loops with nontrivial
2241 ; exit condition are not infinite
2242 funsafe-loop-optimizations
2243 Common Report Var(flag_unsafe_loop_optimizations) Optimization
2244 Allow loop optimizations to assume that the loops behave in normal way
2245
2246 fassociative-math
2247 Common Report Var(flag_associative_math) SetByCombined
2248 Allow optimization for floating-point arithmetic which may change the
2249 result of the operation due to rounding.
2250
2251 freciprocal-math
2252 Common Report Var(flag_reciprocal_math) SetByCombined
2253 Same as -fassociative-math for expressions which include division.
2254
2255 ; Nonzero means that unsafe floating-point math optimizations are allowed
2256 ; for the sake of speed.  IEEE compliance is not guaranteed, and operations
2257 ; are allowed to assume that their arguments and results are "normal"
2258 ; (e.g., nonnegative for SQRT).
2259 funsafe-math-optimizations
2260 Common Report Var(flag_unsafe_math_optimizations) Optimization SetByCombined
2261 Allow math optimizations that may violate IEEE or ISO standards
2262
2263 funswitch-loops
2264 Common Report Var(flag_unswitch_loops) Optimization
2265 Perform loop unswitching
2266
2267 funwind-tables
2268 Common Report Var(flag_unwind_tables) Optimization
2269 Just generate unwind tables for exception handling
2270
2271 fuse-ld=bfd
2272 Common Driver Negative(fuse-ld=gold)
2273 Use the bfd linker instead of the default linker
2274
2275 fuse-ld=gold
2276 Common Driver Negative(fuse-ld=bfd)
2277 Use the gold linker instead of the default linker
2278
2279 fuse-linker-plugin
2280 Common Undocumented Var(flag_use_linker_plugin)
2281
2282 ; Positive if we should track variables, negative if we should run
2283 ; the var-tracking pass only to discard debug annotations, zero if
2284 ; we're not to run it.  When flag_var_tracking == 2 (AUTODETECT_VALUE) it
2285 ; will be set according to optimize, debug_info_level and debug_hooks
2286 ; in process_options ().
2287 fvar-tracking
2288 Common Report Var(flag_var_tracking) Init(2) Optimization
2289 Perform variable tracking
2290
2291 ; Positive if we should track variables at assignments, negative if
2292 ; we should run the var-tracking pass only to discard debug
2293 ; annotations.  When flag_var_tracking_assignments ==
2294 ; AUTODETECT_VALUE it will be set according to flag_var_tracking.
2295 fvar-tracking-assignments
2296 Common Report Var(flag_var_tracking_assignments) Init(2) Optimization
2297 Perform variable tracking by annotating assignments
2298
2299 ; Nonzero if we should toggle flag_var_tracking_assignments after
2300 ; processing options and computing its default.  */
2301 fvar-tracking-assignments-toggle
2302 Common Report Var(flag_var_tracking_assignments_toggle) Optimization
2303 Toggle -fvar-tracking-assignments
2304
2305 ; Positive if we should track uninitialized variables, negative if
2306 ; we should run the var-tracking pass only to discard debug
2307 ; annotations.  When flag_var_tracking_uninit == AUTODETECT_VALUE it
2308 ; will be set according to flag_var_tracking.
2309 fvar-tracking-uninit
2310 Common Report Var(flag_var_tracking_uninit) Optimization
2311 Perform variable tracking and also tag variables that are uninitialized
2312
2313 ftree-vectorize
2314 Common Report Var(flag_tree_vectorize) Optimization
2315 Enable vectorization on trees
2316
2317 ftree-vectorizer-verbose=
2318 Common Joined RejectNegative Ignore
2319 Does nothing.  Preserved for backward compatibility.
2320
2321 ftree-loop-vectorize
2322 Common Report Var(flag_tree_loop_vectorize) Optimization
2323 Enable loop vectorization on trees
2324
2325 ftree-slp-vectorize
2326 Common Report Var(flag_tree_slp_vectorize) Optimization
2327 Enable basic block vectorization (SLP) on trees
2328
2329 fvect-cost-model=
2330 Common Joined RejectNegative Enum(vect_cost_model) Var(flag_vect_cost_model) Init(VECT_COST_MODEL_DEFAULT)
2331 Specifies the cost model for vectorization
2332
2333 fsimd-cost-model=
2334 Common Joined RejectNegative Enum(vect_cost_model) Var(flag_simd_cost_model) Init(VECT_COST_MODEL_UNLIMITED)
2335 Specifies the vectorization cost model for code marked with a simd directive
2336
2337 Enum
2338 Name(vect_cost_model) Type(enum vect_cost_model) UnknownError(unknown vectorizer cost model %qs)
2339
2340 EnumValue
2341 Enum(vect_cost_model) String(unlimited) Value(VECT_COST_MODEL_UNLIMITED)
2342
2343 EnumValue
2344 Enum(vect_cost_model) String(dynamic) Value(VECT_COST_MODEL_DYNAMIC)
2345
2346 EnumValue
2347 Enum(vect_cost_model) String(cheap) Value(VECT_COST_MODEL_CHEAP)
2348
2349 fvect-cost-model
2350 Common RejectNegative Alias(fvect-cost-model=,dynamic)
2351 Enables the dynamic vectorizer cost model.  Preserved for backward compatibility.
2352
2353 fno-vect-cost-model
2354 Common RejectNegative Alias(fvect-cost-model=,unlimited)
2355 Enables the unlimited vectorizer cost model.  Preserved for backward compatibility.
2356
2357 ftree-vect-loop-version
2358 Common Ignore
2359 Does nothing. Preserved for backward compatibility.
2360
2361 ftree-scev-cprop
2362 Common Report Var(flag_tree_scev_cprop) Init(1) Optimization
2363 Enable copy propagation of scalar-evolution information.
2364
2365 ; -fverbose-asm causes extra commentary information to be produced in
2366 ; the generated assembly code (to make it more readable).  This option
2367 ; is generally only of use to those who actually need to read the
2368 ; generated assembly code (perhaps while debugging the compiler itself).
2369 ; -fno-verbose-asm, the default, causes the extra information
2370 ; to not be added and is useful when comparing two assembler files.
2371 fverbose-asm
2372 Common Report Var(flag_verbose_asm)
2373 Add extra commentary to assembler output
2374
2375 fvisibility=
2376 Common Joined RejectNegative Enum(symbol_visibility) Var(default_visibility) Init(VISIBILITY_DEFAULT)
2377 -fvisibility=[default|internal|hidden|protected]        Set the default symbol visibility
2378
2379 Enum
2380 Name(symbol_visibility) Type(enum symbol_visibility) UnknownError(unrecognized visibility value %qs)
2381
2382 EnumValue
2383 Enum(symbol_visibility) String(default) Value(VISIBILITY_DEFAULT)
2384
2385 EnumValue
2386 Enum(symbol_visibility) String(internal) Value(VISIBILITY_INTERNAL)
2387
2388 EnumValue
2389 Enum(symbol_visibility) String(hidden) Value(VISIBILITY_HIDDEN)
2390
2391 EnumValue
2392 Enum(symbol_visibility) String(protected) Value(VISIBILITY_PROTECTED)
2393
2394 fvtable-verify=
2395 Common Joined RejectNegative Enum(vtv_priority) Var(flag_vtable_verify) Init(VTV_NO_PRIORITY)
2396 Validate vtable pointers before using them.
2397
2398 Enum
2399 Name(vtv_priority) Type(enum vtv_priority) UnknownError(unknown vtable verify initialization priority %qs)
2400
2401 EnumValue
2402 Enum(vtv_priority) String(none) Value(VTV_NO_PRIORITY)
2403
2404 EnumValue
2405 Enum(vtv_priority) String(std) Value(VTV_STANDARD_PRIORITY)
2406
2407 EnumValue
2408 Enum(vtv_priority) String(preinit) Value(VTV_PREINIT_PRIORITY)
2409
2410 fvtv-counts
2411 Common Var(flag_vtv_counts)
2412 Output vtable verification counters.
2413
2414 fvtv-debug
2415 Common Var(flag_vtv_debug)
2416 Output vtable verification pointer sets information.
2417
2418 fvpt
2419 Common Report Var(flag_value_profile_transformations) Optimization
2420 Use expression value profiles in optimizations
2421
2422 fweb
2423 Common Report Var(flag_web) Init(2) Optimization
2424 Construct webs and split unrelated uses of single variable
2425
2426 ftree-builtin-call-dce
2427 Common Report Var(flag_tree_builtin_call_dce) Init(0) Optimization
2428 Enable conditional dead code elimination for builtin calls
2429
2430 fwhole-program
2431 Common Report Var(flag_whole_program) Init(0) Optimization
2432 Perform whole program optimizations
2433
2434 fwrapv
2435 Common Report Var(flag_wrapv) Optimization
2436 Assume signed arithmetic overflow wraps around
2437
2438 fzero-initialized-in-bss
2439 Common Report Var(flag_zero_initialized_in_bss) Init(1)
2440 Put zero initialized data in the bss section
2441
2442 g
2443 Common JoinedOrMissing
2444 Generate debug information in default format
2445
2446 gcoff
2447 Common JoinedOrMissing Negative(gdwarf)
2448 Generate debug information in COFF format
2449
2450 gdwarf
2451 Common JoinedOrMissing Negative(gdwarf-)
2452 Generate debug information in default version of DWARF format
2453
2454 gdwarf-
2455 Common Joined UInteger Var(dwarf_version) Init(4) Negative(gstabs)
2456 Generate debug information in DWARF v2 (or later) format
2457
2458 ggdb
2459 Common JoinedOrMissing
2460 Generate debug information in default extended format
2461
2462 gno-pubnames
2463 Common Negative(gpubnames) Var(debug_generate_pub_sections, 0) Init(-1)
2464 Don't generate DWARF pubnames and pubtypes sections.
2465
2466 gpubnames
2467 Common Negative(ggnu-pubnames) Var(debug_generate_pub_sections, 1)
2468 Generate DWARF pubnames and pubtypes sections.
2469
2470 ggnu-pubnames
2471 Common Negative(gno-pubnames) Var(debug_generate_pub_sections, 2)
2472 Generate DWARF pubnames and pubtypes sections with GNU extensions.
2473
2474 gno-record-gcc-switches
2475 Common RejectNegative Var(dwarf_record_gcc_switches,0) Init(1)
2476 Don't record gcc command line switches in DWARF DW_AT_producer.
2477
2478 grecord-gcc-switches
2479 Common RejectNegative Var(dwarf_record_gcc_switches,1)
2480 Record gcc command line switches in DWARF DW_AT_producer.
2481
2482 gno-split-dwarf
2483 Common Driver RejectNegative Var(dwarf_split_debug_info,0) Init(0)
2484 Don't generate debug information in separate .dwo files
2485
2486 gsplit-dwarf
2487 Common Driver RejectNegative Var(dwarf_split_debug_info,1)
2488 Generate debug information in separate .dwo files
2489
2490 gstabs
2491 Common JoinedOrMissing Negative(gstabs+)
2492 Generate debug information in STABS format
2493
2494 gstabs+
2495 Common JoinedOrMissing Negative(gvms)
2496 Generate debug information in extended STABS format
2497
2498 gno-strict-dwarf
2499 Common RejectNegative Var(dwarf_strict,0) Init(0)
2500 Emit DWARF additions beyond selected version
2501
2502 gstrict-dwarf
2503 Common Report RejectNegative Var(dwarf_strict,1)
2504 Don't emit DWARF additions beyond selected version
2505
2506 gtoggle
2507 Common Report Var(flag_gtoggle)
2508 Toggle debug information generation
2509
2510 gvms
2511 Common JoinedOrMissing Negative(gxcoff)
2512 Generate debug information in VMS format
2513
2514 gxcoff
2515 Common JoinedOrMissing Negative(gxcoff+)
2516 Generate debug information in XCOFF format
2517
2518 gxcoff+
2519 Common JoinedOrMissing Negative(gcoff)
2520 Generate debug information in extended XCOFF format
2521
2522 h
2523 Driver Joined Separate
2524
2525 iplugindir=
2526 Common Joined Var(plugindir_string) Init(0)
2527 -iplugindir=<dir>       Set <dir> to be the default plugin directory
2528
2529 imultiarch
2530 Common Joined Separate RejectDriver Var(imultiarch) Init(0)
2531 -imultiarch <dir>       Set <dir> to be the multiarch include subdirectory
2532
2533 l
2534 Driver Joined Separate
2535
2536 n
2537 Driver
2538
2539 no-canonical-prefixes
2540 Driver
2541
2542 nodefaultlibs
2543 Driver
2544
2545 nostartfiles
2546 Driver
2547
2548 nostdlib
2549 Driver
2550
2551 o
2552 Common Driver Joined Separate Var(asm_file_name) MissingArgError(missing filename after %qs)
2553 -o <file>       Place output into <file>
2554
2555 p
2556 Common Var(profile_flag)
2557 Enable function profiling
2558
2559 pass-exit-codes
2560 Driver Var(pass_exit_codes)
2561
2562 pedantic
2563 Common Alias(Wpedantic)
2564
2565 pedantic-errors
2566 Common Var(flag_pedantic_errors)
2567 Like -pedantic but issue them as errors
2568
2569 pg
2570 Driver
2571
2572 pipe
2573 Driver Var(use_pipes)
2574
2575 print-file-name=
2576 Driver JoinedOrMissing Var(print_file_name)
2577
2578 print-libgcc-file-name
2579 Driver
2580
2581 print-multi-directory
2582 Driver Var(print_multi_directory)
2583
2584 print-multi-lib
2585 Driver Var(print_multi_lib)
2586
2587 print-multi-os-directory
2588 Driver Var(print_multi_os_directory)
2589
2590 print-multiarch
2591 Driver Var(print_multiarch)
2592
2593 print-prog-name=
2594 Driver JoinedOrMissing Var(print_prog_name)
2595
2596 print-search-dirs
2597 Driver Var(print_search_dirs)
2598
2599 print-sysroot
2600 Driver Var(print_sysroot)
2601
2602 print-sysroot-headers-suffix
2603 Driver Var(print_sysroot_headers_suffix)
2604
2605 quiet
2606 Common Var(quiet_flag) RejectDriver
2607 Do not display functions compiled or elapsed time
2608
2609 r
2610 Driver
2611
2612 s
2613 Driver
2614
2615 save-temps
2616 Driver
2617
2618 save-temps=
2619 Driver Joined
2620
2621 t
2622 Driver
2623
2624 time
2625 Driver Var(report_times)
2626
2627 time=
2628 Driver JoinedOrMissing
2629
2630 u
2631 Driver Joined Separate
2632
2633 undef
2634 Driver
2635 ; C option, but driver must not handle as "-u ndef".
2636
2637 v
2638 Common Driver Var(verbose_flag)
2639 Enable verbose output
2640
2641 version
2642 Common Var(version_flag) RejectDriver
2643 Display the compiler's version
2644
2645 w
2646 Common Var(inhibit_warnings)
2647 Suppress warnings
2648
2649 wrapper
2650 Driver Separate Var(wrapper_string)
2651
2652 x
2653 Driver Joined Separate
2654
2655 shared
2656 Driver RejectNegative Negative(pie)
2657 Create a shared library
2658
2659 shared-libgcc
2660 Driver
2661
2662 specs
2663 Driver Separate Alias(specs=)
2664
2665 specs=
2666 Driver Joined
2667
2668 static
2669 Driver
2670
2671 static-libgcc
2672 Driver
2673
2674 static-libgfortran
2675 Driver
2676 ; Documented for Fortran, but always accepted by driver.
2677
2678 static-libstdc++
2679 Driver
2680
2681 static-libgo
2682 Driver
2683 ; Documented for Go, but always accepted by driver.
2684
2685 static-libasan
2686 Driver
2687
2688 static-libtsan
2689 Driver
2690
2691 static-liblsan
2692 Driver
2693
2694 static-libubsan
2695 Driver
2696
2697 symbolic
2698 Driver
2699
2700 pie
2701 Driver RejectNegative Negative(shared)
2702 Create a position independent executable
2703
2704 z
2705 Driver Joined Separate
2706
2707 fuse-caller-save
2708 Common Report Var(flag_use_caller_save) Optimization
2709 Use caller save register across calls if possible
2710
2711 ; This comment is to ensure we retain the blank line above.