Warn pointer to signed integer cast for ilp32
[official-gcc.git] / gcc / c-family / c.opt
blob0f5d941b921b58ff3a39ef4f6cc26daf62779fa1
1 ; Options for the C, ObjC, C++ and ObjC++ front ends.
2 ; Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
3 ; 2011, 2012 Free Software Foundation, Inc.
5 ; This file is part of GCC.
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.
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.
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/>.
21 ; See the GCC internals manual for a description of this file's format.
23 ; Please try to keep this file in ASCII collating order.
25 Language
28 Language
29 ObjC
31 Language
32 C++
34 Language
35 ObjC++
37 -all-warnings
38 C ObjC C++ ObjC++ Warning Alias(Wall)
40 -ansi
41 C ObjC C++ ObjC++ Alias(ansi)
43 -assert
44 C ObjC C++ ObjC++ Separate Alias(A) MissingArgError(assertion missing after %qs)
46 -assert=
47 C ObjC C++ ObjC++ Joined Alias(A) MissingArgError(assertion missing after %qs)
49 -comments
50 C ObjC C++ ObjC++ Alias(C)
52 -comments-in-macros
53 C ObjC C++ ObjC++ Alias(CC)
55 -define-macro
56 C ObjC C++ ObjC++ Separate Alias(D) MissingArgError(macro name missing after %qs)
58 -define-macro=
59 C ObjC C++ ObjC++ Joined Alias(D) MissingArgError(macro name missing after %qs)
61 -dependencies
62 C ObjC C++ ObjC++ Alias(M)
64 -dump
65 C ObjC C++ ObjC++ Separate Alias(d)
67 -dump=
68 C ObjC C++ ObjC++ Joined Alias(d)
70 -imacros
71 C ObjC C++ ObjC++ Separate Alias(imacros) MissingArgError(missing filename after %qs)
73 -imacros=
74 C ObjC C++ ObjC++ Joined Alias(imacros) MissingArgError(missing filename after %qs)
76 -include
77 C ObjC C++ ObjC++ Separate Alias(include) MissingArgError(missing filename after %qs)
79 -include=
80 C ObjC C++ ObjC++ Joined Alias(include) MissingArgError(missing filename after %qs)
82 -include-barrier
83 C ObjC C++ ObjC++ Alias(I, -)
85 -include-directory
86 C ObjC C++ ObjC++ Separate Alias(I) MissingArgError(missing path after %qs)
88 -include-directory=
89 C ObjC C++ ObjC++ Joined Alias(I) MissingArgError(missing path after %qs)
91 -include-directory-after
92 C ObjC C++ ObjC++ Separate Alias(idirafter) MissingArgError(missing path after %qs)
94 -include-directory-after=
95 C ObjC C++ ObjC++ Joined Alias(idirafter) MissingArgError(missing path after %qs)
97 -include-prefix
98 C ObjC C++ ObjC++ Separate Alias(iprefix)
100 -include-prefix=
101 C ObjC C++ ObjC++ JoinedOrMissing Alias(iprefix)
103 -include-with-prefix
104 C ObjC C++ ObjC++ Separate Alias(iwithprefix)
106 -include-with-prefix=
107 C ObjC C++ ObjC++ JoinedOrMissing Alias(iwithprefix)
109 -include-with-prefix-after
110 C ObjC C++ ObjC++ Separate Alias(iwithprefix)
112 -include-with-prefix-after=
113 C ObjC C++ ObjC++ JoinedOrMissing Alias(iwithprefix)
115 -include-with-prefix-before
116 C ObjC C++ ObjC++ Separate Alias(iwithprefixbefore)
118 -include-with-prefix-before=
119 C ObjC C++ ObjC++ JoinedOrMissing Alias(iwithprefixbefore)
121 -no-integrated-cpp
122 Driver Alias(no-integrated-cpp)
124 -no-line-commands
125 C ObjC C++ ObjC++ Alias(P)
127 -no-standard-includes
128 C ObjC C++ ObjC++ Alias(nostdinc)
130 -no-warnings
131 C ObjC C++ ObjC++ Alias(w)
133 -output
134 C ObjC C++ ObjC++ Separate Alias(o)
136 -output=
137 C ObjC C++ ObjC++ Joined Alias(o)
139 -output-pch=
140 C ObjC C++ ObjC++ Joined Separate
142 -pedantic
143 C ObjC C++ ObjC++ Alias(pedantic)
145 -preprocess
146 C ObjC C++ ObjC++ Undocumented Alias(E)
148 -print-missing-file-dependencies
149 C ObjC C++ ObjC++ Alias(MG)
151 -trace-includes
152 C ObjC C++ ObjC++ Alias(H)
154 -traditional
155 Driver Alias(traditional)
157 -traditional-cpp
158 C ObjC C++ ObjC++ Alias(traditional-cpp)
160 -trigraphs
161 C ObjC C++ ObjC++ Alias(trigraphs)
163 -undefine-macro
164 C ObjC C++ ObjC++ Separate Alias(U) MissingArgError(macro name missing after %qs)
166 -undefine-macro=
167 C ObjC C++ ObjC++ Joined Alias(U) MissingArgError(macro name missing after %qs)
169 -user-dependencies
170 C ObjC C++ ObjC++ Alias(MM)
172 -verbose
173 Common C ObjC C++ ObjC++ Alias(v)
175 -write-dependencies
176 C ObjC C++ ObjC++ NoDriverArg Separate Alias(MD) MissingArgError(missing filename after %qs)
178 -write-user-dependencies
179 C ObjC C++ ObjC++ NoDriverArg Separate Alias(MMD) MissingArgError(missing filename after %qs)
182 C ObjC C++ ObjC++ Joined Separate MissingArgError(assertion missing after %qs)
183 -A<question>=<answer>   Assert the <answer> to <question>.  Putting '-' before <question> disables the <answer> to <question>
186 C ObjC C++ ObjC++
187 Do not discard comments
190 C ObjC C++ ObjC++
191 Do not discard comments in macro expansions
194 C ObjC C++ ObjC++ Joined Separate MissingArgError(macro name missing after %qs)
195 -D<macro>[=<val>]       Define a <macro> with <val> as its value.  If just <macro> is given, <val> is taken to be 1
198 C ObjC C++ ObjC++ Undocumented Var(flag_preprocess_only)
201 Driver C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
202 -F <dir>        Add <dir> to the end of the main framework include path
205 C ObjC C++ ObjC++
206 Print the name of header files as they are used
209 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
210 -I <dir>        Add <dir> to the end of the main include path
213 C ObjC C++ ObjC++
214 Generate make dependencies
217 C ObjC C++ ObjC++ NoDriverArg Separate MissingArgError(missing filename after %qs)
218 Generate make dependencies and compile
221 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
222 -MF <file>      Write dependency output to the given file
225 C ObjC C++ ObjC++
226 Treat missing header files as generated files
229 C ObjC C++ ObjC++
230 Like -M but ignore system header files
233 C ObjC C++ ObjC++ NoDriverArg Separate MissingArgError(missing filename after %qs)
234 Like -MD but ignore system header files
237 C ObjC C++ ObjC++
238 Generate phony targets for all headers
241 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing makefile target after %qs)
242 -MQ <target>    Add a MAKE-quoted target
245 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing makefile target after %qs)
246 -MT <target>    Add an unquoted target
249 C ObjC C++ ObjC++
250 Do not generate #line directives
253 C ObjC C++ ObjC++ Joined Separate MissingArgError(macro name missing after %qs)
254 -U<macro>       Undefine <macro>
256 Wabi
257 C ObjC C++ ObjC++ LTO Var(warn_abi) Warning
258 Warn about things that will change when compiling with an ABI-compliant compiler
260 Wpsabi
261 C ObjC C++ ObjC++ LTO Var(warn_psabi) Init(1) Undocumented
263 Waddress
264 C ObjC C++ ObjC++ Var(warn_address) Warning
265 Warn about suspicious uses of memory addresses
267 Wall
268 C ObjC C++ ObjC++ Warning
269 Enable most warning messages
271 Wassign-intercept
272 ObjC ObjC++ Var(warn_assign_intercept) Warning
273 Warn whenever an Objective-C assignment is being intercepted by the garbage collector
275 Wbad-function-cast
276 C ObjC Var(warn_bad_function_cast) Warning
277 Warn about casting functions to incompatible types
279 Wbuiltin-macro-redefined
280 C ObjC C++ ObjC++ Warning
281 Warn when a built-in preprocessor macro is undefined or redefined
283 Wc++-compat
284 C ObjC Var(warn_cxx_compat) Warning
285 Warn about C constructs that are not in the common subset of C and C++
287 Wc++0x-compat
288 C++ ObjC++ Var(warn_cxx0x_compat) Warning LangEnabledBy(C++ ObjC++,Wall)
289 Deprecated in favor of -Wc++11-compat
291 Wc++11-compat
292 C++ ObjC++ Warning Alias(Wc++0x-compat)
293 Warn about C++ constructs whose meaning differs between ISO C++ 1998 and ISO C++ 2011
295 Wcast-qual
296 C ObjC C++ ObjC++ Var(warn_cast_qual) Warning
297 Warn about casts which discard qualifiers
299 Wchar-subscripts
300 C ObjC C++ ObjC++ Var(warn_char_subscripts) Warning
301 Warn about subscripts whose type is \"char\"
303 Wclobbered
304 C ObjC C++ ObjC++ Var(warn_clobbered) Warning EnabledBy(Wextra)
305 Warn about variables that might be changed by \"longjmp\" or \"vfork\"
307 Wcomment
308 C ObjC C++ ObjC++ Warning
309 Warn about possibly nested block comments, and C++ comments spanning more than one physical line
311 Wcomments
312 C ObjC C++ ObjC++ Warning Alias(Wcomment)
313 Synonym for -Wcomment
315 Wconversion
316 C ObjC C++ ObjC++ Var(warn_conversion) Warning
317 Warn for implicit type conversions that may change a value
319 Wconversion-null
320 C++ ObjC++ Var(warn_conversion_null) Init(1) Warning
321 Warn for converting NULL from/to a non-pointer type
323 Wsign-conversion
324 C ObjC C++ ObjC++ Var(warn_sign_conversion) Init(-1)
325 Warn for implicit type conversions between signed and unsigned integers
327 Wctor-dtor-privacy
328 C++ ObjC++ Var(warn_ctor_dtor_privacy) Warning
329 Warn when all constructors and destructors are private
331 Wdeclaration-after-statement
332 C ObjC Var(warn_declaration_after_statement) Warning
333 Warn when a declaration is found after a statement
335 Wdelete-non-virtual-dtor
336 C++ ObjC++ Var(warn_delnonvdtor) Warning LangEnabledBy(C++ ObjC++,Wall)
337 Warn about deleting polymorphic objects with non-virtual destructors
339 Wdeprecated
340 C C++ ObjC ObjC++ Var(warn_deprecated) Init(1) Warning
341 Warn if a deprecated compiler feature, class, method, or field is used
343 Wdiv-by-zero
344 C ObjC C++ ObjC++ Var(warn_div_by_zero) Init(1) Warning
345 Warn about compile-time integer division by zero
347 Weffc++
348 C++ ObjC++ Var(warn_ecpp) Warning
349 Warn about violations of Effective C++ style rules
351 Wempty-body
352 C ObjC C++ ObjC++ Var(warn_empty_body) Warning EnabledBy(Wextra)
353 Warn about an empty body in an if or else statement
355 Wendif-labels
356 C ObjC C++ ObjC++ Warning
357 Warn about stray tokens after #elif and #endif
359 Wenum-compare
360 C ObjC C++ ObjC++ Var(warn_enum_compare) Init(-1) Warning
361 Warn about comparison of different enum types
363 Werror
364 C ObjC C++ ObjC++
365 ; Documented in common.opt
367 Werror-implicit-function-declaration
368 C ObjC RejectNegative Warning Alias(Werror=, implicit-function-declaration)
369 This switch is deprecated; use -Werror=implicit-function-declaration instead
371 Wfloat-equal
372 C ObjC C++ ObjC++ Var(warn_float_equal) Warning
373 Warn if testing floating point numbers for equality
375 Wformat
376 C ObjC C++ ObjC++ Warning
377 Warn about printf/scanf/strftime/strfmon format string anomalies
379 Wformat-extra-args
380 C ObjC C++ ObjC++ Var(warn_format_extra_args) Warning
381 Warn if passing too many arguments to a function for its format string
383 Wformat-nonliteral
384 C ObjC C++ ObjC++ Var(warn_format_nonliteral) Warning
385 Warn about format strings that are not literals
387 Wformat-contains-nul
388 C ObjC C++ ObjC++ Var(warn_format_contains_nul) Warning
389 Warn about format strings that contain NUL bytes
391 Wformat-security
392 C ObjC C++ ObjC++ Var(warn_format_security) Warning
393 Warn about possible security problems with format functions
395 Wformat-y2k
396 C ObjC C++ ObjC++ Var(warn_format_y2k) Warning
397 Warn about strftime formats yielding 2-digit years
399 Wformat-zero-length
400 C ObjC C++ ObjC++ Var(warn_format_zero_length) Warning
401 Warn about zero-length formats
403 Wformat=
404 C ObjC C++ ObjC++ Joined Warning
406 Wignored-qualifiers
407 C C++ Var(warn_ignored_qualifiers) Warning EnabledBy(Wextra)
408 Warn whenever type qualifiers are ignored.
410 Winit-self
411 C ObjC C++ ObjC++ Var(warn_init_self) Warning
412 Warn about variables which are initialized to themselves
414 Wimplicit
415 C ObjC Var(warn_implicit) Init(-1) Warning
416 Warn about implicit declarations
418 Wdouble-promotion
419 C ObjC C++ ObjC++ Var(warn_double_promotion) Warning
420 Warn about implicit conversions from \"float\" to \"double\"
422 Wimplicit-function-declaration
423 C ObjC Var(warn_implicit_function_declaration) Init(-1) Warning
424 Warn about implicit function declarations
426 Wimplicit-int
427 C ObjC Var(warn_implicit_int) Init(-1) Warning
428 Warn when a declaration does not specify a type
430 Wimport
431 C ObjC C++ ObjC++ Undocumented Ignore
433 Wint-to-pointer-cast
434 C ObjC C++ ObjC++ Var(warn_int_to_pointer_cast) Init(1) Warning
435 Warn when there is a cast to a pointer from an integer of a different size
437 Winvalid-offsetof
438 C++ ObjC++ Var(warn_invalid_offsetof) Init(1) Warning
439 Warn about invalid uses of the \"offsetof\" macro
441 Winvalid-pch
442 C ObjC C++ ObjC++ Warning
443 Warn about PCH files that are found but not used
445 Wjump-misses-init
446 C ObjC Var(warn_jump_misses_init) Warning LangEnabledby(C ObjC,Wc++-compat)
447 Warn when a jump misses a variable initialization
449 Wliteral-suffix
450 C++ ObjC++ Warning
451 Warn when a string or character literal is followed by a ud-suffix which does not begin with an underscore.
453 Wlogical-op
454 C ObjC C++ ObjC++ Var(warn_logical_op) Init(0) Warning 
455 Warn when a logical operator is suspiciously always evaluating to true or false
457 Wlong-long
458 C ObjC C++ ObjC++ Var(warn_long_long) Init(-1) Warning
459 Do not warn about using \"long long\" when -pedantic
461 Wmain
462 C ObjC C++ ObjC++ Var(warn_main) Init(-1) Warning
463 Warn about suspicious declarations of \"main\"
465 Wmissing-braces
466 C ObjC C++ ObjC++ Var(warn_missing_braces) Warning LangEnabledBy(C ObjC,Wall)
467 Warn about possibly missing braces around initializers
469 Wmissing-declarations
470 C ObjC C++ ObjC++ Var(warn_missing_declarations) Warning
471 Warn about global functions without previous declarations
473 Wmissing-field-initializers
474 C ObjC C++ ObjC++ Var(warn_missing_field_initializers) Warning EnabledBy(Wextra)
475 Warn about missing fields in struct initializers
477 Wsizeof-pointer-memaccess
478 C ObjC C++ ObjC++ Var(warn_sizeof_pointer_memaccess) Warning
480 Wsuggest-attribute=format
481 C ObjC C++ ObjC++ Var(warn_suggest_attribute_format) Warning
482 Warn about functions which might be candidates for format attributes
484 Wmissing-format-attribute
485 C ObjC C++ ObjC++ Alias(Wsuggest-attribute=format)
488 Wmissing-include-dirs
489 C ObjC C++ ObjC++ Warning
490 Warn about user-specified include directories that do not exist
492 Wmissing-parameter-type
493 C ObjC Var(warn_missing_parameter_type) Warning EnabledBy(Wextra)
494 Warn about function parameters declared without a type specifier in K&R-style functions
496 Wmissing-prototypes
497 C ObjC Var(warn_missing_prototypes) Warning
498 Warn about global functions without prototypes
500 Wmudflap
501 C ObjC C++ ObjC++ Var(warn_mudflap) Init(1) Warning
502 Warn about constructs not instrumented by -fmudflap
504 Wmultichar
505 C ObjC C++ ObjC++ Warning
506 Warn about use of multi-character character constants
508 Wnarrowing
509 C ObjC C++ ObjC++ Warning Var(warn_narrowing) Init(-1)
510 Warn about narrowing conversions within { } that are ill-formed in C++11
512 Wnested-externs
513 C ObjC Var(warn_nested_externs) Warning
514 Warn about \"extern\" declarations not at file scope
516 Wnoexcept
517 C++ ObjC++ Var(warn_noexcept) Warning
518 Warn when a noexcept expression evaluates to false even though the expression can't actually throw
520 Wnon-template-friend
521 C++ ObjC++ Var(warn_nontemplate_friend) Init(1) Warning
522 Warn when non-templatized friend functions are declared within a template
524 Wnon-virtual-dtor
525 C++ ObjC++ Var(warn_nonvdtor) Warning
526 Warn about non-virtual destructors
528 Wnonnull
529 C ObjC C++ ObjC++ Var(warn_nonnull) Warning
530 Warn about NULL being passed to argument slots marked as requiring non-NULL
532 Wnormalized=
533 C ObjC C++ ObjC++ Joined Warning
534 -Wnormalized=<id|nfc|nfkc>      Warn about non-normalised Unicode strings
536 Wold-style-cast
537 C++ ObjC++ Var(warn_old_style_cast) Warning
538 Warn if a C-style cast is used in a program
540 Wold-style-declaration
541 C ObjC Var(warn_old_style_declaration) Warning EnabledBy(Wextra)
542 Warn for obsolescent usage in a declaration
544 Wold-style-definition
545 C ObjC Var(warn_old_style_definition) Warning
546 Warn if an old-style parameter definition is used
548 Woverlength-strings
549 C ObjC C++ ObjC++ Var(warn_overlength_strings) Init(-1) Warning
550 Warn if a string is longer than the maximum portable length specified by the standard
552 Woverloaded-virtual
553 C++ ObjC++ Var(warn_overloaded_virtual) Warning
554 Warn about overloaded virtual function names
556 Woverride-init
557 C ObjC Var(warn_override_init) Warning EnabledBy(Wextra)
558 Warn about overriding initializers without side effects
560 Wpacked-bitfield-compat
561 C ObjC C++ ObjC++ Var(warn_packed_bitfield_compat) Init(-1) Warning
562 Warn about packed bit-fields whose offset changed in GCC 4.4
564 Wparentheses
565 C ObjC C++ ObjC++ Var(warn_parentheses) Warning
566 Warn about possibly missing parentheses
568 Wpedantic
569 C ObjC C++ ObjC++ Warning
570 ; Documented in common.opt
572 Wpmf-conversions
573 C++ ObjC++ Var(warn_pmf2ptr) Init(1) Warning
574 Warn when converting the type of pointers to member functions
576 Wpointer-arith
577 C ObjC C++ ObjC++ Var(warn_pointer_arith) Warning
578 Warn about function pointer arithmetic
580 Wpointer-to-int-cast
581 C ObjC Var(warn_pointer_to_int_cast) Init(1) Warning
582 Warn when a pointer is cast to an integer of a different size
584 Wpointer-to-signed-int-cast
585 C ObjC C++ ObjC++ Var(warn_pointer_to_signed_int_cast) Warning
586 Warn when a pointer is cast to a signed integer of the same size
588 Wpragmas
589 C ObjC C++ ObjC++ Var(warn_pragmas) Init(1) Warning
590 Warn about misuses of pragmas
592 Wproperty-assign-default
593 ObjC ObjC++ Var(warn_property_assign_default) Init(1) Warning
594 Warn if a property for an Objective-C object has no assign semantics specified
596 Wprotocol
597 ObjC ObjC++ Var(warn_protocol) Init(1) Warning
598 Warn if inherited methods are unimplemented
600 Wredundant-decls
601 C ObjC C++ ObjC++ Var(warn_redundant_decls) Warning
602 Warn about multiple declarations of the same object
604 Wreorder
605 C++ ObjC++ Var(warn_reorder) Warning LangEnabledBy(C++ ObjC++,Wall)
606 Warn when the compiler reorders code
608 Wreturn-type
609 C ObjC C++ ObjC++ Var(warn_return_type) Warning
610 Warn whenever a function's return type defaults to \"int\" (C), or about inconsistent return types (C++)
612 Wselector
613 ObjC ObjC++ Var(warn_selector) Warning
614 Warn if a selector has multiple methods
616 Wsequence-point
617 C ObjC C++ ObjC++ Var(warn_sequence_point) Warning
618 Warn about possible violations of sequence point rules
620 Wsign-compare
621 C ObjC C++ ObjC++ Var(warn_sign_compare) Init(-1) Warning
622 Warn about signed-unsigned comparisons
624 Wsign-promo
625 C++ ObjC++ Var(warn_sign_promo) Warning
626 Warn when overload promotes from unsigned to signed
628 Wstrict-null-sentinel
629 C++ ObjC++ Warning Var(warn_strict_null_sentinel)
630 Warn about uncasted NULL used as sentinel
632 Wstrict-prototypes
633 C ObjC Var(warn_strict_prototypes) Warning
634 Warn about unprototyped function declarations
636 Wstrict-selector-match
637 ObjC ObjC++ Var(warn_strict_selector_match) Warning
638 Warn if type signatures of candidate methods do not match exactly
640 Wsync-nand
641 C C++ Var(warn_sync_nand) Init(1) Warning
642 Warn when __sync_fetch_and_nand and __sync_nand_and_fetch built-in functions are used
644 Wsynth
645 C++ ObjC++ Var(warn_synth) Warning
646 Deprecated.  This switch has no effect
648 Wsystem-headers
649 C ObjC C++ ObjC++ Warning
650 ; Documented in common.opt
652 Wtraditional
653 C ObjC Var(warn_traditional) Warning
654 Warn about features not present in traditional C
656 Wtraditional-conversion
657 C ObjC Var(warn_traditional_conversion) Warning
658 Warn of prototypes causing type conversions different from what would happen in the absence of prototype
660 Wtrigraphs
661 C ObjC C++ ObjC++ Warning
662 Warn if trigraphs are encountered that might affect the meaning of the program
664 Wundeclared-selector
665 ObjC ObjC++ Var(warn_undeclared_selector) Warning
666 Warn about @selector()s without previously declared methods
668 Wundef
669 C ObjC C++ ObjC++ Warning
670 Warn if an undefined macro is used in an #if directive
672 Wunknown-pragmas
673 C ObjC C++ ObjC++ Warning
674 Warn about unrecognized pragmas
676 Wunsuffixed-float-constants
677 C ObjC Var(warn_unsuffixed_float_constants) Warning
678 Warn about unsuffixed float constants
680 Wunused-local-typedefs
681 C ObjC C++ ObjC++ Var(warn_unused_local_typedefs) Warning EnabledBy(Wunused)
682 Warn when typedefs locally defined in a function are not used
684 Wunused-macros
685 C ObjC C++ ObjC++ Warning
686 Warn about macros defined in the main file that are not used
688 Wunused-result
689 C ObjC C++ ObjC++ Var(warn_unused_result) Init(1) Warning
690 Warn if a caller of a function, marked with attribute warn_unused_result, does not use its return value
692 Wvariadic-macros
693 C ObjC C++ ObjC++ Warning
694 Do not warn about using variadic macros when -pedantic
696 Wvarargs
697 C ObjC C++ ObjC++ Warning Var(warn_varargs) Init(1)
698 Warn about questionable usage of the macros used to retrieve variable arguments
700 Wvla
701 C ObjC C++ ObjC++ Var(warn_vla) Init(-1) Warning
702 Warn if a variable length array is used
704 Wvolatile-register-var
705 C ObjC C++ ObjC++ Var(warn_volatile_register_var) Warning
706 Warn when a register variable is declared volatile
708 Wwrite-strings
709 C ObjC C++ ObjC++ Var(warn_write_strings) Warning
710 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.
712 Wpointer-sign
713 C ObjC Var(warn_pointer_sign) Init(-1) Warning
714 Warn when a pointer differs in signedness in an assignment
716 Wzero-as-null-pointer-constant
717 C++ ObjC++ Var(warn_zero_as_null_pointer_constant) Warning
718 Warn when a literal '0' is used as null pointer
720 Wuseless-cast
721 C++ ObjC++ Var(warn_useless_cast) Warning
722 Warn about useless casts
724 ansi
725 C ObjC C++ ObjC++
726 A synonym for -std=c89 (for C) or -std=c++98 (for C++)
729 C ObjC C++ ObjC++ Joined
730 ; Documented in common.opt.  FIXME - what about -dI, -dD, -dN and -dD?
732 faccess-control
733 C++ ObjC++ Var(flag_access_control) Init(1)
734 Enforce class member access control semantics
736 fall-virtual
737 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
739 fallow-parameterless-variadic-functions
740 C ObjC Var(flag_allow_parameterless_variadic_functions)
741 Allow variadic functions without named parameter
743 falt-external-templates
744 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
745 No longer supported
747 fasm
748 C ObjC C++ ObjC++ Var(flag_no_asm, 0)
749 Recognize the \"asm\" keyword
751 ; Define extra predefined macros for use in libgcc.
752 fbuilding-libgcc
753 C ObjC C++ ObjC++ Undocumented Var(flag_building_libgcc)
755 fbuiltin
756 C ObjC C++ ObjC++ Var(flag_no_builtin, 0)
757 Recognize built-in functions
759 fbuiltin-
760 C ObjC C++ ObjC++ Joined
762 fcheck-new
763 C++ ObjC++ Var(flag_check_new)
764 Check the return value of new
766 fcond-mismatch
767 C ObjC C++ ObjC++
768 Allow the arguments of the '?' operator to have different types
770 fconserve-space
771 C++ ObjC++ Var(flag_conserve_space)
772 Does nothing.  Preserved for backward compatibility.
774 fconstant-string-class=
775 ObjC ObjC++ Joined MissingArgError(no class name specified with %qs)
776 -fconst-string-class=<name>     Use class <name> for constant strings
778 fconstexpr-depth=
779 C++ ObjC++ Joined RejectNegative UInteger Var(max_constexpr_depth) Init(512)
780 -fconstexpr-depth=<number>      Specify maximum constexpr recursion depth
782 fdebug-cpp
783 C ObjC C++ ObjC++
784 Emit debug annotations during preprocessing
786 fdeduce-init-list
787 C++ ObjC++ Var(flag_deduce_init_list) Init(0)
788 -fdeduce-init-list      enable deduction of std::initializer_list for a template type parameter from a brace-enclosed initializer-list
790 fdefault-inline
791 C++ ObjC++ Ignore
792 Does nothing.  Preserved for backward compatibility.
794 fdirectives-only
795 C ObjC C++ ObjC++
796 Preprocess directives only.
798 fdollars-in-identifiers
799 C ObjC C++ ObjC++
800 Permit '$' as an identifier character
802 felide-constructors
803 C++ ObjC++ Var(flag_elide_constructors) Init(1)
805 fenforce-eh-specs
806 C++ ObjC++ Var(flag_enforce_eh_specs) Init(1)
807 Generate code to check exception specifications
809 fenum-int-equiv
810 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
812 fexec-charset=
813 C ObjC C++ ObjC++ Joined RejectNegative
814 -fexec-charset=<cset>   Convert all strings and character constants to character set <cset>
816 fextended-identifiers
817 C ObjC C++ ObjC++
818 Permit universal character names (\\u and \\U) in identifiers
820 finput-charset=
821 C ObjC C++ ObjC++ Joined RejectNegative
822 -finput-charset=<cset>  Specify the default character set for source files
825 fexternal-templates
826 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
828 ffor-scope
829 C++ ObjC++ Var(flag_new_for_scope) Init(1)
830 Scope of for-init-statement variables is local to the loop
832 ffreestanding
833 C ObjC C++ ObjC++
834 Do not assume that standard C libraries and \"main\" exist
836 fgnu-keywords
837 C++ ObjC++ Var(flag_no_gnu_keywords, 0)
838 Recognize GNU-defined keywords
840 fgnu-runtime
841 ObjC ObjC++ Report RejectNegative Var(flag_next_runtime,0) Init(NEXT_OBJC_RUNTIME)
842 Generate code for GNU runtime environment
844 fgnu89-inline
845 C ObjC Var(flag_gnu89_inline) Init(-1)
846 Use traditional GNU semantics for inline functions
848 fguiding-decls
849 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
851 fhandle-exceptions
852 C++ ObjC++ Optimization Alias(fexceptions) Warn({-fhandle-exceptions has been renamed -fexceptions (and is now on by default)})
854 fhonor-std
855 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
857 fhosted
858 C ObjC
859 Assume normal C execution environment
861 fhuge-objects
862 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
863 No longer supported
865 fimplement-inlines
866 C++ ObjC++ Var(flag_implement_inlines) Init(1)
867 Export functions even if they can be inlined
869 fimplicit-inline-templates
870 C++ ObjC++ Var(flag_implicit_inline_templates) Init(1)
871 Emit implicit instantiations of inline templates
873 fimplicit-templates
874 C++ ObjC++ Var(flag_implicit_templates) Init(1)
875 Emit implicit instantiations of templates
877 ffriend-injection
878 C++ ObjC++ Var(flag_friend_injection)
879 Inject friend functions into enclosing namespace
881 fkeep-inline-dllexport
882 C C++ ObjC ObjC++ Var(flag_keep_inline_dllexport) Init(1) Report Condition(TARGET_DLLIMPORT_DECL_ATTRIBUTES)
883 Don't emit dllexported inline functions unless needed
885 flabels-ok
886 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
888 flax-vector-conversions
889 C ObjC C++ ObjC++ Var(flag_lax_vector_conversions)
890 Allow implicit conversions between vectors with differing numbers of subparts and/or differing element types.
892 fms-extensions
893 C ObjC C++ ObjC++ Var(flag_ms_extensions)
894 Don't warn about uses of Microsoft extensions
896 fmudflap
897 C ObjC C++ ObjC++ RejectNegative Report Var(flag_mudflap)
898 Add mudflap bounds-checking instrumentation for single-threaded program
900 fmudflapth
901 C ObjC C++ ObjC++ RejectNegative Report Var(flag_mudflap,2)
902 Add mudflap bounds-checking instrumentation for multi-threaded program
904 fmudflapir
905 C ObjC C++ ObjC++ RejectNegative Report Var(flag_mudflap_ignore_reads)
906 Ignore read operations when inserting mudflap instrumentation
908 fname-mangling-version-
909 C++ ObjC++ Joined Ignore Warn(switch %qs is no longer supported)
911 fnew-abi
912 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
914 fnext-runtime
915 ObjC ObjC++ Report RejectNegative Var(flag_next_runtime)
916 Generate code for NeXT (Apple Mac OS X) runtime environment
918 fnil-receivers
919 ObjC ObjC++ Var(flag_nil_receivers) Init(1)
920 Assume that receivers of Objective-C messages may be nil
922 fnonansi-builtins
923 C++ ObjC++ Var(flag_no_nonansi_builtin, 0)
925 fnonnull-objects
926 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
928 fnothrow-opt
929 C++ ObjC++ Optimization Var(flag_nothrow_opt)
930 Treat a throw() exception specification as noexcept to improve code size
932 fobjc-abi-version=
933 ObjC ObjC++ Joined Report RejectNegative UInteger Var(flag_objc_abi)
934 Specify which ABI to use for Objective-C family code and meta-data generation.
936 ; Generate special '- .cxx_construct' and '- .cxx_destruct' methods
937 ; to initialize any non-POD ivars in Objective-C++ classes.
938 fobjc-call-cxx-cdtors
939 ObjC++ Var(flag_objc_call_cxx_cdtors)
940 Generate special Objective-C methods to initialize/destroy non-POD C++ ivars, if needed
942 fobjc-direct-dispatch
943 ObjC ObjC++ Var(flag_objc_direct_dispatch)
944 Allow fast jumps to the message dispatcher
946 ; Nonzero means that we will allow new ObjC exception syntax (@throw,
947 ; @try, etc.) in source code.
948 fobjc-exceptions
949 ObjC ObjC++ Var(flag_objc_exceptions)
950 Enable Objective-C exception and synchronization syntax
952 fobjc-gc
953 ObjC ObjC++ Var(flag_objc_gc)
954 Enable garbage collection (GC) in Objective-C/Objective-C++ programs
956 fobjc-nilcheck
957 ObjC ObjC++ Var(flag_objc_nilcheck,1)
958 Enable inline checks for nil receivers with the NeXT runtime and ABI version 2.
960 ; Nonzero means that we generate NeXT setjmp based exceptions.
961 fobjc-sjlj-exceptions
962 ObjC ObjC++ Var(flag_objc_sjlj_exceptions) Init(-1)
963 Enable Objective-C setjmp exception handling runtime
965 fobjc-std=objc1
966 ObjC ObjC++ Var(flag_objc1_only)
967 Conform to the Objective-C 1.0 language as implemented in GCC 4.0
969 fopenmp
970 C ObjC C++ ObjC++ Var(flag_openmp)
971 Enable OpenMP (implies -frecursive in Fortran)
973 foperator-names
974 C++ ObjC++
975 Recognize C++ keywords like \"compl\" and \"xor\"
977 foptional-diags
978 C++ ObjC++ Ignore
979 Does nothing.  Preserved for backward compatibility.
981 fpch-deps
982 C ObjC C++ ObjC++
984 fpch-preprocess
985 C ObjC C++ ObjC++
986 Look for and use PCH files even when preprocessing
988 fpermissive
989 C++ ObjC++ Var(flag_permissive)
990 Downgrade conformance errors to warnings
992 fplan9-extensions
993 C ObjC Var(flag_plan9_extensions)
994 Enable Plan 9 language extensions
996 fpreprocessed
997 C ObjC C++ ObjC++
998 Treat the input file as already preprocessed
1000 ftrack-macro-expansion
1001 C ObjC C++ ObjC++ JoinedOrMissing RejectNegative UInteger
1002 ; converted into ftrack-macro-expansion=
1004 ftrack-macro-expansion=
1005 C ObjC C++ ObjC++ JoinedOrMissing RejectNegative UInteger
1006 -ftrack-macro-expansion=<0|1|2>  Track locations of tokens coming from macro expansion and display them in error messages
1008 fpretty-templates
1009 C++ ObjC++ Var(flag_pretty_templates) Init(1)
1010 -fno-pretty-templates Do not pretty-print template specializations as the template signature followed by the arguments
1012 freplace-objc-classes
1013 ObjC ObjC++ Var(flag_replace_objc_classes)
1014 Used in Fix-and-Continue mode to indicate that object files may be swapped in at runtime
1016 frepo
1017 C++ ObjC++
1018 Enable automatic template instantiation
1020 frtti
1021 C++ ObjC++ Optimization Var(flag_rtti) Init(1)
1022 Generate run time type descriptor information
1024 fshort-double
1025 C ObjC C++ ObjC++ Optimization Var(flag_short_double)
1026 Use the same size for double as for float
1028 fshort-enums
1029 C ObjC C++ ObjC++ Optimization Var(flag_short_enums)
1030 Use the narrowest integer type possible for enumeration types
1032 fshort-wchar
1033 C ObjC C++ ObjC++ Optimization Var(flag_short_wchar)
1034 Force the underlying type for \"wchar_t\" to be \"unsigned short\"
1036 fsigned-bitfields
1037 C ObjC C++ ObjC++ Var(flag_signed_bitfields) Init(1)
1038 When \"signed\" or \"unsigned\" is not given make the bitfield signed
1040 fsigned-char
1041 C ObjC C++ ObjC++ LTO Var(flag_signed_char)
1042 Make \"char\" signed by default
1044 fsquangle
1045 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1047 fstats
1048 C++ ObjC++ Var(flag_detailed_statistics)
1049 Display statistics accumulated during compilation
1051 fstrict-enums
1052 C++ ObjC++ Optimization Var(flag_strict_enums)
1053 Assume that values of enumeration type are always within the minimum range of that type
1055 fstrict-prototype
1056 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1058 ftabstop=
1059 C ObjC C++ ObjC++ Joined RejectNegative UInteger
1060 -ftabstop=<number>      Distance between tab stops for column reporting
1062 ftemplate-backtrace-limit=
1063 C++ ObjC++ Joined RejectNegative UInteger Var(template_backtrace_limit) Init(10)
1064 Set the maximum number of template instantiation notes for a single warning or error
1066 ftemplate-depth-
1067 C++ ObjC++ Joined RejectNegative Undocumented Alias(ftemplate-depth=)
1069 ftemplate-depth=
1070 C++ ObjC++ Joined RejectNegative UInteger
1071 -ftemplate-depth=<number>       Specify maximum template instantiation depth
1073 fthis-is-variable
1074 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1076 fthreadsafe-statics
1077 C++ ObjC++ Optimization Var(flag_threadsafe_statics) Init(1)
1078 -fno-threadsafe-statics Do not generate thread-safe code for initializing local statics
1080 funsigned-bitfields
1081 C ObjC C++ ObjC++ Var(flag_signed_bitfields, 0)
1082 When \"signed\" or \"unsigned\" is not given make the bitfield unsigned
1084 funsigned-char
1085 C ObjC C++ ObjC++ LTO Var(flag_signed_char, 0)
1086 Make \"char\" unsigned by default
1088 fuse-cxa-atexit
1089 C++ ObjC++ Var(flag_use_cxa_atexit) Init(DEFAULT_USE_CXA_ATEXIT)
1090 Use __cxa_atexit to register destructors
1092 fuse-cxa-get-exception-ptr
1093 C++ ObjC++ Var(flag_use_cxa_get_exception_ptr) Init(2)
1094 Use __cxa_get_exception_ptr in exception handling
1096 fvisibility-inlines-hidden
1097 C++ ObjC++
1098 Marks all inlined functions and methods as having hidden visibility
1100 fvisibility-ms-compat
1101 C++ ObjC++ Var(flag_visibility_ms_compat)
1102 Changes visibility to match Microsoft Visual Studio by default
1104 fvtable-gc
1105 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1106 No longer supported
1108 fvtable-thunks
1109 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1110 No longer supported
1112 fweak
1113 C++ ObjC++ Var(flag_weak) Init(1)
1114 Emit common-like symbols as weak symbols
1116 fwide-exec-charset=
1117 C ObjC C++ ObjC++ Joined RejectNegative
1118 -fwide-exec-charset=<cset>      Convert all wide strings and character constants to character set <cset>
1120 fworking-directory
1121 C ObjC C++ ObjC++ Var(flag_working_directory) Init(-1)
1122 Generate a #line directive pointing at the current working directory
1124 fxref
1125 C++ ObjC++ Ignore Warn(switch %qs is no longer supported)
1126 No longer supported
1128 fzero-link
1129 ObjC ObjC++ Var(flag_zero_link)
1130 Generate lazy class lookup (via objc_getClass()) for use in Zero-Link mode
1132 gen-decls
1133 ObjC ObjC++ Var(flag_gen_declaration)
1134 Dump declarations to a .decl file
1136 femit-struct-debug-baseonly
1137 C ObjC C++ ObjC++
1138 -femit-struct-debug-baseonly    Aggressive reduced debug info for structs
1140 femit-struct-debug-reduced
1141 C ObjC C++ ObjC++
1142 -femit-struct-debug-reduced     Conservative reduced debug info for structs
1144 femit-struct-debug-detailed=
1145 C ObjC C++ ObjC++ Joined
1146 -femit-struct-debug-detailed=<spec-list>        Detailed reduced debug info for structs
1148 idirafter
1149 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1150 -idirafter <dir>        Add <dir> to the end of the system include path
1152 imacros
1153 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1154 -imacros <file> Accept definition of macros in <file>
1156 imultilib
1157 C ObjC C++ ObjC++ Joined Separate
1158 -imultilib <dir>        Set <dir> to be the multilib include subdirectory
1160 include
1161 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing filename after %qs)
1162 -include <file> Include the contents of <file> before other files
1164 iprefix
1165 C ObjC C++ ObjC++ Joined Separate
1166 -iprefix <path> Specify <path> as a prefix for next two options
1168 isysroot
1169 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1170 -isysroot <dir> Set <dir> to be the system root directory
1172 isystem
1173 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1174 -isystem <dir>  Add <dir> to the start of the system include path
1176 iquote
1177 C ObjC C++ ObjC++ Joined Separate MissingArgError(missing path after %qs)
1178 -iquote <dir>   Add <dir> to the end of the quote include path
1180 iwithprefix
1181 C ObjC C++ ObjC++ Joined Separate
1182 -iwithprefix <dir>      Add <dir> to the end of the system include path
1184 iwithprefixbefore
1185 C ObjC C++ ObjC++ Joined Separate
1186 -iwithprefixbefore <dir>        Add <dir> to the end of the main include path
1188 lang-asm
1189 C Undocumented RejectDriver
1191 no-integrated-cpp
1192 Driver
1194 nostdinc
1195 C ObjC C++ ObjC++
1196 Do not search standard system include directories (those specified with -isystem will still be used)
1198 nostdinc++
1199 C++ ObjC++
1200 Do not search standard system include directories for C++
1203 C ObjC C++ ObjC++ Joined Separate
1204 ; Documented in common.opt
1206 pedantic
1207 C ObjC C++ ObjC++ Alias(Wpedantic)
1208 ; Documented in common.opt
1210 print-objc-runtime-info
1211 ObjC ObjC++
1212 Generate C header of platform-specific features
1214 remap
1215 C ObjC C++ ObjC++
1216 Remap file names when including files
1218 std=c++98
1219 C++ ObjC++
1220 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1222 std=c++03
1223 C++ ObjC++ Alias(std=c++98)
1224 Conform to the ISO 1998 C++ standard revised by the 2003 technical corrigendum
1226 std=c++11
1227 C++ ObjC++
1228 Conform to the ISO 2011 C++ standard (experimental and incomplete support)
1230 std=c++0x
1231 C++ ObjC++ Alias(std=c++11)
1232 Deprecated in favor of -std=c++11
1234 std=c++1y
1235 C++ ObjC++
1236 Conform to the ISO 201y(7?) C++ draft standard (experimental and incomplete support)
1238 std=c11
1239 C ObjC
1240 Conform to the ISO 2011 C standard (experimental and incomplete support)
1242 std=c1x
1243 C ObjC Alias(std=c11)
1244 Deprecated in favor of -std=c11
1246 std=c89
1247 C ObjC Alias(std=c90)
1248 Conform to the ISO 1990 C standard
1250 std=c90
1251 C ObjC
1252 Conform to the ISO 1990 C standard
1254 std=c99
1255 C ObjC
1256 Conform to the ISO 1999 C standard
1258 std=c9x
1259 C ObjC Alias(std=c99)
1260 Deprecated in favor of -std=c99
1262 std=gnu++98
1263 C++ ObjC++
1264 Conform to the ISO 1998 C++ standard revised by the 2003 technical
1265 corrigendum with GNU extensions
1267 std=gnu++03
1268 C++ ObjC++ Alias(std=gnu++98)
1269 Conform to the ISO 1998 C++ standard revised by the 2003 technical
1270 corrigendum with GNU extensions
1272 std=gnu++11
1273 C++ ObjC++
1274 Conform to the ISO 2011 C++ standard with GNU extensions (experimental and incomplete support)
1276 std=gnu++0x
1277 C++ ObjC++ Alias(std=gnu++11)
1278 Deprecated in favor of -std=gnu++11
1280 std=gnu++1y
1281 C++ ObjC++
1282 Conform to the ISO 201y(7?) C++ draft standard with GNU extensions (experimental and incomplete support)
1284 std=gnu11
1285 C ObjC
1286 Conform to the ISO 2011 C standard with GNU extensions (experimental and incomplete support)
1288 std=gnu1x
1289 C ObjC Alias(std=gnu11)
1290 Deprecated in favor of -std=gnu11
1292 std=gnu89
1293 C ObjC Alias(std=gnu90)
1294 Conform to the ISO 1990 C standard with GNU extensions
1296 std=gnu90
1297 C ObjC
1298 Conform to the ISO 1990 C standard with GNU extensions
1300 std=gnu99
1301 C ObjC
1302 Conform to the ISO 1999 C standard with GNU extensions
1304 std=gnu9x
1305 C ObjC Alias(std=gnu99)
1306 Deprecated in favor of -std=gnu99
1308 std=iso9899:1990
1309 C ObjC Alias(std=c90)
1310 Conform to the ISO 1990 C standard
1312 std=iso9899:199409
1313 C ObjC
1314 Conform to the ISO 1990 C standard as amended in 1994
1316 std=iso9899:1999
1317 C ObjC Alias(std=c99)
1318 Conform to the ISO 1999 C standard
1320 std=iso9899:199x
1321 C ObjC Alias(std=c99)
1322 Deprecated in favor of -std=iso9899:1999
1324 std=iso9899:2011
1325 C ObjC Alias(std=c11)
1326 Conform to the ISO 2011 C standard (experimental and incomplete support)
1328 traditional
1329 Driver
1331 traditional-cpp
1332 C ObjC C++ ObjC++
1333 Enable traditional preprocessing
1335 trigraphs
1336 C ObjC C++ ObjC++
1337 -trigraphs      Support ISO C trigraphs
1339 undef
1340 C ObjC C++ ObjC++ Var(flag_undef)
1341 Do not predefine system-specific and GCC-specific macros
1344 C ObjC C++ ObjC++
1345 ; Documented in common.opt
1348 C ObjC C++ ObjC++
1349 ; Documented in common.opt
1351 ; This comment is to ensure we retain the blank line above.