gcc/c-family/c.opt

   1 ; Options for the C, ObjC, C++ and ObjC++ front ends.
   2 ; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
   3 ; 2011 Free Software Foundation, Inc.
   4 ;
   5 ; This file is part of GCC.
   6 ;
   7 ; GCC is free software; you can redistribute it and/or modify it under
   8 ; the terms of the GNU General Public License as published by the Free
   9 ; Software Foundation; either version 3, or (at your option) any later
  10 ; version.
  11 ;
  12 ; GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 ; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 ; for more details.
  16 ;
  17 ; You should have received a copy of the GNU General Public License
  18 ; along with GCC; see the file COPYING3.  If not see
  19 ; <http://www.gnu.org/licenses/>.
  20
  21 ; See the GCC internals manual for a description of this file's format.
  22
  23 ; Please try to keep this file in ASCII collating order.
  24
  25 Language
  26 C
  27
  28 Language
  29 ObjC
  30
  31 Language
  32 C++
  33
  34 Language
  35 ObjC++
  36
  37 -all-warnings
  38 C ObjC C++ ObjC++ Warning Alias(Wall)
  39
  40 -ansi
  41 C ObjC C++ ObjC++ Alias(ansi)
  42
  43 -assert
  44 C ObjC C++ ObjC++ Separate Alias(A) MissingArgError(assertion missing after %qs)
  45
  46 -assert=
  47 C ObjC C++ ObjC++ Joined Alias(A) MissingArgError(assertion missing after %qs)
  48
  49 -comments
  50 C ObjC C++ ObjC++ Alias(C)
  51
  52 -comments-in-macros
  53 C ObjC C++ ObjC++ Alias(CC)
  54
  55 -define-macro
  56 C ObjC C++ ObjC++ Separate Alias(D) MissingArgError(macro name missing after %qs)
  57
  58 -define-macro=
  59 C ObjC C++ ObjC++ Joined Alias(D) MissingArgError(macro name missing after %qs)
  60
  61 -dependencies
  62 C ObjC C++ ObjC++ Alias(M)
  63
  64 -dump
  65 C ObjC C++ ObjC++ Separate Alias(d)
  66
  67 -dump=
  68 C ObjC C++ ObjC++ Joined Alias(d)
  69
  70 -imacros
  71 C ObjC C++ ObjC++ Separate Alias(imacros) MissingArgError(missing filename after %qs)
  72
  73 -imacros=
  74 C ObjC C++ ObjC++ Joined Alias(imacros) MissingArgError(missing filename after %qs)
  75
  76 -include
  77 C ObjC C++ ObjC++ Separate Alias(include) MissingArgError(missing filename after %qs)
  78
  79 -include=
  80 C ObjC C++ ObjC++ Joined Alias(include) MissingArgError(missing filename after %qs)
  81
  82 -include-barrier
  83 C ObjC C++ ObjC++ Alias(I, -)
  84
  85 -include-directory
  86 C ObjC C++ ObjC++ Separate Alias(I) MissingArgError(missing path after %qs)
  87
  88 -include-directory=
  89 C ObjC C++ ObjC++ Joined Alias(I) MissingArgError(missing path after %qs)
  90
  91 -include-directory-after
  92 C ObjC C++ ObjC++ Separate Alias(idirafter) MissingArgError(missing path after %qs)
  93
  94 -include-directory-after=
  95 C ObjC C++ ObjC++ Joined Alias(idirafter) MissingArgError(missing path after %qs)
  96
  97 -include-prefix
  98 C ObjC C++ ObjC++ Separate Alias(iprefix)
  99
 100 -include-prefix=
 101 C ObjC C++ ObjC++ JoinedOrMissing Alias(iprefix)
 102
 103 -include-with-prefix
 104 C ObjC C++ ObjC++ Separate Alias(iwithprefix)
 105
 106 -include-with-prefix=
 107 C ObjC C++ ObjC++ JoinedOrMissing Alias(iwithprefix)
 108
 109 -include-with-prefix-after
 110 C ObjC C++ ObjC++ Separate Alias(iwithprefix)
 111
 112 -include-with-prefix-after=
 113 C ObjC C++ ObjC++ JoinedOrMissing Alias(iwithprefix)
 114
 115 -include-with-prefix-before
 116 C ObjC C++ ObjC++ Separate Alias(iwithprefixbefore)
 117
 118 -include-with-prefix-before=
 119 C ObjC C++ ObjC++ JoinedOrMissing Alias(iwithprefixbefore)
 120
 121 -no-integrated-cpp
 122 Driver Alias(no-integrated-cpp)
 123
 124 -no-line-commands
 125 C ObjC C++ ObjC++ Alias(P)
 126
 127 -no-standard-includes
 128 C ObjC C++ ObjC++ Alias(nostdinc)
 129
 130 -no-warnings
 131 C ObjC C++ ObjC++ Alias(w)
 132
 133 -output
 134 C ObjC C++ ObjC++ Separate Alias(o)
 135
 136 -output=
 137 C ObjC C++ ObjC++ Joined Alias(o)
 138
 139 -output-pch=
 140 C ObjC C++ ObjC++ Joined Separate
 141
 142 -pedantic
 143 C ObjC C++ ObjC++ Alias(pedantic)
 144
 145 -pedantic-errors
 146 C ObjC C++ ObjC++ Alias(pedantic-errors)
 147
 148 -preprocess
 149 C ObjC C++ ObjC++ Undocumented Alias(E)
 150
 151 -print-missing-file-dependencies
 152 C ObjC C++ ObjC++ Alias(MG)
 153
 154 -trace-includes
 155 C ObjC C++ ObjC++ Alias(H)
 156
 157 -traditional
 158 Driver Alias(traditional)
 159
 160 -traditional-cpp
 161 C ObjC C++ ObjC++ Alias(traditional-cpp)
 162
 163 -trigraphs
 164 C ObjC C++ ObjC++ Alias(trigraphs)
 165
 166 -undefine-macro
 167 C ObjC C++ ObjC++ Separate Alias(U) MissingArgError(macro name missing after %qs)
 168
 169 -undefine-macro=
 170 C ObjC C++ ObjC++ Joined Alias(U) MissingArgError(macro name missing after %qs)
 171
 172 -user-dependencies
 173 C ObjC C++ ObjC++ Alias(MM)
 174
 175 -verbose
 176 Common C ObjC C++ ObjC++ Alias(v)
 177
 178 -write-dependencies
 179 C ObjC C++ ObjC++ NoDriverArg Separate Alias(MD) MissingArgError(missing filename after %qs)
 180
 181 -write-user-dependencies
 182 C ObjC C++ ObjC++ NoDriverArg Separate Alias(MMD) MissingArgError(missing filename after %qs)
 183
 184 A
 185 C ObjC C++ ObjC++ Joined Separate MissingArgError(assertion missing after %qs)
 186 -A<question>=<answer>   Assert the <answer> to <question>.  Putting '-' before <question> disables the <answer> to <question>
 187
 188 C
 189 C ObjC C++ ObjC++
 190 Do not discard comments
 191
 192 CC
 193 C ObjC C++ ObjC++
 194 Do not discard comments in macro expansions
 195
 196 D
 197 C ObjC C++ ObjC++ Joined Separate MissingArgError(macro name missing after %qs)
 198 -D<macro>[=<val>]       Define a <macro> with <val> as its value.  If just <macro> is given, <val> is taken to be 1
 199
 200 E
 201 C ObjC C++ ObjC++ Undocumented Var(flag_preprocess_only)
 202
 203 F
 204 Driver C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
 205 -F <dir>        Add <dir> to the end of the main framework include path
 206
 207 H
 208 C ObjC C++ ObjC++
 209 Print the name of header files as they are used
 210
 211 I
 212 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
 213 -I <dir>        Add <dir> to the end of the main include path
 214
 215 M
 216 C ObjC C++ ObjC++
 217 Generate make dependencies
 218
 219 MD
 220 C ObjC C++ ObjC++ NoDriverArg Separate MissingArgError(missing filename after %qs)
 221 Generate make dependencies and compile
 222
 223 MF
 224 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
 225 -MF <file>      Write dependency output to the given file
 226
 227 MG
 228 C ObjC C++ ObjC++
 229 Treat missing header files as generated files
 230
 231 MM
 232 C ObjC C++ ObjC++
 233 Like -M but ignore system header files
 234
 235 MMD
 236 C ObjC C++ ObjC++ NoDriverArg Separate MissingArgError(missing filename after %qs)
 237 Like -MD but ignore system header files
 238
 239 MP
 240 C ObjC C++ ObjC++
 241 Generate phony targets for all headers
 242
 243 MQ
 244 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing makefile target after %qs)
 245 -MQ <target>    Add a MAKE-quoted target
 246
 247 MT
 248 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing makefile target after %qs)
 249 -MT <target>    Add an unquoted target
 250
 251 P
 252 C ObjC C++ ObjC++
 253 Do not generate #line directives
 254
 255 U
 256 C ObjC C++ ObjC++ Joined Separate MissingArgError(macro name missing after %qs)
 257 -U<macro>       Undefine <macro>
 258
 259 Wabi
 260 C ObjC C++ ObjC++ LTO Var(warn_abi) Warning
 261 Warn about things that will change when compiling with an ABI-compliant compiler
 262
 263 Wpsabi
 264 C ObjC C++ ObjC++ LTO Var(warn_psabi) Init(1) Undocumented
 265
 266 Waddress
 267 C ObjC C++ ObjC++ Var(warn_address) Warning
 268 Warn about suspicious uses of memory addresses
 269
 270 Wall
 271 C ObjC C++ ObjC++ Warning
 272 Enable most warning messages
 273
 274 Wassign-intercept
 275 ObjC ObjC++ Var(warn_assign_intercept) Warning
 276 Warn whenever an Objective-C assignment is being intercepted by the garbage collector
 277
 278 Wbad-function-cast
 279 C ObjC Var(warn_bad_function_cast) Warning
 280 Warn about casting functions to incompatible types
 281
 282 Wbuiltin-macro-redefined
 283 C ObjC C++ ObjC++ Warning
 284 Warn when a built-in preprocessor macro is undefined or redefined
 285
 286 Wc++-compat
 287 C ObjC Var(warn_cxx_compat) Warning
 288 Warn about C constructs that are not in the common subset of C and C++
 289
 290 Wc++0x-compat
 291 C++ ObjC++ Var(warn_cxx0x_compat) Warning
 292 Warn about C++ constructs whose meaning differs between ISO C++ 1998 and ISO C++ 200x
 293
 294 Wcast-qual
 295 C ObjC C++ ObjC++ Var(warn_cast_qual) Warning
 296 Warn about casts which discard qualifiers
 297
 298 Wchar-subscripts
 299 C ObjC C++ ObjC++ Var(warn_char_subscripts) Warning
 300 Warn about subscripts whose type is \"char\"
 301
 302 Wclobbered
 303 C ObjC C++ ObjC++ Var(warn_clobbered) Init(-1) Warning
 304 Warn about variables that might be changed by \"longjmp\" or \"vfork\"
 305
 306 Wcomment
 307 C ObjC C++ ObjC++ Warning
 308 Warn about possibly nested block comments, and C++ comments spanning more than one physical line
 309
 310 Wcomments
 311 C ObjC C++ ObjC++ Warning Alias(Wcomment)
 312 Synonym for -Wcomment
 313
 314 Wconversion
 315 C ObjC C++ ObjC++ Var(warn_conversion) Warning
 316 Warn for implicit type conversions that may change a value
 317
 318 Wconversion-null
 319 C++ ObjC++ Var(warn_conversion_null) Init(1) Warning
 320 Warn for converting NULL from/to a non-pointer type
 321
 322 Wsign-conversion
 323 C ObjC C++ ObjC++ Var(warn_sign_conversion) Init(-1)
 324 Warn for implicit type conversions between signed and unsigned integers
 325
 326 Wctor-dtor-privacy
 327 C++ ObjC++ Var(warn_ctor_dtor_privacy) Warning
 328 Warn when all constructors and destructors are private
 329
 330 Wdeclaration-after-statement
 331 C ObjC Var(warn_declaration_after_statement) Warning
 332 Warn when a declaration is found after a statement
 333
 334 Wdelete-non-virtual-dtor
 335 C++ ObjC++ Var(warn_delnonvdtor) Warning
 336 Warn about deleting polymorphic objects with non-virtual destructors
 337
 338 Wdeprecated
 339 C C++ ObjC ObjC++ Var(warn_deprecated) Init(1) Warning
 340 Warn if a deprecated compiler feature, class, method, or field is used
 341
 342 Wdiv-by-zero
 343 C ObjC C++ ObjC++ Var(warn_div_by_zero) Init(1) Warning
 344 Warn about compile-time integer division by zero
 345
 346 Weffc++
 347 C++ ObjC++ Var(warn_ecpp) Warning
 348 Warn about violations of Effective C++ style rules
 349
 350 Wempty-body
 351 C ObjC C++ ObjC++ Var(warn_empty_body) Init(-1) Warning
 352 Warn about an empty body in an if or else statement
 353
 354 Wendif-labels
 355 C ObjC C++ ObjC++ Warning
 356 Warn about stray tokens after #elif and #endif
 357
 358 Wenum-compare
 359 C ObjC C++ ObjC++ Var(warn_enum_compare) Init(-1) Warning
 360 Warn about comparison of different enum types
 361
 362 Werror
 363 C ObjC C++ ObjC++
 364 ; Documented in common.opt
 365
 366 Werror-implicit-function-declaration
 367 C ObjC RejectNegative Warning Alias(Werror=, implicit-function-declaration)
 368 This switch is deprecated; use -Werror=implicit-function-declaration instead
 369
 370 Wfloat-equal
 371 C ObjC C++ ObjC++ Var(warn_float_equal) Warning
 372 Warn if testing floating point numbers for equality
 373
 374 Wformat
 375 C ObjC C++ ObjC++ Warning
 376 Warn about printf/scanf/strftime/strfmon format string anomalies
 377
 378 Wformat-extra-args
 379 C ObjC C++ ObjC++ Var(warn_format_extra_args) Warning
 380 Warn if passing too many arguments to a function for its format string
 381
 382 Wformat-nonliteral
 383 C ObjC C++ ObjC++ Var(warn_format_nonliteral) Warning
 384 Warn about format strings that are not literals
 385
 386 Wformat-contains-nul
 387 C ObjC C++ ObjC++ Var(warn_format_contains_nul) Warning
 388 Warn about format strings that contain NUL bytes
 389
 390 Wformat-security
 391 C ObjC C++ ObjC++ Var(warn_format_security) Warning
 392 Warn about possible security problems with format functions
 393
 394 Wformat-y2k
 395 C ObjC C++ ObjC++ Var(warn_format_y2k) Warning
 396 Warn about strftime formats yielding 2-digit years
 397
 398 Wformat-zero-length
 399 C ObjC C++ ObjC++ Var(warn_format_zero_length) Warning
 400 Warn about zero-length formats
 401
 402 Wformat=
 403 C ObjC C++ ObjC++ Joined Warning
 404
 405 Wignored-qualifiers
 406 C C++ Var(warn_ignored_qualifiers) Init(-1) Warning
 407 Warn whenever type qualifiers are ignored.
 408
 409 Winit-self
 410 C ObjC C++ ObjC++ Var(warn_init_self) Warning
 411 Warn about variables which are initialized to themselves
 412
 413 Wimplicit
 414 C ObjC Var(warn_implicit) Init(-1) Warning
 415 Warn about implicit declarations
 416
 417 Wdouble-promotion
 418 C ObjC C++ ObjC++ Var(warn_double_promotion) Warning
 419 Warn about implicit conversions from \"float\" to \"double\"
 420
 421 Wimplicit-function-declaration
 422 C ObjC Var(warn_implicit_function_declaration) Init(-1) Warning
 423 Warn about implicit function declarations
 424
 425 Wimplicit-int
 426 C ObjC Var(warn_implicit_int) Init(-1) Warning
 427 Warn when a declaration does not specify a type
 428
 429 Wimport
 430 C ObjC C++ ObjC++ Undocumented Ignore
 431
 432 Wint-to-pointer-cast
 433 C ObjC C++ ObjC++ Var(warn_int_to_pointer_cast) Init(1) Warning
 434 Warn when there is a cast to a pointer from an integer of a different size
 435
 436 Winvalid-offsetof
 437 C++ ObjC++ Var(warn_invalid_offsetof) Init(1) Warning
 438 Warn about invalid uses of the \"offsetof\" macro
 439
 440 Winvalid-pch
 441 C ObjC C++ ObjC++ Warning
 442 Warn about PCH files that are found but not used
 443
 444 Wjump-misses-init
 445 C ObjC Var(warn_jump_misses_init) Init(-1) Warning
 446 Warn when a jump misses a variable initialization
 447
 448 Wlogical-op
 449 C ObjC C++ ObjC++ Var(warn_logical_op) Init(0) Warning
 450 Warn when a logical operator is suspiciously always evaluating to true or false
 451
 452 Wlong-long
 453 C ObjC C++ ObjC++ Var(warn_long_long) Init(-1) Warning
 454 Do not warn about using \"long long\" when -pedantic
 455
 456 Wmain
 457 C ObjC C++ ObjC++ Var(warn_main) Init(-1) Warning
 458 Warn about suspicious declarations of \"main\"
 459
 460 Wmissing-braces
 461 C ObjC C++ ObjC++ Var(warn_missing_braces) Warning
 462 Warn about possibly missing braces around initializers
 463
 464 Wmissing-declarations
 465 C ObjC C++ ObjC++ Var(warn_missing_declarations) Warning
 466 Warn about global functions without previous declarations
 467
 468 Wmissing-field-initializers
 469 C ObjC C++ ObjC++ Var(warn_missing_field_initializers) Init(-1) Warning
 470 Warn about missing fields in struct initializers
 471
 472 Wmissing-format-attribute
 473 C ObjC C++ ObjC++ Var(warn_missing_format_attribute) Warning
 474 Warn about functions which might be candidates for format attributes
 475
 476 Wmissing-include-dirs
 477 C ObjC C++ ObjC++ Warning
 478 Warn about user-specified include directories that do not exist
 479
 480 Wmissing-parameter-type
 481 C ObjC Var(warn_missing_parameter_type) Init(-1) Warning
 482 Warn about function parameters declared without a type specifier in K&R-style functions
 483
 484 Wmissing-prototypes
 485 C ObjC Var(warn_missing_prototypes) Warning
 486 Warn about global functions without prototypes
 487
 488 Wmultichar
 489 C ObjC C++ ObjC++ Warning
 490 Warn about use of multi-character character constants
 491
 492 Wnarrowing
 493 C ObjC C++ ObjC++ Warning Var(warn_narrowing) Init(1)
 494 -Wno-narrowing    In C++0x mode, ignore ill-formed narrowing conversions within { }
 495
 496 Wnested-externs
 497 C ObjC Var(warn_nested_externs) Warning
 498 Warn about \"extern\" declarations not at file scope
 499
 500 Wnoexcept
 501 C++ ObjC++ Var(warn_noexcept) Warning
 502 Warn when a noexcept expression evaluates to false even though the expression can't actually throw
 503
 504 Wnon-template-friend
 505 C++ ObjC++ Var(warn_nontemplate_friend) Init(1) Warning
 506 Warn when non-templatized friend functions are declared within a template
 507
 508 Wnon-virtual-dtor
 509 C++ ObjC++ Var(warn_nonvdtor) Warning
 510 Warn about non-virtual destructors
 511
 512 Wnonnull
 513 C ObjC Var(warn_nonnull) Warning
 514 Warn about NULL being passed to argument slots marked as requiring non-NULL
 515
 516 Wnormalized=
 517 C ObjC C++ ObjC++ Joined Warning
 518 -Wnormalized=<id|nfc|nfkc>      Warn about non-normalised Unicode strings
 519
 520 Wold-style-cast
 521 C++ ObjC++ Var(warn_old_style_cast) Warning
 522 Warn if a C-style cast is used in a program
 523
 524 Wold-style-declaration
 525 C ObjC Var(warn_old_style_declaration) Init(-1) Warning
 526 Warn for obsolescent usage in a declaration
 527
 528 Wold-style-definition
 529 C ObjC Var(warn_old_style_definition) Warning
 530 Warn if an old-style parameter definition is used
 531
 532 Woverlength-strings
 533 C ObjC C++ ObjC++ Var(warn_overlength_strings) Init(-1) Warning
 534 Warn if a string is longer than the maximum portable length specified by the standard
 535
 536 Woverloaded-virtual
 537 C++ ObjC++ Var(warn_overloaded_virtual) Warning
 538 Warn about overloaded virtual function names
 539
 540 Woverride-init
 541 C ObjC Var(warn_override_init) Init(-1) Warning
 542 Warn about overriding initializers without side effects
 543
 544 Wpacked-bitfield-compat
 545 C ObjC C++ ObjC++ Var(warn_packed_bitfield_compat) Init(-1) Warning
 546 Warn about packed bit-fields whose offset changed in GCC 4.4
 547
 548 Wparentheses
 549 C ObjC C++ ObjC++ Var(warn_parentheses) Warning
 550 Warn about possibly missing parentheses
 551
 552 Wpmf-conversions
 553 C++ ObjC++ Var(warn_pmf2ptr) Init(1) Warning
 554 Warn when converting the type of pointers to member functions
 555
 556 Wpointer-arith
 557 C ObjC C++ ObjC++ Var(warn_pointer_arith) Warning
 558 Warn about function pointer arithmetic
 559
 560 Wpointer-to-int-cast
 561 C ObjC Var(warn_pointer_to_int_cast) Init(1) Warning
 562 Warn when a pointer is cast to an integer of a different size
 563
 564 Wpragmas
 565 C ObjC C++ ObjC++ Var(warn_pragmas) Init(1) Warning
 566 Warn about misuses of pragmas
 567
 568 Wproperty-assign-default
 569 ObjC ObjC++ Var(warn_property_assign_default) Init(1) Warning
 570 Warn if a property for an Objective-C object has no assign semantics specified
 571
 572 Wprotocol
 573 ObjC ObjC++ Var(warn_protocol) Init(1) Warning
 574 Warn if inherited methods are unimplemented
 575
 576 Wredundant-decls
 577 C ObjC C++ ObjC++ Var(warn_redundant_decls) Warning
 578 Warn about multiple declarations of the same object
 579
 580 Wreorder
 581 C++ ObjC++ Var(warn_reorder) Warning
 582 Warn when the compiler reorders code
 583
 584 Wreturn-type
 585 C ObjC C++ ObjC++ Var(warn_return_type) Warning
 586 Warn whenever a function's return type defaults to \"int\" (C), or about inconsistent return types (C++)
 587
 588 Wselector
 589 ObjC ObjC++ Var(warn_selector) Warning
 590 Warn if a selector has multiple methods
 591
 592 Wsequence-point
 593 C ObjC C++ ObjC++ Var(warn_sequence_point) Warning
 594 Warn about possible violations of sequence point rules
 595
 596 Wsign-compare
 597 C ObjC C++ ObjC++ Var(warn_sign_compare) Init(-1) Warning
 598 Warn about signed-unsigned comparisons
 599
 600 Wsign-promo
 601 C++ ObjC++ Var(warn_sign_promo) Warning
 602 Warn when overload promotes from unsigned to signed
 603
 604 Wstrict-null-sentinel
 605 C++ ObjC++ Warning Var(warn_strict_null_sentinel)
 606 Warn about uncasted NULL used as sentinel
 607
 608 Wstrict-prototypes
 609 C ObjC Var(warn_strict_prototypes) Warning
 610 Warn about unprototyped function declarations
 611
 612 Wstrict-selector-match
 613 ObjC ObjC++ Var(warn_strict_selector_match) Warning
 614 Warn if type signatures of candidate methods do not match exactly
 615
 616 Wsync-nand
 617 C C++ Var(warn_sync_nand) Init(1) Warning
 618 Warn when __sync_fetch_and_nand and __sync_nand_and_fetch built-in functions are used
 619
 620 Wsynth
 621 C++ ObjC++ Var(warn_synth) Warning
 622 Deprecated.  This switch has no effect
 623
 624 Wsystem-headers
 625 C ObjC C++ ObjC++ Warning
 626 ; Documented in common.opt
 627
 628 Wtraditional
 629 C ObjC Var(warn_traditional) Warning
 630 Warn about features not present in traditional C
 631
 632 Wtraditional-conversion
 633 C ObjC Var(warn_traditional_conversion) Warning
 634 Warn of prototypes causing type conversions different from what would happen in the absence of prototype
 635
 636 Wtrigraphs
 637 C ObjC C++ ObjC++ Warning
 638 Warn if trigraphs are encountered that might affect the meaning of the program
 639
 640 Wundeclared-selector
 641 ObjC ObjC++ Var(warn_undeclared_selector) Warning
 642 Warn about @selector()s without previously declared methods
 643
 644 Wundef
 645 C ObjC C++ ObjC++ Warning
 646 Warn if an undefined macro is used in an #if directive
 647
 648 Wunknown-pragmas
 649 C ObjC C++ ObjC++ Warning
 650 Warn about unrecognized pragmas
 651
 652 Wunsuffixed-float-constants
 653 C ObjC Var(warn_unsuffixed_float_constants) Warning
 654 Warn about unsuffixed float constants
 655
 656 Wunused-local-typedefs
 657 C ObjC C++ ObjC++ Var(warn_unused_local_typedefs) Warning
 658 Warn about
 659
 660 Wunused-macros
 661 C ObjC C++ ObjC++ Warning
 662 Warn about macros defined in the main file that are not used
 663
 664 Wunused-result
 665 C ObjC C++ ObjC++ Var(warn_unused_result) Init(1) Warning
 666 Warn if a caller of a function, marked with attribute warn_unused_result, does not use its return value
 667
 668 Wvariadic-macros
 669 C ObjC C++ ObjC++ Warning
 670 Do not warn about using variadic macros when -pedantic
 671
 672 Wvla
 673 C ObjC C++ ObjC++ Var(warn_vla) Init(-1) Warning
 674 Warn if a variable length array is used
 675
 676 Wvolatile-register-var
 677 C ObjC C++ ObjC++ Var(warn_volatile_register_var) Warning
 678 Warn when a register variable is declared volatile
 679
 680 Wwrite-strings
 681 C ObjC C++ ObjC++ Var(warn_write_strings) Warning
 682 In C++, nonzero means warn about deprecated conversion from string literals to 'char *'.  In C, similar warning, except that the conversion is of course not deprecated by the ISO C standard.
 683
 684 Wpointer-sign
 685 C ObjC Var(warn_pointer_sign) Init(-1) Warning
 686 Warn when a pointer differs in signedness in an assignment
 687
 688 ansi
 689 C ObjC C++ ObjC++
 690 A synonym for -std=c89 (for C) or -std=c++98 (for C++)
 691
 692 d
 693 C ObjC C++ ObjC++ Joined
 694 ; Documented in common.opt.  FIXME - what about -dI, -dD, -dN and -dD?
 695
 696 faccess-control
 697 C++ ObjC++ Var(flag_access_control) Init(1)
 698 Enforce class member access control semantics
 699
 700 fall-virtual
 701 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 702
 703 fallow-parameterless-variadic-functions
 704 C ObjC Var(flag_allow_parameterless_variadic_functions)
 705 Allow variadic functions without named parameter
 706
 707 falt-external-templates
 708 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 709 No longer supported
 710
 711 fasm
 712 C ObjC C++ ObjC++ Var(flag_no_asm, 0)
 713 Recognize the \"asm\" keyword
 714
 715 ; Define extra predefined macros for use in libgcc.
 716 fbuilding-libgcc
 717 C ObjC C++ ObjC++ Undocumented Var(flag_building_libgcc)
 718
 719 fbuiltin
 720 C ObjC C++ ObjC++ Var(flag_no_builtin, 0)
 721 Recognize built-in functions
 722
 723 fbuiltin-
 724 C ObjC C++ ObjC++ Joined
 725
 726 fcheck-new
 727 C++ ObjC++ Var(flag_check_new)
 728 Check the return value of new
 729
 730 fcond-mismatch
 731 C ObjC C++ ObjC++
 732 Allow the arguments of the '?' operator to have different types
 733
 734 fconserve-space
 735 C++ ObjC++ Var(flag_conserve_space)
 736 Reduce the size of object files
 737
 738 fconstant-string-class=
 739 ObjC ObjC++ Joined MissingArgError(no class name specified with %qs)
 740 -fconst-string-class=<name>     Use class <name> for constant strings
 741
 742 fconstexpr-depth=
 743 C++ ObjC++ Joined RejectNegative UInteger Var(max_constexpr_depth) Init(512)
 744 -fconstexpr-depth=<number>      Specify maximum constexpr recursion depth
 745
 746 fdeduce-init-list
 747 C++ ObjC++ Var(flag_deduce_init_list) Init(1)
 748 -fno-deduce-init-list   disable deduction of std::initializer_list for a template type parameter from a brace-enclosed initializer-list
 749
 750 fdefault-inline
 751 C++ ObjC++ Ignore
 752 Does nothing.  Preserved for backward compatibility.
 753
 754 fdirectives-only
 755 C ObjC C++ ObjC++
 756 Preprocess directives only.
 757
 758 fdollars-in-identifiers
 759 C ObjC C++ ObjC++
 760 Permit '$' as an identifier character
 761
 762 felide-constructors
 763 C++ ObjC++ Var(flag_elide_constructors) Init(1)
 764
 765 fenforce-eh-specs
 766 C++ ObjC++ Var(flag_enforce_eh_specs) Init(1)
 767 Generate code to check exception specifications
 768
 769 fenum-int-equiv
 770 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 771
 772 fexec-charset=
 773 C ObjC C++ ObjC++ Joined RejectNegative
 774 -fexec-charset=<cset>   Convert all strings and character constants to character set <cset>
 775
 776 fextended-identifiers
 777 C ObjC C++ ObjC++
 778 Permit universal character names (\\u and \\U) in identifiers
 779
 780 finput-charset=
 781 C ObjC C++ ObjC++ Joined RejectNegative
 782 -finput-charset=<cset>  Specify the default character set for source files
 783
 784
 785 fexternal-templates
 786 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 787
 788 ffor-scope
 789 C++ ObjC++ Var(flag_new_for_scope) Init(1)
 790 Scope of for-init-statement variables is local to the loop
 791
 792 ffreestanding
 793 C ObjC C++ ObjC++
 794 Do not assume that standard C libraries and \"main\" exist
 795
 796 fgnu-keywords
 797 C++ ObjC++ Var(flag_no_gnu_keywords, 0)
 798 Recognize GNU-defined keywords
 799
 800 fgnu-runtime
 801 ObjC ObjC++
 802 Generate code for GNU runtime environment
 803
 804 fgnu89-inline
 805 C ObjC Var(flag_gnu89_inline) Init(-1)
 806 Use traditional GNU semantics for inline functions
 807
 808 fguiding-decls
 809 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 810
 811 fhandle-exceptions
 812 C++ ObjC++ Optimization Alias(fexceptions) Warn({-fhandle-exceptions has been renamed -fexceptions (and is now on by default)})
 813
 814 fhonor-std
 815 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 816
 817 fhosted
 818 C ObjC
 819 Assume normal C execution environment
 820
 821 fhuge-objects
 822 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 823 No longer supported
 824
 825 fimplement-inlines
 826 C++ ObjC++ Var(flag_implement_inlines) Init(1)
 827 Export functions even if they can be inlined
 828
 829 fimplicit-inline-templates
 830 C++ ObjC++ Var(flag_implicit_inline_templates) Init(1)
 831 Emit implicit instantiations of inline templates
 832
 833 fimplicit-templates
 834 C++ ObjC++ Var(flag_implicit_templates) Init(1)
 835 Emit implicit instantiations of templates
 836
 837 ffriend-injection
 838 C++ ObjC++ Var(flag_friend_injection)
 839 Inject friend functions into enclosing namespace
 840
 841 fkeep-inline-dllexport
 842 C C++ ObjC ObjC++ Var(flag_keep_inline_dllexport) Init(1) Report Condition(TARGET_DLLIMPORT_DECL_ATTRIBUTES)
 843 Don't emit dllexported inline functions unless needed
 844
 845 flabels-ok
 846 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 847
 848 flax-vector-conversions
 849 C ObjC C++ ObjC++ Var(flag_lax_vector_conversions)
 850 Allow implicit conversions between vectors with differing numbers of subparts and/or differing element types.
 851
 852 fms-extensions
 853 C ObjC C++ ObjC++ Var(flag_ms_extensions)
 854 Don't warn about uses of Microsoft extensions
 855
 856 fname-mangling-version-
 857 C++ ObjC++ Joined Ignore Warn(switch %qs is no longer supported)
 858
 859 fnew-abi
 860 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 861
 862 fnext-runtime
 863 ObjC ObjC++
 864 Generate code for NeXT (Apple Mac OS X) runtime environment
 865
 866 fnil-receivers
 867 ObjC ObjC++ Var(flag_nil_receivers) Init(1)
 868 Assume that receivers of Objective-C messages may be nil
 869
 870 fnonansi-builtins
 871 C++ ObjC++ Var(flag_no_nonansi_builtin, 0)
 872
 873 fnonnull-objects
 874 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 875
 876 fnothrow-opt
 877 C++ ObjC++ Optimization Var(flag_nothrow_opt)
 878 Treat a throw() exception specification as noexcept to improve code size
 879
 880 fobjc-abi-version=
 881 ObjC ObjC++ Joined Report RejectNegative UInteger Var(flag_objc_abi)
 882 Specify which ABI to use for Objective-C family code and meta-data generation.
 883
 884 ; Generate special '- .cxx_construct' and '- .cxx_destruct' methods
 885 ; to initialize any non-POD ivars in Objective-C++ classes.
 886 fobjc-call-cxx-cdtors
 887 ObjC++ Var(flag_objc_call_cxx_cdtors)
 888 Generate special Objective-C methods to initialize/destroy non-POD C++ ivars, if needed
 889
 890 fobjc-direct-dispatch
 891 ObjC ObjC++ Var(flag_objc_direct_dispatch)
 892 Allow fast jumps to the message dispatcher
 893
 894 ; Nonzero means that we will allow new ObjC exception syntax (@throw,
 895 ; @try, etc.) in source code.
 896 fobjc-exceptions
 897 ObjC ObjC++ Var(flag_objc_exceptions)
 898 Enable Objective-C exception and synchronization syntax
 899
 900 fobjc-gc
 901 ObjC ObjC++ Var(flag_objc_gc)
 902 Enable garbage collection (GC) in Objective-C/Objective-C++ programs
 903
 904 fobjc-nilcheck
 905 ObjC ObjC++ Var(flag_objc_nilcheck,1)
 906 Enable inline checks for nil receivers with the NeXT runtime and ABI version 2.
 907
 908 ; Nonzero means that we generate NeXT setjmp based exceptions.
 909 fobjc-sjlj-exceptions
 910 ObjC ObjC++ Var(flag_objc_sjlj_exceptions) Init(-1)
 911 Enable Objective-C setjmp exception handling runtime
 912
 913 fobjc-std=objc1
 914 ObjC ObjC++ Var(flag_objc1_only)
 915 Conform to the Objective-C 1.0 language as implemented in GCC 4.0
 916
 917 fopenmp
 918 C ObjC C++ ObjC++ Var(flag_openmp)
 919 Enable OpenMP (implies -frecursive in Fortran)
 920
 921 foperator-names
 922 C++ ObjC++
 923 Recognize C++ keywords like \"compl\" and \"xor\"
 924
 925 foptional-diags
 926 C++ ObjC++ Ignore
 927 Does nothing.  Preserved for backward compatibility.
 928
 929 fpch-deps
 930 C ObjC C++ ObjC++
 931
 932 fpch-preprocess
 933 C ObjC C++ ObjC++
 934 Look for and use PCH files even when preprocessing
 935
 936 fpermissive
 937 C++ ObjC++
 938 Downgrade conformance errors to warnings
 939
 940 fplan9-extensions
 941 C ObjC Var(flag_plan9_extensions)
 942 Enable Plan 9 language extensions
 943
 944 fpreprocessed
 945 C ObjC C++ ObjC++
 946 Treat the input file as already preprocessed
 947
 948 fpretty-templates
 949 C++ ObjC++ Var(flag_pretty_templates) Init(1)
 950 -fno-pretty-templates Do not pretty-print template specializations as the template signature followed by the arguments
 951
 952 freplace-objc-classes
 953 ObjC ObjC++ Var(flag_replace_objc_classes)
 954 Used in Fix-and-Continue mode to indicate that object files may be swapped in at runtime
 955
 956 frepo
 957 C++ ObjC++
 958 Enable automatic template instantiation
 959
 960 frtti
 961 C++ ObjC++ Optimization Var(flag_rtti) Init(1)
 962 Generate run time type descriptor information
 963
 964 fshort-double
 965 C ObjC C++ ObjC++ Optimization Var(flag_short_double)
 966 Use the same size for double as for float
 967
 968 fshort-enums
 969 C ObjC C++ ObjC++ Optimization Var(flag_short_enums)
 970 Use the narrowest integer type possible for enumeration types
 971
 972 fshort-wchar
 973 C ObjC C++ ObjC++ Optimization Var(flag_short_wchar)
 974 Force the underlying type for \"wchar_t\" to be \"unsigned short\"
 975
 976 fsigned-bitfields
 977 C ObjC C++ ObjC++ Var(flag_signed_bitfields) Init(1)
 978 When \"signed\" or \"unsigned\" is not given make the bitfield signed
 979
 980 fsigned-char
 981 C ObjC C++ ObjC++ LTO Var(flag_signed_char)
 982 Make \"char\" signed by default
 983
 984 fsquangle
 985 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 986
 987 fstats
 988 C++ ObjC++ Var(flag_detailed_statistics)
 989 Display statistics accumulated during compilation
 990
 991 fstrict-enums
 992 C++ ObjC++ Optimization Var(flag_strict_enums)
 993 Assume that values of enumeration type are always within the minimum range of that type
 994
 995 fstrict-prototype
 996 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
 997
 998 ftabstop=
 999 C ObjC C++ ObjC++ Joined RejectNegative UInteger
1000 -ftabstop=<number>      Distance between tab stops for column reporting
1001
1002 ftemplate-depth-
1003 C++ ObjC++ Joined RejectNegative Undocumented Alias(ftemplate-depth=)
1004
1005 ftemplate-depth=
1006 C++ ObjC++ Joined RejectNegative UInteger
1007 -ftemplate-depth=<number>       Specify maximum template instantiation depth
1008
1009 fthis-is-variable
1010 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1011
1012 fthreadsafe-statics
1013 C++ ObjC++ Optimization Var(flag_threadsafe_statics) Init(1)
1014 -fno-threadsafe-statics Do not generate thread-safe code for initializing local statics
1015
1016 funsigned-bitfields
1017 C ObjC C++ ObjC++ Var(flag_signed_bitfields, 0)
1018 When \"signed\" or \"unsigned\" is not given make the bitfield unsigned
1019
1020 funsigned-char
1021 C ObjC C++ ObjC++ LTO Var(flag_signed_char, 0)
1022 Make \"char\" unsigned by default
1023
1024 fuse-cxa-atexit
1025 C++ ObjC++ Var(flag_use_cxa_atexit) Init(DEFAULT_USE_CXA_ATEXIT)
1026 Use __cxa_atexit to register destructors
1027
1028 fuse-cxa-get-exception-ptr
1029 C++ ObjC++ Var(flag_use_cxa_get_exception_ptr) Init(2)
1030 Use __cxa_get_exception_ptr in exception handling
1031
1032 fvisibility-inlines-hidden
1033 C++ ObjC++
1034 Marks all inlined methods as having hidden visibility
1035
1036 fvisibility-ms-compat
1037 C++ ObjC++ Var(flag_visibility_ms_compat)
1038 Changes visibility to match Microsoft Visual Studio by default
1039
1040 fvtable-gc
1041 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1042 No longer supported
1043
1044 fvtable-thunks
1045 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1046 No longer supported
1047
1048 fweak
1049 C++ ObjC++ Var(flag_weak) Init(1)
1050 Emit common-like symbols as weak symbols
1051
1052 fwide-exec-charset=
1053 C ObjC C++ ObjC++ Joined RejectNegative
1054 -fwide-exec-charset=<cset>      Convert all wide strings and character constants to character set <cset>
1055
1056 fworking-directory
1057 C ObjC C++ ObjC++ Var(flag_working_directory) Init(-1)
1058 Generate a #line directive pointing at the current working directory
1059
1060 fxref
1061 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1062 No longer supported
1063
1064 fzero-link
1065 ObjC ObjC++ Var(flag_zero_link)
1066 Generate lazy class lookup (via objc_getClass()) for use in Zero-Link mode
1067
1068 gen-decls
1069 ObjC ObjC++ Var(flag_gen_declaration)
1070 Dump declarations to a .decl file
1071
1072 femit-struct-debug-baseonly
1073 C ObjC C++ ObjC++
1074 -femit-struct-debug-baseonly    Aggressive reduced debug info for structs
1075
1076 femit-struct-debug-reduced
1077 C ObjC C++ ObjC++
1078 -femit-struct-debug-reduced     Conservative reduced debug info for structs
1079
1080 femit-struct-debug-detailed=
1081 C ObjC C++ ObjC++ Joined
1082 -femit-struct-debug-detailed=<spec-list>        Detailed reduced debug info for structs
1083
1084 idirafter
1085 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1086 -idirafter <dir>        Add <dir> to the end of the system include path
1087
1088 imacros
1089 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1090 -imacros <file> Accept definition of macros in <file>
1091
1092 imultilib
1093 C ObjC C++ ObjC++ Joined Separate
1094 -imultilib <dir>        Set <dir> to be the multilib include subdirectory
1095
1096 include
1097 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1098 -include <file> Include the contents of <file> before other files
1099
1100 iprefix
1101 C ObjC C++ ObjC++ Joined Separate
1102 -iprefix <path> Specify <path> as a prefix for next two options
1103
1104 isysroot
1105 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1106 -isysroot <dir> Set <dir> to be the system root directory
1107
1108 isystem
1109 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1110 -isystem <dir>  Add <dir> to the start of the system include path
1111
1112 iquote
1113 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1114 -iquote <dir>   Add <dir> to the end of the quote include path
1115
1116 iwithprefix
1117 C ObjC C++ ObjC++ Joined Separate
1118 -iwithprefix <dir>      Add <dir> to the end of the system include path
1119
1120 iwithprefixbefore
1121 C ObjC C++ ObjC++ Joined Separate
1122 -iwithprefixbefore <dir>        Add <dir> to the end of the main include path
1123
1124 lang-asm
1125 C Undocumented RejectDriver
1126
1127 no-integrated-cpp
1128 Driver
1129
1130 nostdinc
1131 C ObjC C++ ObjC++
1132 Do not search standard system include directories (those specified with -isystem will still be used)
1133
1134 nostdinc++
1135 C++ ObjC++
1136 Do not search standard system include directories for C++
1137
1138 o
1139 C ObjC C++ ObjC++ Joined Separate
1140 ; Documented in common.opt
1141
1142 pedantic
1143 C ObjC C++ ObjC++
1144 ; Documented in common.opt
1145
1146 pedantic-errors
1147 C ObjC C++ ObjC++
1148 ; Documented in common.opt
1149
1150 print-objc-runtime-info
1151 ObjC ObjC++
1152 Generate C header of platform-specific features
1153
1154 remap
1155 C ObjC C++ ObjC++
1156 Remap file names when including files
1157
1158 std=c++98
1159 C++ ObjC++
1160 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1161
1162 std=c++03
1163 C++ ObjC++ Alias(std=c++98)
1164 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1165
1166 std=c++0x
1167 C++ ObjC++
1168 Conform to the ISO 1998 C++ standard, with extensions that are likely to
1169 become a part of the upcoming ISO C++ standard, dubbed C++0x. Note that the
1170 extensions enabled by this mode are experimental and may be removed in
1171 future releases of GCC.
1172
1173 std=c1x
1174 C ObjC
1175 Conform to the ISO 201X C standard draft (experimental and incomplete support)
1176
1177 std=c89
1178 C ObjC Alias(std=c90)
1179 Conform to the ISO 1990 C standard
1180
1181 std=c90
1182 C ObjC
1183 Conform to the ISO 1990 C standard
1184
1185 std=c99
1186 C ObjC
1187 Conform to the ISO 1999 C standard
1188
1189 std=c9x
1190 C ObjC Alias(std=c99)
1191 Deprecated in favor of -std=c99
1192
1193 std=gnu++98
1194 C++ ObjC++
1195 Conform to the ISO 1998 C++ standard with GNU extensions
1196
1197 std=gnu++0x
1198 C++ ObjC++
1199 Conform to the ISO 1998 C++ standard, with GNU extensions and
1200 extensions that are likely to become a part of the upcoming ISO C++
1201 standard, dubbed C++0x. Note that the extensions enabled by this mode
1202 are experimental and may be removed in future releases of GCC.
1203
1204 std=gnu1x
1205 C ObjC
1206 Conform to the ISO 201X C standard draft with GNU extensions (experimental and incomplete support)
1207
1208 std=gnu89
1209 C ObjC Alias(std=gnu90)
1210 Conform to the ISO 1990 C standard with GNU extensions
1211
1212 std=gnu90
1213 C ObjC
1214 Conform to the ISO 1990 C standard with GNU extensions
1215
1216 std=gnu99
1217 C ObjC
1218 Conform to the ISO 1999 C standard with GNU extensions
1219
1220 std=gnu9x
1221 C ObjC Alias(std=gnu99)
1222 Deprecated in favor of -std=gnu99
1223
1224 std=iso9899:1990
1225 C ObjC Alias(std=c90)
1226 Conform to the ISO 1990 C standard
1227
1228 std=iso9899:199409
1229 C ObjC
1230 Conform to the ISO 1990 C standard as amended in 1994
1231
1232 std=iso9899:1999
1233 C ObjC Alias(std=c99)
1234 Conform to the ISO 1999 C standard
1235
1236 std=iso9899:199x
1237 C ObjC Alias(std=c99)
1238 Deprecated in favor of -std=iso9899:1999
1239
1240 traditional
1241 Driver
1242
1243 traditional-cpp
1244 C ObjC C++ ObjC++
1245 Enable traditional preprocessing
1246
1247 trigraphs
1248 C ObjC C++ ObjC++
1249 -trigraphs      Support ISO C trigraphs
1250
1251 undef
1252 C ObjC C++ ObjC++ Var(flag_undef)
1253 Do not predefine system-specific and GCC-specific macros
1254
1255 v
1256 C ObjC C++ ObjC++
1257 ; Documented in common.opt
1258
1259 w
1260 C ObjC C++ ObjC++
1261 ; Documented in common.opt
1262
1263 ; This comment is to ensure we retain the blank line above.