gcc/common.opt

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