gcc/common.opt

   1 ; Options for the language- and target-independent parts of the compiler.
   2 ; Copyright (C) 2003, 2004 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 fbtr-bb-exclusive
 247 Common
 248 Restrict target load migration not to re-use registers in any basic block
 249
 250 fcall-saved-
 251 Common Joined RejectNegative
 252 -fcall-saved-<register> Mark <register> as being preserved across functions
 253
 254 fcall-used-
 255 Common Joined RejectNegative
 256 -fcall-used-<register>  Mark <register> as being corrupted by function calls
 257
 258 fcaller-saves
 259 Common
 260 Save registers around function calls
 261
 262 fcommon
 263 Common
 264 Do not put uninitialized globals in the common section
 265
 266 fcprop-registers
 267 Common
 268 Perform a register copy-propagation optimization pass
 269
 270 fcrossjumping
 271 Common
 272 Perform cross-jumping optimization
 273
 274 fcse-follow-jumps
 275 Common
 276 When running CSE, follow jumps to their targets
 277
 278 fcse-skip-blocks
 279 Common
 280 When running CSE, follow conditional jumps
 281
 282 fdata-sections
 283 Common
 284 Place data items into their own section
 285
 286 fdefer-pop
 287 Common
 288 Defer popping functions args from stack until later
 289
 290 fdelayed-branch
 291 Common
 292 Attempt to fill delay slots of branch instructions
 293
 294 fdelete-null-pointer-checks
 295 Common
 296 Delete useless null pointer checks
 297
 298 fdiagnostics-show-location=
 299 Common Joined RejectNegative
 300 -fdiagnostics-show-location=[once|every-line]   How often to emit source location at the beginning of line-wrapped diagnostics
 301
 302 fdump-unnumbered
 303 Common
 304 Suppress output of instruction numbers and line number notes in debugging dumps
 305
 306 feliminate-dwarf2-dups
 307 Common
 308 Perform DWARF2 duplicate elimination
 309
 310 feliminate-unused-debug-symbols
 311 Common
 312 Perform unused type elimination in debug info
 313
 314 feliminate-unused-debug-types
 315 Common
 316 Perform unused type elimination in debug info
 317
 318 fexceptions
 319 Common
 320 Enable exception handling
 321
 322 fexpensive-optimizations
 323 Common
 324 Perform a number of minor, expensive optimizations
 325
 326 ffast-math
 327 Common
 328
 329 ffinite-math-only
 330 Common
 331 Assume no NaNs or infinities are generated
 332
 333 ffixed-
 334 Common Joined RejectNegative
 335 -ffixed-<register>      Mark <register> as being unavailable to the compiler
 336
 337 ffloat-store
 338 Common
 339 Do not store floats in registers
 340
 341 fforce-addr
 342 Common
 343 Copy memory address constants into registers before use
 344
 345 fforce-mem
 346 Common
 347 Copy memory operands into registers before use
 348
 349 ffunction-cse
 350 Common
 351 Allow function addresses to be held in registers
 352
 353 ffunction-sections
 354 Common
 355 Place each function into its own section
 356
 357 fgcse
 358 Common
 359 Perform global common subexpression elimination
 360
 361 fgcse-lm
 362 Common
 363 Perform enhanced load motion during global common subexpression elimination
 364
 365 fgcse-sm
 366 Common
 367 Perform store motion after global common subexpression elimination
 368
 369 fgcse-las
 370 Common
 371 Perform redundant load after store elimination in global common subexpression elimination
 372
 373 fguess-branch-probability
 374 Common
 375 Enable guessing of branch probabilities
 376
 377 fident
 378 Common
 379 Process #ident directives
 380
 381 fif-conversion
 382 Common
 383 Perform conversion of conditional jumps to branchless equivalents
 384
 385 fif-conversion2
 386 Common
 387 Perform conversion of conditional jumps to conditional execution
 388
 389 finhibit-size-directive
 390 Common
 391 Do not generate .size directives
 392
 393 finline
 394 Common
 395 Pay attention to the \"inline\" keyword
 396
 397 finline-functions
 398 Common
 399 Integrate simple functions into their callers
 400
 401 finline-limit-
 402 Common RejectNegative Joined UInteger
 403
 404 finline-limit=
 405 Common RejectNegative Joined UInteger
 406 -finline-limit=<number> Limit the size of inlined functions to <number>
 407
 408 finstrument-functions
 409 Common
 410 Instrument function entry and exit with profiling calls
 411
 412 fkeep-inline-functions
 413 Common
 414 Generate code for functions even if they are fully inlined
 415
 416 fkeep-static-consts
 417 Common
 418 Emit static const variables even if they are not used
 419
 420 fleading-underscore
 421 Common
 422 Give external symbols a leading underscore
 423
 424 floop-optimize
 425 Common
 426 Perform loop optimizations
 427
 428 fmath-errno
 429 Common
 430 Set errno after built-in math functions
 431
 432 fmem-report
 433 Common
 434 Report on permanent memory allocation
 435
 436 fmerge-all-constants
 437 Common
 438 Attempt to merge identical constants and constant variables
 439
 440 fmerge-constants
 441 Common
 442 Attempt to merge identical constants across compilation units
 443
 444 fmessage-length=
 445 Common RejectNegative Joined UInteger
 446 -fmessage-length=<number>       Limit diagnostics to <number> characters per line.  0 suppresses line-wrapping
 447
 448 fmove-all-movables
 449 Common
 450 Force all loop invariant computations out of loops
 451
 452 fnew-ra
 453 Common
 454 Use graph-coloring register allocation
 455
 456 fnon-call-exceptions
 457 Common
 458 Support synchronous non-call exceptions
 459
 460 fold-unroll-loops
 461 Common
 462 Perform loop unrolling when iteration count is known
 463
 464 fold-unroll-all-loops
 465 Common
 466 Perform loop unrolling for all loops
 467
 468 fomit-frame-pointer
 469 Common
 470 When possible do not generate stack frames
 471
 472 foptimize-register-move
 473 Common
 474 Do the full register move optimization pass
 475
 476 foptimize-sibling-calls
 477 Common
 478 Optimize sibling and tail recursive calls
 479
 480 fpack-struct
 481 Common
 482 Pack structure members together without holes
 483
 484 fpcc-struct-return
 485 Common
 486 Return small aggregates in memory, not registers
 487
 488 fpeel-loops
 489 Common
 490 Perform loop peeling
 491
 492 fpeephole
 493 Common
 494 Enable machine specific peephole optimizations
 495
 496 fpeephole2
 497 Common
 498 Enable an RTL peephole pass before sched2
 499
 500 fpic
 501 Common
 502 Generate position-independent code if possible
 503
 504 fpie
 505 Common
 506 Generate position-independent code for executables if possible
 507
 508 fprefetch-loop-arrays
 509 Common
 510 Generate prefetch instructions, if available, for arrays in loops
 511
 512 fprofile
 513 Common
 514 Enable basic program profiling code
 515
 516 fprofile-arcs
 517 Common
 518 Insert arc-based program profiling code
 519
 520 fprofile-generate
 521 Common
 522 Enable common options for generating profile info for profile feedback directed optimizations
 523
 524 fprofile-use
 525 Common
 526 Enable common options for performing profile feedback directed optimizations
 527
 528 fprofile-values
 529 Common
 530 Insert code to profile values of expressions
 531
 532 frandom-seed
 533 Common
 534
 535 frandom-seed=
 536 Common Joined RejectNegative
 537 -frandom-seed=<string>  Make compile reproducible using <string>
 538
 539 freduce-all-givs
 540 Common
 541 Strength reduce all loop general induction variables
 542
 543 freg-struct-return
 544 Common
 545 Return small aggregates in registers
 546
 547 fregmove
 548 Common
 549 Enables a register move optimization
 550
 551 frename-registers
 552 Common
 553 Perform a register renaming optimization pass
 554
 555 freorder-blocks
 556 Common
 557 Reorder basic blocks to improve code placement
 558
 559 freorder-functions
 560 Common
 561 Reorder functions to improve code placement
 562
 563 frerun-cse-after-loop
 564 Common
 565 Add a common subexpression elimination pass after loop optimizations
 566
 567 frerun-loop-opt
 568 Common
 569 Run the loop optimizer twice
 570
 571 frounding-math
 572 Common
 573 Disable optimizations that assume default FP rounding behavior
 574
 575 fsched-interblock
 576 Common
 577 Enable scheduling across basic blocks
 578
 579 fsched-spec
 580 Common
 581 Allow speculative motion of non-loads
 582
 583 fsched-spec-load
 584 Common
 585 Allow speculative motion of some loads
 586
 587 fsched-spec-load-dangerous
 588 Common
 589 Allow speculative motion of more loads
 590
 591 fsched-verbose=
 592 Common RejectNegative Joined
 593 -fsched-verbose=<number>        Set the verbosity level of the scheduler
 594
 595 fsched2-use-superblocks
 596 Common
 597 If scheduling post reload, do superblock scheduling
 598
 599 fsched2-use-traces
 600 Common
 601 If scheduling post reload, do trace scheduling
 602
 603 fschedule-insns
 604 Common
 605 Reschedule instructions before register allocation
 606
 607 fschedule-insns2
 608 Common
 609 Reschedule instructions after register allocation
 610
 611 fsched-stalled-insns
 612 Common
 613 Allow premature scheduling of queued insns
 614
 615 fsched-stalled-insns=
 616 Common RejectNegative Joined UInteger
 617 -fsched-stalled-insns=<number>       Set number of queued insns that can be prematurely scheduled
 618
 619 fsched-stalled-insns-dep
 620 Common
 621 Set dependence distance checking in premature scheduling of queued insns
 622
 623 fsched-stalled-insns-dep=
 624 Common RejectNegative Joined UInteger
 625 -fsched-stalled-insns-dep=<number>   Set dependence distance checking in premature scheduling of queued insns
 626
 627 fshared-data
 628 Common
 629 Mark data as shared rather than private
 630
 631 fsignaling-nans
 632 Common
 633 Disable optimizations observable by IEEE signaling NaNs
 634
 635 fsingle-precision-constant
 636 Common
 637 Convert floating point constants to single precision constants
 638
 639 fstack-check
 640 Common
 641 Insert stack checking code into the program
 642
 643 fstack-limit
 644 Common
 645
 646 fstack-limit-register=
 647 Common RejectNegative Joined
 648 -fstack-limit-register=<register>       Trap if the stack goes past <register>
 649
 650 fstack-limit-symbol=
 651 Common RejectNegative Joined
 652 -fstack-limit-symbol=<name>     Trap if the stack goes past symbol <name>
 653
 654 fstrength-reduce
 655 Common
 656 Perform strength reduction optimizations
 657
 658 fstrict-aliasing
 659 Common
 660 Assume strict aliasing rules apply
 661
 662 fsyntax-only
 663 Common
 664 Check for syntax errors, then stop
 665
 666 ftest-coverage
 667 Common
 668 Create data files needed by \"gcov\"
 669
 670 fthread-jumps
 671 Common
 672 Perform jump threading optimizations
 673
 674 ftime-report
 675 Common
 676 Report the time taken by each compiler pass
 677
 678 ftls-model=
 679 Common Joined RejectNegative
 680 -ftls-model=[global-dynamic|local-dynamic|initial-exec|local-exec]      Set the default thread-local storage code generation model
 681
 682 ftracer
 683 Common
 684 Perform superblock formation via tail duplication
 685
 686 ftrapping-math
 687 Common
 688 Assume floating-point operations can trap
 689
 690 ftrapv
 691 Common
 692 Trap for signed overflow in addition, subtraction and multiplication
 693
 694 funit-at-a-time
 695 Common
 696 Compile whole compilation unit at a time
 697
 698 funroll-loops
 699 Common
 700 Perform loop unrolling when iteration count is known
 701
 702 funroll-all-loops
 703 Common
 704 Perform loop unrolling for all loops
 705
 706 funsafe-math-optimizations
 707 Common
 708 Allow math optimizations that may violate IEEE or ISO standards
 709
 710 funswitch-loops
 711 Common
 712 Perform loop unswitching
 713
 714 funwind-tables
 715 Common
 716 Just generate unwind tables for exception handling
 717
 718 fverbose-asm
 719 Common
 720 Add extra commentary to assembler output
 721
 722 fvpt
 723 Common
 724 Use expression value profiles in optimizations
 725
 726 fweb
 727 Common
 728 Construct webs and split unrelated uses of single variable
 729
 730 fwrapv
 731 Common
 732 Assume signed arithmetic overflow wraps around
 733
 734 fwritable-strings
 735 Common
 736 Store strings in writable data section
 737
 738 fzero-initialized-in-bss
 739 Common
 740 Put zero initialized data in the bss section
 741
 742 g
 743 Common JoinedOrMissing
 744 Generate debug information in default format
 745
 746 gcoff
 747 Common JoinedOrMissing
 748 Generate debug information in COFF format
 749
 750 gdwarf-2
 751 Common JoinedOrMissing
 752 Generate debug information in DWARF v2 format
 753
 754 ggdb
 755 Common JoinedOrMissing
 756 Generate debug information in default extended format
 757
 758 gstabs
 759 Common JoinedOrMissing
 760 Generate debug information in STABS format
 761
 762 gstabs+
 763 Common JoinedOrMissing
 764 Generate debug information in extended STABS format
 765
 766 gvms
 767 Common JoinedOrMissing
 768 Generate debug information in VMS format
 769
 770 gxcoff
 771 Common JoinedOrMissing
 772 Generate debug information in XCOFF format
 773
 774 gxcoff+
 775 Common JoinedOrMissing
 776 Generate debug information in extended XCOFF format
 777
 778 m
 779 Common Joined
 780
 781 o
 782 Common Joined Separate
 783 -o <file>       Place output into <file>
 784
 785 p
 786 Common
 787 Enable function profiling
 788
 789 pedantic
 790 Common
 791 Issue warnings needed for strict compliance to the standard
 792
 793 pedantic-errors
 794 Common
 795 Like -pedantic but issue them as errors
 796
 797 quiet
 798 Common
 799 Do not display functions compiled or elapsed time
 800
 801 version
 802 Common
 803 Display the compiler's version
 804
 805 w
 806 Common
 807 Suppress warnings
 808
 809 ; This comment is to ensure we retain the blank line above.