OSDN Git Service

2011-05-08 Jonathan Wakely <jwakely.gcc@gmail.com>
[pf3gnuchains/gcc-fork.git] / gcc / doc / invoke.texi
1 @c Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
2 @c 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
3 @c Free Software Foundation, Inc.
4 @c This is part of the GCC manual.
5 @c For copying conditions, see the file gcc.texi.
6
7 @ignore
8 @c man begin INCLUDE
9 @include gcc-vers.texi
10 @c man end
11
12 @c man begin COPYRIGHT
13 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
14 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
15 Free Software Foundation, Inc.
16
17 Permission is granted to copy, distribute and/or modify this document
18 under the terms of the GNU Free Documentation License, Version 1.3 or
19 any later version published by the Free Software Foundation; with the
20 Invariant Sections being ``GNU General Public License'' and ``Funding
21 Free Software'', the Front-Cover texts being (a) (see below), and with
22 the Back-Cover Texts being (b) (see below).  A copy of the license is
23 included in the gfdl(7) man page.
24
25 (a) The FSF's Front-Cover Text is:
26
27      A GNU Manual
28
29 (b) The FSF's Back-Cover Text is:
30
31      You have freedom to copy and modify this GNU Manual, like GNU
32      software.  Copies published by the Free Software Foundation raise
33      funds for GNU development.
34 @c man end
35 @c Set file name and title for the man page.
36 @setfilename gcc
37 @settitle GNU project C and C++ compiler
38 @c man begin SYNOPSIS
39 gcc [@option{-c}|@option{-S}|@option{-E}] [@option{-std=}@var{standard}]
40     [@option{-g}] [@option{-pg}] [@option{-O}@var{level}]
41     [@option{-W}@var{warn}@dots{}] [@option{-pedantic}]
42     [@option{-I}@var{dir}@dots{}] [@option{-L}@var{dir}@dots{}]
43     [@option{-D}@var{macro}[=@var{defn}]@dots{}] [@option{-U}@var{macro}]
44     [@option{-f}@var{option}@dots{}] [@option{-m}@var{machine-option}@dots{}]
45     [@option{-o} @var{outfile}] [@@@var{file}] @var{infile}@dots{}
46
47 Only the most useful options are listed here; see below for the
48 remainder.  @samp{g++} accepts mostly the same options as @samp{gcc}.
49 @c man end
50 @c man begin SEEALSO
51 gpl(7), gfdl(7), fsf-funding(7),
52 cpp(1), gcov(1), as(1), ld(1), gdb(1), adb(1), dbx(1), sdb(1)
53 and the Info entries for @file{gcc}, @file{cpp}, @file{as},
54 @file{ld}, @file{binutils} and @file{gdb}.
55 @c man end
56 @c man begin BUGS
57 For instructions on reporting bugs, see
58 @w{@value{BUGURL}}.
59 @c man end
60 @c man begin AUTHOR
61 See the Info entry for @command{gcc}, or
62 @w{@uref{http://gcc.gnu.org/onlinedocs/gcc/Contributors.html}},
63 for contributors to GCC@.
64 @c man end
65 @end ignore
66
67 @node Invoking GCC
68 @chapter GCC Command Options
69 @cindex GCC command options
70 @cindex command options
71 @cindex options, GCC command
72
73 @c man begin DESCRIPTION
74 When you invoke GCC, it normally does preprocessing, compilation,
75 assembly and linking.  The ``overall options'' allow you to stop this
76 process at an intermediate stage.  For example, the @option{-c} option
77 says not to run the linker.  Then the output consists of object files
78 output by the assembler.
79
80 Other options are passed on to one stage of processing.  Some options
81 control the preprocessor and others the compiler itself.  Yet other
82 options control the assembler and linker; most of these are not
83 documented here, since you rarely need to use any of them.
84
85 @cindex C compilation options
86 Most of the command line options that you can use with GCC are useful
87 for C programs; when an option is only useful with another language
88 (usually C++), the explanation says so explicitly.  If the description
89 for a particular option does not mention a source language, you can use
90 that option with all supported languages.
91
92 @cindex C++ compilation options
93 @xref{Invoking G++,,Compiling C++ Programs}, for a summary of special
94 options for compiling C++ programs.
95
96 @cindex grouping options
97 @cindex options, grouping
98 The @command{gcc} program accepts options and file names as operands.  Many
99 options have multi-letter names; therefore multiple single-letter options
100 may @emph{not} be grouped: @option{-dv} is very different from @w{@samp{-d
101 -v}}.
102
103 @cindex order of options
104 @cindex options, order
105 You can mix options and other arguments.  For the most part, the order
106 you use doesn't matter.  Order does matter when you use several
107 options of the same kind; for example, if you specify @option{-L} more
108 than once, the directories are searched in the order specified.  Also,
109 the placement of the @option{-l} option is significant.
110
111 Many options have long names starting with @samp{-f} or with
112 @samp{-W}---for example,
113 @option{-fmove-loop-invariants}, @option{-Wformat} and so on.  Most of
114 these have both positive and negative forms; the negative form of
115 @option{-ffoo} would be @option{-fno-foo}.  This manual documents
116 only one of these two forms, whichever one is not the default.
117
118 @c man end
119
120 @xref{Option Index}, for an index to GCC's options.
121
122 @menu
123 * Option Summary::      Brief list of all options, without explanations.
124 * Overall Options::     Controlling the kind of output:
125                         an executable, object files, assembler files,
126                         or preprocessed source.
127 * Invoking G++::        Compiling C++ programs.
128 * C Dialect Options::   Controlling the variant of C language compiled.
129 * C++ Dialect Options:: Variations on C++.
130 * Objective-C and Objective-C++ Dialect Options:: Variations on Objective-C
131                         and Objective-C++.
132 * Language Independent Options:: Controlling how diagnostics should be
133                         formatted.
134 * Warning Options::     How picky should the compiler be?
135 * Debugging Options::   Symbol tables, measurements, and debugging dumps.
136 * Optimize Options::    How much optimization?
137 * Preprocessor Options:: Controlling header files and macro definitions.
138                          Also, getting dependency information for Make.
139 * Assembler Options::   Passing options to the assembler.
140 * Link Options::        Specifying libraries and so on.
141 * Directory Options::   Where to find header files and libraries.
142                         Where to find the compiler executable files.
143 * Spec Files::          How to pass switches to sub-processes.
144 * Target Options::      Running a cross-compiler, or an old version of GCC.
145 * Submodel Options::    Specifying minor hardware or convention variations,
146                         such as 68010 vs 68020.
147 * Code Gen Options::    Specifying conventions for function calls, data layout
148                         and register usage.
149 * Environment Variables:: Env vars that affect GCC.
150 * Precompiled Headers:: Compiling a header once, and using it many times.
151 @end menu
152
153 @c man begin OPTIONS
154
155 @node Option Summary
156 @section Option Summary
157
158 Here is a summary of all the options, grouped by type.  Explanations are
159 in the following sections.
160
161 @table @emph
162 @item Overall Options
163 @xref{Overall Options,,Options Controlling the Kind of Output}.
164 @gccoptlist{-c  -S  -E  -o @var{file}  -no-canonical-prefixes  @gol
165 -pipe  -pass-exit-codes  @gol
166 -x @var{language}  -v  -###  --help@r{[}=@var{class}@r{[},@dots{}@r{]]}  --target-help  @gol
167 --version -wrapper @@@var{file} -fplugin=@var{file} -fplugin-arg-@var{name}=@var{arg}  @gol
168 -fdump-ada-spec@r{[}-slim@r{]} -fdump-go-spec=@var{file}}
169
170 @item C Language Options
171 @xref{C Dialect Options,,Options Controlling C Dialect}.
172 @gccoptlist{-ansi  -std=@var{standard}  -fgnu89-inline @gol
173 -aux-info @var{filename} @gol
174 -fno-asm  -fno-builtin  -fno-builtin-@var{function} @gol
175 -fhosted  -ffreestanding -fopenmp -fms-extensions -fplan9-extensions @gol
176 -trigraphs  -no-integrated-cpp  -traditional  -traditional-cpp @gol
177 -fallow-single-precision  -fcond-mismatch -flax-vector-conversions @gol
178 -fsigned-bitfields  -fsigned-char @gol
179 -funsigned-bitfields  -funsigned-char}
180
181 @item C++ Language Options
182 @xref{C++ Dialect Options,,Options Controlling C++ Dialect}.
183 @gccoptlist{-fabi-version=@var{n}  -fno-access-control  -fcheck-new @gol
184 -fconserve-space  -fconstexpr-depth=@var{n}  -ffriend-injection @gol
185 -fno-elide-constructors @gol
186 -fno-enforce-eh-specs @gol
187 -ffor-scope  -fno-for-scope  -fno-gnu-keywords @gol
188 -fno-implicit-templates @gol
189 -fno-implicit-inline-templates @gol
190 -fno-implement-inlines  -fms-extensions @gol
191 -fno-nonansi-builtins  -fnothrow-opt  -fno-operator-names @gol
192 -fno-optional-diags  -fpermissive @gol
193 -fno-pretty-templates @gol
194 -frepo  -fno-rtti  -fstats  -ftemplate-depth=@var{n} @gol
195 -fno-threadsafe-statics -fuse-cxa-atexit  -fno-weak  -nostdinc++ @gol
196 -fno-default-inline  -fvisibility-inlines-hidden @gol
197 -fvisibility-ms-compat @gol
198 -Wabi  -Wconversion-null  -Wctor-dtor-privacy @gol
199 -Wnoexcept -Wnon-virtual-dtor  -Wreorder @gol
200 -Weffc++  -Wstrict-null-sentinel @gol
201 -Wno-non-template-friend  -Wold-style-cast @gol
202 -Woverloaded-virtual  -Wno-pmf-conversions @gol
203 -Wsign-promo}
204
205 @item Objective-C and Objective-C++ Language Options
206 @xref{Objective-C and Objective-C++ Dialect Options,,Options Controlling
207 Objective-C and Objective-C++ Dialects}.
208 @gccoptlist{-fconstant-string-class=@var{class-name} @gol
209 -fgnu-runtime  -fnext-runtime @gol
210 -fno-nil-receivers @gol
211 -fobjc-abi-version=@var{n} @gol
212 -fobjc-call-cxx-cdtors @gol
213 -fobjc-direct-dispatch @gol
214 -fobjc-exceptions @gol
215 -fobjc-gc @gol
216 -fobjc-nilcheck @gol
217 -fobjc-std=objc1 @gol
218 -freplace-objc-classes @gol
219 -fzero-link @gol
220 -gen-decls @gol
221 -Wassign-intercept @gol
222 -Wno-protocol  -Wselector @gol
223 -Wstrict-selector-match @gol
224 -Wundeclared-selector}
225
226 @item Language Independent Options
227 @xref{Language Independent Options,,Options to Control Diagnostic Messages Formatting}.
228 @gccoptlist{-fmessage-length=@var{n}  @gol
229 -fdiagnostics-show-location=@r{[}once@r{|}every-line@r{]}  @gol
230 -fno-diagnostics-show-option}
231
232 @item Warning Options
233 @xref{Warning Options,,Options to Request or Suppress Warnings}.
234 @gccoptlist{-fsyntax-only  -fmax-errors=@var{n}  -pedantic @gol
235 -pedantic-errors @gol
236 -w  -Wextra  -Wall  -Waddress  -Waggregate-return  -Warray-bounds @gol
237 -Wno-attributes -Wno-builtin-macro-redefined @gol
238 -Wc++-compat -Wc++0x-compat -Wcast-align  -Wcast-qual  @gol
239 -Wchar-subscripts -Wclobbered  -Wcomment @gol
240 -Wconversion  -Wcoverage-mismatch  -Wno-cpp  -Wno-deprecated  @gol
241 -Wno-deprecated-declarations -Wdisabled-optimization  @gol
242 -Wno-div-by-zero -Wdouble-promotion -Wempty-body  -Wenum-compare @gol
243 -Wno-endif-labels -Werror  -Werror=* @gol
244 -Wfatal-errors  -Wfloat-equal  -Wformat  -Wformat=2 @gol
245 -Wno-format-contains-nul -Wno-format-extra-args -Wformat-nonliteral @gol
246 -Wformat-security  -Wformat-y2k @gol
247 -Wframe-larger-than=@var{len} -Wjump-misses-init -Wignored-qualifiers @gol
248 -Wimplicit  -Wimplicit-function-declaration  -Wimplicit-int @gol
249 -Winit-self  -Winline -Wmaybe-uninitialized @gol
250 -Wno-int-to-pointer-cast -Wno-invalid-offsetof @gol
251 -Winvalid-pch -Wlarger-than=@var{len}  -Wunsafe-loop-optimizations @gol
252 -Wlogical-op -Wlong-long @gol
253 -Wmain -Wmaybe-uninitialized -Wmissing-braces  -Wmissing-field-initializers @gol
254 -Wmissing-format-attribute  -Wmissing-include-dirs @gol
255 -Wno-mudflap @gol
256 -Wno-multichar  -Wnonnull  -Wno-overflow @gol
257 -Woverlength-strings  -Wpacked  -Wpacked-bitfield-compat  -Wpadded @gol
258 -Wparentheses  -Wpedantic-ms-format -Wno-pedantic-ms-format @gol
259 -Wpointer-arith  -Wno-pointer-to-int-cast @gol
260 -Wredundant-decls @gol
261 -Wreturn-type  -Wsequence-point  -Wshadow @gol
262 -Wsign-compare  -Wsign-conversion  -Wstack-protector @gol
263 -Wstrict-aliasing -Wstrict-aliasing=n @gol
264 -Wstrict-overflow -Wstrict-overflow=@var{n} @gol
265 -Wsuggest-attribute=@r{[}pure@r{|}const@r{|}noreturn@r{]} @gol
266 -Wswitch  -Wswitch-default  -Wswitch-enum -Wsync-nand @gol
267 -Wsystem-headers  -Wtrampolines  -Wtrigraphs  -Wtype-limits  -Wundef @gol
268 -Wuninitialized  -Wunknown-pragmas  -Wno-pragmas @gol
269 -Wunsuffixed-float-constants  -Wunused  -Wunused-function @gol
270 -Wunused-label  -Wunused-parameter -Wno-unused-result -Wunused-value @gol
271 -Wunused-variable -Wunused-but-set-parameter -Wunused-but-set-variable @gol
272 -Wvariadic-macros -Wvla -Wvolatile-register-var  -Wwrite-strings}
273
274 @item C and Objective-C-only Warning Options
275 @gccoptlist{-Wbad-function-cast  -Wmissing-declarations @gol
276 -Wmissing-parameter-type  -Wmissing-prototypes  -Wnested-externs @gol
277 -Wold-style-declaration  -Wold-style-definition @gol
278 -Wstrict-prototypes  -Wtraditional  -Wtraditional-conversion @gol
279 -Wdeclaration-after-statement -Wpointer-sign}
280
281 @item Debugging Options
282 @xref{Debugging Options,,Options for Debugging Your Program or GCC}.
283 @gccoptlist{-d@var{letters}  -dumpspecs  -dumpmachine  -dumpversion @gol
284 -fdbg-cnt-list -fdbg-cnt=@var{counter-value-list} @gol
285 -fdump-noaddr -fdump-unnumbered -fdump-unnumbered-links @gol
286 -fdump-translation-unit@r{[}-@var{n}@r{]} @gol
287 -fdump-class-hierarchy@r{[}-@var{n}@r{]} @gol
288 -fdump-ipa-all -fdump-ipa-cgraph -fdump-ipa-inline @gol
289 -fdump-statistics @gol
290 -fdump-tree-all @gol
291 -fdump-tree-original@r{[}-@var{n}@r{]}  @gol
292 -fdump-tree-optimized@r{[}-@var{n}@r{]} @gol
293 -fdump-tree-cfg -fdump-tree-vcg -fdump-tree-alias @gol
294 -fdump-tree-ch @gol
295 -fdump-tree-ssa@r{[}-@var{n}@r{]} -fdump-tree-pre@r{[}-@var{n}@r{]} @gol
296 -fdump-tree-ccp@r{[}-@var{n}@r{]} -fdump-tree-dce@r{[}-@var{n}@r{]} @gol
297 -fdump-tree-gimple@r{[}-raw@r{]} -fdump-tree-mudflap@r{[}-@var{n}@r{]} @gol
298 -fdump-tree-dom@r{[}-@var{n}@r{]} @gol
299 -fdump-tree-dse@r{[}-@var{n}@r{]} @gol
300 -fdump-tree-phiprop@r{[}-@var{n}@r{]} @gol
301 -fdump-tree-phiopt@r{[}-@var{n}@r{]} @gol
302 -fdump-tree-forwprop@r{[}-@var{n}@r{]} @gol
303 -fdump-tree-copyrename@r{[}-@var{n}@r{]} @gol
304 -fdump-tree-nrv -fdump-tree-vect @gol
305 -fdump-tree-sink @gol
306 -fdump-tree-sra@r{[}-@var{n}@r{]} @gol
307 -fdump-tree-forwprop@r{[}-@var{n}@r{]} @gol
308 -fdump-tree-fre@r{[}-@var{n}@r{]} @gol
309 -fdump-tree-vrp@r{[}-@var{n}@r{]} @gol
310 -ftree-vectorizer-verbose=@var{n} @gol
311 -fdump-tree-storeccp@r{[}-@var{n}@r{]} @gol
312 -fdump-final-insns=@var{file} @gol
313 -fcompare-debug@r{[}=@var{opts}@r{]}  -fcompare-debug-second @gol
314 -feliminate-dwarf2-dups -feliminate-unused-debug-types @gol
315 -feliminate-unused-debug-symbols -femit-class-debug-always @gol
316 -fdebug-types-section @gol
317 -fmem-report -fpre-ipa-mem-report -fpost-ipa-mem-report -fprofile-arcs @gol
318 -frandom-seed=@var{string} -fsched-verbose=@var{n} @gol
319 -fsel-sched-verbose -fsel-sched-dump-cfg -fsel-sched-pipelining-verbose @gol
320 -fstack-usage  -ftest-coverage  -ftime-report -fvar-tracking @gol
321 -fvar-tracking-assignments  -fvar-tracking-assignments-toggle @gol
322 -g  -g@var{level}  -gtoggle  -gcoff  -gdwarf-@var{version} @gol
323 -ggdb  -gstabs  -gstabs+  -gstrict-dwarf  -gno-strict-dwarf @gol
324 -gvms  -gxcoff  -gxcoff+ @gol
325 -fno-merge-debug-strings -fno-dwarf2-cfi-asm @gol
326 -fdebug-prefix-map=@var{old}=@var{new} @gol
327 -femit-struct-debug-baseonly -femit-struct-debug-reduced @gol
328 -femit-struct-debug-detailed@r{[}=@var{spec-list}@r{]} @gol
329 -p  -pg  -print-file-name=@var{library}  -print-libgcc-file-name @gol
330 -print-multi-directory  -print-multi-lib  -print-multi-os-directory @gol
331 -print-prog-name=@var{program}  -print-search-dirs  -Q @gol
332 -print-sysroot -print-sysroot-headers-suffix @gol
333 -save-temps -save-temps=cwd -save-temps=obj -time@r{[}=@var{file}@r{]}}
334
335 @item Optimization Options
336 @xref{Optimize Options,,Options that Control Optimization}.
337 @gccoptlist{-falign-functions[=@var{n}] -falign-jumps[=@var{n}] @gol
338 -falign-labels[=@var{n}] -falign-loops[=@var{n}] -fassociative-math @gol
339 -fauto-inc-dec -fbranch-probabilities -fbranch-target-load-optimize @gol
340 -fbranch-target-load-optimize2 -fbtr-bb-exclusive -fcaller-saves @gol
341 -fcheck-data-deps -fcombine-stack-adjustments -fconserve-stack @gol
342 -fcompare-elim -fcprop-registers -fcrossjumping @gol
343 -fcse-follow-jumps -fcse-skip-blocks -fcx-fortran-rules @gol
344 -fcx-limited-range @gol
345 -fdata-sections -fdce -fdce -fdelayed-branch @gol
346 -fdelete-null-pointer-checks -fdse -fdevirtualize -fdse @gol
347 -fearly-inlining -fipa-sra -fexpensive-optimizations -ffast-math @gol
348 -ffinite-math-only -ffloat-store -fexcess-precision=@var{style} @gol
349 -fforward-propagate -ffp-contract=@var{style} -ffunction-sections @gol
350 -fgcse -fgcse-after-reload -fgcse-las -fgcse-lm -fgraphite-identity @gol
351 -fgcse-sm -fif-conversion -fif-conversion2 -findirect-inlining @gol
352 -finline-functions -finline-functions-called-once -finline-limit=@var{n} @gol
353 -finline-small-functions -fipa-cp -fipa-cp-clone -fipa-matrix-reorg @gol
354 -fipa-pta -fipa-profile -fipa-pure-const -fipa-reference @gol
355 -fira-algorithm=@var{algorithm} @gol
356 -fira-region=@var{region} @gol
357 -fira-loop-pressure -fno-ira-share-save-slots @gol
358 -fno-ira-share-spill-slots -fira-verbose=@var{n} @gol
359 -fivopts -fkeep-inline-functions -fkeep-static-consts @gol
360 -floop-block -floop-flatten -floop-interchange -floop-strip-mine @gol
361 -floop-parallelize-all -flto -flto-compression-level @gol
362 -flto-partition=@var{alg} -flto-report -fmerge-all-constants @gol
363 -fmerge-constants -fmodulo-sched -fmodulo-sched-allow-regmoves @gol
364 -fmove-loop-invariants fmudflap -fmudflapir -fmudflapth -fno-branch-count-reg @gol
365 -fno-default-inline @gol
366 -fno-defer-pop -fno-function-cse -fno-guess-branch-probability @gol
367 -fno-inline -fno-math-errno -fno-peephole -fno-peephole2 @gol
368 -fno-sched-interblock -fno-sched-spec -fno-signed-zeros @gol
369 -fno-toplevel-reorder -fno-trapping-math -fno-zero-initialized-in-bss @gol
370 -fomit-frame-pointer -foptimize-register-move -foptimize-sibling-calls @gol
371 -fpartial-inlining -fpeel-loops -fpredictive-commoning @gol
372 -fprefetch-loop-arrays @gol
373 -fprofile-correction -fprofile-dir=@var{path} -fprofile-generate @gol
374 -fprofile-generate=@var{path} @gol
375 -fprofile-use -fprofile-use=@var{path} -fprofile-values @gol
376 -freciprocal-math -fregmove -frename-registers -freorder-blocks @gol
377 -freorder-blocks-and-partition -freorder-functions @gol
378 -frerun-cse-after-loop -freschedule-modulo-scheduled-loops @gol
379 -frounding-math -fsched2-use-superblocks -fsched-pressure @gol
380 -fsched-spec-load -fsched-spec-load-dangerous @gol
381 -fsched-stalled-insns-dep[=@var{n}] -fsched-stalled-insns[=@var{n}] @gol
382 -fsched-group-heuristic -fsched-critical-path-heuristic @gol
383 -fsched-spec-insn-heuristic -fsched-rank-heuristic @gol
384 -fsched-last-insn-heuristic -fsched-dep-count-heuristic @gol
385 -fschedule-insns -fschedule-insns2 -fsection-anchors @gol
386 -fselective-scheduling -fselective-scheduling2 @gol
387 -fsel-sched-pipelining -fsel-sched-pipelining-outer-loops @gol
388 -fsignaling-nans -fsingle-precision-constant -fsplit-ivs-in-unroller @gol
389 -fsplit-wide-types -fstack-protector -fstack-protector-all @gol
390 -fstrict-aliasing -fstrict-overflow -fthread-jumps -ftracer @gol
391 -ftree-bit-ccp @gol
392 -ftree-builtin-call-dce -ftree-ccp -ftree-ch -ftree-copy-prop @gol
393 -ftree-copyrename -ftree-dce -ftree-dominator-opts -ftree-dse @gol
394 -ftree-forwprop -ftree-fre -ftree-loop-if-convert @gol
395 -ftree-loop-if-convert-stores -ftree-loop-im @gol
396 -ftree-phiprop -ftree-loop-distribution -ftree-loop-distribute-patterns @gol
397 -ftree-loop-ivcanon -ftree-loop-linear -ftree-loop-optimize @gol
398 -ftree-parallelize-loops=@var{n} -ftree-pre -ftree-pta -ftree-reassoc @gol
399 -ftree-sink -ftree-sra -ftree-switch-conversion @gol
400 -ftree-ter -ftree-vect-loop-version -ftree-vectorize -ftree-vrp @gol
401 -funit-at-a-time -funroll-all-loops -funroll-loops @gol
402 -funsafe-loop-optimizations -funsafe-math-optimizations -funswitch-loops @gol
403 -fvariable-expansion-in-unroller -fvect-cost-model -fvpt -fweb @gol
404 -fwhole-program -fwpa -fuse-linker-plugin @gol
405 --param @var{name}=@var{value}
406 -O  -O0  -O1  -O2  -O3  -Os -Ofast}
407
408 @item Preprocessor Options
409 @xref{Preprocessor Options,,Options Controlling the Preprocessor}.
410 @gccoptlist{-A@var{question}=@var{answer} @gol
411 -A-@var{question}@r{[}=@var{answer}@r{]} @gol
412 -C  -dD  -dI  -dM  -dN @gol
413 -D@var{macro}@r{[}=@var{defn}@r{]}  -E  -H @gol
414 -idirafter @var{dir} @gol
415 -include @var{file}  -imacros @var{file} @gol
416 -iprefix @var{file}  -iwithprefix @var{dir} @gol
417 -iwithprefixbefore @var{dir}  -isystem @var{dir} @gol
418 -imultilib @var{dir} -isysroot @var{dir} @gol
419 -M  -MM  -MF  -MG  -MP  -MQ  -MT  -nostdinc  @gol
420 -P  -fworking-directory  -remap @gol
421 -trigraphs  -undef  -U@var{macro}  -Wp,@var{option} @gol
422 -Xpreprocessor @var{option}}
423
424 @item Assembler Option
425 @xref{Assembler Options,,Passing Options to the Assembler}.
426 @gccoptlist{-Wa,@var{option}  -Xassembler @var{option}}
427
428 @item Linker Options
429 @xref{Link Options,,Options for Linking}.
430 @gccoptlist{@var{object-file-name}  -l@var{library} @gol
431 -nostartfiles  -nodefaultlibs  -nostdlib -pie -rdynamic @gol
432 -s  -static  -static-libgcc  -static-libstdc++ -shared  @gol
433 -shared-libgcc  -symbolic @gol
434 -T @var{script}  -Wl,@var{option}  -Xlinker @var{option} @gol
435 -u @var{symbol}}
436
437 @item Directory Options
438 @xref{Directory Options,,Options for Directory Search}.
439 @gccoptlist{-B@var{prefix} -I@var{dir} -iplugindir=@var{dir} @gol
440 -iquote@var{dir} -L@var{dir} -specs=@var{file} -I- @gol
441 --sysroot=@var{dir}}
442
443 @item Machine Dependent Options
444 @xref{Submodel Options,,Hardware Models and Configurations}.
445 @c This list is ordered alphanumerically by subsection name.
446 @c Try and put the significant identifier (CPU or system) first,
447 @c so users have a clue at guessing where the ones they want will be.
448
449 @emph{ARM Options}
450 @gccoptlist{-mapcs-frame  -mno-apcs-frame @gol
451 -mabi=@var{name} @gol
452 -mapcs-stack-check  -mno-apcs-stack-check @gol
453 -mapcs-float  -mno-apcs-float @gol
454 -mapcs-reentrant  -mno-apcs-reentrant @gol
455 -msched-prolog  -mno-sched-prolog @gol
456 -mlittle-endian  -mbig-endian  -mwords-little-endian @gol
457 -mfloat-abi=@var{name}  -mfpe @gol
458 -mfp16-format=@var{name}
459 -mthumb-interwork  -mno-thumb-interwork @gol
460 -mcpu=@var{name}  -march=@var{name}  -mfpu=@var{name}  @gol
461 -mstructure-size-boundary=@var{n} @gol
462 -mabort-on-noreturn @gol
463 -mlong-calls  -mno-long-calls @gol
464 -msingle-pic-base  -mno-single-pic-base @gol
465 -mpic-register=@var{reg} @gol
466 -mnop-fun-dllimport @gol
467 -mcirrus-fix-invalid-insns -mno-cirrus-fix-invalid-insns @gol
468 -mpoke-function-name @gol
469 -mthumb  -marm @gol
470 -mtpcs-frame  -mtpcs-leaf-frame @gol
471 -mcaller-super-interworking  -mcallee-super-interworking @gol
472 -mtp=@var{name} @gol
473 -mword-relocations @gol
474 -mfix-cortex-m3-ldrd}
475
476 @emph{AVR Options}
477 @gccoptlist{-mmcu=@var{mcu}  -mno-interrupts @gol
478 -mcall-prologues  -mtiny-stack  -mint8}
479
480 @emph{Blackfin Options}
481 @gccoptlist{-mcpu=@var{cpu}@r{[}-@var{sirevision}@r{]} @gol
482 -msim -momit-leaf-frame-pointer  -mno-omit-leaf-frame-pointer @gol
483 -mspecld-anomaly  -mno-specld-anomaly  -mcsync-anomaly  -mno-csync-anomaly @gol
484 -mlow-64k -mno-low64k  -mstack-check-l1  -mid-shared-library @gol
485 -mno-id-shared-library  -mshared-library-id=@var{n} @gol
486 -mleaf-id-shared-library  -mno-leaf-id-shared-library @gol
487 -msep-data  -mno-sep-data  -mlong-calls  -mno-long-calls @gol
488 -mfast-fp -minline-plt -mmulticore  -mcorea  -mcoreb  -msdram @gol
489 -micplb}
490
491 @emph{CRIS Options}
492 @gccoptlist{-mcpu=@var{cpu}  -march=@var{cpu}  -mtune=@var{cpu} @gol
493 -mmax-stack-frame=@var{n}  -melinux-stacksize=@var{n} @gol
494 -metrax4  -metrax100  -mpdebug  -mcc-init  -mno-side-effects @gol
495 -mstack-align  -mdata-align  -mconst-align @gol
496 -m32-bit  -m16-bit  -m8-bit  -mno-prologue-epilogue  -mno-gotplt @gol
497 -melf  -maout  -melinux  -mlinux  -sim  -sim2 @gol
498 -mmul-bug-workaround  -mno-mul-bug-workaround}
499
500 @emph{Darwin Options}
501 @gccoptlist{-all_load  -allowable_client  -arch  -arch_errors_fatal @gol
502 -arch_only  -bind_at_load  -bundle  -bundle_loader @gol
503 -client_name  -compatibility_version  -current_version @gol
504 -dead_strip @gol
505 -dependency-file  -dylib_file  -dylinker_install_name @gol
506 -dynamic  -dynamiclib  -exported_symbols_list @gol
507 -filelist  -flat_namespace  -force_cpusubtype_ALL @gol
508 -force_flat_namespace  -headerpad_max_install_names @gol
509 -iframework @gol
510 -image_base  -init  -install_name  -keep_private_externs @gol
511 -multi_module  -multiply_defined  -multiply_defined_unused @gol
512 -noall_load   -no_dead_strip_inits_and_terms @gol
513 -nofixprebinding -nomultidefs  -noprebind  -noseglinkedit @gol
514 -pagezero_size  -prebind  -prebind_all_twolevel_modules @gol
515 -private_bundle  -read_only_relocs  -sectalign @gol
516 -sectobjectsymbols  -whyload  -seg1addr @gol
517 -sectcreate  -sectobjectsymbols  -sectorder @gol
518 -segaddr -segs_read_only_addr -segs_read_write_addr @gol
519 -seg_addr_table  -seg_addr_table_filename  -seglinkedit @gol
520 -segprot  -segs_read_only_addr  -segs_read_write_addr @gol
521 -single_module  -static  -sub_library  -sub_umbrella @gol
522 -twolevel_namespace  -umbrella  -undefined @gol
523 -unexported_symbols_list  -weak_reference_mismatches @gol
524 -whatsloaded -F -gused -gfull -mmacosx-version-min=@var{version} @gol
525 -mkernel -mone-byte-bool}
526
527 @emph{DEC Alpha Options}
528 @gccoptlist{-mno-fp-regs  -msoft-float  -malpha-as  -mgas @gol
529 -mieee  -mieee-with-inexact  -mieee-conformant @gol
530 -mfp-trap-mode=@var{mode}  -mfp-rounding-mode=@var{mode} @gol
531 -mtrap-precision=@var{mode}  -mbuild-constants @gol
532 -mcpu=@var{cpu-type}  -mtune=@var{cpu-type} @gol
533 -mbwx  -mmax  -mfix  -mcix @gol
534 -mfloat-vax  -mfloat-ieee @gol
535 -mexplicit-relocs  -msmall-data  -mlarge-data @gol
536 -msmall-text  -mlarge-text @gol
537 -mmemory-latency=@var{time}}
538
539 @emph{DEC Alpha/VMS Options}
540 @gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64}
541
542 @emph{FR30 Options}
543 @gccoptlist{-msmall-model -mno-lsim}
544
545 @emph{FRV Options}
546 @gccoptlist{-mgpr-32  -mgpr-64  -mfpr-32  -mfpr-64 @gol
547 -mhard-float  -msoft-float @gol
548 -malloc-cc  -mfixed-cc  -mdword  -mno-dword @gol
549 -mdouble  -mno-double @gol
550 -mmedia  -mno-media  -mmuladd  -mno-muladd @gol
551 -mfdpic  -minline-plt -mgprel-ro  -multilib-library-pic @gol
552 -mlinked-fp  -mlong-calls  -malign-labels @gol
553 -mlibrary-pic  -macc-4  -macc-8 @gol
554 -mpack  -mno-pack  -mno-eflags  -mcond-move  -mno-cond-move @gol
555 -moptimize-membar -mno-optimize-membar @gol
556 -mscc  -mno-scc  -mcond-exec  -mno-cond-exec @gol
557 -mvliw-branch  -mno-vliw-branch @gol
558 -mmulti-cond-exec  -mno-multi-cond-exec  -mnested-cond-exec @gol
559 -mno-nested-cond-exec  -mtomcat-stats @gol
560 -mTLS -mtls @gol
561 -mcpu=@var{cpu}}
562
563 @emph{GNU/Linux Options}
564 @gccoptlist{-mglibc -muclibc -mbionic -mandroid @gol
565 -tno-android-cc -tno-android-ld}
566
567 @emph{H8/300 Options}
568 @gccoptlist{-mrelax  -mh  -ms  -mn  -mint32  -malign-300}
569
570 @emph{HPPA Options}
571 @gccoptlist{-march=@var{architecture-type} @gol
572 -mbig-switch  -mdisable-fpregs  -mdisable-indexing @gol
573 -mfast-indirect-calls  -mgas  -mgnu-ld   -mhp-ld @gol
574 -mfixed-range=@var{register-range} @gol
575 -mjump-in-delay -mlinker-opt -mlong-calls @gol
576 -mlong-load-store  -mno-big-switch  -mno-disable-fpregs @gol
577 -mno-disable-indexing  -mno-fast-indirect-calls  -mno-gas @gol
578 -mno-jump-in-delay  -mno-long-load-store @gol
579 -mno-portable-runtime  -mno-soft-float @gol
580 -mno-space-regs  -msoft-float  -mpa-risc-1-0 @gol
581 -mpa-risc-1-1  -mpa-risc-2-0  -mportable-runtime @gol
582 -mschedule=@var{cpu-type}  -mspace-regs  -msio  -mwsio @gol
583 -munix=@var{unix-std}  -nolibdld  -static  -threads}
584
585 @emph{i386 and x86-64 Options}
586 @gccoptlist{-mtune=@var{cpu-type}  -march=@var{cpu-type} @gol
587 -mfpmath=@var{unit} @gol
588 -masm=@var{dialect}  -mno-fancy-math-387 @gol
589 -mno-fp-ret-in-387  -msoft-float @gol
590 -mno-wide-multiply  -mrtd  -malign-double @gol
591 -mpreferred-stack-boundary=@var{num} @gol
592 -mincoming-stack-boundary=@var{num} @gol
593 -mcld -mcx16 -msahf -mmovbe -mcrc32 -mrecip -mvzeroupper @gol
594 -mmmx  -msse  -msse2 -msse3 -mssse3 -msse4.1 -msse4.2 -msse4 -mavx @gol
595 -maes -mpclmul -mfsgsbase -mrdrnd -mf16c -mfused-madd @gol
596 -msse4a -m3dnow -mpopcnt -mabm -mbmi -mtbm -mfma4 -mxop -mlwp @gol
597 -mthreads  -mno-align-stringops  -minline-all-stringops @gol
598 -minline-stringops-dynamically -mstringop-strategy=@var{alg} @gol
599 -mpush-args  -maccumulate-outgoing-args  -m128bit-long-double @gol
600 -m96bit-long-double  -mregparm=@var{num}  -msseregparm @gol
601 -mveclibabi=@var{type} -mvect8-ret-in-mem @gol
602 -mpc32 -mpc64 -mpc80 -mstackrealign @gol
603 -momit-leaf-frame-pointer  -mno-red-zone -mno-tls-direct-seg-refs @gol
604 -mcmodel=@var{code-model} -mabi=@var{name} @gol
605 -m32  -m64 -mlarge-data-threshold=@var{num} @gol
606 -msse2avx -mfentry -m8bit-idiv @gol
607 -mavx256-split-unaligned-load -mavx256-split-unaligned-store}
608
609 @emph{i386 and x86-64 Windows Options}
610 @gccoptlist{-mconsole -mcygwin -mno-cygwin -mdll @gol
611 -mnop-fun-dllimport -mthread @gol
612 -municode -mwin32 -mwindows -fno-set-stack-executable}
613
614 @emph{IA-64 Options}
615 @gccoptlist{-mbig-endian  -mlittle-endian  -mgnu-as  -mgnu-ld  -mno-pic @gol
616 -mvolatile-asm-stop  -mregister-names  -msdata -mno-sdata @gol
617 -mconstant-gp  -mauto-pic  -mfused-madd @gol
618 -minline-float-divide-min-latency @gol
619 -minline-float-divide-max-throughput @gol
620 -mno-inline-float-divide @gol
621 -minline-int-divide-min-latency @gol
622 -minline-int-divide-max-throughput  @gol
623 -mno-inline-int-divide @gol
624 -minline-sqrt-min-latency -minline-sqrt-max-throughput @gol
625 -mno-inline-sqrt @gol
626 -mdwarf2-asm -mearly-stop-bits @gol
627 -mfixed-range=@var{register-range} -mtls-size=@var{tls-size} @gol
628 -mtune=@var{cpu-type} -milp32 -mlp64 @gol
629 -msched-br-data-spec -msched-ar-data-spec -msched-control-spec @gol
630 -msched-br-in-data-spec -msched-ar-in-data-spec -msched-in-control-spec @gol
631 -msched-spec-ldc -msched-spec-control-ldc @gol
632 -msched-prefer-non-data-spec-insns -msched-prefer-non-control-spec-insns @gol
633 -msched-stop-bits-after-every-cycle -msched-count-spec-in-critical-path @gol
634 -msel-sched-dont-check-control-spec -msched-fp-mem-deps-zero-cost @gol
635 -msched-max-memory-insns-hard-limit -msched-max-memory-insns=@var{max-insns}}
636
637 @emph{IA-64/VMS Options}
638 @gccoptlist{-mvms-return-codes -mdebug-main=@var{prefix} -mmalloc64}
639
640 @emph{LM32 Options}
641 @gccoptlist{-mbarrel-shift-enabled -mdivide-enabled -mmultiply-enabled @gol
642 -msign-extend-enabled -muser-enabled}
643
644 @emph{M32R/D Options}
645 @gccoptlist{-m32r2 -m32rx -m32r @gol
646 -mdebug @gol
647 -malign-loops -mno-align-loops @gol
648 -missue-rate=@var{number} @gol
649 -mbranch-cost=@var{number} @gol
650 -mmodel=@var{code-size-model-type} @gol
651 -msdata=@var{sdata-type} @gol
652 -mno-flush-func -mflush-func=@var{name} @gol
653 -mno-flush-trap -mflush-trap=@var{number} @gol
654 -G @var{num}}
655
656 @emph{M32C Options}
657 @gccoptlist{-mcpu=@var{cpu} -msim -memregs=@var{number}}
658
659 @emph{M680x0 Options}
660 @gccoptlist{-march=@var{arch}  -mcpu=@var{cpu}  -mtune=@var{tune}
661 -m68000  -m68020  -m68020-40  -m68020-60  -m68030  -m68040 @gol
662 -m68060  -mcpu32  -m5200  -m5206e  -m528x  -m5307  -m5407 @gol
663 -mcfv4e  -mbitfield  -mno-bitfield  -mc68000  -mc68020 @gol
664 -mnobitfield  -mrtd  -mno-rtd  -mdiv  -mno-div  -mshort @gol
665 -mno-short  -mhard-float  -m68881  -msoft-float  -mpcrel @gol
666 -malign-int  -mstrict-align  -msep-data  -mno-sep-data @gol
667 -mshared-library-id=n  -mid-shared-library  -mno-id-shared-library @gol
668 -mxgot -mno-xgot}
669
670 @emph{MCore Options}
671 @gccoptlist{-mhardlit  -mno-hardlit  -mdiv  -mno-div  -mrelax-immediates @gol
672 -mno-relax-immediates  -mwide-bitfields  -mno-wide-bitfields @gol
673 -m4byte-functions  -mno-4byte-functions  -mcallgraph-data @gol
674 -mno-callgraph-data  -mslow-bytes  -mno-slow-bytes  -mno-lsim @gol
675 -mlittle-endian  -mbig-endian  -m210  -m340  -mstack-increment}
676
677 @emph{MeP Options}
678 @gccoptlist{-mabsdiff -mall-opts -maverage -mbased=@var{n} -mbitops @gol
679 -mc=@var{n} -mclip -mconfig=@var{name} -mcop -mcop32 -mcop64 -mivc2 @gol
680 -mdc -mdiv -meb -mel -mio-volatile -ml -mleadz -mm -mminmax @gol
681 -mmult -mno-opts -mrepeat -ms -msatur -msdram -msim -msimnovec -mtf @gol
682 -mtiny=@var{n}}
683
684 @emph{MicroBlaze Options}
685 @gccoptlist{-msoft-float -mhard-float -msmall-divides -mcpu=@var{cpu} @gol
686 -mmemcpy -mxl-soft-mul -mxl-soft-div -mxl-barrel-shift @gol
687 -mxl-pattern-compare -mxl-stack-check -mxl-gp-opt -mno-clearbss @gol
688 -mxl-multiply-high -mxl-float-convert -mxl-float-sqrt @gol
689 -mxl-mode-@var{app-model}}
690
691 @emph{MIPS Options}
692 @gccoptlist{-EL  -EB  -march=@var{arch}  -mtune=@var{arch} @gol
693 -mips1  -mips2  -mips3  -mips4  -mips32  -mips32r2 @gol
694 -mips64  -mips64r2 @gol
695 -mips16  -mno-mips16  -mflip-mips16 @gol
696 -minterlink-mips16  -mno-interlink-mips16 @gol
697 -mabi=@var{abi}  -mabicalls  -mno-abicalls @gol
698 -mshared  -mno-shared  -mplt  -mno-plt  -mxgot  -mno-xgot @gol
699 -mgp32  -mgp64  -mfp32  -mfp64  -mhard-float  -msoft-float @gol
700 -msingle-float  -mdouble-float  -mdsp  -mno-dsp  -mdspr2  -mno-dspr2 @gol
701 -mfpu=@var{fpu-type} @gol
702 -msmartmips  -mno-smartmips @gol
703 -mpaired-single  -mno-paired-single  -mdmx  -mno-mdmx @gol
704 -mips3d  -mno-mips3d  -mmt  -mno-mt  -mllsc  -mno-llsc @gol
705 -mlong64  -mlong32  -msym32  -mno-sym32 @gol
706 -G@var{num}  -mlocal-sdata  -mno-local-sdata @gol
707 -mextern-sdata  -mno-extern-sdata  -mgpopt  -mno-gopt @gol
708 -membedded-data  -mno-embedded-data @gol
709 -muninit-const-in-rodata  -mno-uninit-const-in-rodata @gol
710 -mcode-readable=@var{setting} @gol
711 -msplit-addresses  -mno-split-addresses @gol
712 -mexplicit-relocs  -mno-explicit-relocs @gol
713 -mcheck-zero-division  -mno-check-zero-division @gol
714 -mdivide-traps  -mdivide-breaks @gol
715 -mmemcpy  -mno-memcpy  -mlong-calls  -mno-long-calls @gol
716 -mmad  -mno-mad  -mfused-madd  -mno-fused-madd  -nocpp @gol
717 -mfix-24k -mno-fix-24k @gol
718 -mfix-r4000  -mno-fix-r4000  -mfix-r4400  -mno-fix-r4400 @gol
719 -mfix-r10000 -mno-fix-r10000  -mfix-vr4120  -mno-fix-vr4120 @gol
720 -mfix-vr4130  -mno-fix-vr4130  -mfix-sb1  -mno-fix-sb1 @gol
721 -mflush-func=@var{func}  -mno-flush-func @gol
722 -mbranch-cost=@var{num}  -mbranch-likely  -mno-branch-likely @gol
723 -mfp-exceptions -mno-fp-exceptions @gol
724 -mvr4130-align -mno-vr4130-align -msynci -mno-synci @gol
725 -mrelax-pic-calls -mno-relax-pic-calls -mmcount-ra-address}
726
727 @emph{MMIX Options}
728 @gccoptlist{-mlibfuncs  -mno-libfuncs  -mepsilon  -mno-epsilon  -mabi=gnu @gol
729 -mabi=mmixware  -mzero-extend  -mknuthdiv  -mtoplevel-symbols @gol
730 -melf  -mbranch-predict  -mno-branch-predict  -mbase-addresses @gol
731 -mno-base-addresses  -msingle-exit  -mno-single-exit}
732
733 @emph{MN10300 Options}
734 @gccoptlist{-mmult-bug  -mno-mult-bug @gol
735 -mno-am33 -mam33 -mam33-2 -mam34 @gol
736 -mtune=@var{cpu-type} @gol
737 -mreturn-pointer-on-d0 @gol
738 -mno-crt0  -mrelax -mliw -msetlb}
739
740 @emph{PDP-11 Options}
741 @gccoptlist{-mfpu  -msoft-float  -mac0  -mno-ac0  -m40  -m45  -m10 @gol
742 -mbcopy  -mbcopy-builtin  -mint32  -mno-int16 @gol
743 -mint16  -mno-int32  -mfloat32  -mno-float64 @gol
744 -mfloat64  -mno-float32  -mabshi  -mno-abshi @gol
745 -mbranch-expensive  -mbranch-cheap @gol
746 -munix-asm  -mdec-asm}
747
748 @emph{picoChip Options}
749 @gccoptlist{-mae=@var{ae_type} -mvliw-lookahead=@var{N} @gol
750 -msymbol-as-address -mno-inefficient-warnings}
751
752 @emph{PowerPC Options}
753 See RS/6000 and PowerPC Options.
754
755 @emph{RS/6000 and PowerPC Options}
756 @gccoptlist{-mcpu=@var{cpu-type} @gol
757 -mtune=@var{cpu-type} @gol
758 -mcmodel=@var{code-model} @gol
759 -mpower  -mno-power  -mpower2  -mno-power2 @gol
760 -mpowerpc  -mpowerpc64  -mno-powerpc @gol
761 -maltivec  -mno-altivec @gol
762 -mpowerpc-gpopt  -mno-powerpc-gpopt @gol
763 -mpowerpc-gfxopt  -mno-powerpc-gfxopt @gol
764 -mmfcrf  -mno-mfcrf  -mpopcntb  -mno-popcntb -mpopcntd -mno-popcntd @gol
765 -mfprnd  -mno-fprnd @gol
766 -mcmpb -mno-cmpb -mmfpgpr -mno-mfpgpr -mhard-dfp -mno-hard-dfp @gol
767 -mnew-mnemonics  -mold-mnemonics @gol
768 -mfull-toc   -mminimal-toc  -mno-fp-in-toc  -mno-sum-in-toc @gol
769 -m64  -m32  -mxl-compat  -mno-xl-compat  -mpe @gol
770 -malign-power  -malign-natural @gol
771 -msoft-float  -mhard-float  -mmultiple  -mno-multiple @gol
772 -msingle-float -mdouble-float -msimple-fpu @gol
773 -mstring  -mno-string  -mupdate  -mno-update @gol
774 -mavoid-indexed-addresses  -mno-avoid-indexed-addresses @gol
775 -mfused-madd  -mno-fused-madd  -mbit-align  -mno-bit-align @gol
776 -mstrict-align  -mno-strict-align  -mrelocatable @gol
777 -mno-relocatable  -mrelocatable-lib  -mno-relocatable-lib @gol
778 -mtoc  -mno-toc  -mlittle  -mlittle-endian  -mbig  -mbig-endian @gol
779 -mdynamic-no-pic  -maltivec -mswdiv  -msingle-pic-base @gol
780 -mprioritize-restricted-insns=@var{priority} @gol
781 -msched-costly-dep=@var{dependence_type} @gol
782 -minsert-sched-nops=@var{scheme} @gol
783 -mcall-sysv  -mcall-netbsd @gol
784 -maix-struct-return  -msvr4-struct-return @gol
785 -mabi=@var{abi-type} -msecure-plt -mbss-plt @gol
786 -mblock-move-inline-limit=@var{num} @gol
787 -misel -mno-isel @gol
788 -misel=yes  -misel=no @gol
789 -mspe -mno-spe @gol
790 -mspe=yes  -mspe=no @gol
791 -mpaired @gol
792 -mgen-cell-microcode -mwarn-cell-microcode @gol
793 -mvrsave -mno-vrsave @gol
794 -mmulhw -mno-mulhw @gol
795 -mdlmzb -mno-dlmzb @gol
796 -mfloat-gprs=yes  -mfloat-gprs=no -mfloat-gprs=single -mfloat-gprs=double @gol
797 -mprototype  -mno-prototype @gol
798 -msim  -mmvme  -mads  -myellowknife  -memb  -msdata @gol
799 -msdata=@var{opt}  -mvxworks  -G @var{num}  -pthread @gol
800 -mrecip -mrecip=@var{opt} -mno-recip -mrecip-precision @gol
801 -mno-recip-precision @gol
802 -mveclibabi=@var{type} -mfriz -mno-friz}
803
804 @emph{RX Options}
805 @gccoptlist{-m64bit-doubles  -m32bit-doubles  -fpu  -nofpu@gol
806 -mcpu=@gol
807 -mbig-endian-data -mlittle-endian-data @gol
808 -msmall-data @gol
809 -msim  -mno-sim@gol
810 -mas100-syntax -mno-as100-syntax@gol
811 -mrelax@gol
812 -mmax-constant-size=@gol
813 -mint-register=@gol
814 -msave-acc-in-interrupts}
815
816 @emph{S/390 and zSeries Options}
817 @gccoptlist{-mtune=@var{cpu-type}  -march=@var{cpu-type} @gol
818 -mhard-float  -msoft-float  -mhard-dfp -mno-hard-dfp @gol
819 -mlong-double-64 -mlong-double-128 @gol
820 -mbackchain  -mno-backchain -mpacked-stack  -mno-packed-stack @gol
821 -msmall-exec  -mno-small-exec  -mmvcle -mno-mvcle @gol
822 -m64  -m31  -mdebug  -mno-debug  -mesa  -mzarch @gol
823 -mtpf-trace -mno-tpf-trace  -mfused-madd  -mno-fused-madd @gol
824 -mwarn-framesize  -mwarn-dynamicstack  -mstack-size -mstack-guard}
825
826 @emph{Score Options}
827 @gccoptlist{-meb -mel @gol
828 -mnhwloop @gol
829 -muls @gol
830 -mmac @gol
831 -mscore5 -mscore5u -mscore7 -mscore7d}
832
833 @emph{SH Options}
834 @gccoptlist{-m1  -m2  -m2e @gol
835 -m2a-nofpu -m2a-single-only -m2a-single -m2a @gol
836 -m3  -m3e @gol
837 -m4-nofpu  -m4-single-only  -m4-single  -m4 @gol
838 -m4a-nofpu -m4a-single-only -m4a-single -m4a -m4al @gol
839 -m5-64media  -m5-64media-nofpu @gol
840 -m5-32media  -m5-32media-nofpu @gol
841 -m5-compact  -m5-compact-nofpu @gol
842 -mb  -ml  -mdalign  -mrelax @gol
843 -mbigtable -mfmovd -mhitachi -mrenesas -mno-renesas -mnomacsave @gol
844 -mieee  -mbitops  -misize  -minline-ic_invalidate -mpadstruct  -mspace @gol
845 -mprefergot  -musermode -multcost=@var{number} -mdiv=@var{strategy} @gol
846 -mdivsi3_libfunc=@var{name} -mfixed-range=@var{register-range} @gol
847 -madjust-unroll -mindexed-addressing -mgettrcost=@var{number} -mpt-fixed @gol
848 -maccumulate-outgoing-args -minvalid-symbols}
849
850 @emph{Solaris 2 Options}
851 @gccoptlist{-mimpure-text  -mno-impure-text @gol
852 -pthreads -pthread}
853
854 @emph{SPARC Options}
855 @gccoptlist{-mcpu=@var{cpu-type} @gol
856 -mtune=@var{cpu-type} @gol
857 -mcmodel=@var{code-model} @gol
858 -m32  -m64  -mapp-regs  -mno-app-regs @gol
859 -mfaster-structs  -mno-faster-structs @gol
860 -mfpu  -mno-fpu  -mhard-float  -msoft-float @gol
861 -mhard-quad-float  -msoft-quad-float @gol
862 -mlittle-endian @gol
863 -mstack-bias  -mno-stack-bias @gol
864 -munaligned-doubles  -mno-unaligned-doubles @gol
865 -mv8plus  -mno-v8plus  -mvis  -mno-vis}
866
867 @emph{SPU Options}
868 @gccoptlist{-mwarn-reloc -merror-reloc @gol
869 -msafe-dma -munsafe-dma @gol
870 -mbranch-hints @gol
871 -msmall-mem -mlarge-mem -mstdmain @gol
872 -mfixed-range=@var{register-range} @gol
873 -mea32 -mea64 @gol
874 -maddress-space-conversion -mno-address-space-conversion @gol
875 -mcache-size=@var{cache-size} @gol
876 -matomic-updates -mno-atomic-updates}
877
878 @emph{System V Options}
879 @gccoptlist{-Qy  -Qn  -YP,@var{paths}  -Ym,@var{dir}}
880
881 @emph{V850 Options}
882 @gccoptlist{-mlong-calls  -mno-long-calls  -mep  -mno-ep @gol
883 -mprolog-function  -mno-prolog-function  -mspace @gol
884 -mtda=@var{n}  -msda=@var{n}  -mzda=@var{n} @gol
885 -mapp-regs  -mno-app-regs @gol
886 -mdisable-callt  -mno-disable-callt @gol
887 -mv850e2v3 @gol
888 -mv850e2 @gol
889 -mv850e1 -mv850es @gol
890 -mv850e @gol
891 -mv850  -mbig-switch}
892
893 @emph{VAX Options}
894 @gccoptlist{-mg  -mgnu  -munix}
895
896 @emph{VxWorks Options}
897 @gccoptlist{-mrtp  -non-static  -Bstatic  -Bdynamic @gol
898 -Xbind-lazy  -Xbind-now}
899
900 @emph{x86-64 Options}
901 See i386 and x86-64 Options.
902
903 @emph{Xstormy16 Options}
904 @gccoptlist{-msim}
905
906 @emph{Xtensa Options}
907 @gccoptlist{-mconst16 -mno-const16 @gol
908 -mfused-madd  -mno-fused-madd @gol
909 -mforce-no-pic @gol
910 -mserialize-volatile  -mno-serialize-volatile @gol
911 -mtext-section-literals  -mno-text-section-literals @gol
912 -mtarget-align  -mno-target-align @gol
913 -mlongcalls  -mno-longcalls}
914
915 @emph{zSeries Options}
916 See S/390 and zSeries Options.
917
918 @item Code Generation Options
919 @xref{Code Gen Options,,Options for Code Generation Conventions}.
920 @gccoptlist{-fcall-saved-@var{reg}  -fcall-used-@var{reg} @gol
921 -ffixed-@var{reg}  -fexceptions @gol
922 -fnon-call-exceptions  -funwind-tables @gol
923 -fasynchronous-unwind-tables @gol
924 -finhibit-size-directive  -finstrument-functions @gol
925 -finstrument-functions-exclude-function-list=@var{sym},@var{sym},@dots{} @gol
926 -finstrument-functions-exclude-file-list=@var{file},@var{file},@dots{} @gol
927 -fno-common  -fno-ident @gol
928 -fpcc-struct-return  -fpic  -fPIC -fpie -fPIE @gol
929 -fno-jump-tables @gol
930 -frecord-gcc-switches @gol
931 -freg-struct-return  -fshort-enums @gol
932 -fshort-double  -fshort-wchar @gol
933 -fverbose-asm  -fpack-struct[=@var{n}]  -fstack-check @gol
934 -fstack-limit-register=@var{reg}  -fstack-limit-symbol=@var{sym} @gol
935 -fno-stack-limit -fsplit-stack @gol
936 -fleading-underscore  -ftls-model=@var{model} @gol
937 -ftrapv  -fwrapv  -fbounds-check @gol
938 -fvisibility -fstrict-volatile-bitfields}
939 @end table
940
941 @menu
942 * Overall Options::     Controlling the kind of output:
943                         an executable, object files, assembler files,
944                         or preprocessed source.
945 * C Dialect Options::   Controlling the variant of C language compiled.
946 * C++ Dialect Options:: Variations on C++.
947 * Objective-C and Objective-C++ Dialect Options:: Variations on Objective-C
948                         and Objective-C++.
949 * Language Independent Options:: Controlling how diagnostics should be
950                         formatted.
951 * Warning Options::     How picky should the compiler be?
952 * Debugging Options::   Symbol tables, measurements, and debugging dumps.
953 * Optimize Options::    How much optimization?
954 * Preprocessor Options:: Controlling header files and macro definitions.
955                          Also, getting dependency information for Make.
956 * Assembler Options::   Passing options to the assembler.
957 * Link Options::        Specifying libraries and so on.
958 * Directory Options::   Where to find header files and libraries.
959                         Where to find the compiler executable files.
960 * Spec Files::          How to pass switches to sub-processes.
961 * Target Options::      Running a cross-compiler, or an old version of GCC.
962 @end menu
963
964 @node Overall Options
965 @section Options Controlling the Kind of Output
966
967 Compilation can involve up to four stages: preprocessing, compilation
968 proper, assembly and linking, always in that order.  GCC is capable of
969 preprocessing and compiling several files either into several
970 assembler input files, or into one assembler input file; then each
971 assembler input file produces an object file, and linking combines all
972 the object files (those newly compiled, and those specified as input)
973 into an executable file.
974
975 @cindex file name suffix
976 For any given input file, the file name suffix determines what kind of
977 compilation is done:
978
979 @table @gcctabopt
980 @item @var{file}.c
981 C source code which must be preprocessed.
982
983 @item @var{file}.i
984 C source code which should not be preprocessed.
985
986 @item @var{file}.ii
987 C++ source code which should not be preprocessed.
988
989 @item @var{file}.m
990 Objective-C source code.  Note that you must link with the @file{libobjc}
991 library to make an Objective-C program work.
992
993 @item @var{file}.mi
994 Objective-C source code which should not be preprocessed.
995
996 @item @var{file}.mm
997 @itemx @var{file}.M
998 Objective-C++ source code.  Note that you must link with the @file{libobjc}
999 library to make an Objective-C++ program work.  Note that @samp{.M} refers
1000 to a literal capital M@.
1001
1002 @item @var{file}.mii
1003 Objective-C++ source code which should not be preprocessed.
1004
1005 @item @var{file}.h
1006 C, C++, Objective-C or Objective-C++ header file to be turned into a
1007 precompiled header (default), or C, C++ header file to be turned into an
1008 Ada spec (via the @option{-fdump-ada-spec} switch).
1009
1010 @item @var{file}.cc
1011 @itemx @var{file}.cp
1012 @itemx @var{file}.cxx
1013 @itemx @var{file}.cpp
1014 @itemx @var{file}.CPP
1015 @itemx @var{file}.c++
1016 @itemx @var{file}.C
1017 C++ source code which must be preprocessed.  Note that in @samp{.cxx},
1018 the last two letters must both be literally @samp{x}.  Likewise,
1019 @samp{.C} refers to a literal capital C@.
1020
1021 @item @var{file}.mm
1022 @itemx @var{file}.M
1023 Objective-C++ source code which must be preprocessed.
1024
1025 @item @var{file}.mii
1026 Objective-C++ source code which should not be preprocessed.
1027
1028 @item @var{file}.hh
1029 @itemx @var{file}.H
1030 @itemx @var{file}.hp
1031 @itemx @var{file}.hxx
1032 @itemx @var{file}.hpp
1033 @itemx @var{file}.HPP
1034 @itemx @var{file}.h++
1035 @itemx @var{file}.tcc
1036 C++ header file to be turned into a precompiled header or Ada spec.
1037
1038 @item @var{file}.f
1039 @itemx @var{file}.for
1040 @itemx @var{file}.ftn
1041 Fixed form Fortran source code which should not be preprocessed.
1042
1043 @item @var{file}.F
1044 @itemx @var{file}.FOR
1045 @itemx @var{file}.fpp
1046 @itemx @var{file}.FPP
1047 @itemx @var{file}.FTN
1048 Fixed form Fortran source code which must be preprocessed (with the traditional
1049 preprocessor).
1050
1051 @item @var{file}.f90
1052 @itemx @var{file}.f95
1053 @itemx @var{file}.f03
1054 @itemx @var{file}.f08
1055 Free form Fortran source code which should not be preprocessed.
1056
1057 @item @var{file}.F90
1058 @itemx @var{file}.F95
1059 @itemx @var{file}.F03
1060 @itemx @var{file}.F08
1061 Free form Fortran source code which must be preprocessed (with the
1062 traditional preprocessor).
1063
1064 @item @var{file}.go
1065 Go source code.
1066
1067 @c FIXME: Descriptions of Java file types.
1068 @c @var{file}.java
1069 @c @var{file}.class
1070 @c @var{file}.zip
1071 @c @var{file}.jar
1072
1073 @item @var{file}.ads
1074 Ada source code file which contains a library unit declaration (a
1075 declaration of a package, subprogram, or generic, or a generic
1076 instantiation), or a library unit renaming declaration (a package,
1077 generic, or subprogram renaming declaration).  Such files are also
1078 called @dfn{specs}.
1079
1080 @item @var{file}.adb
1081 Ada source code file containing a library unit body (a subprogram or
1082 package body).  Such files are also called @dfn{bodies}.
1083
1084 @c GCC also knows about some suffixes for languages not yet included:
1085 @c Pascal:
1086 @c @var{file}.p
1087 @c @var{file}.pas
1088 @c Ratfor:
1089 @c @var{file}.r
1090
1091 @item @var{file}.s
1092 Assembler code.
1093
1094 @item @var{file}.S
1095 @itemx @var{file}.sx
1096 Assembler code which must be preprocessed.
1097
1098 @item @var{other}
1099 An object file to be fed straight into linking.
1100 Any file name with no recognized suffix is treated this way.
1101 @end table
1102
1103 @opindex x
1104 You can specify the input language explicitly with the @option{-x} option:
1105
1106 @table @gcctabopt
1107 @item -x @var{language}
1108 Specify explicitly the @var{language} for the following input files
1109 (rather than letting the compiler choose a default based on the file
1110 name suffix).  This option applies to all following input files until
1111 the next @option{-x} option.  Possible values for @var{language} are:
1112 @smallexample
1113 c  c-header  cpp-output
1114 c++  c++-header  c++-cpp-output
1115 objective-c  objective-c-header  objective-c-cpp-output
1116 objective-c++ objective-c++-header objective-c++-cpp-output
1117 assembler  assembler-with-cpp
1118 ada
1119 f77  f77-cpp-input f95  f95-cpp-input
1120 go
1121 java
1122 @end smallexample
1123
1124 @item -x none
1125 Turn off any specification of a language, so that subsequent files are
1126 handled according to their file name suffixes (as they are if @option{-x}
1127 has not been used at all).
1128
1129 @item -pass-exit-codes
1130 @opindex pass-exit-codes
1131 Normally the @command{gcc} program will exit with the code of 1 if any
1132 phase of the compiler returns a non-success return code.  If you specify
1133 @option{-pass-exit-codes}, the @command{gcc} program will instead return with
1134 numerically highest error produced by any phase that returned an error
1135 indication.  The C, C++, and Fortran frontends return 4, if an internal
1136 compiler error is encountered.
1137 @end table
1138
1139 If you only want some of the stages of compilation, you can use
1140 @option{-x} (or filename suffixes) to tell @command{gcc} where to start, and
1141 one of the options @option{-c}, @option{-S}, or @option{-E} to say where
1142 @command{gcc} is to stop.  Note that some combinations (for example,
1143 @samp{-x cpp-output -E}) instruct @command{gcc} to do nothing at all.
1144
1145 @table @gcctabopt
1146 @item -c
1147 @opindex c
1148 Compile or assemble the source files, but do not link.  The linking
1149 stage simply is not done.  The ultimate output is in the form of an
1150 object file for each source file.
1151
1152 By default, the object file name for a source file is made by replacing
1153 the suffix @samp{.c}, @samp{.i}, @samp{.s}, etc., with @samp{.o}.
1154
1155 Unrecognized input files, not requiring compilation or assembly, are
1156 ignored.
1157
1158 @item -S
1159 @opindex S
1160 Stop after the stage of compilation proper; do not assemble.  The output
1161 is in the form of an assembler code file for each non-assembler input
1162 file specified.
1163
1164 By default, the assembler file name for a source file is made by
1165 replacing the suffix @samp{.c}, @samp{.i}, etc., with @samp{.s}.
1166
1167 Input files that don't require compilation are ignored.
1168
1169 @item -E
1170 @opindex E
1171 Stop after the preprocessing stage; do not run the compiler proper.  The
1172 output is in the form of preprocessed source code, which is sent to the
1173 standard output.
1174
1175 Input files which don't require preprocessing are ignored.
1176
1177 @cindex output file option
1178 @item -o @var{file}
1179 @opindex o
1180 Place output in file @var{file}.  This applies regardless to whatever
1181 sort of output is being produced, whether it be an executable file,
1182 an object file, an assembler file or preprocessed C code.
1183
1184 If @option{-o} is not specified, the default is to put an executable
1185 file in @file{a.out}, the object file for
1186 @file{@var{source}.@var{suffix}} in @file{@var{source}.o}, its
1187 assembler file in @file{@var{source}.s}, a precompiled header file in
1188 @file{@var{source}.@var{suffix}.gch}, and all preprocessed C source on
1189 standard output.
1190
1191 @item -v
1192 @opindex v
1193 Print (on standard error output) the commands executed to run the stages
1194 of compilation.  Also print the version number of the compiler driver
1195 program and of the preprocessor and the compiler proper.
1196
1197 @item -###
1198 @opindex ###
1199 Like @option{-v} except the commands are not executed and arguments
1200 are quoted unless they contain only alphanumeric characters or @code{./-_}.
1201 This is useful for shell scripts to capture the driver-generated command lines.
1202
1203 @item -pipe
1204 @opindex pipe
1205 Use pipes rather than temporary files for communication between the
1206 various stages of compilation.  This fails to work on some systems where
1207 the assembler is unable to read from a pipe; but the GNU assembler has
1208 no trouble.
1209
1210 @item --help
1211 @opindex help
1212 Print (on the standard output) a description of the command line options
1213 understood by @command{gcc}.  If the @option{-v} option is also specified
1214 then @option{--help} will also be passed on to the various processes
1215 invoked by @command{gcc}, so that they can display the command line options
1216 they accept.  If the @option{-Wextra} option has also been specified
1217 (prior to the @option{--help} option), then command line options which
1218 have no documentation associated with them will also be displayed.
1219
1220 @item --target-help
1221 @opindex target-help
1222 Print (on the standard output) a description of target-specific command
1223 line options for each tool.  For some targets extra target-specific
1224 information may also be printed.
1225
1226 @item --help=@{@var{class}@r{|[}^@r{]}@var{qualifier}@}@r{[},@dots{}@r{]}
1227 Print (on the standard output) a description of the command line
1228 options understood by the compiler that fit into all specified classes
1229 and qualifiers.  These are the supported classes:
1230
1231 @table @asis
1232 @item @samp{optimizers}
1233 This will display all of the optimization options supported by the
1234 compiler.
1235
1236 @item @samp{warnings}
1237 This will display all of the options controlling warning messages
1238 produced by the compiler.
1239
1240 @item @samp{target}
1241 This will display target-specific options.  Unlike the
1242 @option{--target-help} option however, target-specific options of the
1243 linker and assembler will not be displayed.  This is because those
1244 tools do not currently support the extended @option{--help=} syntax.
1245
1246 @item @samp{params}
1247 This will display the values recognized by the @option{--param}
1248 option.
1249
1250 @item @var{language}
1251 This will display the options supported for @var{language}, where
1252 @var{language} is the name of one of the languages supported in this
1253 version of GCC.
1254
1255 @item @samp{common}
1256 This will display the options that are common to all languages.
1257 @end table
1258
1259 These are the supported qualifiers:
1260
1261 @table @asis
1262 @item @samp{undocumented}
1263 Display only those options which are undocumented.
1264
1265 @item @samp{joined}
1266 Display options which take an argument that appears after an equal
1267 sign in the same continuous piece of text, such as:
1268 @samp{--help=target}.
1269
1270 @item @samp{separate}
1271 Display options which take an argument that appears as a separate word
1272 following the original option, such as: @samp{-o output-file}.
1273 @end table
1274
1275 Thus for example to display all the undocumented target-specific
1276 switches supported by the compiler the following can be used:
1277
1278 @smallexample
1279 --help=target,undocumented
1280 @end smallexample
1281
1282 The sense of a qualifier can be inverted by prefixing it with the
1283 @samp{^} character, so for example to display all binary warning
1284 options (i.e., ones that are either on or off and that do not take an
1285 argument), which have a description the following can be used:
1286
1287 @smallexample
1288 --help=warnings,^joined,^undocumented
1289 @end smallexample
1290
1291 The argument to @option{--help=} should not consist solely of inverted
1292 qualifiers.
1293
1294 Combining several classes is possible, although this usually
1295 restricts the output by so much that there is nothing to display.  One
1296 case where it does work however is when one of the classes is
1297 @var{target}.  So for example to display all the target-specific
1298 optimization options the following can be used:
1299
1300 @smallexample
1301 --help=target,optimizers
1302 @end smallexample
1303
1304 The @option{--help=} option can be repeated on the command line.  Each
1305 successive use will display its requested class of options, skipping
1306 those that have already been displayed.
1307
1308 If the @option{-Q} option appears on the command line before the
1309 @option{--help=} option, then the descriptive text displayed by
1310 @option{--help=} is changed.  Instead of describing the displayed
1311 options, an indication is given as to whether the option is enabled,
1312 disabled or set to a specific value (assuming that the compiler
1313 knows this at the point where the @option{--help=} option is used).
1314
1315 Here is a truncated example from the ARM port of @command{gcc}:
1316
1317 @smallexample
1318   % gcc -Q -mabi=2 --help=target -c
1319   The following options are target specific:
1320   -mabi=                                2
1321   -mabort-on-noreturn                   [disabled]
1322   -mapcs                                [disabled]
1323 @end smallexample
1324
1325 The output is sensitive to the effects of previous command line
1326 options, so for example it is possible to find out which optimizations
1327 are enabled at @option{-O2} by using:
1328
1329 @smallexample
1330 -Q -O2 --help=optimizers
1331 @end smallexample
1332
1333 Alternatively you can discover which binary optimizations are enabled
1334 by @option{-O3} by using:
1335
1336 @smallexample
1337 gcc -c -Q -O3 --help=optimizers > /tmp/O3-opts
1338 gcc -c -Q -O2 --help=optimizers > /tmp/O2-opts
1339 diff /tmp/O2-opts /tmp/O3-opts | grep enabled
1340 @end smallexample
1341
1342 @item -no-canonical-prefixes
1343 @opindex no-canonical-prefixes
1344 Do not expand any symbolic links, resolve references to @samp{/../}
1345 or @samp{/./}, or make the path absolute when generating a relative
1346 prefix.
1347
1348 @item --version
1349 @opindex version
1350 Display the version number and copyrights of the invoked GCC@.
1351
1352 @item -wrapper
1353 @opindex wrapper
1354 Invoke all subcommands under a wrapper program.  The name of the
1355 wrapper program and its parameters are passed as a comma separated
1356 list.
1357
1358 @smallexample
1359 gcc -c t.c -wrapper gdb,--args
1360 @end smallexample
1361
1362 This will invoke all subprograms of @command{gcc} under
1363 @samp{gdb --args}, thus the invocation of @command{cc1} will be
1364 @samp{gdb --args cc1 @dots{}}.
1365
1366 @item -fplugin=@var{name}.so
1367 Load the plugin code in file @var{name}.so, assumed to be a
1368 shared object to be dlopen'd by the compiler.  The base name of
1369 the shared object file is used to identify the plugin for the
1370 purposes of argument parsing (See
1371 @option{-fplugin-arg-@var{name}-@var{key}=@var{value}} below).
1372 Each plugin should define the callback functions specified in the
1373 Plugins API.
1374
1375 @item -fplugin-arg-@var{name}-@var{key}=@var{value}
1376 Define an argument called @var{key} with a value of @var{value}
1377 for the plugin called @var{name}.
1378
1379 @item -fdump-ada-spec@r{[}-slim@r{]}
1380 For C and C++ source and include files, generate corresponding Ada
1381 specs. @xref{Generating Ada Bindings for C and C++ headers,,, gnat_ugn,
1382 GNAT User's Guide}, which provides detailed documentation on this feature.
1383
1384 @item -fdump-go-spec=@var{file}
1385 For input files in any language, generate corresponding Go
1386 declarations in @var{file}.  This generates Go @code{const},
1387 @code{type}, @code{var}, and @code{func} declarations which may be a
1388 useful way to start writing a Go interface to code written in some
1389 other language.
1390
1391 @include @value{srcdir}/../libiberty/at-file.texi
1392 @end table
1393
1394 @node Invoking G++
1395 @section Compiling C++ Programs
1396
1397 @cindex suffixes for C++ source
1398 @cindex C++ source file suffixes
1399 C++ source files conventionally use one of the suffixes @samp{.C},
1400 @samp{.cc}, @samp{.cpp}, @samp{.CPP}, @samp{.c++}, @samp{.cp}, or
1401 @samp{.cxx}; C++ header files often use @samp{.hh}, @samp{.hpp},
1402 @samp{.H}, or (for shared template code) @samp{.tcc}; and
1403 preprocessed C++ files use the suffix @samp{.ii}.  GCC recognizes
1404 files with these names and compiles them as C++ programs even if you
1405 call the compiler the same way as for compiling C programs (usually
1406 with the name @command{gcc}).
1407
1408 @findex g++
1409 @findex c++
1410 However, the use of @command{gcc} does not add the C++ library.
1411 @command{g++} is a program that calls GCC and treats @samp{.c},
1412 @samp{.h} and @samp{.i} files as C++ source files instead of C source
1413 files unless @option{-x} is used, and automatically specifies linking
1414 against the C++ library.  This program is also useful when
1415 precompiling a C header file with a @samp{.h} extension for use in C++
1416 compilations.  On many systems, @command{g++} is also installed with
1417 the name @command{c++}.
1418
1419 @cindex invoking @command{g++}
1420 When you compile C++ programs, you may specify many of the same
1421 command-line options that you use for compiling programs in any
1422 language; or command-line options meaningful for C and related
1423 languages; or options that are meaningful only for C++ programs.
1424 @xref{C Dialect Options,,Options Controlling C Dialect}, for
1425 explanations of options for languages related to C@.
1426 @xref{C++ Dialect Options,,Options Controlling C++ Dialect}, for
1427 explanations of options that are meaningful only for C++ programs.
1428
1429 @node C Dialect Options
1430 @section Options Controlling C Dialect
1431 @cindex dialect options
1432 @cindex language dialect options
1433 @cindex options, dialect
1434
1435 The following options control the dialect of C (or languages derived
1436 from C, such as C++, Objective-C and Objective-C++) that the compiler
1437 accepts:
1438
1439 @table @gcctabopt
1440 @cindex ANSI support
1441 @cindex ISO support
1442 @item -ansi
1443 @opindex ansi
1444 In C mode, this is equivalent to @samp{-std=c90}. In C++ mode, it is
1445 equivalent to @samp{-std=c++98}.
1446
1447 This turns off certain features of GCC that are incompatible with ISO
1448 C90 (when compiling C code), or of standard C++ (when compiling C++ code),
1449 such as the @code{asm} and @code{typeof} keywords, and
1450 predefined macros such as @code{unix} and @code{vax} that identify the
1451 type of system you are using.  It also enables the undesirable and
1452 rarely used ISO trigraph feature.  For the C compiler,
1453 it disables recognition of C++ style @samp{//} comments as well as
1454 the @code{inline} keyword.
1455
1456 The alternate keywords @code{__asm__}, @code{__extension__},
1457 @code{__inline__} and @code{__typeof__} continue to work despite
1458 @option{-ansi}.  You would not want to use them in an ISO C program, of
1459 course, but it is useful to put them in header files that might be included
1460 in compilations done with @option{-ansi}.  Alternate predefined macros
1461 such as @code{__unix__} and @code{__vax__} are also available, with or
1462 without @option{-ansi}.
1463
1464 The @option{-ansi} option does not cause non-ISO programs to be
1465 rejected gratuitously.  For that, @option{-pedantic} is required in
1466 addition to @option{-ansi}.  @xref{Warning Options}.
1467
1468 The macro @code{__STRICT_ANSI__} is predefined when the @option{-ansi}
1469 option is used.  Some header files may notice this macro and refrain
1470 from declaring certain functions or defining certain macros that the
1471 ISO standard doesn't call for; this is to avoid interfering with any
1472 programs that might use these names for other things.
1473
1474 Functions that would normally be built in but do not have semantics
1475 defined by ISO C (such as @code{alloca} and @code{ffs}) are not built-in
1476 functions when @option{-ansi} is used.  @xref{Other Builtins,,Other
1477 built-in functions provided by GCC}, for details of the functions
1478 affected.
1479
1480 @item -std=
1481 @opindex std
1482 Determine the language standard. @xref{Standards,,Language Standards
1483 Supported by GCC}, for details of these standard versions.  This option
1484 is currently only supported when compiling C or C++.
1485
1486 The compiler can accept several base standards, such as @samp{c90} or
1487 @samp{c++98}, and GNU dialects of those standards, such as
1488 @samp{gnu90} or @samp{gnu++98}.  By specifying a base standard, the
1489 compiler will accept all programs following that standard and those
1490 using GNU extensions that do not contradict it.  For example,
1491 @samp{-std=c90} turns off certain features of GCC that are
1492 incompatible with ISO C90, such as the @code{asm} and @code{typeof}
1493 keywords, but not other GNU extensions that do not have a meaning in
1494 ISO C90, such as omitting the middle term of a @code{?:}
1495 expression. On the other hand, by specifying a GNU dialect of a
1496 standard, all features the compiler support are enabled, even when
1497 those features change the meaning of the base standard and some
1498 strict-conforming programs may be rejected.  The particular standard
1499 is used by @option{-pedantic} to identify which features are GNU
1500 extensions given that version of the standard. For example
1501 @samp{-std=gnu90 -pedantic} would warn about C++ style @samp{//}
1502 comments, while @samp{-std=gnu99 -pedantic} would not.
1503
1504 A value for this option must be provided; possible values are
1505
1506 @table @samp
1507 @item c90
1508 @itemx c89
1509 @itemx iso9899:1990
1510 Support all ISO C90 programs (certain GNU extensions that conflict
1511 with ISO C90 are disabled). Same as @option{-ansi} for C code.
1512
1513 @item iso9899:199409
1514 ISO C90 as modified in amendment 1.
1515
1516 @item c99
1517 @itemx c9x
1518 @itemx iso9899:1999
1519 @itemx iso9899:199x
1520 ISO C99.  Note that this standard is not yet fully supported; see
1521 @w{@uref{http://gcc.gnu.org/c99status.html}} for more information.  The
1522 names @samp{c9x} and @samp{iso9899:199x} are deprecated.
1523
1524 @item c1x
1525 ISO C1X, the draft of the next revision of the ISO C standard.
1526 Support is limited and experimental and features enabled by this
1527 option may be changed or removed if changed in or removed from the
1528 standard draft.
1529
1530 @item gnu90
1531 @itemx gnu89
1532 GNU dialect of ISO C90 (including some C99 features). This
1533 is the default for C code.
1534
1535 @item gnu99
1536 @itemx gnu9x
1537 GNU dialect of ISO C99.  When ISO C99 is fully implemented in GCC,
1538 this will become the default.  The name @samp{gnu9x} is deprecated.
1539
1540 @item gnu1x
1541 GNU dialect of ISO C1X.  Support is limited and experimental and
1542 features enabled by this option may be changed or removed if changed
1543 in or removed from the standard draft.
1544
1545 @item c++98
1546 The 1998 ISO C++ standard plus amendments. Same as @option{-ansi} for
1547 C++ code.
1548
1549 @item gnu++98
1550 GNU dialect of @option{-std=c++98}.  This is the default for
1551 C++ code.
1552
1553 @item c++0x
1554 The working draft of the upcoming ISO C++0x standard. This option
1555 enables experimental features that are likely to be included in
1556 C++0x. The working draft is constantly changing, and any feature that is
1557 enabled by this flag may be removed from future versions of GCC if it is
1558 not part of the C++0x standard.
1559
1560 @item gnu++0x
1561 GNU dialect of @option{-std=c++0x}. This option enables
1562 experimental features that may be removed in future versions of GCC.
1563 @end table
1564
1565 @item -fgnu89-inline
1566 @opindex fgnu89-inline
1567 The option @option{-fgnu89-inline} tells GCC to use the traditional
1568 GNU semantics for @code{inline} functions when in C99 mode.
1569 @xref{Inline,,An Inline Function is As Fast As a Macro}.  This option
1570 is accepted and ignored by GCC versions 4.1.3 up to but not including
1571 4.3.  In GCC versions 4.3 and later it changes the behavior of GCC in
1572 C99 mode.  Using this option is roughly equivalent to adding the
1573 @code{gnu_inline} function attribute to all inline functions
1574 (@pxref{Function Attributes}).
1575
1576 The option @option{-fno-gnu89-inline} explicitly tells GCC to use the
1577 C99 semantics for @code{inline} when in C99 or gnu99 mode (i.e., it
1578 specifies the default behavior).  This option was first supported in
1579 GCC 4.3.  This option is not supported in @option{-std=c90} or
1580 @option{-std=gnu90} mode.
1581
1582 The preprocessor macros @code{__GNUC_GNU_INLINE__} and
1583 @code{__GNUC_STDC_INLINE__} may be used to check which semantics are
1584 in effect for @code{inline} functions.  @xref{Common Predefined
1585 Macros,,,cpp,The C Preprocessor}.
1586
1587 @item -aux-info @var{filename}
1588 @opindex aux-info
1589 Output to the given filename prototyped declarations for all functions
1590 declared and/or defined in a translation unit, including those in header
1591 files.  This option is silently ignored in any language other than C@.
1592
1593 Besides declarations, the file indicates, in comments, the origin of
1594 each declaration (source file and line), whether the declaration was
1595 implicit, prototyped or unprototyped (@samp{I}, @samp{N} for new or
1596 @samp{O} for old, respectively, in the first character after the line
1597 number and the colon), and whether it came from a declaration or a
1598 definition (@samp{C} or @samp{F}, respectively, in the following
1599 character).  In the case of function definitions, a K&R-style list of
1600 arguments followed by their declarations is also provided, inside
1601 comments, after the declaration.
1602
1603 @item -fno-asm
1604 @opindex fno-asm
1605 Do not recognize @code{asm}, @code{inline} or @code{typeof} as a
1606 keyword, so that code can use these words as identifiers.  You can use
1607 the keywords @code{__asm__}, @code{__inline__} and @code{__typeof__}
1608 instead.  @option{-ansi} implies @option{-fno-asm}.
1609
1610 In C++, this switch only affects the @code{typeof} keyword, since
1611 @code{asm} and @code{inline} are standard keywords.  You may want to
1612 use the @option{-fno-gnu-keywords} flag instead, which has the same
1613 effect.  In C99 mode (@option{-std=c99} or @option{-std=gnu99}), this
1614 switch only affects the @code{asm} and @code{typeof} keywords, since
1615 @code{inline} is a standard keyword in ISO C99.
1616
1617 @item -fno-builtin
1618 @itemx -fno-builtin-@var{function}
1619 @opindex fno-builtin
1620 @cindex built-in functions
1621 Don't recognize built-in functions that do not begin with
1622 @samp{__builtin_} as prefix.  @xref{Other Builtins,,Other built-in
1623 functions provided by GCC}, for details of the functions affected,
1624 including those which are not built-in functions when @option{-ansi} or
1625 @option{-std} options for strict ISO C conformance are used because they
1626 do not have an ISO standard meaning.
1627
1628 GCC normally generates special code to handle certain built-in functions
1629 more efficiently; for instance, calls to @code{alloca} may become single
1630 instructions that adjust the stack directly, and calls to @code{memcpy}
1631 may become inline copy loops.  The resulting code is often both smaller
1632 and faster, but since the function calls no longer appear as such, you
1633 cannot set a breakpoint on those calls, nor can you change the behavior
1634 of the functions by linking with a different library.  In addition,
1635 when a function is recognized as a built-in function, GCC may use
1636 information about that function to warn about problems with calls to
1637 that function, or to generate more efficient code, even if the
1638 resulting code still contains calls to that function.  For example,
1639 warnings are given with @option{-Wformat} for bad calls to
1640 @code{printf}, when @code{printf} is built in, and @code{strlen} is
1641 known not to modify global memory.
1642
1643 With the @option{-fno-builtin-@var{function}} option
1644 only the built-in function @var{function} is
1645 disabled.  @var{function} must not begin with @samp{__builtin_}.  If a
1646 function is named that is not built-in in this version of GCC, this
1647 option is ignored.  There is no corresponding
1648 @option{-fbuiltin-@var{function}} option; if you wish to enable
1649 built-in functions selectively when using @option{-fno-builtin} or
1650 @option{-ffreestanding}, you may define macros such as:
1651
1652 @smallexample
1653 #define abs(n)          __builtin_abs ((n))
1654 #define strcpy(d, s)    __builtin_strcpy ((d), (s))
1655 @end smallexample
1656
1657 @item -fhosted
1658 @opindex fhosted
1659 @cindex hosted environment
1660
1661 Assert that compilation takes place in a hosted environment.  This implies
1662 @option{-fbuiltin}.  A hosted environment is one in which the
1663 entire standard library is available, and in which @code{main} has a return
1664 type of @code{int}.  Examples are nearly everything except a kernel.
1665 This is equivalent to @option{-fno-freestanding}.
1666
1667 @item -ffreestanding
1668 @opindex ffreestanding
1669 @cindex hosted environment
1670
1671 Assert that compilation takes place in a freestanding environment.  This
1672 implies @option{-fno-builtin}.  A freestanding environment
1673 is one in which the standard library may not exist, and program startup may
1674 not necessarily be at @code{main}.  The most obvious example is an OS kernel.
1675 This is equivalent to @option{-fno-hosted}.
1676
1677 @xref{Standards,,Language Standards Supported by GCC}, for details of
1678 freestanding and hosted environments.
1679
1680 @item -fopenmp
1681 @opindex fopenmp
1682 @cindex OpenMP parallel
1683 Enable handling of OpenMP directives @code{#pragma omp} in C/C++ and
1684 @code{!$omp} in Fortran.  When @option{-fopenmp} is specified, the
1685 compiler generates parallel code according to the OpenMP Application
1686 Program Interface v3.0 @w{@uref{http://www.openmp.org/}}.  This option
1687 implies @option{-pthread}, and thus is only supported on targets that
1688 have support for @option{-pthread}.
1689
1690 @item -fms-extensions
1691 @opindex fms-extensions
1692 Accept some non-standard constructs used in Microsoft header files.
1693
1694 In C++ code, this allows member names in structures to be similar
1695 to previous types declarations.
1696
1697 @smallexample
1698 typedef int UOW;
1699 struct ABC @{
1700   UOW UOW;
1701 @};
1702 @end smallexample
1703
1704 Some cases of unnamed fields in structures and unions are only
1705 accepted with this option.  @xref{Unnamed Fields,,Unnamed struct/union
1706 fields within structs/unions}, for details.
1707
1708 @item -fplan9-extensions
1709 Accept some non-standard constructs used in Plan 9 code.
1710
1711 This enables @option{-fms-extensions}, permits passing pointers to
1712 structures with anonymous fields to functions which expect pointers to
1713 elements of the type of the field, and permits referring to anonymous
1714 fields declared using a typedef.  @xref{Unnamed Fields,,Unnamed
1715 struct/union fields within structs/unions}, for details.  This is only
1716 supported for C, not C++.
1717
1718 @item -trigraphs
1719 @opindex trigraphs
1720 Support ISO C trigraphs.  The @option{-ansi} option (and @option{-std}
1721 options for strict ISO C conformance) implies @option{-trigraphs}.
1722
1723 @item -no-integrated-cpp
1724 @opindex no-integrated-cpp
1725 Performs a compilation in two passes: preprocessing and compiling.  This
1726 option allows a user supplied "cc1", "cc1plus", or "cc1obj" via the
1727 @option{-B} option.  The user supplied compilation step can then add in
1728 an additional preprocessing step after normal preprocessing but before
1729 compiling.  The default is to use the integrated cpp (internal cpp)
1730
1731 The semantics of this option will change if "cc1", "cc1plus", and
1732 "cc1obj" are merged.
1733
1734 @cindex traditional C language
1735 @cindex C language, traditional
1736 @item -traditional
1737 @itemx -traditional-cpp
1738 @opindex traditional-cpp
1739 @opindex traditional
1740 Formerly, these options caused GCC to attempt to emulate a pre-standard
1741 C compiler.  They are now only supported with the @option{-E} switch.
1742 The preprocessor continues to support a pre-standard mode.  See the GNU
1743 CPP manual for details.
1744
1745 @item -fcond-mismatch
1746 @opindex fcond-mismatch
1747 Allow conditional expressions with mismatched types in the second and
1748 third arguments.  The value of such an expression is void.  This option
1749 is not supported for C++.
1750
1751 @item -flax-vector-conversions
1752 @opindex flax-vector-conversions
1753 Allow implicit conversions between vectors with differing numbers of
1754 elements and/or incompatible element types.  This option should not be
1755 used for new code.
1756
1757 @item -funsigned-char
1758 @opindex funsigned-char
1759 Let the type @code{char} be unsigned, like @code{unsigned char}.
1760
1761 Each kind of machine has a default for what @code{char} should
1762 be.  It is either like @code{unsigned char} by default or like
1763 @code{signed char} by default.
1764
1765 Ideally, a portable program should always use @code{signed char} or
1766 @code{unsigned char} when it depends on the signedness of an object.
1767 But many programs have been written to use plain @code{char} and
1768 expect it to be signed, or expect it to be unsigned, depending on the
1769 machines they were written for.  This option, and its inverse, let you
1770 make such a program work with the opposite default.
1771
1772 The type @code{char} is always a distinct type from each of
1773 @code{signed char} or @code{unsigned char}, even though its behavior
1774 is always just like one of those two.
1775
1776 @item -fsigned-char
1777 @opindex fsigned-char
1778 Let the type @code{char} be signed, like @code{signed char}.
1779
1780 Note that this is equivalent to @option{-fno-unsigned-char}, which is
1781 the negative form of @option{-funsigned-char}.  Likewise, the option
1782 @option{-fno-signed-char} is equivalent to @option{-funsigned-char}.
1783
1784 @item -fsigned-bitfields
1785 @itemx -funsigned-bitfields
1786 @itemx -fno-signed-bitfields
1787 @itemx -fno-unsigned-bitfields
1788 @opindex fsigned-bitfields
1789 @opindex funsigned-bitfields
1790 @opindex fno-signed-bitfields
1791 @opindex fno-unsigned-bitfields
1792 These options control whether a bit-field is signed or unsigned, when the
1793 declaration does not use either @code{signed} or @code{unsigned}.  By
1794 default, such a bit-field is signed, because this is consistent: the
1795 basic integer types such as @code{int} are signed types.
1796 @end table
1797
1798 @node C++ Dialect Options
1799 @section Options Controlling C++ Dialect
1800
1801 @cindex compiler options, C++
1802 @cindex C++ options, command line
1803 @cindex options, C++
1804 This section describes the command-line options that are only meaningful
1805 for C++ programs; but you can also use most of the GNU compiler options
1806 regardless of what language your program is in.  For example, you
1807 might compile a file @code{firstClass.C} like this:
1808
1809 @smallexample
1810 g++ -g -frepo -O -c firstClass.C
1811 @end smallexample
1812
1813 @noindent
1814 In this example, only @option{-frepo} is an option meant
1815 only for C++ programs; you can use the other options with any
1816 language supported by GCC@.
1817
1818 Here is a list of options that are @emph{only} for compiling C++ programs:
1819
1820 @table @gcctabopt
1821
1822 @item -fabi-version=@var{n}
1823 @opindex fabi-version
1824 Use version @var{n} of the C++ ABI@.  Version 2 is the version of the
1825 C++ ABI that first appeared in G++ 3.4.  Version 1 is the version of
1826 the C++ ABI that first appeared in G++ 3.2.  Version 0 will always be
1827 the version that conforms most closely to the C++ ABI specification.
1828 Therefore, the ABI obtained using version 0 will change as ABI bugs
1829 are fixed.
1830
1831 The default is version 2.
1832
1833 Version 3 corrects an error in mangling a constant address as a
1834 template argument.
1835
1836 Version 4 implements a standard mangling for vector types.
1837
1838 Version 5 corrects the mangling of attribute const/volatile on
1839 function pointer types, decltype of a plain decl, and use of a
1840 function parameter in the declaration of another parameter.
1841
1842 See also @option{-Wabi}.
1843
1844 @item -fno-access-control
1845 @opindex fno-access-control
1846 Turn off all access checking.  This switch is mainly useful for working
1847 around bugs in the access control code.
1848
1849 @item -fcheck-new
1850 @opindex fcheck-new
1851 Check that the pointer returned by @code{operator new} is non-null
1852 before attempting to modify the storage allocated.  This check is
1853 normally unnecessary because the C++ standard specifies that
1854 @code{operator new} will only return @code{0} if it is declared
1855 @samp{throw()}, in which case the compiler will always check the
1856 return value even without this option.  In all other cases, when
1857 @code{operator new} has a non-empty exception specification, memory
1858 exhaustion is signalled by throwing @code{std::bad_alloc}.  See also
1859 @samp{new (nothrow)}.
1860
1861 @item -fconserve-space
1862 @opindex fconserve-space
1863 Put uninitialized or runtime-initialized global variables into the
1864 common segment, as C does.  This saves space in the executable at the
1865 cost of not diagnosing duplicate definitions.  If you compile with this
1866 flag and your program mysteriously crashes after @code{main()} has
1867 completed, you may have an object that is being destroyed twice because
1868 two definitions were merged.
1869
1870 This option is no longer useful on most targets, now that support has
1871 been added for putting variables into BSS without making them common.
1872
1873 @item -fconstexpr-depth=@var{n}
1874 @opindex fconstexpr-depth
1875 Set the maximum nested evaluation depth for C++0x constexpr functions
1876 to @var{n}.  A limit is needed to detect endless recursion during
1877 constant expression evaluation.  The minimum specified by the standard
1878 is 512.
1879
1880 @item -fno-deduce-init-list
1881 @opindex fno-deduce-init-list
1882 Disable deduction of a template type parameter as
1883 std::initializer_list from a brace-enclosed initializer list, i.e.
1884
1885 @smallexample
1886 template <class T> auto forward(T t) -> decltype (realfn (t))
1887 @{
1888   return realfn (t);
1889 @}
1890
1891 void f()
1892 @{
1893   forward(@{1,2@}); // call forward<std::initializer_list<int>>
1894 @}
1895 @end smallexample
1896
1897 This option is present because this deduction is an extension to the
1898 current specification in the C++0x working draft, and there was
1899 some concern about potential overload resolution problems.
1900
1901 @item -ffriend-injection
1902 @opindex ffriend-injection
1903 Inject friend functions into the enclosing namespace, so that they are
1904 visible outside the scope of the class in which they are declared.
1905 Friend functions were documented to work this way in the old Annotated
1906 C++ Reference Manual, and versions of G++ before 4.1 always worked
1907 that way.  However, in ISO C++ a friend function which is not declared
1908 in an enclosing scope can only be found using argument dependent
1909 lookup.  This option causes friends to be injected as they were in
1910 earlier releases.
1911
1912 This option is for compatibility, and may be removed in a future
1913 release of G++.
1914
1915 @item -fno-elide-constructors
1916 @opindex fno-elide-constructors
1917 The C++ standard allows an implementation to omit creating a temporary
1918 which is only used to initialize another object of the same type.
1919 Specifying this option disables that optimization, and forces G++ to
1920 call the copy constructor in all cases.
1921
1922 @item -fno-enforce-eh-specs
1923 @opindex fno-enforce-eh-specs
1924 Don't generate code to check for violation of exception specifications
1925 at runtime.  This option violates the C++ standard, but may be useful
1926 for reducing code size in production builds, much like defining
1927 @samp{NDEBUG}.  This does not give user code permission to throw
1928 exceptions in violation of the exception specifications; the compiler
1929 will still optimize based on the specifications, so throwing an
1930 unexpected exception will result in undefined behavior.
1931
1932 @item -ffor-scope
1933 @itemx -fno-for-scope
1934 @opindex ffor-scope
1935 @opindex fno-for-scope
1936 If @option{-ffor-scope} is specified, the scope of variables declared in
1937 a @i{for-init-statement} is limited to the @samp{for} loop itself,
1938 as specified by the C++ standard.
1939 If @option{-fno-for-scope} is specified, the scope of variables declared in
1940 a @i{for-init-statement} extends to the end of the enclosing scope,
1941 as was the case in old versions of G++, and other (traditional)
1942 implementations of C++.
1943
1944 The default if neither flag is given to follow the standard,
1945 but to allow and give a warning for old-style code that would
1946 otherwise be invalid, or have different behavior.
1947
1948 @item -fno-gnu-keywords
1949 @opindex fno-gnu-keywords
1950 Do not recognize @code{typeof} as a keyword, so that code can use this
1951 word as an identifier.  You can use the keyword @code{__typeof__} instead.
1952 @option{-ansi} implies @option{-fno-gnu-keywords}.
1953
1954 @item -fno-implicit-templates
1955 @opindex fno-implicit-templates
1956 Never emit code for non-inline templates which are instantiated
1957 implicitly (i.e.@: by use); only emit code for explicit instantiations.
1958 @xref{Template Instantiation}, for more information.
1959
1960 @item -fno-implicit-inline-templates
1961 @opindex fno-implicit-inline-templates
1962 Don't emit code for implicit instantiations of inline templates, either.
1963 The default is to handle inlines differently so that compiles with and
1964 without optimization will need the same set of explicit instantiations.
1965
1966 @item -fno-implement-inlines
1967 @opindex fno-implement-inlines
1968 To save space, do not emit out-of-line copies of inline functions
1969 controlled by @samp{#pragma implementation}.  This will cause linker
1970 errors if these functions are not inlined everywhere they are called.
1971
1972 @item -fms-extensions
1973 @opindex fms-extensions
1974 Disable pedantic warnings about constructs used in MFC, such as implicit
1975 int and getting a pointer to member function via non-standard syntax.
1976
1977 @item -fno-nonansi-builtins
1978 @opindex fno-nonansi-builtins
1979 Disable built-in declarations of functions that are not mandated by
1980 ANSI/ISO C@.  These include @code{ffs}, @code{alloca}, @code{_exit},
1981 @code{index}, @code{bzero}, @code{conjf}, and other related functions.
1982
1983 @item -fnothrow-opt
1984 @opindex fnothrow-opt
1985 Treat a @code{throw()} exception specification as though it were a
1986 @code{noexcept} specification to reduce or eliminate the text size
1987 overhead relative to a function with no exception specification.  If
1988 the function has local variables of types with non-trivial
1989 destructors, the exception specification will actually make the
1990 function smaller because the EH cleanups for those variables can be
1991 optimized away.  The semantic effect is that an exception thrown out of
1992 a function with such an exception specification will result in a call
1993 to @code{terminate} rather than @code{unexpected}.
1994
1995 @item -fno-operator-names
1996 @opindex fno-operator-names
1997 Do not treat the operator name keywords @code{and}, @code{bitand},
1998 @code{bitor}, @code{compl}, @code{not}, @code{or} and @code{xor} as
1999 synonyms as keywords.
2000
2001 @item -fno-optional-diags
2002 @opindex fno-optional-diags
2003 Disable diagnostics that the standard says a compiler does not need to
2004 issue.  Currently, the only such diagnostic issued by G++ is the one for
2005 a name having multiple meanings within a class.
2006
2007 @item -fpermissive
2008 @opindex fpermissive
2009 Downgrade some diagnostics about nonconformant code from errors to
2010 warnings.  Thus, using @option{-fpermissive} will allow some
2011 nonconforming code to compile.
2012
2013 @item -fno-pretty-templates
2014 @opindex fno-pretty-templates
2015 When an error message refers to a specialization of a function
2016 template, the compiler will normally print the signature of the
2017 template followed by the template arguments and any typedefs or
2018 typenames in the signature (e.g. @code{void f(T) [with T = int]}
2019 rather than @code{void f(int)}) so that it's clear which template is
2020 involved.  When an error message refers to a specialization of a class
2021 template, the compiler will omit any template arguments which match
2022 the default template arguments for that template.  If either of these
2023 behaviors make it harder to understand the error message rather than
2024 easier, using @option{-fno-pretty-templates} will disable them.
2025
2026 @item -frepo
2027 @opindex frepo
2028 Enable automatic template instantiation at link time.  This option also
2029 implies @option{-fno-implicit-templates}.  @xref{Template
2030 Instantiation}, for more information.
2031
2032 @item -fno-rtti
2033 @opindex fno-rtti
2034 Disable generation of information about every class with virtual
2035 functions for use by the C++ runtime type identification features
2036 (@samp{dynamic_cast} and @samp{typeid}).  If you don't use those parts
2037 of the language, you can save some space by using this flag.  Note that
2038 exception handling uses the same information, but it will generate it as
2039 needed. The @samp{dynamic_cast} operator can still be used for casts that
2040 do not require runtime type information, i.e.@: casts to @code{void *} or to
2041 unambiguous base classes.
2042
2043 @item -fstats
2044 @opindex fstats
2045 Emit statistics about front-end processing at the end of the compilation.
2046 This information is generally only useful to the G++ development team.
2047
2048 @item -fstrict-enums
2049 @opindex fstrict-enums
2050 Allow the compiler to optimize using the assumption that a value of
2051 enumeration type can only be one of the values of the enumeration (as
2052 defined in the C++ standard; basically, a value which can be
2053 represented in the minimum number of bits needed to represent all the
2054 enumerators).  This assumption may not be valid if the program uses a
2055 cast to convert an arbitrary integer value to the enumeration type.
2056
2057 @item -ftemplate-depth=@var{n}
2058 @opindex ftemplate-depth
2059 Set the maximum instantiation depth for template classes to @var{n}.
2060 A limit on the template instantiation depth is needed to detect
2061 endless recursions during template class instantiation.  ANSI/ISO C++
2062 conforming programs must not rely on a maximum depth greater than 17
2063 (changed to 1024 in C++0x).
2064
2065 @item -fno-threadsafe-statics
2066 @opindex fno-threadsafe-statics
2067 Do not emit the extra code to use the routines specified in the C++
2068 ABI for thread-safe initialization of local statics.  You can use this
2069 option to reduce code size slightly in code that doesn't need to be
2070 thread-safe.
2071
2072 @item -fuse-cxa-atexit
2073 @opindex fuse-cxa-atexit
2074 Register destructors for objects with static storage duration with the
2075 @code{__cxa_atexit} function rather than the @code{atexit} function.
2076 This option is required for fully standards-compliant handling of static
2077 destructors, but will only work if your C library supports
2078 @code{__cxa_atexit}.
2079
2080 @item -fno-use-cxa-get-exception-ptr
2081 @opindex fno-use-cxa-get-exception-ptr
2082 Don't use the @code{__cxa_get_exception_ptr} runtime routine.  This
2083 will cause @code{std::uncaught_exception} to be incorrect, but is necessary
2084 if the runtime routine is not available.
2085
2086 @item -fvisibility-inlines-hidden
2087 @opindex fvisibility-inlines-hidden
2088 This switch declares that the user does not attempt to compare
2089 pointers to inline methods where the addresses of the two functions
2090 were taken in different shared objects.
2091
2092 The effect of this is that GCC may, effectively, mark inline methods with
2093 @code{__attribute__ ((visibility ("hidden")))} so that they do not
2094 appear in the export table of a DSO and do not require a PLT indirection
2095 when used within the DSO@.  Enabling this option can have a dramatic effect
2096 on load and link times of a DSO as it massively reduces the size of the
2097 dynamic export table when the library makes heavy use of templates.
2098
2099 The behavior of this switch is not quite the same as marking the
2100 methods as hidden directly, because it does not affect static variables
2101 local to the function or cause the compiler to deduce that
2102 the function is defined in only one shared object.
2103
2104 You may mark a method as having a visibility explicitly to negate the
2105 effect of the switch for that method.  For example, if you do want to
2106 compare pointers to a particular inline method, you might mark it as
2107 having default visibility.  Marking the enclosing class with explicit
2108 visibility will have no effect.
2109
2110 Explicitly instantiated inline methods are unaffected by this option
2111 as their linkage might otherwise cross a shared library boundary.
2112 @xref{Template Instantiation}.
2113
2114 @item -fvisibility-ms-compat
2115 @opindex fvisibility-ms-compat
2116 This flag attempts to use visibility settings to make GCC's C++
2117 linkage model compatible with that of Microsoft Visual Studio.
2118
2119 The flag makes these changes to GCC's linkage model:
2120
2121 @enumerate
2122 @item
2123 It sets the default visibility to @code{hidden}, like
2124 @option{-fvisibility=hidden}.
2125
2126 @item
2127 Types, but not their members, are not hidden by default.
2128
2129 @item
2130 The One Definition Rule is relaxed for types without explicit
2131 visibility specifications which are defined in more than one different
2132 shared object: those declarations are permitted if they would have
2133 been permitted when this option was not used.
2134 @end enumerate
2135
2136 In new code it is better to use @option{-fvisibility=hidden} and
2137 export those classes which are intended to be externally visible.
2138 Unfortunately it is possible for code to rely, perhaps accidentally,
2139 on the Visual Studio behavior.
2140
2141 Among the consequences of these changes are that static data members
2142 of the same type with the same name but defined in different shared
2143 objects will be different, so changing one will not change the other;
2144 and that pointers to function members defined in different shared
2145 objects may not compare equal.  When this flag is given, it is a
2146 violation of the ODR to define types with the same name differently.
2147
2148 @item -fno-weak
2149 @opindex fno-weak
2150 Do not use weak symbol support, even if it is provided by the linker.
2151 By default, G++ will use weak symbols if they are available.  This
2152 option exists only for testing, and should not be used by end-users;
2153 it will result in inferior code and has no benefits.  This option may
2154 be removed in a future release of G++.
2155
2156 @item -nostdinc++
2157 @opindex nostdinc++
2158 Do not search for header files in the standard directories specific to
2159 C++, but do still search the other standard directories.  (This option
2160 is used when building the C++ library.)
2161 @end table
2162
2163 In addition, these optimization, warning, and code generation options
2164 have meanings only for C++ programs:
2165
2166 @table @gcctabopt
2167 @item -fno-default-inline
2168 @opindex fno-default-inline
2169 Do not assume @samp{inline} for functions defined inside a class scope.
2170 @xref{Optimize Options,,Options That Control Optimization}.  Note that these
2171 functions will have linkage like inline functions; they just won't be
2172 inlined by default.
2173
2174 @item -Wabi @r{(C, Objective-C, C++ and Objective-C++ only)}
2175 @opindex Wabi
2176 @opindex Wno-abi
2177 Warn when G++ generates code that is probably not compatible with the
2178 vendor-neutral C++ ABI@.  Although an effort has been made to warn about
2179 all such cases, there are probably some cases that are not warned about,
2180 even though G++ is generating incompatible code.  There may also be
2181 cases where warnings are emitted even though the code that is generated
2182 will be compatible.
2183
2184 You should rewrite your code to avoid these warnings if you are
2185 concerned about the fact that code generated by G++ may not be binary
2186 compatible with code generated by other compilers.
2187
2188 The known incompatibilities in @option{-fabi-version=2} (the default) include:
2189
2190 @itemize @bullet
2191
2192 @item
2193 A template with a non-type template parameter of reference type is
2194 mangled incorrectly:
2195 @smallexample
2196 extern int N;
2197 template <int &> struct S @{@};
2198 void n (S<N>) @{2@}
2199 @end smallexample
2200
2201 This is fixed in @option{-fabi-version=3}.
2202
2203 @item
2204 SIMD vector types declared using @code{__attribute ((vector_size))} are
2205 mangled in a non-standard way that does not allow for overloading of
2206 functions taking vectors of different sizes.
2207
2208 The mangling is changed in @option{-fabi-version=4}.
2209 @end itemize
2210
2211 The known incompatibilities in @option{-fabi-version=1} include:
2212
2213 @itemize @bullet
2214
2215 @item
2216 Incorrect handling of tail-padding for bit-fields.  G++ may attempt to
2217 pack data into the same byte as a base class.  For example:
2218
2219 @smallexample
2220 struct A @{ virtual void f(); int f1 : 1; @};
2221 struct B : public A @{ int f2 : 1; @};
2222 @end smallexample
2223
2224 @noindent
2225 In this case, G++ will place @code{B::f2} into the same byte
2226 as@code{A::f1}; other compilers will not.  You can avoid this problem
2227 by explicitly padding @code{A} so that its size is a multiple of the
2228 byte size on your platform; that will cause G++ and other compilers to
2229 layout @code{B} identically.
2230
2231 @item
2232 Incorrect handling of tail-padding for virtual bases.  G++ does not use
2233 tail padding when laying out virtual bases.  For example:
2234
2235 @smallexample
2236 struct A @{ virtual void f(); char c1; @};
2237 struct B @{ B(); char c2; @};
2238 struct C : public A, public virtual B @{@};
2239 @end smallexample
2240
2241 @noindent
2242 In this case, G++ will not place @code{B} into the tail-padding for
2243 @code{A}; other compilers will.  You can avoid this problem by
2244 explicitly padding @code{A} so that its size is a multiple of its
2245 alignment (ignoring virtual base classes); that will cause G++ and other
2246 compilers to layout @code{C} identically.
2247
2248 @item
2249 Incorrect handling of bit-fields with declared widths greater than that
2250 of their underlying types, when the bit-fields appear in a union.  For
2251 example:
2252
2253 @smallexample
2254 union U @{ int i : 4096; @};
2255 @end smallexample
2256
2257 @noindent
2258 Assuming that an @code{int} does not have 4096 bits, G++ will make the
2259 union too small by the number of bits in an @code{int}.
2260
2261 @item
2262 Empty classes can be placed at incorrect offsets.  For example:
2263
2264 @smallexample
2265 struct A @{@};
2266
2267 struct B @{
2268   A a;
2269   virtual void f ();
2270 @};
2271
2272 struct C : public B, public A @{@};
2273 @end smallexample
2274
2275 @noindent
2276 G++ will place the @code{A} base class of @code{C} at a nonzero offset;
2277 it should be placed at offset zero.  G++ mistakenly believes that the
2278 @code{A} data member of @code{B} is already at offset zero.
2279
2280 @item
2281 Names of template functions whose types involve @code{typename} or
2282 template template parameters can be mangled incorrectly.
2283
2284 @smallexample
2285 template <typename Q>
2286 void f(typename Q::X) @{@}
2287
2288 template <template <typename> class Q>
2289 void f(typename Q<int>::X) @{@}
2290 @end smallexample
2291
2292 @noindent
2293 Instantiations of these templates may be mangled incorrectly.
2294
2295 @end itemize
2296
2297 It also warns psABI related changes.  The known psABI changes at this
2298 point include:
2299
2300 @itemize @bullet
2301
2302 @item
2303 For SYSV/x86-64, when passing union with long double, it is changed to
2304 pass in memory as specified in psABI.  For example:
2305
2306 @smallexample
2307 union U @{
2308   long double ld;
2309   int i;
2310 @};
2311 @end smallexample
2312
2313 @noindent
2314 @code{union U} will always be passed in memory.
2315
2316 @end itemize
2317
2318 @item -Wctor-dtor-privacy @r{(C++ and Objective-C++ only)}
2319 @opindex Wctor-dtor-privacy
2320 @opindex Wno-ctor-dtor-privacy
2321 Warn when a class seems unusable because all the constructors or
2322 destructors in that class are private, and it has neither friends nor
2323 public static member functions.
2324
2325 @item -Wnoexcept @r{(C++ and Objective-C++ only)}
2326 @opindex Wnoexcept
2327 @opindex Wno-noexcept
2328 Warn when a noexcept-expression evaluates to false because of a call
2329 to a function that does not have a non-throwing exception
2330 specification (i.e. @samp{throw()} or @samp{noexcept}) but is known by
2331 the compiler to never throw an exception.
2332
2333 @item -Wnon-virtual-dtor @r{(C++ and Objective-C++ only)}
2334 @opindex Wnon-virtual-dtor
2335 @opindex Wno-non-virtual-dtor
2336 Warn when a class has virtual functions and accessible non-virtual
2337 destructor, in which case it would be possible but unsafe to delete
2338 an instance of a derived class through a pointer to the base class.
2339 This warning is also enabled if -Weffc++ is specified.
2340
2341 @item -Wreorder @r{(C++ and Objective-C++ only)}
2342 @opindex Wreorder
2343 @opindex Wno-reorder
2344 @cindex reordering, warning
2345 @cindex warning for reordering of member initializers
2346 Warn when the order of member initializers given in the code does not
2347 match the order in which they must be executed.  For instance:
2348
2349 @smallexample
2350 struct A @{
2351   int i;
2352   int j;
2353   A(): j (0), i (1) @{ @}
2354 @};
2355 @end smallexample
2356
2357 The compiler will rearrange the member initializers for @samp{i}
2358 and @samp{j} to match the declaration order of the members, emitting
2359 a warning to that effect.  This warning is enabled by @option{-Wall}.
2360 @end table
2361
2362 The following @option{-W@dots{}} options are not affected by @option{-Wall}.
2363
2364 @table @gcctabopt
2365 @item -Weffc++ @r{(C++ and Objective-C++ only)}
2366 @opindex Weffc++
2367 @opindex Wno-effc++
2368 Warn about violations of the following style guidelines from Scott Meyers'
2369 @cite{Effective C++} book:
2370
2371 @itemize @bullet
2372 @item
2373 Item 11:  Define a copy constructor and an assignment operator for classes
2374 with dynamically allocated memory.
2375
2376 @item
2377 Item 12:  Prefer initialization to assignment in constructors.
2378
2379 @item
2380 Item 14:  Make destructors virtual in base classes.
2381
2382 @item
2383 Item 15:  Have @code{operator=} return a reference to @code{*this}.
2384
2385 @item
2386 Item 23:  Don't try to return a reference when you must return an object.
2387
2388 @end itemize
2389
2390 Also warn about violations of the following style guidelines from
2391 Scott Meyers' @cite{More Effective C++} book:
2392
2393 @itemize @bullet
2394 @item
2395 Item 6:  Distinguish between prefix and postfix forms of increment and
2396 decrement operators.
2397
2398 @item
2399 Item 7:  Never overload @code{&&}, @code{||}, or @code{,}.
2400
2401 @end itemize
2402
2403 When selecting this option, be aware that the standard library
2404 headers do not obey all of these guidelines; use @samp{grep -v}
2405 to filter out those warnings.
2406
2407 @item -Wstrict-null-sentinel @r{(C++ and Objective-C++ only)}
2408 @opindex Wstrict-null-sentinel
2409 @opindex Wno-strict-null-sentinel
2410 Warn also about the use of an uncasted @code{NULL} as sentinel.  When
2411 compiling only with GCC this is a valid sentinel, as @code{NULL} is defined
2412 to @code{__null}.  Although it is a null pointer constant not a null pointer,
2413 it is guaranteed to be of the same size as a pointer.  But this use is
2414 not portable across different compilers.
2415
2416 @item -Wno-non-template-friend @r{(C++ and Objective-C++ only)}
2417 @opindex Wno-non-template-friend
2418 @opindex Wnon-template-friend
2419 Disable warnings when non-templatized friend functions are declared
2420 within a template.  Since the advent of explicit template specification
2421 support in G++, if the name of the friend is an unqualified-id (i.e.,
2422 @samp{friend foo(int)}), the C++ language specification demands that the
2423 friend declare or define an ordinary, nontemplate function.  (Section
2424 14.5.3).  Before G++ implemented explicit specification, unqualified-ids
2425 could be interpreted as a particular specialization of a templatized
2426 function.  Because this non-conforming behavior is no longer the default
2427 behavior for G++, @option{-Wnon-template-friend} allows the compiler to
2428 check existing code for potential trouble spots and is on by default.
2429 This new compiler behavior can be turned off with
2430 @option{-Wno-non-template-friend} which keeps the conformant compiler code
2431 but disables the helpful warning.
2432
2433 @item -Wold-style-cast @r{(C++ and Objective-C++ only)}
2434 @opindex Wold-style-cast
2435 @opindex Wno-old-style-cast
2436 Warn if an old-style (C-style) cast to a non-void type is used within
2437 a C++ program.  The new-style casts (@samp{dynamic_cast},
2438 @samp{static_cast}, @samp{reinterpret_cast}, and @samp{const_cast}) are
2439 less vulnerable to unintended effects and much easier to search for.
2440
2441 @item -Woverloaded-virtual @r{(C++ and Objective-C++ only)}
2442 @opindex Woverloaded-virtual
2443 @opindex Wno-overloaded-virtual
2444 @cindex overloaded virtual function, warning
2445 @cindex warning for overloaded virtual function
2446 Warn when a function declaration hides virtual functions from a
2447 base class.  For example, in:
2448
2449 @smallexample
2450 struct A @{
2451   virtual void f();
2452 @};
2453
2454 struct B: public A @{
2455   void f(int);
2456 @};
2457 @end smallexample
2458
2459 the @code{A} class version of @code{f} is hidden in @code{B}, and code
2460 like:
2461
2462 @smallexample
2463 B* b;
2464 b->f();
2465 @end smallexample
2466
2467 will fail to compile.
2468
2469 @item -Wno-pmf-conversions @r{(C++ and Objective-C++ only)}
2470 @opindex Wno-pmf-conversions
2471 @opindex Wpmf-conversions
2472 Disable the diagnostic for converting a bound pointer to member function
2473 to a plain pointer.
2474
2475 @item -Wsign-promo @r{(C++ and Objective-C++ only)}
2476 @opindex Wsign-promo
2477 @opindex Wno-sign-promo
2478 Warn when overload resolution chooses a promotion from unsigned or
2479 enumerated type to a signed type, over a conversion to an unsigned type of
2480 the same size.  Previous versions of G++ would try to preserve
2481 unsignedness, but the standard mandates the current behavior.
2482
2483 @smallexample
2484 struct A @{
2485   operator int ();
2486   A& operator = (int);
2487 @};
2488
2489 main ()
2490 @{
2491   A a,b;
2492   a = b;
2493 @}
2494 @end smallexample
2495
2496 In this example, G++ will synthesize a default @samp{A& operator =
2497 (const A&);}, while cfront will use the user-defined @samp{operator =}.
2498 @end table
2499
2500 @node Objective-C and Objective-C++ Dialect Options
2501 @section Options Controlling Objective-C and Objective-C++ Dialects
2502
2503 @cindex compiler options, Objective-C and Objective-C++
2504 @cindex Objective-C and Objective-C++ options, command line
2505 @cindex options, Objective-C and Objective-C++
2506 (NOTE: This manual does not describe the Objective-C and Objective-C++
2507 languages themselves.  @xref{Standards,,Language Standards
2508 Supported by GCC}, for references.)
2509
2510 This section describes the command-line options that are only meaningful
2511 for Objective-C and Objective-C++ programs, but you can also use most of
2512 the language-independent GNU compiler options.
2513 For example, you might compile a file @code{some_class.m} like this:
2514
2515 @smallexample
2516 gcc -g -fgnu-runtime -O -c some_class.m
2517 @end smallexample
2518
2519 @noindent
2520 In this example, @option{-fgnu-runtime} is an option meant only for
2521 Objective-C and Objective-C++ programs; you can use the other options with
2522 any language supported by GCC@.
2523
2524 Note that since Objective-C is an extension of the C language, Objective-C
2525 compilations may also use options specific to the C front-end (e.g.,
2526 @option{-Wtraditional}).  Similarly, Objective-C++ compilations may use
2527 C++-specific options (e.g., @option{-Wabi}).
2528
2529 Here is a list of options that are @emph{only} for compiling Objective-C
2530 and Objective-C++ programs:
2531
2532 @table @gcctabopt
2533 @item -fconstant-string-class=@var{class-name}
2534 @opindex fconstant-string-class
2535 Use @var{class-name} as the name of the class to instantiate for each
2536 literal string specified with the syntax @code{@@"@dots{}"}.  The default
2537 class name is @code{NXConstantString} if the GNU runtime is being used, and
2538 @code{NSConstantString} if the NeXT runtime is being used (see below).  The
2539 @option{-fconstant-cfstrings} option, if also present, will override the
2540 @option{-fconstant-string-class} setting and cause @code{@@"@dots{}"} literals
2541 to be laid out as constant CoreFoundation strings.
2542
2543 @item -fgnu-runtime
2544 @opindex fgnu-runtime
2545 Generate object code compatible with the standard GNU Objective-C
2546 runtime.  This is the default for most types of systems.
2547
2548 @item -fnext-runtime
2549 @opindex fnext-runtime
2550 Generate output compatible with the NeXT runtime.  This is the default
2551 for NeXT-based systems, including Darwin and Mac OS X@.  The macro
2552 @code{__NEXT_RUNTIME__} is predefined if (and only if) this option is
2553 used.
2554
2555 @item -fno-nil-receivers
2556 @opindex fno-nil-receivers
2557 Assume that all Objective-C message dispatches (@code{[receiver
2558 message:arg]}) in this translation unit ensure that the receiver is
2559 not @code{nil}.  This allows for more efficient entry points in the
2560 runtime to be used.  This option is only available in conjunction with
2561 the NeXT runtime and ABI version 0 or 1.
2562
2563 @item -fobjc-abi-version=@var{n}
2564 @opindex fobjc-abi-version
2565 Use version @var{n} of the Objective-C ABI for the selected runtime.
2566 This option is currently supported only for the NeXT runtime.  In that
2567 case, Version 0 is the traditional (32-bit) ABI without support for
2568 properties and other Objective-C 2.0 additions.  Version 1 is the
2569 traditional (32-bit) ABI with support for properties and other
2570 Objective-C 2.0 additions.  Version 2 is the modern (64-bit) ABI.  If
2571 nothing is specified, the default is Version 0 on 32-bit target
2572 machines, and Version 2 on 64-bit target machines.
2573
2574 @item -fobjc-call-cxx-cdtors
2575 @opindex fobjc-call-cxx-cdtors
2576 For each Objective-C class, check if any of its instance variables is a
2577 C++ object with a non-trivial default constructor.  If so, synthesize a
2578 special @code{- (id) .cxx_construct} instance method that will run
2579 non-trivial default constructors on any such instance variables, in order,
2580 and then return @code{self}.  Similarly, check if any instance variable
2581 is a C++ object with a non-trivial destructor, and if so, synthesize a
2582 special @code{- (void) .cxx_destruct} method that will run
2583 all such default destructors, in reverse order.
2584
2585 The @code{- (id) .cxx_construct} and @code{- (void) .cxx_destruct}
2586 methods thusly generated will only operate on instance variables
2587 declared in the current Objective-C class, and not those inherited
2588 from superclasses.  It is the responsibility of the Objective-C
2589 runtime to invoke all such methods in an object's inheritance
2590 hierarchy.  The @code{- (id) .cxx_construct} methods will be invoked
2591 by the runtime immediately after a new object instance is allocated;
2592 the @code{- (void) .cxx_destruct} methods will be invoked immediately
2593 before the runtime deallocates an object instance.
2594
2595 As of this writing, only the NeXT runtime on Mac OS X 10.4 and later has
2596 support for invoking the @code{- (id) .cxx_construct} and
2597 @code{- (void) .cxx_destruct} methods.
2598
2599 @item -fobjc-direct-dispatch
2600 @opindex fobjc-direct-dispatch
2601 Allow fast jumps to the message dispatcher.  On Darwin this is
2602 accomplished via the comm page.
2603
2604 @item -fobjc-exceptions
2605 @opindex fobjc-exceptions
2606 Enable syntactic support for structured exception handling in
2607 Objective-C, similar to what is offered by C++ and Java.  This option
2608 is required to use the Objective-C keywords @code{@@try},
2609 @code{@@throw}, @code{@@catch}, @code{@@finally} and
2610 @code{@@synchronized}.  This option is available with both the GNU
2611 runtime and the NeXT runtime (but not available in conjunction with
2612 the NeXT runtime on Mac OS X 10.2 and earlier).
2613
2614 @item -fobjc-gc
2615 @opindex fobjc-gc
2616 Enable garbage collection (GC) in Objective-C and Objective-C++
2617 programs.  This option is only available with the NeXT runtime; the
2618 GNU runtime has a different garbage collection implementation that
2619 does not require special compiler flags.
2620
2621 @item -fobjc-nilcheck
2622 @opindex fobjc-nilcheck
2623 For the NeXT runtime with version 2 of the ABI, check for a nil
2624 receiver in method invocations before doing the actual method call.
2625 This is the default and can be disabled using
2626 @option{-fno-objc-nilcheck}.  Class methods and super calls are never
2627 checked for nil in this way no matter what this flag is set to.
2628 Currently this flag does nothing when the GNU runtime, or an older
2629 version of the NeXT runtime ABI, is used.
2630
2631 @item -fobjc-std=objc1
2632 @opindex fobjc-std
2633 Conform to the language syntax of Objective-C 1.0, the language
2634 recognized by GCC 4.0.  This only affects the Objective-C additions to
2635 the C/C++ language; it does not affect conformance to C/C++ standards,
2636 which is controlled by the separate C/C++ dialect option flags.  When
2637 this option is used with the Objective-C or Objective-C++ compiler,
2638 any Objective-C syntax that is not recognized by GCC 4.0 is rejected.
2639 This is useful if you need to make sure that your Objective-C code can
2640 be compiled with older versions of GCC.
2641
2642 @item -freplace-objc-classes
2643 @opindex freplace-objc-classes
2644 Emit a special marker instructing @command{ld(1)} not to statically link in
2645 the resulting object file, and allow @command{dyld(1)} to load it in at
2646 run time instead.  This is used in conjunction with the Fix-and-Continue
2647 debugging mode, where the object file in question may be recompiled and
2648 dynamically reloaded in the course of program execution, without the need
2649 to restart the program itself.  Currently, Fix-and-Continue functionality
2650 is only available in conjunction with the NeXT runtime on Mac OS X 10.3
2651 and later.
2652
2653 @item -fzero-link
2654 @opindex fzero-link
2655 When compiling for the NeXT runtime, the compiler ordinarily replaces calls
2656 to @code{objc_getClass("@dots{}")} (when the name of the class is known at
2657 compile time) with static class references that get initialized at load time,
2658 which improves run-time performance.  Specifying the @option{-fzero-link} flag
2659 suppresses this behavior and causes calls to @code{objc_getClass("@dots{}")}
2660 to be retained.  This is useful in Zero-Link debugging mode, since it allows
2661 for individual class implementations to be modified during program execution.
2662 The GNU runtime currently always retains calls to @code{objc_get_class("@dots{}")}
2663 regardless of command line options.
2664
2665 @item -gen-decls
2666 @opindex gen-decls
2667 Dump interface declarations for all classes seen in the source file to a
2668 file named @file{@var{sourcename}.decl}.
2669
2670 @item -Wassign-intercept @r{(Objective-C and Objective-C++ only)}
2671 @opindex Wassign-intercept
2672 @opindex Wno-assign-intercept
2673 Warn whenever an Objective-C assignment is being intercepted by the
2674 garbage collector.
2675
2676 @item -Wno-protocol @r{(Objective-C and Objective-C++ only)}
2677 @opindex Wno-protocol
2678 @opindex Wprotocol
2679 If a class is declared to implement a protocol, a warning is issued for
2680 every method in the protocol that is not implemented by the class.  The
2681 default behavior is to issue a warning for every method not explicitly
2682 implemented in the class, even if a method implementation is inherited
2683 from the superclass.  If you use the @option{-Wno-protocol} option, then
2684 methods inherited from the superclass are considered to be implemented,
2685 and no warning is issued for them.
2686
2687 @item -Wselector @r{(Objective-C and Objective-C++ only)}
2688 @opindex Wselector
2689 @opindex Wno-selector
2690 Warn if multiple methods of different types for the same selector are
2691 found during compilation.  The check is performed on the list of methods
2692 in the final stage of compilation.  Additionally, a check is performed
2693 for each selector appearing in a @code{@@selector(@dots{})}
2694 expression, and a corresponding method for that selector has been found
2695 during compilation.  Because these checks scan the method table only at
2696 the end of compilation, these warnings are not produced if the final
2697 stage of compilation is not reached, for example because an error is
2698 found during compilation, or because the @option{-fsyntax-only} option is
2699 being used.
2700
2701 @item -Wstrict-selector-match @r{(Objective-C and Objective-C++ only)}
2702 @opindex Wstrict-selector-match
2703 @opindex Wno-strict-selector-match
2704 Warn if multiple methods with differing argument and/or return types are
2705 found for a given selector when attempting to send a message using this
2706 selector to a receiver of type @code{id} or @code{Class}.  When this flag
2707 is off (which is the default behavior), the compiler will omit such warnings
2708 if any differences found are confined to types which share the same size
2709 and alignment.
2710
2711 @item -Wundeclared-selector @r{(Objective-C and Objective-C++ only)}
2712 @opindex Wundeclared-selector
2713 @opindex Wno-undeclared-selector
2714 Warn if a @code{@@selector(@dots{})} expression referring to an
2715 undeclared selector is found.  A selector is considered undeclared if no
2716 method with that name has been declared before the
2717 @code{@@selector(@dots{})} expression, either explicitly in an
2718 @code{@@interface} or @code{@@protocol} declaration, or implicitly in
2719 an @code{@@implementation} section.  This option always performs its
2720 checks as soon as a @code{@@selector(@dots{})} expression is found,
2721 while @option{-Wselector} only performs its checks in the final stage of
2722 compilation.  This also enforces the coding style convention
2723 that methods and selectors must be declared before being used.
2724
2725 @item -print-objc-runtime-info
2726 @opindex print-objc-runtime-info
2727 Generate C header describing the largest structure that is passed by
2728 value, if any.
2729
2730 @end table
2731
2732 @node Language Independent Options
2733 @section Options to Control Diagnostic Messages Formatting
2734 @cindex options to control diagnostics formatting
2735 @cindex diagnostic messages
2736 @cindex message formatting
2737
2738 Traditionally, diagnostic messages have been formatted irrespective of
2739 the output device's aspect (e.g.@: its width, @dots{}).  The options described
2740 below can be used to control the diagnostic messages formatting
2741 algorithm, e.g.@: how many characters per line, how often source location
2742 information should be reported.  Right now, only the C++ front end can
2743 honor these options.  However it is expected, in the near future, that
2744 the remaining front ends would be able to digest them correctly.
2745
2746 @table @gcctabopt
2747 @item -fmessage-length=@var{n}
2748 @opindex fmessage-length
2749 Try to format error messages so that they fit on lines of about @var{n}
2750 characters.  The default is 72 characters for @command{g++} and 0 for the rest of
2751 the front ends supported by GCC@.  If @var{n} is zero, then no
2752 line-wrapping will be done; each error message will appear on a single
2753 line.
2754
2755 @opindex fdiagnostics-show-location
2756 @item -fdiagnostics-show-location=once
2757 Only meaningful in line-wrapping mode.  Instructs the diagnostic messages
2758 reporter to emit @emph{once} source location information; that is, in
2759 case the message is too long to fit on a single physical line and has to
2760 be wrapped, the source location won't be emitted (as prefix) again,
2761 over and over, in subsequent continuation lines.  This is the default
2762 behavior.
2763
2764 @item -fdiagnostics-show-location=every-line
2765 Only meaningful in line-wrapping mode.  Instructs the diagnostic
2766 messages reporter to emit the same source location information (as
2767 prefix) for physical lines that result from the process of breaking
2768 a message which is too long to fit on a single line.
2769
2770 @item -fno-diagnostics-show-option
2771 @opindex fno-diagnostics-show-option
2772 @opindex fdiagnostics-show-option
2773 By default, each diagnostic emitted includes text which indicates the
2774 command line option that directly controls the diagnostic (if such an
2775 option is known to the diagnostic machinery).  Specifying the
2776 @option{-fno-diagnostics-show-option} flag suppresses that behavior.
2777
2778 @item -Wcoverage-mismatch
2779 @opindex Wcoverage-mismatch
2780 Warn if feedback profiles do not match when using the
2781 @option{-fprofile-use} option.
2782 If a source file was changed between @option{-fprofile-gen} and
2783 @option{-fprofile-use}, the files with the profile feedback can fail
2784 to match the source file and GCC can not use the profile feedback
2785 information.  By default, this warning is enabled and is treated as an
2786 error.  @option{-Wno-coverage-mismatch} can be used to disable the
2787 warning or @option{-Wno-error=coverage-mismatch} can be used to
2788 disable the error.  Disable the error for this warning can result in
2789 poorly optimized code, so disabling the error is useful only in the
2790 case of very minor changes such as bug fixes to an existing code-base.
2791 Completely disabling the warning is not recommended.
2792
2793 @end table
2794
2795 @node Warning Options
2796 @section Options to Request or Suppress Warnings
2797 @cindex options to control warnings
2798 @cindex warning messages
2799 @cindex messages, warning
2800 @cindex suppressing warnings
2801
2802 Warnings are diagnostic messages that report constructions which
2803 are not inherently erroneous but which are risky or suggest there
2804 may have been an error.
2805
2806 The following language-independent options do not enable specific
2807 warnings but control the kinds of diagnostics produced by GCC.
2808
2809 @table @gcctabopt
2810 @cindex syntax checking
2811 @item -fsyntax-only
2812 @opindex fsyntax-only
2813 Check the code for syntax errors, but don't do anything beyond that.
2814
2815 @item -fmax-errors=@var{n}
2816 @opindex fmax-errors
2817 Limits the maximum number of error messages to @var{n}, at which point
2818 GCC bails out rather than attempting to continue processing the source
2819 code.  If @var{n} is 0 (the default), there is no limit on the number
2820 of error messages produced.  If @option{-Wfatal-errors} is also
2821 specified, then @option{-Wfatal-errors} takes precedence over this
2822 option.
2823
2824 @item -w
2825 @opindex w
2826 Inhibit all warning messages.
2827
2828 @item -Werror
2829 @opindex Werror
2830 @opindex Wno-error
2831 Make all warnings into errors.
2832
2833 @item -Werror=
2834 @opindex Werror=
2835 @opindex Wno-error=
2836 Make the specified warning into an error.  The specifier for a warning
2837 is appended, for example @option{-Werror=switch} turns the warnings
2838 controlled by @option{-Wswitch} into errors.  This switch takes a
2839 negative form, to be used to negate @option{-Werror} for specific
2840 warnings, for example @option{-Wno-error=switch} makes
2841 @option{-Wswitch} warnings not be errors, even when @option{-Werror}
2842 is in effect.
2843
2844 The warning message for each controllable warning includes the
2845 option which controls the warning.  That option can then be used with
2846 @option{-Werror=} and @option{-Wno-error=} as described above.
2847 (Printing of the option in the warning message can be disabled using the
2848 @option{-fno-diagnostics-show-option} flag.)
2849
2850 Note that specifying @option{-Werror=}@var{foo} automatically implies
2851 @option{-W}@var{foo}.  However, @option{-Wno-error=}@var{foo} does not
2852 imply anything.
2853
2854 @item -Wfatal-errors
2855 @opindex Wfatal-errors
2856 @opindex Wno-fatal-errors
2857 This option causes the compiler to abort compilation on the first error
2858 occurred rather than trying to keep going and printing further error
2859 messages.
2860
2861 @end table
2862
2863 You can request many specific warnings with options beginning
2864 @samp{-W}, for example @option{-Wimplicit} to request warnings on
2865 implicit declarations.  Each of these specific warning options also
2866 has a negative form beginning @samp{-Wno-} to turn off warnings; for
2867 example, @option{-Wno-implicit}.  This manual lists only one of the
2868 two forms, whichever is not the default.  For further,
2869 language-specific options also refer to @ref{C++ Dialect Options} and
2870 @ref{Objective-C and Objective-C++ Dialect Options}.
2871
2872 When an unrecognized warning option is requested (e.g.,
2873 @option{-Wunknown-warning}), GCC will emit a diagnostic stating
2874 that the option is not recognized.  However, if the @option{-Wno-} form
2875 is used, the behavior is slightly different: No diagnostic will be
2876 produced for @option{-Wno-unknown-warning} unless other diagnostics
2877 are being produced.  This allows the use of new @option{-Wno-} options
2878 with old compilers, but if something goes wrong, the compiler will
2879 warn that an unrecognized option was used.
2880
2881 @table @gcctabopt
2882 @item -pedantic
2883 @opindex pedantic
2884 Issue all the warnings demanded by strict ISO C and ISO C++;
2885 reject all programs that use forbidden extensions, and some other
2886 programs that do not follow ISO C and ISO C++.  For ISO C, follows the
2887 version of the ISO C standard specified by any @option{-std} option used.
2888
2889 Valid ISO C and ISO C++ programs should compile properly with or without
2890 this option (though a rare few will require @option{-ansi} or a
2891 @option{-std} option specifying the required version of ISO C)@.  However,
2892 without this option, certain GNU extensions and traditional C and C++
2893 features are supported as well.  With this option, they are rejected.
2894
2895 @option{-pedantic} does not cause warning messages for use of the
2896 alternate keywords whose names begin and end with @samp{__}.  Pedantic
2897 warnings are also disabled in the expression that follows
2898 @code{__extension__}.  However, only system header files should use
2899 these escape routes; application programs should avoid them.
2900 @xref{Alternate Keywords}.
2901
2902 Some users try to use @option{-pedantic} to check programs for strict ISO
2903 C conformance.  They soon find that it does not do quite what they want:
2904 it finds some non-ISO practices, but not all---only those for which
2905 ISO C @emph{requires} a diagnostic, and some others for which
2906 diagnostics have been added.
2907
2908 A feature to report any failure to conform to ISO C might be useful in
2909 some instances, but would require considerable additional work and would
2910 be quite different from @option{-pedantic}.  We don't have plans to
2911 support such a feature in the near future.
2912
2913 Where the standard specified with @option{-std} represents a GNU
2914 extended dialect of C, such as @samp{gnu90} or @samp{gnu99}, there is a
2915 corresponding @dfn{base standard}, the version of ISO C on which the GNU
2916 extended dialect is based.  Warnings from @option{-pedantic} are given
2917 where they are required by the base standard.  (It would not make sense
2918 for such warnings to be given only for features not in the specified GNU
2919 C dialect, since by definition the GNU dialects of C include all
2920 features the compiler supports with the given option, and there would be
2921 nothing to warn about.)
2922
2923 @item -pedantic-errors
2924 @opindex pedantic-errors
2925 Like @option{-pedantic}, except that errors are produced rather than
2926 warnings.
2927
2928 @item -Wall
2929 @opindex Wall
2930 @opindex Wno-all
2931 This enables all the warnings about constructions that some users
2932 consider questionable, and that are easy to avoid (or modify to
2933 prevent the warning), even in conjunction with macros.  This also
2934 enables some language-specific warnings described in @ref{C++ Dialect
2935 Options} and @ref{Objective-C and Objective-C++ Dialect Options}.
2936
2937 @option{-Wall} turns on the following warning flags:
2938
2939 @gccoptlist{-Waddress   @gol
2940 -Warray-bounds @r{(only with} @option{-O2}@r{)}  @gol
2941 -Wc++0x-compat  @gol
2942 -Wchar-subscripts  @gol
2943 -Wenum-compare @r{(in C/Objc; this is on by default in C++)} @gol
2944 -Wimplicit-int @r{(C and Objective-C only)} @gol
2945 -Wimplicit-function-declaration @r{(C and Objective-C only)} @gol
2946 -Wcomment  @gol
2947 -Wformat   @gol
2948 -Wmain @r{(only for C/ObjC and unless} @option{-ffreestanding}@r{)}  @gol
2949 -Wmaybe-uninitialized @gol
2950 -Wmissing-braces  @gol
2951 -Wnonnull  @gol
2952 -Wparentheses  @gol
2953 -Wpointer-sign  @gol
2954 -Wreorder   @gol
2955 -Wreturn-type  @gol
2956 -Wsequence-point  @gol
2957 -Wsign-compare @r{(only in C++)}  @gol
2958 -Wstrict-aliasing  @gol
2959 -Wstrict-overflow=1  @gol
2960 -Wswitch  @gol
2961 -Wtrigraphs  @gol
2962 -Wuninitialized  @gol
2963 -Wunknown-pragmas  @gol
2964 -Wunused-function  @gol
2965 -Wunused-label     @gol
2966 -Wunused-value     @gol
2967 -Wunused-variable  @gol
2968 -Wvolatile-register-var @gol
2969 }
2970
2971 Note that some warning flags are not implied by @option{-Wall}.  Some of
2972 them warn about constructions that users generally do not consider
2973 questionable, but which occasionally you might wish to check for;
2974 others warn about constructions that are necessary or hard to avoid in
2975 some cases, and there is no simple way to modify the code to suppress
2976 the warning. Some of them are enabled by @option{-Wextra} but many of
2977 them must be enabled individually.
2978
2979 @item -Wextra
2980 @opindex W
2981 @opindex Wextra
2982 @opindex Wno-extra
2983 This enables some extra warning flags that are not enabled by
2984 @option{-Wall}. (This option used to be called @option{-W}.  The older
2985 name is still supported, but the newer name is more descriptive.)
2986
2987 @gccoptlist{-Wclobbered  @gol
2988 -Wempty-body  @gol
2989 -Wignored-qualifiers @gol
2990 -Wmissing-field-initializers  @gol
2991 -Wmissing-parameter-type @r{(C only)}  @gol
2992 -Wold-style-declaration @r{(C only)}  @gol
2993 -Woverride-init  @gol
2994 -Wsign-compare  @gol
2995 -Wtype-limits  @gol
2996 -Wuninitialized  @gol
2997 -Wunused-parameter @r{(only with} @option{-Wunused} @r{or} @option{-Wall}@r{)} @gol
2998 -Wunused-but-set-parameter @r{(only with} @option{-Wunused} @r{or} @option{-Wall}@r{)}  @gol
2999 }
3000
3001 The option @option{-Wextra} also prints warning messages for the
3002 following cases:
3003
3004 @itemize @bullet
3005
3006 @item
3007 A pointer is compared against integer zero with @samp{<}, @samp{<=},
3008 @samp{>}, or @samp{>=}.
3009
3010 @item
3011 (C++ only) An enumerator and a non-enumerator both appear in a
3012 conditional expression.
3013
3014 @item
3015 (C++ only) Ambiguous virtual bases.
3016
3017 @item
3018 (C++ only) Subscripting an array which has been declared @samp{register}.
3019
3020 @item
3021 (C++ only) Taking the address of a variable which has been declared
3022 @samp{register}.
3023
3024 @item
3025 (C++ only) A base class is not initialized in a derived class' copy
3026 constructor.
3027
3028 @end itemize
3029
3030 @item -Wchar-subscripts
3031 @opindex Wchar-subscripts
3032 @opindex Wno-char-subscripts
3033 Warn if an array subscript has type @code{char}.  This is a common cause
3034 of error, as programmers often forget that this type is signed on some
3035 machines.
3036 This warning is enabled by @option{-Wall}.
3037
3038 @item -Wcomment
3039 @opindex Wcomment
3040 @opindex Wno-comment
3041 Warn whenever a comment-start sequence @samp{/*} appears in a @samp{/*}
3042 comment, or whenever a Backslash-Newline appears in a @samp{//} comment.
3043 This warning is enabled by @option{-Wall}.
3044
3045 @item -Wno-cpp
3046 @r{(C, Objective-C, C++, Objective-C++ and Fortran only)}
3047
3048 Suppress warning messages emitted by @code{#warning} directives.
3049
3050 @item -Wdouble-promotion @r{(C, C++, Objective-C and Objective-C++ only)}
3051 @opindex Wdouble-promotion
3052 @opindex Wno-double-promotion
3053 Give a warning when a value of type @code{float} is implicitly
3054 promoted to @code{double}.  CPUs with a 32-bit ``single-precision''
3055 floating-point unit implement @code{float} in hardware, but emulate
3056 @code{double} in software.  On such a machine, doing computations
3057 using @code{double} values is much more expensive because of the
3058 overhead required for software emulation.
3059
3060 It is easy to accidentally do computations with @code{double} because
3061 floating-point literals are implicitly of type @code{double}.  For
3062 example, in:
3063 @smallexample
3064 @group
3065 float area(float radius)
3066 @{
3067    return 3.14159 * radius * radius;
3068 @}
3069 @end group
3070 @end smallexample
3071 the compiler will perform the entire computation with @code{double}
3072 because the floating-point literal is a @code{double}.
3073
3074 @item -Wformat
3075 @opindex Wformat
3076 @opindex Wno-format
3077 @opindex ffreestanding
3078 @opindex fno-builtin
3079 Check calls to @code{printf} and @code{scanf}, etc., to make sure that
3080 the arguments supplied have types appropriate to the format string
3081 specified, and that the conversions specified in the format string make
3082 sense.  This includes standard functions, and others specified by format
3083 attributes (@pxref{Function Attributes}), in the @code{printf},
3084 @code{scanf}, @code{strftime} and @code{strfmon} (an X/Open extension,
3085 not in the C standard) families (or other target-specific families).
3086 Which functions are checked without format attributes having been
3087 specified depends on the standard version selected, and such checks of
3088 functions without the attribute specified are disabled by
3089 @option{-ffreestanding} or @option{-fno-builtin}.
3090
3091 The formats are checked against the format features supported by GNU
3092 libc version 2.2.  These include all ISO C90 and C99 features, as well
3093 as features from the Single Unix Specification and some BSD and GNU
3094 extensions.  Other library implementations may not support all these
3095 features; GCC does not support warning about features that go beyond a
3096 particular library's limitations.  However, if @option{-pedantic} is used
3097 with @option{-Wformat}, warnings will be given about format features not
3098 in the selected standard version (but not for @code{strfmon} formats,
3099 since those are not in any version of the C standard).  @xref{C Dialect
3100 Options,,Options Controlling C Dialect}.
3101
3102 Since @option{-Wformat} also checks for null format arguments for
3103 several functions, @option{-Wformat} also implies @option{-Wnonnull}.
3104
3105 @option{-Wformat} is included in @option{-Wall}.  For more control over some
3106 aspects of format checking, the options @option{-Wformat-y2k},
3107 @option{-Wno-format-extra-args}, @option{-Wno-format-zero-length},
3108 @option{-Wformat-nonliteral}, @option{-Wformat-security}, and
3109 @option{-Wformat=2} are available, but are not included in @option{-Wall}.
3110
3111 @item -Wformat-y2k
3112 @opindex Wformat-y2k
3113 @opindex Wno-format-y2k
3114 If @option{-Wformat} is specified, also warn about @code{strftime}
3115 formats which may yield only a two-digit year.
3116
3117 @item -Wno-format-contains-nul
3118 @opindex Wno-format-contains-nul
3119 @opindex Wformat-contains-nul
3120 If @option{-Wformat} is specified, do not warn about format strings that
3121 contain NUL bytes.
3122
3123 @item -Wno-format-extra-args
3124 @opindex Wno-format-extra-args
3125 @opindex Wformat-extra-args
3126 If @option{-Wformat} is specified, do not warn about excess arguments to a
3127 @code{printf} or @code{scanf} format function.  The C standard specifies
3128 that such arguments are ignored.
3129
3130 Where the unused arguments lie between used arguments that are
3131 specified with @samp{$} operand number specifications, normally
3132 warnings are still given, since the implementation could not know what
3133 type to pass to @code{va_arg} to skip the unused arguments.  However,
3134 in the case of @code{scanf} formats, this option will suppress the
3135 warning if the unused arguments are all pointers, since the Single
3136 Unix Specification says that such unused arguments are allowed.
3137
3138 @item -Wno-format-zero-length @r{(C and Objective-C only)}
3139 @opindex Wno-format-zero-length
3140 @opindex Wformat-zero-length
3141 If @option{-Wformat} is specified, do not warn about zero-length formats.
3142 The C standard specifies that zero-length formats are allowed.
3143
3144 @item -Wformat-nonliteral
3145 @opindex Wformat-nonliteral
3146 @opindex Wno-format-nonliteral
3147 If @option{-Wformat} is specified, also warn if the format string is not a
3148 string literal and so cannot be checked, unless the format function
3149 takes its format arguments as a @code{va_list}.
3150
3151 @item -Wformat-security
3152 @opindex Wformat-security
3153 @opindex Wno-format-security
3154 If @option{-Wformat} is specified, also warn about uses of format
3155 functions that represent possible security problems.  At present, this
3156 warns about calls to @code{printf} and @code{scanf} functions where the
3157 format string is not a string literal and there are no format arguments,
3158 as in @code{printf (foo);}.  This may be a security hole if the format
3159 string came from untrusted input and contains @samp{%n}.  (This is
3160 currently a subset of what @option{-Wformat-nonliteral} warns about, but
3161 in future warnings may be added to @option{-Wformat-security} that are not
3162 included in @option{-Wformat-nonliteral}.)
3163
3164 @item -Wformat=2
3165 @opindex Wformat=2
3166 @opindex Wno-format=2
3167 Enable @option{-Wformat} plus format checks not included in
3168 @option{-Wformat}.  Currently equivalent to @samp{-Wformat
3169 -Wformat-nonliteral -Wformat-security -Wformat-y2k}.
3170
3171 @item -Wnonnull @r{(C and Objective-C only)}
3172 @opindex Wnonnull
3173 @opindex Wno-nonnull
3174 Warn about passing a null pointer for arguments marked as
3175 requiring a non-null value by the @code{nonnull} function attribute.
3176
3177 @option{-Wnonnull} is included in @option{-Wall} and @option{-Wformat}.  It
3178 can be disabled with the @option{-Wno-nonnull} option.
3179
3180 @item -Winit-self @r{(C, C++, Objective-C and Objective-C++ only)}
3181 @opindex Winit-self
3182 @opindex Wno-init-self
3183 Warn about uninitialized variables which are initialized with themselves.
3184 Note this option can only be used with the @option{-Wuninitialized} option.
3185
3186 For example, GCC will warn about @code{i} being uninitialized in the
3187 following snippet only when @option{-Winit-self} has been specified:
3188 @smallexample
3189 @group
3190 int f()
3191 @{
3192   int i = i;
3193   return i;
3194 @}
3195 @end group
3196 @end smallexample
3197
3198 @item -Wimplicit-int @r{(C and Objective-C only)}
3199 @opindex Wimplicit-int
3200 @opindex Wno-implicit-int
3201 Warn when a declaration does not specify a type.
3202 This warning is enabled by @option{-Wall}.
3203
3204 @item -Wimplicit-function-declaration @r{(C and Objective-C only)}
3205 @opindex Wimplicit-function-declaration
3206 @opindex Wno-implicit-function-declaration
3207 Give a warning whenever a function is used before being declared. In
3208 C99 mode (@option{-std=c99} or @option{-std=gnu99}), this warning is
3209 enabled by default and it is made into an error by
3210 @option{-pedantic-errors}. This warning is also enabled by
3211 @option{-Wall}.
3212
3213 @item -Wimplicit @r{(C and Objective-C only)}
3214 @opindex Wimplicit
3215 @opindex Wno-implicit
3216 Same as @option{-Wimplicit-int} and @option{-Wimplicit-function-declaration}.
3217 This warning is enabled by @option{-Wall}.
3218
3219 @item -Wignored-qualifiers @r{(C and C++ only)}
3220 @opindex Wignored-qualifiers
3221 @opindex Wno-ignored-qualifiers
3222 Warn if the return type of a function has a type qualifier
3223 such as @code{const}.  For ISO C such a type qualifier has no effect,
3224 since the value returned by a function is not an lvalue.
3225 For C++, the warning is only emitted for scalar types or @code{void}.
3226 ISO C prohibits qualified @code{void} return types on function
3227 definitions, so such return types always receive a warning
3228 even without this option.
3229
3230 This warning is also enabled by @option{-Wextra}.
3231
3232 @item -Wmain
3233 @opindex Wmain
3234 @opindex Wno-main
3235 Warn if the type of @samp{main} is suspicious.  @samp{main} should be
3236 a function with external linkage, returning int, taking either zero
3237 arguments, two, or three arguments of appropriate types.  This warning
3238 is enabled by default in C++ and is enabled by either @option{-Wall}
3239 or @option{-pedantic}.
3240
3241 @item -Wmissing-braces
3242 @opindex Wmissing-braces
3243 @opindex Wno-missing-braces
3244 Warn if an aggregate or union initializer is not fully bracketed.  In
3245 the following example, the initializer for @samp{a} is not fully
3246 bracketed, but that for @samp{b} is fully bracketed.
3247
3248 @smallexample
3249 int a[2][2] = @{ 0, 1, 2, 3 @};
3250 int b[2][2] = @{ @{ 0, 1 @}, @{ 2, 3 @} @};
3251 @end smallexample
3252
3253 This warning is enabled by @option{-Wall}.
3254
3255 @item -Wmissing-include-dirs @r{(C, C++, Objective-C and Objective-C++ only)}
3256 @opindex Wmissing-include-dirs
3257 @opindex Wno-missing-include-dirs
3258 Warn if a user-supplied include directory does not exist.
3259
3260 @item -Wparentheses
3261 @opindex Wparentheses
3262 @opindex Wno-parentheses
3263 Warn if parentheses are omitted in certain contexts, such
3264 as when there is an assignment in a context where a truth value
3265 is expected, or when operators are nested whose precedence people
3266 often get confused about.
3267
3268 Also warn if a comparison like @samp{x<=y<=z} appears; this is
3269 equivalent to @samp{(x<=y ? 1 : 0) <= z}, which is a different
3270 interpretation from that of ordinary mathematical notation.
3271
3272 Also warn about constructions where there may be confusion to which
3273 @code{if} statement an @code{else} branch belongs.  Here is an example of
3274 such a case:
3275
3276 @smallexample
3277 @group
3278 @{
3279   if (a)
3280     if (b)
3281       foo ();
3282   else
3283     bar ();
3284 @}
3285 @end group
3286 @end smallexample
3287
3288 In C/C++, every @code{else} branch belongs to the innermost possible
3289 @code{if} statement, which in this example is @code{if (b)}.  This is
3290 often not what the programmer expected, as illustrated in the above
3291 example by indentation the programmer chose.  When there is the
3292 potential for this confusion, GCC will issue a warning when this flag
3293 is specified.  To eliminate the warning, add explicit braces around
3294 the innermost @code{if} statement so there is no way the @code{else}
3295 could belong to the enclosing @code{if}.  The resulting code would
3296 look like this:
3297
3298 @smallexample
3299 @group
3300 @{
3301   if (a)
3302     @{
3303       if (b)
3304         foo ();
3305       else
3306         bar ();
3307     @}
3308 @}
3309 @end group
3310 @end smallexample
3311
3312 Also warn for dangerous uses of the
3313 ?: with omitted middle operand GNU extension. When the condition
3314 in the ?: operator is a boolean expression the omitted value will
3315 be always 1. Often the user expects it to be a value computed
3316 inside the conditional expression instead.
3317
3318 This warning is enabled by @option{-Wall}.
3319
3320 @item -Wsequence-point
3321 @opindex Wsequence-point
3322 @opindex Wno-sequence-point
3323 Warn about code that may have undefined semantics because of violations
3324 of sequence point rules in the C and C++ standards.
3325
3326 The C and C++ standards defines the order in which expressions in a C/C++
3327 program are evaluated in terms of @dfn{sequence points}, which represent
3328 a partial ordering between the execution of parts of the program: those
3329 executed before the sequence point, and those executed after it.  These
3330 occur after the evaluation of a full expression (one which is not part
3331 of a larger expression), after the evaluation of the first operand of a
3332 @code{&&}, @code{||}, @code{? :} or @code{,} (comma) operator, before a
3333 function is called (but after the evaluation of its arguments and the
3334 expression denoting the called function), and in certain other places.
3335 Other than as expressed by the sequence point rules, the order of
3336 evaluation of subexpressions of an expression is not specified.  All
3337 these rules describe only a partial order rather than a total order,
3338 since, for example, if two functions are called within one expression
3339 with no sequence point between them, the order in which the functions
3340 are called is not specified.  However, the standards committee have
3341 ruled that function calls do not overlap.
3342
3343 It is not specified when between sequence points modifications to the
3344 values of objects take effect.  Programs whose behavior depends on this
3345 have undefined behavior; the C and C++ standards specify that ``Between
3346 the previous and next sequence point an object shall have its stored
3347 value modified at most once by the evaluation of an expression.
3348 Furthermore, the prior value shall be read only to determine the value
3349 to be stored.''.  If a program breaks these rules, the results on any
3350 particular implementation are entirely unpredictable.
3351
3352 Examples of code with undefined behavior are @code{a = a++;}, @code{a[n]
3353 = b[n++]} and @code{a[i++] = i;}.  Some more complicated cases are not
3354 diagnosed by this option, and it may give an occasional false positive
3355 result, but in general it has been found fairly effective at detecting
3356 this sort of problem in programs.
3357
3358 The standard is worded confusingly, therefore there is some debate
3359 over the precise meaning of the sequence point rules in subtle cases.
3360 Links to discussions of the problem, including proposed formal
3361 definitions, may be found on the GCC readings page, at
3362 @uref{http://gcc.gnu.org/@/readings.html}.
3363
3364 This warning is enabled by @option{-Wall} for C and C++.
3365
3366 @item -Wreturn-type
3367 @opindex Wreturn-type
3368 @opindex Wno-return-type
3369 Warn whenever a function is defined with a return-type that defaults
3370 to @code{int}.  Also warn about any @code{return} statement with no
3371 return-value in a function whose return-type is not @code{void}
3372 (falling off the end of the function body is considered returning
3373 without a value), and about a @code{return} statement with an
3374 expression in a function whose return-type is @code{void}.
3375
3376 For C++, a function without return type always produces a diagnostic
3377 message, even when @option{-Wno-return-type} is specified.  The only
3378 exceptions are @samp{main} and functions defined in system headers.
3379
3380 This warning is enabled by @option{-Wall}.
3381
3382 @item -Wswitch
3383 @opindex Wswitch
3384 @opindex Wno-switch
3385 Warn whenever a @code{switch} statement has an index of enumerated type
3386 and lacks a @code{case} for one or more of the named codes of that
3387 enumeration.  (The presence of a @code{default} label prevents this
3388 warning.)  @code{case} labels outside the enumeration range also
3389 provoke warnings when this option is used (even if there is a
3390 @code{default} label).
3391 This warning is enabled by @option{-Wall}.
3392
3393 @item -Wswitch-default
3394 @opindex Wswitch-default
3395 @opindex Wno-switch-default
3396 Warn whenever a @code{switch} statement does not have a @code{default}
3397 case.
3398
3399 @item -Wswitch-enum
3400 @opindex Wswitch-enum
3401 @opindex Wno-switch-enum
3402 Warn whenever a @code{switch} statement has an index of enumerated type
3403 and lacks a @code{case} for one or more of the named codes of that
3404 enumeration.  @code{case} labels outside the enumeration range also
3405 provoke warnings when this option is used.  The only difference
3406 between @option{-Wswitch} and this option is that this option gives a
3407 warning about an omitted enumeration code even if there is a
3408 @code{default} label.
3409
3410 @item -Wsync-nand @r{(C and C++ only)}
3411 @opindex Wsync-nand
3412 @opindex Wno-sync-nand
3413 Warn when @code{__sync_fetch_and_nand} and @code{__sync_nand_and_fetch}
3414 built-in functions are used.  These functions changed semantics in GCC 4.4.
3415
3416 @item -Wtrigraphs
3417 @opindex Wtrigraphs
3418 @opindex Wno-trigraphs
3419 Warn if any trigraphs are encountered that might change the meaning of
3420 the program (trigraphs within comments are not warned about).
3421 This warning is enabled by @option{-Wall}.
3422
3423 @item -Wunused-but-set-parameter
3424 @opindex Wunused-but-set-parameter
3425 @opindex Wno-unused-but-set-parameter
3426 Warn whenever a function parameter is assigned to, but otherwise unused
3427 (aside from its declaration).
3428
3429 To suppress this warning use the @samp{unused} attribute
3430 (@pxref{Variable Attributes}).
3431
3432 This warning is also enabled by @option{-Wunused} together with
3433 @option{-Wextra}.
3434
3435 @item -Wunused-but-set-variable
3436 @opindex Wunused-but-set-variable
3437 @opindex Wno-unused-but-set-variable
3438 Warn whenever a local variable is assigned to, but otherwise unused
3439 (aside from its declaration).
3440 This warning is enabled by @option{-Wall}.
3441
3442 To suppress this warning use the @samp{unused} attribute
3443 (@pxref{Variable Attributes}).
3444
3445 This warning is also enabled by @option{-Wunused}, which is enabled
3446 by @option{-Wall}.
3447
3448 @item -Wunused-function
3449 @opindex Wunused-function
3450 @opindex Wno-unused-function
3451 Warn whenever a static function is declared but not defined or a
3452 non-inline static function is unused.
3453 This warning is enabled by @option{-Wall}.
3454
3455 @item -Wunused-label
3456 @opindex Wunused-label
3457 @opindex Wno-unused-label
3458 Warn whenever a label is declared but not used.
3459 This warning is enabled by @option{-Wall}.
3460
3461 To suppress this warning use the @samp{unused} attribute
3462 (@pxref{Variable Attributes}).
3463
3464 @item -Wunused-parameter
3465 @opindex Wunused-parameter
3466 @opindex Wno-unused-parameter
3467 Warn whenever a function parameter is unused aside from its declaration.
3468
3469 To suppress this warning use the @samp{unused} attribute
3470 (@pxref{Variable Attributes}).
3471
3472 @item -Wno-unused-result
3473 @opindex Wunused-result
3474 @opindex Wno-unused-result
3475 Do not warn if a caller of a function marked with attribute
3476 @code{warn_unused_result} (@pxref{Variable Attributes}) does not use
3477 its return value. The default is @option{-Wunused-result}.
3478
3479 @item -Wunused-variable
3480 @opindex Wunused-variable
3481 @opindex Wno-unused-variable
3482 Warn whenever a local variable or non-constant static variable is unused
3483 aside from its declaration.
3484 This warning is enabled by @option{-Wall}.
3485
3486 To suppress this warning use the @samp{unused} attribute
3487 (@pxref{Variable Attributes}).
3488
3489 @item -Wunused-value
3490 @opindex Wunused-value
3491 @opindex Wno-unused-value
3492 Warn whenever a statement computes a result that is explicitly not
3493 used. To suppress this warning cast the unused expression to
3494 @samp{void}. This includes an expression-statement or the left-hand
3495 side of a comma expression that contains no side effects. For example,
3496 an expression such as @samp{x[i,j]} will cause a warning, while
3497 @samp{x[(void)i,j]} will not.
3498
3499 This warning is enabled by @option{-Wall}.
3500
3501 @item -Wunused
3502 @opindex Wunused
3503 @opindex Wno-unused
3504 All the above @option{-Wunused} options combined.
3505
3506 In order to get a warning about an unused function parameter, you must
3507 either specify @samp{-Wextra -Wunused} (note that @samp{-Wall} implies
3508 @samp{-Wunused}), or separately specify @option{-Wunused-parameter}.
3509
3510 @item -Wuninitialized
3511 @opindex Wuninitialized
3512 @opindex Wno-uninitialized
3513 Warn if an automatic variable is used without first being initialized
3514 or if a variable may be clobbered by a @code{setjmp} call. In C++,
3515 warn if a non-static reference or non-static @samp{const} member
3516 appears in a class without constructors.
3517
3518 If you want to warn about code which uses the uninitialized value of the
3519 variable in its own initializer, use the @option{-Winit-self} option.
3520
3521 These warnings occur for individual uninitialized or clobbered
3522 elements of structure, union or array variables as well as for
3523 variables which are uninitialized or clobbered as a whole.  They do
3524 not occur for variables or elements declared @code{volatile}.  Because
3525 these warnings depend on optimization, the exact variables or elements
3526 for which there are warnings will depend on the precise optimization
3527 options and version of GCC used.
3528
3529 Note that there may be no warning about a variable that is used only
3530 to compute a value that itself is never used, because such
3531 computations may be deleted by data flow analysis before the warnings
3532 are printed.
3533
3534 @item -Wmaybe-uninitialized
3535 @opindex Wmaybe-uninitialized
3536 @opindex Wno-maybe-uninitialized
3537 For an automatic variable, if there exists a path from the function
3538 entry to a use of the variable that is initialized, but there exist
3539 some other paths the variable is not initialized, the compiler will
3540 emit a warning if it can not prove the uninitialized paths do not
3541 happen at runtime. These warnings are made optional because GCC is
3542 not smart enough to see all the reasons why the code might be correct
3543 despite appearing to have an error.  Here is one example of how
3544 this can happen:
3545
3546 @smallexample
3547 @group
3548 @{
3549   int x;
3550   switch (y)
3551     @{
3552     case 1: x = 1;
3553       break;
3554     case 2: x = 4;
3555       break;
3556     case 3: x = 5;
3557     @}
3558   foo (x);
3559 @}
3560 @end group
3561 @end smallexample
3562
3563 @noindent
3564 If the value of @code{y} is always 1, 2 or 3, then @code{x} is
3565 always initialized, but GCC doesn't know this. To suppress the
3566 warning, the user needs to provide a default case with assert(0) or
3567 similar code.
3568
3569 @cindex @code{longjmp} warnings
3570 This option also warns when a non-volatile automatic variable might be
3571 changed by a call to @code{longjmp}.  These warnings as well are possible
3572 only in optimizing compilation.
3573
3574 The compiler sees only the calls to @code{setjmp}.  It cannot know
3575 where @code{longjmp} will be called; in fact, a signal handler could
3576 call it at any point in the code.  As a result, you may get a warning
3577 even when there is in fact no problem because @code{longjmp} cannot
3578 in fact be called at the place which would cause a problem.
3579
3580 Some spurious warnings can be avoided if you declare all the functions
3581 you use that never return as @code{noreturn}.  @xref{Function
3582 Attributes}.
3583
3584 This warning is enabled by @option{-Wall} or @option{-Wextra}.
3585
3586 @item -Wunknown-pragmas
3587 @opindex Wunknown-pragmas
3588 @opindex Wno-unknown-pragmas
3589 @cindex warning for unknown pragmas
3590 @cindex unknown pragmas, warning
3591 @cindex pragmas, warning of unknown
3592 Warn when a #pragma directive is encountered which is not understood by
3593 GCC@.  If this command line option is used, warnings will even be issued
3594 for unknown pragmas in system header files.  This is not the case if
3595 the warnings were only enabled by the @option{-Wall} command line option.
3596
3597 @item -Wno-pragmas
3598 @opindex Wno-pragmas
3599 @opindex Wpragmas
3600 Do not warn about misuses of pragmas, such as incorrect parameters,
3601 invalid syntax, or conflicts between pragmas.  See also
3602 @samp{-Wunknown-pragmas}.
3603
3604 @item -Wstrict-aliasing
3605 @opindex Wstrict-aliasing
3606 @opindex Wno-strict-aliasing
3607 This option is only active when @option{-fstrict-aliasing} is active.
3608 It warns about code which might break the strict aliasing rules that the
3609 compiler is using for optimization.  The warning does not catch all
3610 cases, but does attempt to catch the more common pitfalls.  It is
3611 included in @option{-Wall}.
3612 It is equivalent to @option{-Wstrict-aliasing=3}
3613
3614 @item -Wstrict-aliasing=n
3615 @opindex Wstrict-aliasing=n
3616 @opindex Wno-strict-aliasing=n
3617 This option is only active when @option{-fstrict-aliasing} is active.
3618 It warns about code which might break the strict aliasing rules that the
3619 compiler is using for optimization.
3620 Higher levels correspond to higher accuracy (fewer false positives).
3621 Higher levels also correspond to more effort, similar to the way -O works.
3622 @option{-Wstrict-aliasing} is equivalent to @option{-Wstrict-aliasing=n},
3623 with n=3.
3624
3625 Level 1: Most aggressive, quick, least accurate.
3626 Possibly useful when higher levels
3627 do not warn but -fstrict-aliasing still breaks the code, as it has very few
3628 false negatives.  However, it has many false positives.
3629 Warns for all pointer conversions between possibly incompatible types,
3630 even if never dereferenced.  Runs in the frontend only.
3631
3632 Level 2: Aggressive, quick, not too precise.
3633 May still have many false positives (not as many as level 1 though),
3634 and few false negatives (but possibly more than level 1).
3635 Unlike level 1, it only warns when an address is taken.  Warns about