gcc/common.opt

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