gcc/common.opt

   1 ; Options for the language- and target-independent parts of the compiler.
   2 ; Copyright (C) 2003 Free Software Foundation, Inc.
   3 ;
   4 ; This file is part of GCC.
   5 ;
   6 ; GCC is free software; you can redistribute it and/or modify it under
   7 ; the terms of the GNU General Public License as published by the Free
   8 ; Software Foundation; either version 2, or (at your option) any later
   9 ; version.
  10 ;
  11 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  12 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13 ; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14 ; for more details.
  15 ;
  16 ; You should have received a copy of the GNU General Public License
  17 ; along with GCC; see the file COPYING.  If not, write to the Free
  18 ; Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  19 ; 02111-1307, USA.
  20
  21 ; See c.opt for a description of this file's format.
  22
  23 ; Please try to keep this file in ASCII collating order.
  24
  25 -help
  26 Common
  27 Display this information
  28
  29 -param
  30 Common Separate
  31 --param <param>=<value> Set paramter <param> to value.  See below for a complete list of parameters
  32
  33 -target-help
  34 Common
  35
  36 -version
  37 Common
  38
  39 G
  40 Common Joined Separate UInteger
  41 -G<number>      Put global and static data smaller than <number> bytes into a special section (on some targets)
  42
  43 O
  44 Common JoinedOrMissing
  45 -O<number>      Set optimization level to <number>
  46
  47 Os
  48 Common
  49 Optimize for space rather than speed
  50
  51 W
  52 Common RejectNegative
  53 This switch is deprecated; use -Wextra instead
  54
  55 Waggregate-return
  56 Common
  57 Warn about returning structures, unions or arrays
  58
  59 Wcast-align
  60 Common
  61 Warn about pointer casts which increase alignment
  62
  63 Wdeprecated-declarations
  64 Common
  65 Warn about uses of __attribute__((deprecated)) declarations
  66
  67 Wdisabled-optimization
  68 Common
  69 Warn when an optimization pass is disabled
  70
  71 Werror
  72 Common
  73 Treat all warnings as errors
  74
  75 Wextra
  76 Common
  77 Print extra (possibly unwanted) warnings
  78
  79 Winline
  80 Common
  81 Warn when an inlined function cannot be inlined
  82
  83 Wlarger-than-
  84 Common RejectNegative Joined UInteger
  85 -Wlarger-than-<number>  Warn if an object is larger than <number> bytes
  86
  87 Wmissing-noreturn
  88 Common
  89 Warn about functions which might be candidates for __attribute__((noreturn))
  90
  91 Wpacked
  92 Common
  93 Warn when the packed attribute has no effect on struct layout
  94
  95 Wpadded
  96 Common
  97 Warn when padding is required to align structure members
  98
  99 Wshadow
 100 Common
 101 Warn when one local variable shadows another
 102
 103 Wstrict-aliasing
 104 Common
 105 Warn about code which might break strict aliasing rules
 106
 107 Wswitch
 108 Common
 109 Warn about enumerated switches, with no default, missing a case
 110
 111 Wswitch-default
 112 Common
 113 Warn about enumerated switches missing a \"default:\" statement
 114
 115 Wswitch-enum
 116 Common
 117 Warn about all enumerated switches missing a specific case
 118
 119 Wsystem-headers
 120 Common
 121 Do not suppress warnings from system headers
 122
 123 Wuninitialized
 124 Common
 125 Warn about uninitialized automatic variables
 126
 127 Wunreachable-code
 128 Common
 129 Warn about code that will never be executed
 130
 131 Wunused
 132 Common
 133 Enable all -Wunused- warnings
 134
 135 Wunused-function
 136 Common
 137 Warn when a function is unused
 138
 139 Wunused-label
 140 Common
 141 Warn when a label is unused
 142
 143 Wunused-parameter
 144 Common
 145 Warn when a function parameter is unused
 146
 147 Wunused-value
 148 Common
 149 Warn when an expression value is unused
 150
 151 Wunused-variable
 152 Common
 153 Warn when a variable is unused
 154
 155 aux-info
 156 Common Separate
 157 -aux-info <file>        Emit declaration information into <file>
 158
 159 aux-info=
 160 Common Joined
 161
 162 auxbase
 163 Common Separate
 164
 165 auxbase-strip
 166 Common Separate
 167
 168 d
 169 Common Joined
 170 -d<letters>     Enable dumps from specific passes of the compiler
 171
 172 dumpbase
 173 Common Separate
 174 -dumpbase <file>        Set the file basename to be used for dumps
 175
 176 fPIC
 177 Common
 178
 179 fPIE
 180 Common
 181
 182 falign-functions
 183 Common
 184 Align the start of functions
 185
 186 falign-functions=
 187 Common RejectNegative Joined UInteger
 188
 189 falign-jumps
 190 Common
 191 Align labels which are only reached by jumping
 192
 193 falign-jumps=
 194 Common RejectNegative Joined UInteger
 195
 196 falign-labels
 197 Common
 198 Align all labels
 199
 200 falign-labels=
 201 Common RejectNegative Joined UInteger
 202
 203 falign-loops
 204 Common
 205 Align the start of loops
 206
 207 falign-loops=
 208 Common RejectNegative Joined UInteger
 209
 210 fargument-alias
 211 Common
 212 Specify that arguments may alias each other and globals
 213
 214 fargument-noalias
 215 Common
 216 Assume arguments may alias globals but not each other
 217
 218 fargument-noalias-global
 219 Common
 220 Assume arguments alias neither each other nor globals
 221
 222 fasynchronous-unwind-tables
 223 Common
 224 Generate unwind tables that are exact at each instruction boundary
 225
 226 fbounds-check
 227 Common
 228 Generate code to check bounds before indexing arrays
 229
 230 fbranch-count-reg
 231 Common
 232 Replace add, compare, branch with branch on count register
 233
 234 fbranch-probabilities
 235 Common
 236 Use profiling information for branch probabilities
 237
 238 fbranch-target-load-optimize
 239 Common
 240 Perform branch target load optimization before prologue / epilogue threading
 241
 242 fbranch-target-load-optimize2
 243 Common
 244 Perform branch target load optimization after prologue / epilogue threading
 245
 246 fcall-saved-
 247 Common Joined RejectNegative
 248 -fcall-saved-<register> Mark <register> as being preserved across functions
 249
 250 fcall-used-
 251 Common Joined RejectNegative
 252 -fcall-used-<register>  Mark <register> as being corrupted by function calls
 253
 254 fcaller-saves
 255 Common
 256 Save registers around function calls
 257
 258 fcommon
 259 Common
 260 Do not put uninitialized globals in the common section
 261
 262 fcprop-registers
 263 Common
 264 Perform a register copy-propagation optimization pass
 265
 266 fcrossjumping
 267 Common
 268 Perform cross-jumping optimization
 269
 270 fcse-follow-jumps
 271 Common
 272 When running CSE, follow jumps to their targets
 273
 274 fcse-skip-blocks
 275 Common
 276 When running CSE, follow conditional jumps
 277
 278 fdata-sections
 279 Common
 280 Place data items into their own section
 281
 282 fdefer-pop
 283 Common
 284 Defer popping functions args from stack until later
 285
 286 fdelayed-branch
 287 Common
 288 Attempt to fill delay slots of branch instructions
 289
 290 fdelete-null-pointer-checks
 291 Common
 292 Delete useless null pointer checks
 293
 294 fdiagnostics-show-location=
 295 Common Joined RejectNegative
 296 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
 297
 298 fdump-unnumbered
 299 Common
 300 Suppress output of instruction numbers and line number notes in debugging dumps
 301
 302 feliminate-dwarf2-dups
 303 Common
 304 Perform DWARF2 duplicate elimination
 305
 306 feliminate-unused-debug-symbols
 307 Common
 308 Perform unused type elimination in debug info
 309
 310 feliminate-unused-debug-types
 311 Common
 312 Perform unused type elimination in debug info
 313
 314 fexceptions
 315 Common
 316 Enable exception handling
 317
 318 fexpensive-optimizations
 319 Common
 320 Perform a number of minor, expensive optimizations
 321
 322 ffast-math
 323 Common
 324
 325 ffinite-math-only
 326 Common
 327 Assume no NaNs or infinities are generated
 328
 329 ffixed-
 330 Common Joined RejectNegative
 331 -ffixed-<register>      Mark <register> as being unavailable to the compiler
 332
 333 ffloat-store
 334 Common
 335 Do not store floats in registers
 336
 337 fforce-addr
 338 Common
 339 Copy memory address constants into registers before use
 340
 341 fforce-mem
 342 Common
 343 Copy memory operands into registers before use
 344
 345 ffunction-cse
 346 Common
 347 Allow function addresses to be held in registers
 348
 349 ffunction-sections
 350 Common
 351 Place each function into its own section
 352
 353 fgcse
 354 Common
 355 Perform global common subexpression elimination
 356
 357 fgcse-lm
 358 Common
 359 Perform enhanced load motion during global common subexpression elimination
 360
 361 fgcse-sm
 362 Common
 363 Perform store motion after global common subexpression elimination
 364
 365 fgcse-las
 366 Common
 367 Perform redundant load after store elimination in global common subexpression elimination
 368
 369 fguess-branch-probability
 370 Common
 371 Enable guessing of branch probabilities
 372
 373 fident
 374 Common
 375 Process #ident directives
 376
 377 fif-conversion
 378 Common
 379 Perform conversion of conditional jumps to branchless equivalents
 380
 381 fif-conversion2
 382 Common
 383 Perform conversion of conditional jumps to conditional execution
 384
 385 finhibit-size-directive
 386 Common
 387 Do not generate .size directives
 388
 389 finline
 390 Common
 391 Pay attention to the \"inline\" keyword
 392
 393 finline-functions
 394 Common
 395 Integrate simple functions into their callers
 396
 397 finline-limit-
 398 Common RejectNegative Joined UInteger
 399
 400 finline-limit=
 401 Common RejectNegative Joined UInteger
 402 -finline-limit=<number> Limit the size of inlined functions to <number>
 403
 404 finstrument-functions
 405 Common
 406 Instrument function entry and exit with profiling calls
 407
 408 fkeep-inline-functions
 409 Common
 410 Generate code for functions even if they are fully inlined
 411
 412 fkeep-static-consts
 413 Common
 414 Emit static const variables even if they are not used
 415
 416 fleading-underscore
 417 Common
 418 Give external symbols a leading underscore
 419
 420 floop-optimize
 421 Common
 422 Perform loop optimizations
 423
 424 fmath-errno
 425 Common
 426 Set errno after built-in math functions
 427
 428 fmem-report
 429 Common
 430 Report on permanent memory allocation
 431
 432 fmerge-all-constants
 433 Common
 434 Attempt to merge identical constants and constant variables
 435
 436 fmerge-constants
 437 Common
 438 Attempt to merge identical constants across compilation units
 439
 440 fmessage-length=
 441 Common RejectNegative Joined UInteger
 442 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
 443
 444 fmove-all-movables
 445 Common
 446 Force all loop invariant computations out of loops
 447
 448 fnew-ra
 449 Common
 450 Use graph-coloring register allocation
 451
 452 fnon-call-exceptions
 453 Common
 454 Support synchronous non-call exceptions
 455
 456 fold-unroll-loops
 457 Common
 458 Perform loop unrolling when iteration count is known
 459
 460 fold-unroll-all-loops
 461 Common
 462 Perform loop unrolling for all loops
 463
 464 fomit-frame-pointer
 465 Common
 466 When possible do not generate stack frames
 467
 468 foptimize-register-move
 469 Common
 470 Do the full register move optimization pass
 471
 472 foptimize-sibling-calls
 473 Common
 474 Optimize sibling and tail recursive calls
 475
 476 fpack-struct
 477 Common
 478 Pack structure members together without holes
 479
 480 fpcc-struct-return
 481 Common
 482 Return small aggregates in memory, not registers
 483
 484 fpeel-loops
 485 Common
 486 Perform loop peeling
 487
 488 fpeephole
 489 Common
 490 Enable machine specific peephole optimizations
 491
 492 fpeephole2
 493 Common
 494 Enable an RTL peephole pass before sched2
 495
 496 fpic
 497 Common
 498 Generate position-independent code if possible
 499
 500 fpie
 501 Common
 502 Generate position-independent code for executables if possible
 503
 504 fprefetch-loop-arrays
 505 Common
 506 Generate prefetch instructions, if available, for arrays in loops
 507
 508 fprofile
 509 Common
 510 Enable basic program profiling code
 511
 512 fprofile-arcs
 513 Common
 514 Insert arc-based program profiling code
 515
 516 fprofile-values
 517 Common
 518 Insert code to profile values of expressions
 519
 520 frandom-seed
 521 Common
 522
 523 frandom-seed=
 524 Common Joined RejectNegative
 525 -frandom-seed=<string>  Make compile reproducible using <string>
 526
 527 freduce-all-givs
 528 Common
 529 Strength reduce all loop general induction variables
 530
 531 freg-struct-return
 532 Common
 533 Return small aggregates in registers
 534
 535 fregmove
 536 Common
 537 Enables a register move optimization
 538
 539 frename-registers
 540 Common
 541 Perform a register renaming optimization pass
 542
 543 freorder-blocks
 544 Common
 545 Reorder basic blocks to improve code placement
 546
 547 freorder-functions
 548 Common
 549 Reorder functions to improve code placement
 550
 551 frerun-cse-after-loop
 552 Common
 553 Add a common subexpression elimination pass after loop optimizations
 554
 555 frerun-loop-opt
 556 Common
 557 Run the loop optimizer twice
 558
 559 frounding-math
 560 Common
 561 Disable optimizations that assume default FP rounding behavior
 562
 563 fsched-interblock
 564 Common
 565 Enable scheduling across basic blocks
 566
 567 fsched-spec
 568 Common
 569 Allow speculative motion of non-loads
 570
 571 fsched-spec-load
 572 Common
 573 Allow speculative motion of some loads
 574
 575 fsched-spec-load-dangerous
 576 Common
 577 Allow speculative motion of more loads
 578
 579 fsched-verbose=
 580 Common RejectNegative Joined
 581 -fsched-verbose=<number>        Set the verbosity level of the scheduler
 582
 583 fsched2-use-superblocks
 584 Common
 585 If scheduling post reload, do superblock scheduling
 586
 587 fsched2-use-traces
 588 Common
 589 If scheduling post reload, do trace scheduling
 590
 591 fschedule-insns
 592 Common
 593 Reschedule instructions before register allocation
 594
 595 fschedule-insns2
 596 Common
 597 Reschedule instructions after register allocation
 598
 599 fsched-stalled-insns
 600 Common
 601 Allow premature scheduling of queued insns
 602
 603 fsched-stalled-insns=
 604 Common RejectNegative Joined UInteger
 605 -fsched-stalled-insns=<number>       Set number of queued insns that can be prematurely scheduled
 606
 607 fsched-stalled-insns-dep
 608 Common
 609 Set dependence distance checking in premature scheduling of queued insns
 610
 611 fsched-stalled-insns-dep=
 612 Common RejectNegative Joined UInteger
 613 -fsched-stalled-insns-dep=<number>   Set dependence distance checking in premature scheduling of queued insns
 614
 615 fshared-data
 616 Common
 617 Mark data as shared rather than private
 618
 619 fsignaling-nans
 620 Common
 621 Disable optimizations observable by IEEE signaling NaNs
 622
 623 fsingle-precision-constant
 624 Common
 625 Convert floating point constants to single precision constants
 626
 627 fstack-check
 628 Common
 629 Insert stack checking code into the program
 630
 631 fstack-limit
 632 Common
 633
 634 fstack-limit-register=
 635 Common RejectNegative Joined
 636 -fstack-limit-register=<register>       Trap if the stack goes past <register>
 637
 638 fstack-limit-symbol=
 639 Common RejectNegative Joined
 640 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
 641
 642 fstrength-reduce
 643 Common
 644 Perform strength reduction optimizations
 645
 646 fstrict-aliasing
 647 Common
 648 Assume strict aliasing rules apply
 649
 650 fsyntax-only
 651 Common
 652 Check for syntax errors, then stop
 653
 654 ftest-coverage
 655 Common
 656 Create data files needed by \"gcov\"
 657
 658 fthread-jumps
 659 Common
 660 Perform jump threading optimizations
 661
 662 ftime-report
 663 Common
 664 Report the time taken by each compiler pass
 665
 666 ftls-model=
 667 Common Joined RejectNegative
 668 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
 669
 670 ftracer
 671 Common
 672 Perform superblock formation via tail duplication
 673
 674 ftrapping-math
 675 Common
 676 Assume floating-point operations can trap
 677
 678 ftrapv
 679 Common
 680 Trap for signed overflow in addition, subtraction and multiplication
 681
 682 funit-at-a-time
 683 Common
 684 Compile whole compilation unit at a time
 685
 686 funroll-loops
 687 Common
 688 Perform loop unrolling when iteration count is known
 689
 690 funroll-all-loops
 691 Common
 692 Perform loop unrolling for all loops
 693
 694 funsafe-math-optimizations
 695 Common
 696 Allow math optimizations that may violate IEEE or ISO standards
 697
 698 funswitch-loops
 699 Common
 700 Perform loop unswitching
 701
 702 funwind-tables
 703 Common
 704 Just generate unwind tables for exception handling
 705
 706 fverbose-asm
 707 Common
 708 Add extra commentary to assembler output
 709
 710 fvpt
 711 Common
 712 Use expression value profiles in optimizations
 713
 714 fweb
 715 Common
 716 Construct webs and split unrelated uses of single variable
 717
 718 fwrapv
 719 Common
 720 Assume signed arithmetic overflow wraps around
 721
 722 fwritable-strings
 723 Common
 724 Store strings in writable data section
 725
 726 fzero-initialized-in-bss
 727 Common
 728 Put zero initialized data in the bss section
 729
 730 g
 731 Common JoinedOrMissing
 732 Generate debug information in default format
 733
 734 gcoff
 735 Common JoinedOrMissing
 736 Generate debug information in COFF format
 737
 738 gdwarf
 739 Common JoinedOrMissing
 740 Generate debug information in DWARF v1 format
 741
 742 gdwarf+
 743 Common JoinedOrMissing
 744 Generate debug information in extended DWARF v1 format
 745
 746 gdwarf-2
 747 Common JoinedOrMissing
 748 Generate debug information in DWARF v2 format
 749
 750 ggdb
 751 Common JoinedOrMissing
 752 Generate debug information in default extended format
 753
 754 gstabs
 755 Common JoinedOrMissing
 756 Generate debug information in STABS format
 757
 758 gstabs+
 759 Common JoinedOrMissing
 760 Generate debug information in extended STABS format
 761
 762 gvms
 763 Common JoinedOrMissing
 764 Generate debug information in VMS format
 765
 766 gxcoff
 767 Common JoinedOrMissing
 768 Generate debug information in XCOFF format
 769
 770 gxcoff+
 771 Common JoinedOrMissing
 772 Generate debug information in extended XCOFF format
 773
 774 m
 775 Common Joined
 776
 777 o
 778 Common Joined Separate
 779 -o <file>       Place output into <file>
 780
 781 p
 782 Common
 783 Enable function profiling
 784
 785 pedantic
 786 Common
 787 Issue warnings needed for strict compliance to the standard
 788
 789 pedantic-errors
 790 Common
 791 Like -pedantic but issue them as errors
 792
 793 quiet
 794 Common
 795 Do not display functions compiled or elapsed time
 796
 797 version
 798 Common
 799 Display the compiler's version
 800
 801 w
 802 Common
 803 Suppress warnings
 804
 805 ; This comment is to ensure we retain the blank line above.