OSDN Git Service

fa9ed7f4d2b2592f3ac5a8e99605325041848ada
[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
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 Free Software Foundation, Inc.
15
16 Permission is granted to copy, distribute and/or modify this document
17 under the terms of the GNU Free Documentation License, Version 1.2 or
18 any later version published by the Free Software Foundation; with the
19 Invariant Sections being ``GNU General Public License'' and ``Funding
20 Free Software'', the Front-Cover texts being (a) (see below), and with
21 the Back-Cover Texts being (b) (see below).  A copy of the license is
22 included in the gfdl(7) man page.
23
24 (a) The FSF's Front-Cover Text is:
25
26      A GNU Manual
27
28 (b) The FSF's Back-Cover Text is:
29
30      You have freedom to copy and modify this GNU Manual, like GNU
31      software.  Copies published by the Free Software Foundation raise
32      funds for GNU development.
33 @c man end
34 @c Set file name and title for the man page.
35 @setfilename gcc
36 @settitle GNU project C and C++ compiler
37 @c man begin SYNOPSIS
38 gcc [@option{-c}|@option{-S}|@option{-E}] [@option{-std=}@var{standard}]
39     [@option{-g}] [@option{-pg}] [@option{-O}@var{level}]
40     [@option{-W}@var{warn}@dots{}] [@option{-pedantic}]
41     [@option{-I}@var{dir}@dots{}] [@option{-L}@var{dir}@dots{}]
42     [@option{-D}@var{macro}[=@var{defn}]@dots{}] [@option{-U}@var{macro}]
43     [@option{-f}@var{option}@dots{}] [@option{-m}@var{machine-option}@dots{}]
44     [@option{-o} @var{outfile}] [@@@var{file}] @var{infile}@dots{}
45
46 Only the most useful options are listed here; see below for the
47 remainder.  @samp{g++} accepts mostly the same options as @samp{gcc}.
48 @c man end
49 @c man begin SEEALSO
50 gpl(7), gfdl(7), fsf-funding(7),
51 cpp(1), gcov(1), as(1), ld(1), gdb(1), adb(1), dbx(1), sdb(1)
52 and the Info entries for @file{gcc}, @file{cpp}, @file{as},
53 @file{ld}, @file{binutils} and @file{gdb}.
54 @c man end
55 @c man begin BUGS
56 For instructions on reporting bugs, see
57 @w{@uref{http://gcc.gnu.org/bugs.html}}.
58 @c man end
59 @c man begin AUTHOR
60 See the Info entry for @command{gcc}, or
61 @w{@uref{http://gcc.gnu.org/onlinedocs/gcc/Contributors.html}},
62 for contributors to GCC@.
63 @c man end
64 @end ignore
65
66 @node Invoking GCC
67 @chapter GCC Command Options
68 @cindex GCC command options
69 @cindex command options
70 @cindex options, GCC command
71
72 @c man begin DESCRIPTION
73 When you invoke GCC, it normally does preprocessing, compilation,
74 assembly and linking.  The ``overall options'' allow you to stop this
75 process at an intermediate stage.  For example, the @option{-c} option
76 says not to run the linker.  Then the output consists of object files
77 output by the assembler.
78
79 Other options are passed on to one stage of processing.  Some options
80 control the preprocessor and others the compiler itself.  Yet other
81 options control the assembler and linker; most of these are not
82 documented here, since you rarely need to use any of them.
83
84 @cindex C compilation options
85 Most of the command line options that you can use with GCC are useful
86 for C programs; when an option is only useful with another language
87 (usually C++), the explanation says so explicitly.  If the description
88 for a particular option does not mention a source language, you can use
89 that option with all supported languages.
90
91 @cindex C++ compilation options
92 @xref{Invoking G++,,Compiling C++ Programs}, for a summary of special
93 options for compiling C++ programs.
94
95 @cindex grouping options
96 @cindex options, grouping
97 The @command{gcc} program accepts options and file names as operands.  Many
98 options have multi-letter names; therefore multiple single-letter options
99 may @emph{not} be grouped: @option{-dr} is very different from @w{@samp{-d
100 -r}}.
101
102 @cindex order of options
103 @cindex options, order
104 You can mix options and other arguments.  For the most part, the order
105 you use doesn't matter.  Order does matter when you use several options
106 of the same kind; for example, if you specify @option{-L} more than once,
107 the directories are searched in the order specified.
108
109 Many options have long names starting with @samp{-f} or with
110 @samp{-W}---for example, 
111 @option{-fmove-loop-invariants}, @option{-Wformat} and so on.  Most of
112 these have both positive and negative forms; the negative form of
113 @option{-ffoo} would be @option{-fno-foo}.  This manual documents
114 only one of these two forms, whichever one is not the default.
115
116 @c man end
117
118 @xref{Option Index}, for an index to GCC's options.
119
120 @menu
121 * Option Summary::      Brief list of all options, without explanations.
122 * Overall Options::     Controlling the kind of output:
123                         an executable, object files, assembler files,
124                         or preprocessed source.
125 * Invoking G++::        Compiling C++ programs.
126 * C Dialect Options::   Controlling the variant of C language compiled.
127 * C++ Dialect Options:: Variations on C++.
128 * Objective-C and Objective-C++ Dialect Options:: Variations on Objective-C
129                         and Objective-C++.
130 * Language Independent Options:: Controlling how diagnostics should be
131                         formatted.
132 * Warning Options::     How picky should the compiler be?
133 * Debugging Options::   Symbol tables, measurements, and debugging dumps.
134 * Optimize Options::    How much optimization?
135 * Preprocessor Options:: Controlling header files and macro definitions.
136                          Also, getting dependency information for Make.
137 * Assembler Options::   Passing options to the assembler.
138 * Link Options::        Specifying libraries and so on.
139 * Directory Options::   Where to find header files and libraries.
140                         Where to find the compiler executable files.
141 * Spec Files::          How to pass switches to sub-processes.
142 * Target Options::      Running a cross-compiler, or an old version of GCC.
143 * Submodel Options::    Specifying minor hardware or convention variations,
144                         such as 68010 vs 68020.
145 * Code Gen Options::    Specifying conventions for function calls, data layout
146                         and register usage.
147 * Environment Variables:: Env vars that affect GCC.
148 * Precompiled Headers:: Compiling a header once, and using it many times.
149 * Running Protoize::    Automatically adding or removing function prototypes.
150 @end menu
151
152 @c man begin OPTIONS
153
154 @node Option Summary
155 @section Option Summary
156
157 Here is a summary of all the options, grouped by type.  Explanations are
158 in the following sections.
159
160 @table @emph
161 @item Overall Options
162 @xref{Overall Options,,Options Controlling the Kind of Output}.
163 @gccoptlist{-c  -S  -E  -o @var{file}  -combine  -pipe  -pass-exit-codes  @gol
164 -x @var{language}  -v  -###  --help@r{[}=@var{class}@r{]}  --target-help  @gol 
165 --version @@@var{file}}
166
167 @item C Language Options
168 @xref{C Dialect Options,,Options Controlling C Dialect}.
169 @gccoptlist{-ansi  -std=@var{standard}  -fgnu89-inline @gol
170 -aux-info @var{filename} @gol
171 -fno-asm  -fno-builtin  -fno-builtin-@var{function} @gol
172 -fhosted  -ffreestanding -fopenmp -fms-extensions @gol
173 -trigraphs  -no-integrated-cpp  -traditional  -traditional-cpp @gol
174 -fallow-single-precision  -fcond-mismatch -flax-vector-conversions @gol
175 -fsigned-bitfields  -fsigned-char @gol
176 -funsigned-bitfields  -funsigned-char}
177
178 @item C++ Language Options
179 @xref{C++ Dialect Options,,Options Controlling C++ Dialect}.
180 @gccoptlist{-fabi-version=@var{n}  -fno-access-control  -fcheck-new @gol
181 -fconserve-space  -ffriend-injection @gol
182 -fno-elide-constructors @gol
183 -fno-enforce-eh-specs @gol
184 -ffor-scope  -fno-for-scope  -fno-gnu-keywords @gol
185 -fno-implicit-templates @gol
186 -fno-implicit-inline-templates @gol
187 -fno-implement-inlines  -fms-extensions @gol
188 -fno-nonansi-builtins  -fno-operator-names @gol
189 -fno-optional-diags  -fpermissive @gol
190 -frepo  -fno-rtti  -fstats  -ftemplate-depth-@var{n} @gol
191 -fno-threadsafe-statics -fuse-cxa-atexit  -fno-weak  -nostdinc++ @gol
192 -fno-default-inline  -fvisibility-inlines-hidden @gol
193 -Wabi  -Wctor-dtor-privacy @gol
194 -Wnon-virtual-dtor  -Wreorder @gol
195 -Weffc++  -Wno-deprecated  -Wstrict-null-sentinel @gol
196 -Wno-non-template-friend  -Wold-style-cast @gol
197 -Woverloaded-virtual  -Wno-pmf-conversions @gol
198 -Wsign-promo}
199
200 @item Objective-C and Objective-C++ Language Options
201 @xref{Objective-C and Objective-C++ Dialect Options,,Options Controlling
202 Objective-C and Objective-C++ Dialects}.
203 @gccoptlist{-fconstant-string-class=@var{class-name} @gol
204 -fgnu-runtime  -fnext-runtime @gol
205 -fno-nil-receivers @gol
206 -fobjc-call-cxx-cdtors @gol
207 -fobjc-direct-dispatch @gol
208 -fobjc-exceptions @gol
209 -fobjc-gc @gol
210 -freplace-objc-classes @gol
211 -fzero-link @gol
212 -gen-decls @gol
213 -Wassign-intercept @gol
214 -Wno-protocol  -Wselector @gol
215 -Wstrict-selector-match @gol
216 -Wundeclared-selector}
217
218 @item Language Independent Options
219 @xref{Language Independent Options,,Options to Control Diagnostic Messages Formatting}.
220 @gccoptlist{-fmessage-length=@var{n}  @gol
221 -fdiagnostics-show-location=@r{[}once@r{|}every-line@r{]}  @gol
222 -fdiagnostics-show-option}
223
224 @item Warning Options
225 @xref{Warning Options,,Options to Request or Suppress Warnings}.
226 @gccoptlist{-fsyntax-only  -pedantic  -pedantic-errors @gol
227 -w  -Wextra  -Wall  -Waddress  -Waggregate-return -Warray-bounds @gol
228 -Wno-attributes -Wc++-compat -Wc++0x-compat -Wcast-align  -Wcast-qual  @gol
229 -Wchar-subscripts -Wclobbered  -Wcomment @gol
230 -Wconversion -Wcoverage-mismatch -Wno-deprecated-declarations @gol
231 -Wdisabled-optimization  -Wno-div-by-zero  @gol
232 -Wempty-body  -Wno-endif-labels @gol
233 -Werror  -Werror=* @gol
234 -Wfatal-errors  -Wfloat-equal  -Wformat  -Wformat=2 @gol
235 -Wno-format-extra-args -Wformat-nonliteral @gol
236 -Wformat-security  -Wformat-y2k @gol
237 -Wimplicit  -Wimplicit-function-declaration  -Wimplicit-int @gol
238 -Wimport  -Wno-import  -Winit-self  -Winline @gol
239 -Wno-int-to-pointer-cast -Wno-invalid-offsetof @gol
240 -Winvalid-pch -Wlarger-than-@var{len}  -Wunsafe-loop-optimizations @gol
241 -Wlogical-op -Wlong-long @gol
242 -Wmain  -Wmissing-braces  -Wmissing-field-initializers @gol
243 -Wmissing-format-attribute  -Wmissing-include-dirs @gol
244 -Wmissing-noreturn @gol
245 -Wno-multichar  -Wnonnull  -Wno-overflow @gol
246 -Woverlength-strings  -Wpacked  -Wpadded @gol
247 -Wparentheses  -Wpointer-arith  -Wno-pointer-to-int-cast @gol
248 -Wredundant-decls @gol
249 -Wreturn-type  -Wsequence-point  -Wshadow @gol
250 -Wsign-compare  -Wstack-protector @gol
251 -Wstrict-aliasing -Wstrict-aliasing=2 @gol
252 -Wstrict-overflow -Wstrict-overflow=@var{n} @gol
253 -Wswitch  -Wswitch-default  -Wswitch-enum @gol
254 -Wsystem-headers  -Wtrigraphs  -Wundef  -Wuninitialized @gol
255 -Wunknown-pragmas  -Wno-pragmas -Wunreachable-code @gol
256 -Wunused  -Wunused-function  -Wunused-label  -Wunused-parameter @gol
257 -Wunused-value  -Wunused-variable @gol
258 -Wvariadic-macros -Wvla @gol
259 -Wvolatile-register-var  -Wwrite-strings}
260
261 @item C-only Warning Options
262 @gccoptlist{-Wbad-function-cast  -Wmissing-declarations @gol
263 -Wmissing-parameter-type  -Wmissing-prototypes  -Wnested-externs @gol
264 -Wold-style-declaration  -Wold-style-definition @gol
265 -Wstrict-prototypes  -Wtraditional  -Wtraditional-conversion @gol
266 -Wdeclaration-after-statement -Wpointer-sign}
267
268 @item Debugging Options
269 @xref{Debugging Options,,Options for Debugging Your Program or GCC}.
270 @gccoptlist{-d@var{letters}  -dumpspecs  -dumpmachine  -dumpversion @gol
271 -fdump-noaddr -fdump-unnumbered  -fdump-translation-unit@r{[}-@var{n}@r{]} @gol
272 -fdump-class-hierarchy@r{[}-@var{n}@r{]} @gol
273 -fdump-ipa-all -fdump-ipa-cgraph @gol
274 -fdump-tree-all @gol
275 -fdump-tree-original@r{[}-@var{n}@r{]}  @gol
276 -fdump-tree-optimized@r{[}-@var{n}@r{]} @gol
277 -fdump-tree-inlined@r{[}-@var{n}@r{]} @gol
278 -fdump-tree-cfg -fdump-tree-vcg -fdump-tree-alias @gol
279 -fdump-tree-ch @gol
280 -fdump-tree-ssa@r{[}-@var{n}@r{]} -fdump-tree-pre@r{[}-@var{n}@r{]} @gol
281 -fdump-tree-ccp@r{[}-@var{n}@r{]} -fdump-tree-dce@r{[}-@var{n}@r{]} @gol
282 -fdump-tree-gimple@r{[}-raw@r{]} -fdump-tree-mudflap@r{[}-@var{n}@r{]} @gol
283 -fdump-tree-dom@r{[}-@var{n}@r{]} @gol
284 -fdump-tree-dse@r{[}-@var{n}@r{]} @gol
285 -fdump-tree-phiopt@r{[}-@var{n}@r{]} @gol
286 -fdump-tree-forwprop@r{[}-@var{n}@r{]} @gol
287 -fdump-tree-copyrename@r{[}-@var{n}@r{]} @gol
288 -fdump-tree-nrv -fdump-tree-vect @gol
289 -fdump-tree-sink @gol
290 -fdump-tree-sra@r{[}-@var{n}@r{]} @gol
291 -fdump-tree-salias @gol
292 -fdump-tree-fre@r{[}-@var{n}@r{]} @gol
293 -fdump-tree-vrp@r{[}-@var{n}@r{]} @gol
294 -ftree-vectorizer-verbose=@var{n} @gol
295 -fdump-tree-storeccp@r{[}-@var{n}@r{]} @gol
296 -feliminate-dwarf2-dups -feliminate-unused-debug-types @gol
297 -feliminate-unused-debug-symbols -femit-class-debug-always @gol
298 -fmem-report -fpre-ipa-mem-report -fpost-ipa-mem-report -fprofile-arcs @gol
299 -frandom-seed=@var{string} -fsched-verbose=@var{n} @gol
300 -ftest-coverage  -ftime-report -fvar-tracking @gol
301 -g  -g@var{level}  -gcoff -gdwarf-2 @gol
302 -ggdb  -gstabs  -gstabs+  -gvms  -gxcoff  -gxcoff+ @gol
303 -p  -pg  -print-file-name=@var{library}  -print-libgcc-file-name @gol
304 -print-multi-directory  -print-multi-lib @gol
305 -print-prog-name=@var{program}  -print-search-dirs  -Q @gol
306 -print-sysroot-headers-suffix @gol
307 -save-temps  -time}
308
309 @item Optimization Options
310 @xref{Optimize Options,,Options that Control Optimization}.
311 @gccoptlist{-falign-functions=@var{n}  -falign-jumps=@var{n} @gol
312 -falign-labels=@var{n}  -falign-loops=@var{n}  @gol
313 -fbounds-check -fmudflap -fmudflapth -fmudflapir @gol
314 -fbranch-probabilities -fprofile-values -fvpt -fbranch-target-load-optimize @gol
315 -fbranch-target-load-optimize2 -fbtr-bb-exclusive @gol
316 -fcaller-saves  -fcprop-registers  -fcse-follow-jumps @gol
317 -fcse-skip-blocks  -fcx-limited-range  -fdata-sections @gol
318 -fdelayed-branch  -fdelete-null-pointer-checks -fearly-inlining @gol
319 -fexpensive-optimizations  -ffast-math  -ffloat-store @gol
320 -fforce-addr  -fforward-propagate  -ffunction-sections @gol
321 -fgcse  -fgcse-lm  -fgcse-sm  -fgcse-las  -fgcse-after-reload @gol
322 -fcrossjumping  -fif-conversion  -fif-conversion2 @gol
323 -finline-functions  -finline-functions-called-once @gol
324 -finline-limit=@var{n}  -fkeep-inline-functions @gol
325 -fkeep-static-consts  -fmerge-constants  -fmerge-all-constants @gol
326 -fmodulo-sched -fno-branch-count-reg @gol
327 -fno-default-inline  -fno-defer-pop -fmove-loop-invariants @gol
328 -fno-function-cse  -fno-guess-branch-probability @gol
329 -fno-inline  -fno-math-errno  -fno-peephole  -fno-peephole2 @gol
330 -funsafe-math-optimizations  -funsafe-loop-optimizations @gol
331 -ffinite-math-only  -fno-signed-zeros @gol
332 -fno-toplevel-reorder -fno-trapping-math  -fno-zero-initialized-in-bss @gol
333 -fomit-frame-pointer  -foptimize-register-move @gol
334 -foptimize-sibling-calls  -fprefetch-loop-arrays @gol
335 -fprofile-generate -fprofile-use @gol
336 -fregmove  -frename-registers @gol
337 -freorder-blocks  -freorder-blocks-and-partition -freorder-functions @gol
338 -frerun-cse-after-loop @gol
339 -frounding-math -frtl-abstract-sequences @gol
340 -fschedule-insns  -fschedule-insns2 @gol
341 -fno-sched-interblock  -fno-sched-spec  -fsched-spec-load @gol
342 -fsched-spec-load-dangerous  @gol
343 -fsched-stalled-insns=@var{n} -fsched-stalled-insns-dep=@var{n} @gol
344 -fsched2-use-superblocks @gol
345 -fsched2-use-traces -fsee -freschedule-modulo-scheduled-loops @gol
346 -fsection-anchors  -fsignaling-nans  -fsingle-precision-constant @gol
347 -fno-split-wide-types -fstack-protector  -fstack-protector-all @gol
348 -fstrict-aliasing  -fstrict-overflow  -ftracer  -fthread-jumps @gol
349 -funroll-all-loops  -funroll-loops  -fpeel-loops @gol
350 -fsplit-ivs-in-unroller -funswitch-loops @gol
351 -fvariable-expansion-in-unroller @gol
352 -ftree-pre  -ftree-ccp  -ftree-dce -ftree-loop-optimize @gol
353 -ftree-loop-linear -ftree-loop-im -ftree-loop-ivcanon -fivopts @gol
354 -fcheck-data-deps @gol
355 -ftree-dominator-opts -ftree-dse -ftree-copyrename -ftree-sink @gol
356 -ftree-ch -ftree-sra -ftree-ter -ftree-fre -ftree-vectorize @gol
357 -ftree-vect-loop-version -ftree-salias -fipa-pta -fweb @gol
358 -ftree-copy-prop -ftree-store-ccp -ftree-store-copy-prop -fwhole-program @gol
359 --param @var{name}=@var{value}
360 -O  -O0  -O1  -O2  -O3  -Os}
361
362 @item Preprocessor Options
363 @xref{Preprocessor Options,,Options Controlling the Preprocessor}.
364 @gccoptlist{-A@var{question}=@var{answer} @gol
365 -A-@var{question}@r{[}=@var{answer}@r{]} @gol
366 -C  -dD  -dI  -dM  -dN @gol
367 -D@var{macro}@r{[}=@var{defn}@r{]}  -E  -H @gol
368 -idirafter @var{dir} @gol
369 -include @var{file}  -imacros @var{file} @gol
370 -iprefix @var{file}  -iwithprefix @var{dir} @gol
371 -iwithprefixbefore @var{dir}  -isystem @var{dir} @gol
372 -imultilib @var{dir} -isysroot @var{dir} @gol
373 -M  -MM  -MF  -MG  -MP  -MQ  -MT  -nostdinc  @gol
374 -P  -fworking-directory  -remap @gol
375 -trigraphs  -undef  -U@var{macro}  -Wp,@var{option} @gol
376 -Xpreprocessor @var{option}}
377
378 @item Assembler Option
379 @xref{Assembler Options,,Passing Options to the Assembler}.
380 @gccoptlist{-Wa,@var{option}  -Xassembler @var{option}}
381
382 @item Linker Options
383 @xref{Link Options,,Options for Linking}.
384 @gccoptlist{@var{object-file-name}  -l@var{library} @gol
385 -nostartfiles  -nodefaultlibs  -nostdlib -pie -rdynamic @gol
386 -s  -static  -static-libgcc  -shared  -shared-libgcc  -symbolic @gol
387 -Wl,@var{option}  -Xlinker @var{option} @gol
388 -u @var{symbol}}
389
390 @item Directory Options
391 @xref{Directory Options,,Options for Directory Search}.
392 @gccoptlist{-B@var{prefix}  -I@var{dir}  -iquote@var{dir}  -L@var{dir}
393 -specs=@var{file}  -I- --sysroot=@var{dir}}
394
395 @item Target Options
396 @c I wrote this xref this way to avoid overfull hbox. -- rms
397 @xref{Target Options}.
398 @gccoptlist{-V @var{version}  -b @var{machine}}
399
400 @item Machine Dependent Options
401 @xref{Submodel Options,,Hardware Models and Configurations}.
402 @c This list is ordered alphanumerically by subsection name.
403 @c Try and put the significant identifier (CPU or system) first,
404 @c so users have a clue at guessing where the ones they want will be.
405
406 @emph{ARC Options}
407 @gccoptlist{-EB  -EL @gol
408 -mmangle-cpu  -mcpu=@var{cpu}  -mtext=@var{text-section} @gol
409 -mdata=@var{data-section}  -mrodata=@var{readonly-data-section}}
410
411 @emph{ARM Options}
412 @gccoptlist{-mapcs-frame  -mno-apcs-frame @gol
413 -mabi=@var{name} @gol
414 -mapcs-stack-check  -mno-apcs-stack-check @gol
415 -mapcs-float  -mno-apcs-float @gol
416 -mapcs-reentrant  -mno-apcs-reentrant @gol
417 -msched-prolog  -mno-sched-prolog @gol
418 -mlittle-endian  -mbig-endian  -mwords-little-endian @gol
419 -mfloat-abi=@var{name}  -msoft-float  -mhard-float  -mfpe @gol
420 -mthumb-interwork  -mno-thumb-interwork @gol
421 -mcpu=@var{name}  -march=@var{name}  -mfpu=@var{name}  @gol
422 -mstructure-size-boundary=@var{n} @gol
423 -mabort-on-noreturn @gol
424 -mlong-calls  -mno-long-calls @gol
425 -msingle-pic-base  -mno-single-pic-base @gol
426 -mpic-register=@var{reg} @gol
427 -mnop-fun-dllimport @gol
428 -mcirrus-fix-invalid-insns -mno-cirrus-fix-invalid-insns @gol
429 -mpoke-function-name @gol
430 -mthumb  -marm @gol
431 -mtpcs-frame  -mtpcs-leaf-frame @gol
432 -mcaller-super-interworking  -mcallee-super-interworking @gol
433 -mtp=@var{name}}
434
435 @emph{AVR Options}
436 @gccoptlist{-mmcu=@var{mcu}  -msize  -minit-stack=@var{n}  -mno-interrupts @gol
437 -mcall-prologues  -mno-tablejump  -mtiny-stack  -mint8}
438
439 @emph{Blackfin Options}
440 @gccoptlist{-momit-leaf-frame-pointer -mno-omit-leaf-frame-pointer @gol
441 -mspecld-anomaly -mno-specld-anomaly -mcsync-anomaly -mno-csync-anomaly @gol
442 -mlow-64k  -mno-low64k  -mstack-check-l1  -mid-shared-library @gol
443 -mno-id-shared-library -mshared-library-id=@var{n} @gol
444 -mleaf-id-shared-library  -mno-leaf-id-shared-library @gol
445 -msep-data  -mno-sep-data  -mlong-calls  -mno-long-calls}
446
447 @emph{CRIS Options}
448 @gccoptlist{-mcpu=@var{cpu}  -march=@var{cpu}  -mtune=@var{cpu} @gol
449 -mmax-stack-frame=@var{n}  -melinux-stacksize=@var{n} @gol
450 -metrax4  -metrax100  -mpdebug  -mcc-init  -mno-side-effects @gol
451 -mstack-align  -mdata-align  -mconst-align @gol
452 -m32-bit  -m16-bit  -m8-bit  -mno-prologue-epilogue  -mno-gotplt @gol
453 -melf  -maout  -melinux  -mlinux  -sim  -sim2 @gol
454 -mmul-bug-workaround  -mno-mul-bug-workaround}
455
456 @emph{CRX Options}
457 @gccoptlist{-mmac -mpush-args}
458
459 @emph{Darwin Options}
460 @gccoptlist{-all_load  -allowable_client  -arch  -arch_errors_fatal @gol
461 -arch_only  -bind_at_load  -bundle  -bundle_loader @gol
462 -client_name  -compatibility_version  -current_version @gol
463 -dead_strip @gol
464 -dependency-file  -dylib_file  -dylinker_install_name @gol
465 -dynamic  -dynamiclib  -exported_symbols_list @gol
466 -filelist  -flat_namespace  -force_cpusubtype_ALL @gol
467 -force_flat_namespace  -headerpad_max_install_names @gol
468 -iframework @gol
469 -image_base  -init  -install_name  -keep_private_externs @gol
470 -multi_module  -multiply_defined  -multiply_defined_unused @gol
471 -noall_load   -no_dead_strip_inits_and_terms @gol
472 -nofixprebinding -nomultidefs  -noprebind  -noseglinkedit @gol
473 -pagezero_size  -prebind  -prebind_all_twolevel_modules @gol
474 -private_bundle  -read_only_relocs  -sectalign @gol
475 -sectobjectsymbols  -whyload  -seg1addr @gol
476 -sectcreate  -sectobjectsymbols  -sectorder @gol
477 -segaddr -segs_read_only_addr -segs_read_write_addr @gol
478 -seg_addr_table  -seg_addr_table_filename  -seglinkedit @gol
479 -segprot  -segs_read_only_addr  -segs_read_write_addr @gol
480 -single_module  -static  -sub_library  -sub_umbrella @gol
481 -twolevel_namespace  -umbrella  -undefined @gol
482 -unexported_symbols_list  -weak_reference_mismatches @gol
483 -whatsloaded -F -gused -gfull -mmacosx-version-min=@var{version} @gol
484 -mkernel -mone-byte-bool}
485
486 @emph{DEC Alpha Options}
487 @gccoptlist{-mno-fp-regs  -msoft-float  -malpha-as  -mgas @gol
488 -mieee  -mieee-with-inexact  -mieee-conformant @gol
489 -mfp-trap-mode=@var{mode}  -mfp-rounding-mode=@var{mode} @gol
490 -mtrap-precision=@var{mode}  -mbuild-constants @gol
491 -mcpu=@var{cpu-type}  -mtune=@var{cpu-type} @gol
492 -mbwx  -mmax  -mfix  -mcix @gol
493 -mfloat-vax  -mfloat-ieee @gol
494 -mexplicit-relocs  -msmall-data  -mlarge-data @gol
495 -msmall-text  -mlarge-text @gol
496 -mmemory-latency=@var{time}}
497
498 @emph{DEC Alpha/VMS Options}
499 @gccoptlist{-mvms-return-codes}
500
501 @emph{FRV Options}
502 @gccoptlist{-mgpr-32  -mgpr-64  -mfpr-32  -mfpr-64 @gol
503 -mhard-float  -msoft-float @gol
504 -malloc-cc  -mfixed-cc  -mdword  -mno-dword @gol
505 -mdouble  -mno-double @gol
506 -mmedia  -mno-media  -mmuladd  -mno-muladd @gol
507 -mfdpic  -minline-plt -mgprel-ro  -multilib-library-pic @gol
508 -mlinked-fp  -mlong-calls  -malign-labels @gol
509 -mlibrary-pic  -macc-4  -macc-8 @gol
510 -mpack  -mno-pack  -mno-eflags  -mcond-move  -mno-cond-move @gol
511 -moptimize-membar -mno-optimize-membar @gol
512 -mscc  -mno-scc  -mcond-exec  -mno-cond-exec @gol
513 -mvliw-branch  -mno-vliw-branch @gol
514 -mmulti-cond-exec  -mno-multi-cond-exec  -mnested-cond-exec @gol
515 -mno-nested-cond-exec  -mtomcat-stats @gol
516 -mTLS -mtls @gol
517 -mcpu=@var{cpu}}
518
519 @emph{GNU/Linux Options}
520 @gccoptlist{-muclibc}
521
522 @emph{H8/300 Options}
523 @gccoptlist{-mrelax  -mh  -ms  -mn  -mint32  -malign-300}
524
525 @emph{HPPA Options}
526 @gccoptlist{-march=@var{architecture-type} @gol
527 -mbig-switch  -mdisable-fpregs  -mdisable-indexing @gol
528 -mfast-indirect-calls  -mgas  -mgnu-ld   -mhp-ld @gol
529 -mfixed-range=@var{register-range} @gol
530 -mjump-in-delay -mlinker-opt -mlong-calls @gol
531 -mlong-load-store  -mno-big-switch  -mno-disable-fpregs @gol
532 -mno-disable-indexing  -mno-fast-indirect-calls  -mno-gas @gol
533 -mno-jump-in-delay  -mno-long-load-store @gol
534 -mno-portable-runtime  -mno-soft-float @gol
535 -mno-space-regs  -msoft-float  -mpa-risc-1-0 @gol
536 -mpa-risc-1-1  -mpa-risc-2-0  -mportable-runtime @gol
537 -mschedule=@var{cpu-type}  -mspace-regs  -msio  -mwsio @gol
538 -munix=@var{unix-std}  -nolibdld  -static  -threads}
539
540 @emph{i386 and x86-64 Options}
541 @gccoptlist{-mtune=@var{cpu-type}  -march=@var{cpu-type} @gol
542 -mfpmath=@var{unit} @gol
543 -masm=@var{dialect}  -mno-fancy-math-387 @gol
544 -mno-fp-ret-in-387  -msoft-float  -msvr3-shlib @gol
545 -mno-wide-multiply  -mrtd  -malign-double @gol
546 -mpreferred-stack-boundary=@var{num} -mcx16 -msahf @gol
547 -mmmx  -msse  -msse2 -msse3 -mssse3 -msse4a -m3dnow -mpopcnt -mabm @gol
548 -mthreads  -mno-align-stringops  -minline-all-stringops @gol
549 -mpush-args  -maccumulate-outgoing-args  -m128bit-long-double @gol
550 -m96bit-long-double  -mregparm=@var{num}  -msseregparm @gol
551 -mstackrealign @gol
552 -momit-leaf-frame-pointer  -mno-red-zone -mno-tls-direct-seg-refs @gol
553 -mcmodel=@var{code-model} @gol
554 -m32  -m64 -mlarge-data-threshold=@var{num}}
555
556 @emph{IA-64 Options}
557 @gccoptlist{-mbig-endian  -mlittle-endian  -mgnu-as  -mgnu-ld  -mno-pic @gol
558 -mvolatile-asm-stop  -mregister-names  -mno-sdata @gol
559 -mconstant-gp  -mauto-pic  -minline-float-divide-min-latency @gol
560 -minline-float-divide-max-throughput @gol
561 -minline-int-divide-min-latency @gol
562 -minline-int-divide-max-throughput  @gol
563 -minline-sqrt-min-latency -minline-sqrt-max-throughput @gol
564 -mno-dwarf2-asm -mearly-stop-bits @gol
565 -mfixed-range=@var{register-range} -mtls-size=@var{tls-size} @gol
566 -mtune=@var{cpu-type} -mt -pthread -milp32 -mlp64 @gol
567 -mno-sched-br-data-spec -msched-ar-data-spec -mno-sched-control-spec @gol
568 -msched-br-in-data-spec -msched-ar-in-data-spec -msched-in-control-spec @gol
569 -msched-ldc -mno-sched-control-ldc -mno-sched-spec-verbose @gol
570 -mno-sched-prefer-non-data-spec-insns @gol
571 -mno-sched-prefer-non-control-spec-insns @gol
572 -mno-sched-count-spec-in-critical-path}
573
574 @emph{M32R/D Options}
575 @gccoptlist{-m32r2 -m32rx -m32r @gol
576 -mdebug @gol
577 -malign-loops -mno-align-loops @gol
578 -missue-rate=@var{number} @gol
579 -mbranch-cost=@var{number} @gol
580 -mmodel=@var{code-size-model-type} @gol
581 -msdata=@var{sdata-type} @gol
582 -mno-flush-func -mflush-func=@var{name} @gol
583 -mno-flush-trap -mflush-trap=@var{number} @gol
584 -G @var{num}}
585
586 @emph{M32C Options}
587 @gccoptlist{-mcpu=@var{cpu} -msim -memregs=@var{number}}
588
589 @emph{M680x0 Options}
590 @gccoptlist{-march=@var{arch}  -mcpu=@var{cpu}  -mtune=@var{tune}
591 -m68000  -m68020  -m68020-40  -m68020-60  -m68030  -m68040 @gol
592 -m68060  -mcpu32  -m5200  -m5206e  -m528x  -m5307  -m5407 @gol
593 -mcfv4e  -mbitfield  -mno-bitfield  -mc68000  -mc68020 @gol
594 -mnobitfield  -mrtd  -mno-rtd  -mdiv  -mno-div  -mshort @gol
595 -mno-short  -mhard-float  -m68881  -msoft-float  -mpcrel @gol
596 -malign-int  -mstrict-align  -msep-data  -mno-sep-data @gol
597 -mshared-library-id=n  -mid-shared-library  -mno-id-shared-library}
598
599 @emph{M68hc1x Options}
600 @gccoptlist{-m6811  -m6812  -m68hc11  -m68hc12   -m68hcs12 @gol
601 -mauto-incdec  -minmax  -mlong-calls  -mshort @gol
602 -msoft-reg-count=@var{count}}
603
604 @emph{MCore Options}
605 @gccoptlist{-mhardlit  -mno-hardlit  -mdiv  -mno-div  -mrelax-immediates @gol
606 -mno-relax-immediates  -mwide-bitfields  -mno-wide-bitfields @gol
607 -m4byte-functions  -mno-4byte-functions  -mcallgraph-data @gol
608 -mno-callgraph-data  -mslow-bytes  -mno-slow-bytes  -mno-lsim @gol
609 -mlittle-endian  -mbig-endian  -m210  -m340  -mstack-increment}
610
611 @emph{MIPS Options}
612 @gccoptlist{-EL  -EB  -march=@var{arch}  -mtune=@var{arch} @gol
613 -mips1  -mips2  -mips3  -mips4  -mips32  -mips32r2  -mips64 @gol
614 -mips16  -mno-mips16  -mabi=@var{abi}  -mabicalls  -mno-abicalls @gol
615 -mshared  -mno-shared  -mxgot  -mno-xgot  -mgp32  -mgp64  @gol
616 -mfp32  -mfp64  -mhard-float  -msoft-float  @gol
617 -msingle-float  -mdouble-float  -mdsp  -mdspr2  -mpaired-single  -mips3d @gol
618 -mlong64  -mlong32  -msym32  -mno-sym32 @gol
619 -G@var{num}  -membedded-data  -mno-embedded-data @gol
620 -muninit-const-in-rodata  -mno-uninit-const-in-rodata @gol
621 -msplit-addresses  -mno-split-addresses  @gol
622 -mexplicit-relocs  -mno-explicit-relocs  @gol
623 -mcheck-zero-division  -mno-check-zero-division @gol
624 -mdivide-traps  -mdivide-breaks @gol
625 -mmemcpy  -mno-memcpy  -mlong-calls  -mno-long-calls @gol
626 -mmad  -mno-mad  -mfused-madd  -mno-fused-madd  -nocpp @gol
627 -mfix-r4000  -mno-fix-r4000  -mfix-r4400  -mno-fix-r4400 @gol
628 -mfix-vr4120  -mno-fix-vr4120  -mfix-vr4130 @gol
629 -mfix-sb1  -mno-fix-sb1 @gol
630 -mflush-func=@var{func}  -mno-flush-func @gol
631 -mbranch-likely  -mno-branch-likely @gol
632 -mfp-exceptions -mno-fp-exceptions @gol
633 -mvr4130-align -mno-vr4130-align}
634
635 @emph{MMIX Options}
636 @gccoptlist{-mlibfuncs  -mno-libfuncs  -mepsilon  -mno-epsilon  -mabi=gnu @gol
637 -mabi=mmixware  -mzero-extend  -mknuthdiv  -mtoplevel-symbols @gol
638 -melf  -mbranch-predict  -mno-branch-predict  -mbase-addresses @gol
639 -mno-base-addresses  -msingle-exit  -mno-single-exit}
640
641 @emph{MN10300 Options}
642 @gccoptlist{-mmult-bug  -mno-mult-bug @gol
643 -mam33  -mno-am33 @gol
644 -mam33-2  -mno-am33-2 @gol
645 -mreturn-pointer-on-d0 @gol
646 -mno-crt0  -mrelax}
647
648 @emph{MT Options}
649 @gccoptlist{-mno-crt0 -mbacc -msim @gol
650 -march=@var{cpu-type} }
651
652 @emph{PDP-11 Options}
653 @gccoptlist{-mfpu  -msoft-float  -mac0  -mno-ac0  -m40  -m45  -m10 @gol
654 -mbcopy  -mbcopy-builtin  -mint32  -mno-int16 @gol
655 -mint16  -mno-int32  -mfloat32  -mno-float64 @gol
656 -mfloat64  -mno-float32  -mabshi  -mno-abshi @gol
657 -mbranch-expensive  -mbranch-cheap @gol
658 -msplit  -mno-split  -munix-asm  -mdec-asm}
659
660 @emph{PowerPC Options}
661 See RS/6000 and PowerPC Options.
662
663 @emph{RS/6000 and PowerPC Options}
664 @gccoptlist{-mcpu=@var{cpu-type} @gol
665 -mtune=@var{cpu-type} @gol
666 -mpower  -mno-power  -mpower2  -mno-power2 @gol
667 -mpowerpc  -mpowerpc64  -mno-powerpc @gol
668 -maltivec  -mno-altivec @gol
669 -mpowerpc-gpopt  -mno-powerpc-gpopt @gol
670 -mpowerpc-gfxopt  -mno-powerpc-gfxopt @gol
671 -mmfcrf  -mno-mfcrf  -mpopcntb  -mno-popcntb  -mfprnd  -mno-fprnd @gol
672 -mcmpb -mno-cmpb -mmfpgpr -mno-mfpgpr -mdfp -mno-dfp @gol
673 -mnew-mnemonics  -mold-mnemonics @gol
674 -mfull-toc   -mminimal-toc  -mno-fp-in-toc  -mno-sum-in-toc @gol
675 -m64  -m32  -mxl-compat  -mno-xl-compat  -mpe @gol
676 -malign-power  -malign-natural @gol
677 -msoft-float  -mhard-float  -mmultiple  -mno-multiple @gol
678 -mstring  -mno-string  -mupdate  -mno-update @gol
679 -mfused-madd  -mno-fused-madd  -mbit-align  -mno-bit-align @gol
680 -mstrict-align  -mno-strict-align  -mrelocatable @gol
681 -mno-relocatable  -mrelocatable-lib  -mno-relocatable-lib @gol
682 -mtoc  -mno-toc  -mlittle  -mlittle-endian  -mbig  -mbig-endian @gol
683 -mdynamic-no-pic  -maltivec  -mswdiv @gol
684 -mprioritize-restricted-insns=@var{priority} @gol
685 -msched-costly-dep=@var{dependence_type} @gol
686 -minsert-sched-nops=@var{scheme} @gol
687 -mcall-sysv  -mcall-netbsd @gol
688 -maix-struct-return  -msvr4-struct-return @gol
689 -mabi=@var{abi-type} -msecure-plt -mbss-plt @gol
690 -misel -mno-isel @gol
691 -misel=yes  -misel=no @gol
692 -mspe -mno-spe @gol
693 -mspe=yes  -mspe=no @gol
694 -mvrsave -mno-vrsave @gol
695 -mmulhw -mno-mulhw @gol
696 -mdlmzb -mno-dlmzb @gol
697 -mfloat-gprs=yes  -mfloat-gprs=no -mfloat-gprs=single -mfloat-gprs=double @gol
698 -mprototype  -mno-prototype @gol
699 -msim  -mmvme  -mads  -myellowknife  -memb  -msdata @gol
700 -msdata=@var{opt}  -mvxworks  -mwindiss  -G @var{num}  -pthread}
701
702 @emph{S/390 and zSeries Options}
703 @gccoptlist{-mtune=@var{cpu-type}  -march=@var{cpu-type} @gol
704 -mhard-float  -msoft-float -mlong-double-64 -mlong-double-128 @gol
705 -mbackchain  -mno-backchain -mpacked-stack  -mno-packed-stack @gol
706 -msmall-exec  -mno-small-exec  -mmvcle -mno-mvcle @gol
707 -m64  -m31  -mdebug  -mno-debug  -mesa  -mzarch @gol
708 -mtpf-trace -mno-tpf-trace  -mfused-madd  -mno-fused-madd @gol
709 -mwarn-framesize  -mwarn-dynamicstack  -mstack-size -mstack-guard}
710
711 @emph{Score Options}
712 @gccoptlist{-mel -mel @gol
713 -mmac @gol
714 -mscore5u -mscore7}
715  
716 @emph{SH Options}
717 @gccoptlist{-m1  -m2  -m2e  -m3  -m3e @gol
718 -m4-nofpu  -m4-single-only  -m4-single  -m4 @gol
719 -m4a-nofpu -m4a-single-only -m4a-single -m4a -m4al @gol
720 -m5-64media  -m5-64media-nofpu @gol
721 -m5-32media  -m5-32media-nofpu @gol
722 -m5-compact  -m5-compact-nofpu @gol
723 -mb  -ml  -mdalign  -mrelax @gol
724 -mbigtable  -mfmovd  -mhitachi -mrenesas -mno-renesas -mnomacsave @gol
725 -mieee  -misize  -minline-ic_invalidate -mpadstruct  -mspace @gol
726 -mprefergot  -musermode -multcost=@var{number} -mdiv=@var{strategy} @gol
727 -mdivsi3_libfunc=@var{name}  @gol
728 -madjust-unroll -mindexed-addressing -mgettrcost=@var{number} -mpt-fixed @gol
729  -minvalid-symbols}
730
731 @emph{SPARC Options}
732 @gccoptlist{-mcpu=@var{cpu-type} @gol
733 -mtune=@var{cpu-type} @gol
734 -mcmodel=@var{code-model} @gol
735 -m32  -m64  -mapp-regs  -mno-app-regs @gol
736 -mfaster-structs  -mno-faster-structs @gol
737 -mfpu  -mno-fpu  -mhard-float  -msoft-float @gol
738 -mhard-quad-float  -msoft-quad-float @gol
739 -mimpure-text  -mno-impure-text  -mlittle-endian @gol
740 -mstack-bias  -mno-stack-bias @gol
741 -munaligned-doubles  -mno-unaligned-doubles @gol
742 -mv8plus  -mno-v8plus  -mvis  -mno-vis
743 -threads -pthreads -pthread}
744
745 @emph{SPU Options}
746 @gccoptlist{-mwarn-reloc -merror-reloc @gol
747 -msafe-dma -munsafe-dma @gol
748 -mbranch-hints @gol
749 -msmall-mem -mlarge-mem -mstdmain @gol
750 -mfixed-range=@var{register-range}}
751
752 @emph{System V Options}
753 @gccoptlist{-Qy  -Qn  -YP,@var{paths}  -Ym,@var{dir}}
754
755 @emph{TMS320C3x/C4x Options}
756 @gccoptlist{-mcpu=@var{cpu}  -mbig  -msmall  -mregparm  -mmemparm @gol
757 -mfast-fix  -mmpyi  -mbk  -mti  -mdp-isr-reload @gol
758 -mrpts=@var{count}  -mrptb  -mdb  -mloop-unsigned @gol
759 -mparallel-insns  -mparallel-mpy  -mpreserve-float}
760
761 @emph{V850 Options}
762 @gccoptlist{-mlong-calls  -mno-long-calls  -mep  -mno-ep @gol
763 -mprolog-function  -mno-prolog-function  -mspace @gol
764 -mtda=@var{n}  -msda=@var{n}  -mzda=@var{n} @gol
765 -mapp-regs  -mno-app-regs @gol
766 -mdisable-callt  -mno-disable-callt @gol
767 -mv850e1 @gol
768 -mv850e @gol
769 -mv850  -mbig-switch}
770
771 @emph{VAX Options}
772 @gccoptlist{-mg  -mgnu  -munix}
773
774 @emph{VxWorks Options}
775 @gccoptlist{-mrtp  -non-static  -Bstatic  -Bdynamic @gol
776 -Xbind-lazy  -Xbind-now}
777
778 @emph{x86-64 Options}
779 See i386 and x86-64 Options.
780
781 @emph{Xstormy16 Options}
782 @gccoptlist{-msim}
783
784 @emph{Xtensa Options}
785 @gccoptlist{-mconst16 -mno-const16 @gol
786 -mfused-madd  -mno-fused-madd @gol
787 -mtext-section-literals  -mno-text-section-literals @gol
788 -mtarget-align  -mno-target-align @gol
789 -mlongcalls  -mno-longcalls}
790
791 @emph{zSeries Options}
792 See S/390 and zSeries Options.
793
794 @item Code Generation Options
795 @xref{Code Gen Options,,Options for Code Generation Conventions}.
796 @gccoptlist{-fcall-saved-@var{reg}  -fcall-used-@var{reg} @gol
797 -ffixed-@var{reg}  -fexceptions @gol
798 -fnon-call-exceptions  -funwind-tables @gol
799 -fasynchronous-unwind-tables @gol
800 -finhibit-size-directive  -finstrument-functions @gol
801 -fno-common  -fno-ident @gol
802 -fpcc-struct-return  -fpic  -fPIC -fpie -fPIE @gol
803 -fno-jump-tables @gol
804 -frecord-gcc-switches @gol
805 -freg-struct-return  -fshort-enums @gol
806 -fshort-double  -fshort-wchar @gol
807 -fverbose-asm  -fpack-struct[=@var{n}]  -fstack-check @gol
808 -fstack-limit-register=@var{reg}  -fstack-limit-symbol=@var{sym} @gol
809 -fargument-alias  -fargument-noalias @gol
810 -fargument-noalias-global  -fargument-noalias-anything
811 -fleading-underscore  -ftls-model=@var{model} @gol
812 -ftrapv  -fwrapv  -fbounds-check @gol
813 -fvisibility}
814 @end table
815
816 @menu
817 * Overall Options::     Controlling the kind of output:
818                         an executable, object files, assembler files,
819                         or preprocessed source.
820 * C Dialect Options::   Controlling the variant of C language compiled.
821 * C++ Dialect Options:: Variations on C++.
822 * Objective-C and Objective-C++ Dialect Options:: Variations on Objective-C
823                         and Objective-C++.
824 * Language Independent Options:: Controlling how diagnostics should be
825                         formatted.
826 * Warning Options::     How picky should the compiler be?
827 * Debugging Options::   Symbol tables, measurements, and debugging dumps.
828 * Optimize Options::    How much optimization?
829 * Preprocessor Options:: Controlling header files and macro definitions.
830                          Also, getting dependency information for Make.
831 * Assembler Options::   Passing options to the assembler.
832 * Link Options::        Specifying libraries and so on.
833 * Directory Options::   Where to find header files and libraries.
834                         Where to find the compiler executable files.
835 * Spec Files::          How to pass switches to sub-processes.
836 * Target Options::      Running a cross-compiler, or an old version of GCC.
837 @end menu
838
839 @node Overall Options
840 @section Options Controlling the Kind of Output
841
842 Compilation can involve up to four stages: preprocessing, compilation
843 proper, assembly and linking, always in that order.  GCC is capable of
844 preprocessing and compiling several files either into several
845 assembler input files, or into one assembler input file; then each
846 assembler input file produces an object file, and linking combines all
847 the object files (those newly compiled, and those specified as input)
848 into an executable file.
849
850 @cindex file name suffix
851 For any given input file, the file name suffix determines what kind of
852 compilation is done:
853
854 @table @gcctabopt
855 @item @var{file}.c
856 C source code which must be preprocessed.
857
858 @item @var{file}.i
859 C source code which should not be preprocessed.
860
861 @item @var{file}.ii
862 C++ source code which should not be preprocessed.
863
864 @item @var{file}.m
865 Objective-C source code.  Note that you must link with the @file{libobjc}
866 library to make an Objective-C program work.
867
868 @item @var{file}.mi
869 Objective-C source code which should not be preprocessed.
870
871 @item @var{file}.mm
872 @itemx @var{file}.M
873 Objective-C++ source code.  Note that you must link with the @file{libobjc}
874 library to make an Objective-C++ program work.  Note that @samp{.M} refers
875 to a literal capital M@.
876
877 @item @var{file}.mii
878 Objective-C++ source code which should not be preprocessed.
879
880 @item @var{file}.h
881 C, C++, Objective-C or Objective-C++ header file to be turned into a
882 precompiled header.
883
884 @item @var{file}.cc
885 @itemx @var{file}.cp
886 @itemx @var{file}.cxx
887 @itemx @var{file}.cpp
888 @itemx @var{file}.CPP
889 @itemx @var{file}.c++
890 @itemx @var{file}.C
891 C++ source code which must be preprocessed.  Note that in @samp{.cxx},
892 the last two letters must both be literally @samp{x}.  Likewise,
893 @samp{.C} refers to a literal capital C@.
894
895 @item @var{file}.mm
896 @itemx @var{file}.M
897 Objective-C++ source code which must be preprocessed.
898
899 @item @var{file}.mii
900 Objective-C++ source code which should not be preprocessed.
901
902 @item @var{file}.hh
903 @itemx @var{file}.H
904 C++ header file to be turned into a precompiled header.
905
906 @item @var{file}.f
907 @itemx @var{file}.for
908 @itemx @var{file}.FOR
909 Fixed form Fortran source code which should not be preprocessed.
910
911 @item @var{file}.F
912 @itemx @var{file}.fpp
913 @itemx @var{file}.FPP
914 Fixed form Fortran source code which must be preprocessed (with the traditional
915 preprocessor).
916
917 @item @var{file}.f90
918 @itemx @var{file}.f95
919 Free form Fortran source code which should not be preprocessed.
920
921 @item @var{file}.F90
922 @itemx @var{file}.F95
923 Free form Fortran source code which must be preprocessed (with the
924 traditional preprocessor).
925
926 @c FIXME: Descriptions of Java file types.
927 @c @var{file}.java
928 @c @var{file}.class
929 @c @var{file}.zip
930 @c @var{file}.jar
931
932 @item @var{file}.ads
933 Ada source code file which contains a library unit declaration (a
934 declaration of a package, subprogram, or generic, or a generic
935 instantiation), or a library unit renaming declaration (a package,
936 generic, or subprogram renaming declaration).  Such files are also
937 called @dfn{specs}.
938
939 @itemx @var{file}.adb
940 Ada source code file containing a library unit body (a subprogram or
941 package body).  Such files are also called @dfn{bodies}.
942
943 @c GCC also knows about some suffixes for languages not yet included:
944 @c Pascal:
945 @c @var{file}.p
946 @c @var{file}.pas
947 @c Ratfor:
948 @c @var{file}.r
949
950 @item @var{file}.s
951 Assembler code.
952
953 @item @var{file}.S
954 Assembler code which must be preprocessed.
955
956 @item @var{other}
957 An object file to be fed straight into linking.
958 Any file name with no recognized suffix is treated this way.
959 @end table
960
961 @opindex x
962 You can specify the input language explicitly with the @option{-x} option:
963
964 @table @gcctabopt
965 @item -x @var{language}
966 Specify explicitly the @var{language} for the following input files
967 (rather than letting the compiler choose a default based on the file
968 name suffix).  This option applies to all following input files until
969 the next @option{-x} option.  Possible values for @var{language} are:
970 @smallexample
971 c  c-header  c-cpp-output
972 c++  c++-header  c++-cpp-output
973 objective-c  objective-c-header  objective-c-cpp-output
974 objective-c++ objective-c++-header objective-c++-cpp-output
975 assembler  assembler-with-cpp
976 ada
977 f95  f95-cpp-input
978 java
979 treelang
980 @end smallexample
981
982 @item -x none
983 Turn off any specification of a language, so that subsequent files are
984 handled according to their file name suffixes (as they are if @option{-x}
985 has not been used at all).
986
987 @item -pass-exit-codes
988 @opindex pass-exit-codes
989 Normally the @command{gcc} program will exit with the code of 1 if any
990 phase of the compiler returns a non-success return code.  If you specify
991 @option{-pass-exit-codes}, the @command{gcc} program will instead return with
992 numerically highest error produced by any phase that returned an error
993 indication.  The C, C++, and Fortran frontends return 4, if an internal
994 compiler error is encountered.
995 @end table
996
997 If you only want some of the stages of compilation, you can use
998 @option{-x} (or filename suffixes) to tell @command{gcc} where to start, and
999 one of the options @option{-c}, @option{-S}, or @option{-E} to say where
1000 @command{gcc} is to stop.  Note that some combinations (for example,
1001 @samp{-x cpp-output -E}) instruct @command{gcc} to do nothing at all.
1002
1003 @table @gcctabopt
1004 @item -c
1005 @opindex c
1006 Compile or assemble the source files, but do not link.  The linking
1007 stage simply is not done.  The ultimate output is in the form of an
1008 object file for each source file.
1009
1010 By default, the object file name for a source file is made by replacing
1011 the suffix @samp{.c}, @samp{.i}, @samp{.s}, etc., with @samp{.o}.
1012
1013 Unrecognized input files, not requiring compilation or assembly, are
1014 ignored.
1015
1016 @item -S
1017 @opindex S
1018 Stop after the stage of compilation proper; do not assemble.  The output
1019 is in the form of an assembler code file for each non-assembler input
1020 file specified.
1021
1022 By default, the assembler file name for a source file is made by
1023 replacing the suffix @samp{.c}, @samp{.i}, etc., with @samp{.s}.
1024
1025 Input files that don't require compilation are ignored.
1026
1027 @item -E
1028 @opindex E
1029 Stop after the preprocessing stage; do not run the compiler proper.  The
1030 output is in the form of preprocessed source code, which is sent to the
1031 standard output.
1032
1033 Input files which don't require preprocessing are ignored.
1034
1035 @cindex output file option
1036 @item -o @var{file}
1037 @opindex o
1038 Place output in file @var{file}.  This applies regardless to whatever
1039 sort of output is being produced, whether it be an executable file,
1040 an object file, an assembler file or preprocessed C code.
1041
1042 If @option{-o} is not specified, the default is to put an executable
1043 file in @file{a.out}, the object file for
1044 @file{@var{source}.@var{suffix}} in @file{@var{source}.o}, its
1045 assembler file in @file{@var{source}.s}, a precompiled header file in
1046 @file{@var{source}.@var{suffix}.gch}, and all preprocessed C source on
1047 standard output.
1048
1049 @item -v
1050 @opindex v
1051 Print (on standard error output) the commands executed to run the stages
1052 of compilation.  Also print the version number of the compiler driver
1053 program and of the preprocessor and the compiler proper.
1054
1055 @item -###
1056 @opindex ###
1057 Like @option{-v} except the commands are not executed and all command
1058 arguments are quoted.  This is useful for shell scripts to capture the
1059 driver-generated command lines.
1060
1061 @item -pipe
1062 @opindex pipe
1063 Use pipes rather than temporary files for communication between the
1064 various stages of compilation.  This fails to work on some systems where
1065 the assembler is unable to read from a pipe; but the GNU assembler has
1066 no trouble.
1067
1068 @item -combine
1069 @opindex combine
1070 If you are compiling multiple source files, this option tells the driver
1071 to pass all the source files to the compiler at once (for those
1072 languages for which the compiler can handle this).  This will allow
1073 intermodule analysis (IMA) to be performed by the compiler.  Currently the only
1074 language for which this is supported is C@.  If you pass source files for
1075 multiple languages to the driver, using this option, the driver will invoke
1076 the compiler(s) that support IMA once each, passing each compiler all the
1077 source files appropriate for it.  For those languages that do not support
1078 IMA this option will be ignored, and the compiler will be invoked once for
1079 each source file in that language.  If you use this option in conjunction
1080 with @option{-save-temps}, the compiler will generate multiple
1081 pre-processed files
1082 (one for each source file), but only one (combined) @file{.o} or
1083 @file{.s} file.
1084
1085 @item --help
1086 @opindex help
1087 Print (on the standard output) a description of the command line options
1088 understood by @command{gcc}.  If the @option{-v} option is also specified
1089 then @option{--help} will also be passed on to the various processes
1090 invoked by @command{gcc}, so that they can display the command line options
1091 they accept.  If the @option{-Wextra} option has also been specified
1092 (prior to the @option{--help} option), then command line options which
1093 have no documentation associated with them will also be displayed.
1094
1095 @item --target-help
1096 @opindex target-help
1097 Print (on the standard output) a description of target-specific command
1098 line options for each tool.
1099
1100 @item --help=@var{class}@r{[},@var{qualifier}@r{]}
1101 Print (on the standard output) a description of the command line
1102 options understood by the compiler that fit into a specific class.
1103 The class can be one of @var{optimizers}, @var{warnings}, @var{target}
1104 or @var{params}:
1105
1106 @table @gcctabopt
1107 @item @var{optimizers}
1108 This will display all of the optimization options supported by the
1109 compiler.
1110
1111 @item @var{warnings}
1112 This will display all of the options controlling warning messages
1113 produced by the compiler.
1114
1115 @item @var{target}
1116 This will display target-specific options.  Unlike the
1117 @option{--target-help} option however, target-specific options of the
1118 linker and assembler will not be displayed.  This is because those
1119 tools do not currently support the extended @option{--help=} syntax.
1120
1121 @item @var{params}
1122 This will display the values recognized by the @option{--param}
1123 option.
1124 @end table
1125
1126 It is possible to further refine the output of the @option{--help=}
1127 option by adding a comma separated list of qualifiers after the
1128 class.  These can be any from the following list:
1129
1130 @table @gcctabopt
1131 @item undocumented
1132 Display only those options which are undocumented.
1133
1134 @item joined
1135 Display options which take an argument that appears after an equal
1136 sign in the same continuous piece of text, such as:
1137 @samp{--help=target}.
1138
1139 @item separate
1140 Display options which take an argument that appears as a separate word
1141 following the original option, such as: @samp{-o output-file}.
1142 @end table
1143
1144 Thus for example to display all the undocumented target-specific
1145 switches supported by the compiler the following can be used:
1146
1147 @smallexample
1148 --help=target,undocumented
1149 @end smallexample
1150
1151 The sense of a qualifier can be inverted by prefixing it with the
1152 @var{^} character, so for example to display all binary warning
1153 options (i.e. ones that are either on or off and that do not take an
1154 argument), which have a description the following can be used:
1155
1156 @smallexample
1157 --help=warnings,^joined,^undocumented
1158 @end smallexample
1159
1160 A class can also be used as a qualifier, although this usually
1161 restricts the output by so much that there is nothing to display.  One
1162 case where it does work however is when one of the classes is
1163 @var{target}.  So for example to display all the target-specific
1164 optimization options the following can be used:
1165
1166 @smallexample
1167 --help=target,optimizers
1168 @end smallexample
1169
1170 The @option{--help=} option can be repeated on the command line.  Each
1171 successive use will display its requested class of options, skipping
1172 those that have already been displayed.
1173
1174 If the @option{-Q} option appears on the command line before the
1175 @option{--help=} option, then the descriptive text displayed by
1176 @option{--help=} is changed.  Instead of describing the displayed
1177 options, an indication is given as to whether the option is enabled,
1178 disabled or set to a specific value (assuming that the compiler
1179 knows this at the point where the @option{--help=} option is used).
1180
1181 Here is a truncated example from the ARM port of @command{gcc}:
1182
1183 @smallexample
1184   % gcc -Q -mabi=2 --help=target -c
1185   The following options are target specific:
1186   -mabi=                                2
1187   -mabort-on-noreturn                   [disabled]
1188   -mapcs                                [disabled]
1189 @end smallexample
1190
1191 The output is sensitive to the effects of previous command line
1192 options, so for example it is possible to find out which optimizations
1193 are enabled at @option{-O2} by using:
1194
1195 @smallexample
1196 -O2 --help=optimizers
1197 @end smallexample
1198
1199 Alternatively you can discover which binary optimizations are enabled
1200 by @option{-O3} by using:
1201
1202 @smallexample
1203 gcc -c -Q -O3 --help=optimizers > /tmp/O3-opts
1204 gcc -c -Q -O2 --help=optimizers > /tmp/O2-opts
1205 diff /tmp/O2-opts /tmp/O3-opts | grep enabled
1206 @end smallexample
1207
1208 @item --version
1209 @opindex version
1210 Display the version number and copyrights of the invoked GCC@.
1211
1212 @include @value{srcdir}/../libiberty/at-file.texi
1213 @end table
1214
1215 @node Invoking G++
1216 @section Compiling C++ Programs
1217
1218 @cindex suffixes for C++ source
1219 @cindex C++ source file suffixes
1220 C++ source files conventionally use one of the suffixes @samp{.C},
1221 @samp{.cc}, @samp{.cpp}, @samp{.CPP}, @samp{.c++}, @samp{.cp}, or
1222 @samp{.cxx}; C++ header files often use @samp{.hh} or @samp{.H}; and
1223 preprocessed C++ files use the suffix @samp{.ii}.  GCC recognizes
1224 files with these names and compiles them as C++ programs even if you
1225 call the compiler the same way as for compiling C programs (usually
1226 with the name @command{gcc}).
1227
1228 @findex g++
1229 @findex c++
1230 However, the use of @command{gcc} does not add the C++ library.
1231 @command{g++} is a program that calls GCC and treats @samp{.c},
1232 @samp{.h} and @samp{.i} files as C++ source files instead of C source
1233 files unless @option{-x} is used, and automatically specifies linking
1234 against the C++ library.  This program is also useful when
1235 precompiling a C header file with a @samp{.h} extension for use in C++
1236 compilations.  On many systems, @command{g++} is also installed with
1237 the name @command{c++}.
1238
1239 @cindex invoking @command{g++}
1240 When you compile C++ programs, you may specify many of the same
1241 command-line options that you use for compiling programs in any
1242 language; or command-line options meaningful for C and related
1243 languages; or options that are meaningful only for C++ programs.
1244 @xref{C Dialect Options,,Options Controlling C Dialect}, for
1245 explanations of options for languages related to C@.
1246 @xref{C++ Dialect Options,,Options Controlling C++ Dialect}, for
1247 explanations of options that are meaningful only for C++ programs.
1248
1249 @node C Dialect Options
1250 @section Options Controlling C Dialect
1251 @cindex dialect options
1252 @cindex language dialect options
1253 @cindex options, dialect
1254
1255 The following options control the dialect of C (or languages derived
1256 from C, such as C++, Objective-C and Objective-C++) that the compiler
1257 accepts:
1258
1259 @table @gcctabopt
1260 @cindex ANSI support
1261 @cindex ISO support
1262 @item -ansi
1263 @opindex ansi
1264 In C mode, support all ISO C90 programs.  In C++ mode,
1265 remove GNU extensions that conflict with ISO C++.
1266
1267 This turns off certain features of GCC that are incompatible with ISO
1268 C90 (when compiling C code), or of standard C++ (when compiling C++ code),
1269 such as the @code{asm} and @code{typeof} keywords, and
1270 predefined macros such as @code{unix} and @code{vax} that identify the
1271 type of system you are using.  It also enables the undesirable and
1272 rarely used ISO trigraph feature.  For the C compiler,
1273 it disables recognition of C++ style @samp{//} comments as well as
1274 the @code{inline} keyword.
1275
1276 The alternate keywords @code{__asm__}, @code{__extension__},
1277 @code{__inline__} and @code{__typeof__} continue to work despite
1278 @option{-ansi}.  You would not want to use them in an ISO C program, of
1279 course, but it is useful to put them in header files that might be included
1280 in compilations done with @option{-ansi}.  Alternate predefined macros
1281 such as @code{__unix__} and @code{__vax__} are also available, with or
1282 without @option{-ansi}.
1283
1284 The @option{-ansi} option does not cause non-ISO programs to be
1285 rejected gratuitously.  For that, @option{-pedantic} is required in
1286 addition to @option{-ansi}.  @xref{Warning Options}.
1287
1288 The macro @code{__STRICT_ANSI__} is predefined when the @option{-ansi}
1289 option is used.  Some header files may notice this macro and refrain
1290 from declaring certain functions or defining certain macros that the
1291 ISO standard doesn't call for; this is to avoid interfering with any
1292 programs that might use these names for other things.
1293
1294 Functions which would normally be built in but do not have semantics
1295 defined by ISO C (such as @code{alloca} and @code{ffs}) are not built-in
1296 functions with @option{-ansi} is used.  @xref{Other Builtins,,Other
1297 built-in functions provided by GCC}, for details of the functions
1298 affected.
1299
1300 @item -std=
1301 @opindex std
1302 Determine the language standard.  This option is currently only
1303 supported when compiling C or C++.  A value for this option must be
1304 provided; possible values are
1305
1306 @table @samp
1307 @item c89
1308 @itemx iso9899:1990
1309 ISO C90 (same as @option{-ansi}).
1310
1311 @item iso9899:199409
1312 ISO C90 as modified in amendment 1.
1313
1314 @item c99
1315 @itemx c9x
1316 @itemx iso9899:1999
1317 @itemx iso9899:199x
1318 ISO C99.  Note that this standard is not yet fully supported; see
1319 @w{@uref{http://gcc.gnu.org/c99status.html}} for more information.  The
1320 names @samp{c9x} and @samp{iso9899:199x} are deprecated.
1321
1322 @item gnu89
1323 Default, ISO C90 plus GNU extensions (including some C99 features).
1324
1325 @item gnu99
1326 @itemx gnu9x
1327 ISO C99 plus GNU extensions.  When ISO C99 is fully implemented in GCC,
1328 this will become the default.  The name @samp{gnu9x} is deprecated.
1329
1330 @item c++98
1331 The 1998 ISO C++ standard plus amendments.
1332
1333 @item gnu++98
1334 The same as @option{-std=c++98} plus GNU extensions.  This is the
1335 default for C++ code.
1336
1337 @item c++0x
1338 The working draft of the upcoming ISO C++0x standard. This option
1339 enables experimental features that are likely to be included in
1340 C++0x. The working draft is constantly changing, and any feature that is
1341 enabled by this flag may be removed from future versions of GCC if it is
1342 not part of the C++0x standard.
1343
1344 @item gnu++0x
1345 The same as @option{-std=c++0x} plus GNU extensions. As with
1346 @option{-std=c++0x}, this option enables experimental features that may
1347 be removed in future versions of GCC.
1348 @end table
1349
1350 Even when this option is not specified, you can still use some of the
1351 features of newer standards in so far as they do not conflict with
1352 previous C standards.  For example, you may use @code{__restrict__} even
1353 when @option{-std=c99} is not specified.
1354
1355 The @option{-std} options specifying some version of ISO C have the same
1356 effects as @option{-ansi}, except that features that were not in ISO C90
1357 but are in the specified version (for example, @samp{//} comments and
1358 the @code{inline} keyword in ISO C99) are not disabled.
1359
1360 @xref{Standards,,Language Standards Supported by GCC}, for details of
1361 these standard versions.
1362
1363 @item -fgnu89-inline
1364 @opindex fgnu89-inline
1365 The option @option{-fgnu89-inline} tells GCC to use the traditional
1366 GNU semantics for @code{inline} functions when in C99 mode.
1367 @xref{Inline,,An Inline Function is As Fast As a Macro}.  This option
1368 is accepted and ignored by GCC versions 4.1.3 up to but not including
1369 4.3.  In GCC versions 4.3 and later it changes the behavior of GCC in
1370 C99 mode.  Using this option is roughly equivalent to adding the
1371 @code{gnu_inline} function attribute to all inline functions
1372 (@pxref{Function Attributes}).
1373
1374 The option @option{-fno-gnu89-inline} explicitly tells GCC to use the
1375 C99 semantics for @code{inline} when in C99 or gnu99 mode (i.e., it
1376 specifies the default behavior).  This option was first supported in
1377 GCC 4.3.  This option is not supported in C89 or gnu89 mode.
1378
1379 The preprocesor macros @code{__GNUC_GNU_INLINE__} and
1380 @code{__GNUC_STDC_INLINE__} may be used to check which semantics are
1381 in effect for @code{inline} functions.  @xref{Common Predefined
1382 Macros,,,cpp,The C Preprocessor}.
1383
1384 @item -aux-info @var{filename}
1385 @opindex aux-info
1386 Output to the given filename prototyped declarations for all functions
1387 declared and/or defined in a translation unit, including those in header
1388 files.  This option is silently ignored in any language other than C@.
1389
1390 Besides declarations, the file indicates, in comments, the origin of
1391 each declaration (source file and line), whether the declaration was
1392 implicit, prototyped or unprototyped (@samp{I}, @samp{N} for new or
1393 @samp{O} for old, respectively, in the first character after the line
1394 number and the colon), and whether it came from a declaration or a
1395 definition (@samp{C} or @samp{F}, respectively, in the following
1396 character).  In the case of function definitions, a K&R-style list of
1397 arguments followed by their declarations is also provided, inside
1398 comments, after the declaration.
1399
1400 @item -fno-asm
1401 @opindex fno-asm
1402 Do not recognize @code{asm}, @code{inline} or @code{typeof} as a
1403 keyword, so that code can use these words as identifiers.  You can use
1404 the keywords @code{__asm__}, @code{__inline__} and @code{__typeof__}
1405 instead.  @option{-ansi} implies @option{-fno-asm}.
1406
1407 In C++, this switch only affects the @code{typeof} keyword, since
1408 @code{asm} and @code{inline} are standard keywords.  You may want to
1409 use the @option{-fno-gnu-keywords} flag instead, which has the same
1410 effect.  In C99 mode (@option{-std=c99} or @option{-std=gnu99}), this
1411 switch only affects the @code{asm} and @code{typeof} keywords, since
1412 @code{inline} is a standard keyword in ISO C99.
1413
1414 @item -fno-builtin
1415 @itemx -fno-builtin-@var{function}
1416 @opindex fno-builtin
1417 @cindex built-in functions
1418 Don't recognize built-in functions that do not begin with
1419 @samp{__builtin_} as prefix.  @xref{Other Builtins,,Other built-in
1420 functions provided by GCC}, for details of the functions affected,
1421 including those which are not built-in functions when @option{-ansi} or
1422 @option{-std} options for strict ISO C conformance are used because they
1423 do not have an ISO standard meaning.
1424
1425 GCC normally generates special code to handle certain built-in functions
1426 more efficiently; for instance, calls to @code{alloca} may become single
1427 instructions that adjust the stack directly, and calls to @code{memcpy}
1428 may become inline copy loops.  The resulting code is often both smaller
1429 and faster, but since the function calls no longer appear as such, you
1430 cannot set a breakpoint on those calls, nor can you change the behavior
1431 of the functions by linking with a different library.  In addition,
1432 when a function is recognized as a built-in function, GCC may use
1433 information about that function to warn about problems with calls to
1434 that function, or to generate more efficient code, even if the
1435 resulting code still contains calls to that function.  For example,
1436 warnings are given with @option{-Wformat} for bad calls to
1437 @code{printf}, when @code{printf} is built in, and @code{strlen} is
1438 known not to modify global memory.
1439
1440 With the @option{-fno-builtin-@var{function}} option
1441 only the built-in function @var{function} is
1442 disabled.  @var{function} must not begin with @samp{__builtin_}.  If a
1443 function is named this is not built-in in this version of GCC, this
1444 option is ignored.  There is no corresponding
1445 @option{-fbuiltin-@var{function}} option; if you wish to enable
1446 built-in functions selectively when using @option{-fno-builtin} or
1447 @option{-ffreestanding}, you may define macros such as:
1448
1449 @smallexample
1450 #define abs(n)          __builtin_abs ((n))
1451 #define strcpy(d, s)    __builtin_strcpy ((d), (s))
1452 @end smallexample
1453
1454 @item -fhosted
1455 @opindex fhosted
1456 @cindex hosted environment
1457
1458 Assert that compilation takes place in a hosted environment.  This implies
1459 @option{-fbuiltin}.  A hosted environment is one in which the
1460 entire standard library is available, and in which @code{main} has a return
1461 type of @code{int}.  Examples are nearly everything except a kernel.
1462 This is equivalent to @option{-fno-freestanding}.
1463
1464 @item -ffreestanding
1465 @opindex ffreestanding
1466 @cindex hosted environment
1467
1468 Assert that compilation takes place in a freestanding environment.  This
1469 implies @option{-fno-builtin}.  A freestanding environment
1470 is one in which the standard library may not exist, and program startup may
1471 not necessarily be at @code{main}.  The most obvious example is an OS kernel.
1472 This is equivalent to @option{-fno-hosted}.
1473
1474 @xref{Standards,,Language Standards Supported by GCC}, for details of
1475 freestanding and hosted environments.
1476
1477 @item -fopenmp
1478 @opindex fopenmp
1479 @cindex openmp parallel
1480 Enable handling of OpenMP directives @code{#pragma omp} in C/C++ and
1481 @code{!$omp} in Fortran.  When @option{-fopenmp} is specified, the
1482 compiler generates parallel code according to the OpenMP Application
1483 Program Interface v2.5 @w{@uref{http://www.openmp.org/}}.
1484
1485 @item -fms-extensions
1486 @opindex fms-extensions
1487 Accept some non-standard constructs used in Microsoft header files.
1488
1489 Some cases of unnamed fields in structures and unions are only
1490 accepted with this option.  @xref{Unnamed Fields,,Unnamed struct/union
1491 fields within structs/unions}, for details.
1492
1493 @item -trigraphs
1494 @opindex trigraphs
1495 Support ISO C trigraphs.  The @option{-ansi} option (and @option{-std}
1496 options for strict ISO C conformance) implies @option{-trigraphs}.
1497
1498 @item -no-integrated-cpp
1499 @opindex no-integrated-cpp
1500 Performs a compilation in two passes: preprocessing and compiling.  This
1501 option allows a user supplied "cc1", "cc1plus", or "cc1obj" via the
1502 @option{-B} option.  The user supplied compilation step can then add in
1503 an additional preprocessing step after normal preprocessing but before
1504 compiling.  The default is to use the integrated cpp (internal cpp)
1505
1506 The semantics of this option will change if "cc1", "cc1plus", and
1507 "cc1obj" are merged.
1508
1509 @cindex traditional C language
1510 @cindex C language, traditional
1511 @item -traditional
1512 @itemx -traditional-cpp
1513 @opindex traditional-cpp
1514 @opindex traditional
1515 Formerly, these options caused GCC to attempt to emulate a pre-standard
1516 C compiler.  They are now only supported with the @option{-E} switch.
1517 The preprocessor continues to support a pre-standard mode.  See the GNU
1518 CPP manual for details.
1519
1520 @item -fcond-mismatch
1521 @opindex fcond-mismatch
1522 Allow conditional expressions with mismatched types in the second and
1523 third arguments.  The value of such an expression is void.  This option
1524 is not supported for C++.
1525
1526 @item -flax-vector-conversions
1527 @opindex flax-vector-conversions
1528 Allow implicit conversions between vectors with differing numbers of
1529 elements and/or incompatible element types.  This option should not be
1530 used for new code.
1531
1532 @item -funsigned-char
1533 @opindex funsigned-char
1534 Let the type @code{char} be unsigned, like @code{unsigned char}.
1535
1536 Each kind of machine has a default for what @code{char} should
1537 be.  It is either like @code{unsigned char} by default or like
1538 @code{signed char} by default.
1539
1540 Ideally, a portable program should always use @code{signed char} or
1541 @code{unsigned char} when it depends on the signedness of an object.
1542 But many programs have been written to use plain @code{char} and
1543 expect it to be signed, or expect it to be unsigned, depending on the
1544 machines they were written for.  This option, and its inverse, let you
1545 make such a program work with the opposite default.
1546
1547 The type @code{char} is always a distinct type from each of
1548 @code{signed char} or @code{unsigned char}, even though its behavior
1549 is always just like one of those two.
1550
1551 @item -fsigned-char
1552 @opindex fsigned-char
1553 Let the type @code{char} be signed, like @code{signed char}.
1554
1555 Note that this is equivalent to @option{-fno-unsigned-char}, which is
1556 the negative form of @option{-funsigned-char}.  Likewise, the option
1557 @option{-fno-signed-char} is equivalent to @option{-funsigned-char}.
1558
1559 @item -fsigned-bitfields
1560 @itemx -funsigned-bitfields
1561 @itemx -fno-signed-bitfields
1562 @itemx -fno-unsigned-bitfields
1563 @opindex fsigned-bitfields
1564 @opindex funsigned-bitfields
1565 @opindex fno-signed-bitfields
1566 @opindex fno-unsigned-bitfields
1567 These options control whether a bit-field is signed or unsigned, when the
1568 declaration does not use either @code{signed} or @code{unsigned}.  By
1569 default, such a bit-field is signed, because this is consistent: the
1570 basic integer types such as @code{int} are signed types.
1571 @end table
1572
1573 @node C++ Dialect Options
1574 @section Options Controlling C++ Dialect
1575
1576 @cindex compiler options, C++
1577 @cindex C++ options, command line
1578 @cindex options, C++
1579 This section describes the command-line options that are only meaningful
1580 for C++ programs; but you can also use most of the GNU compiler options
1581 regardless of what language your program is in.  For example, you
1582 might compile a file @code{firstClass.C} like this:
1583
1584 @smallexample
1585 g++ -g -frepo -O -c firstClass.C
1586 @end smallexample
1587
1588 @noindent
1589 In this example, only @option{-frepo} is an option meant
1590 only for C++ programs; you can use the other options with any
1591 language supported by GCC@.
1592
1593 Here is a list of options that are @emph{only} for compiling C++ programs:
1594
1595 @table @gcctabopt
1596
1597 @item -fabi-version=@var{n}
1598 @opindex fabi-version
1599 Use version @var{n} of the C++ ABI@.  Version 2 is the version of the
1600 C++ ABI that first appeared in G++ 3.4.  Version 1 is the version of
1601 the C++ ABI that first appeared in G++ 3.2.  Version 0 will always be
1602 the version that conforms most closely to the C++ ABI specification.
1603 Therefore, the ABI obtained using version 0 will change as ABI bugs
1604 are fixed.
1605
1606 The default is version 2.
1607
1608 @item -fno-access-control
1609 @opindex fno-access-control
1610 Turn off all access checking.  This switch is mainly useful for working
1611 around bugs in the access control code.
1612
1613 @item -fcheck-new
1614 @opindex fcheck-new
1615 Check that the pointer returned by @code{operator new} is non-null
1616 before attempting to modify the storage allocated.  This check is
1617 normally unnecessary because the C++ standard specifies that
1618 @code{operator new} will only return @code{0} if it is declared
1619 @samp{throw()}, in which case the compiler will always check the
1620 return value even without this option.  In all other cases, when
1621 @code{operator new} has a non-empty exception specification, memory
1622 exhaustion is signalled by throwing @code{std::bad_alloc}.  See also
1623 @samp{new (nothrow)}.
1624
1625 @item -fconserve-space
1626 @opindex fconserve-space
1627 Put uninitialized or runtime-initialized global variables into the
1628 common segment, as C does.  This saves space in the executable at the
1629 cost of not diagnosing duplicate definitions.  If you compile with this
1630 flag and your program mysteriously crashes after @code{main()} has
1631 completed, you may have an object that is being destroyed twice because
1632 two definitions were merged.
1633
1634 This option is no longer useful on most targets, now that support has
1635 been added for putting variables into BSS without making them common.
1636
1637 @item -ffriend-injection
1638 @opindex ffriend-injection
1639 Inject friend functions into the enclosing namespace, so that they are
1640 visible outside the scope of the class in which they are declared.
1641 Friend functions were documented to work this way in the old Annotated
1642 C++ Reference Manual, and versions of G++ before 4.1 always worked
1643 that way.  However, in ISO C++ a friend function which is not declared
1644 in an enclosing scope can only be found using argument dependent
1645 lookup.  This option causes friends to be injected as they were in
1646 earlier releases.
1647
1648 This option is for compatibility, and may be removed in a future
1649 release of G++.
1650
1651 @item -fno-elide-constructors
1652 @opindex fno-elide-constructors
1653 The C++ standard allows an implementation to omit creating a temporary
1654 which is only used to initialize another object of the same type.
1655 Specifying this option disables that optimization, and forces G++ to
1656 call the copy constructor in all cases.
1657
1658 @item -fno-enforce-eh-specs
1659 @opindex fno-enforce-eh-specs
1660 Don't generate code to check for violation of exception specifications
1661 at runtime.  This option violates the C++ standard, but may be useful
1662 for reducing code size in production builds, much like defining
1663 @samp{NDEBUG}.  This does not give user code permission to throw
1664 exceptions in violation of the exception specifications; the compiler
1665 will still optimize based on the specifications, so throwing an
1666 unexpected exception will result in undefined behavior.
1667
1668 @item -ffor-scope
1669 @itemx -fno-for-scope
1670 @opindex ffor-scope
1671 @opindex fno-for-scope
1672 If @option{-ffor-scope} is specified, the scope of variables declared in
1673 a @i{for-init-statement} is limited to the @samp{for} loop itself,
1674 as specified by the C++ standard.
1675 If @option{-fno-for-scope} is specified, the scope of variables declared in
1676 a @i{for-init-statement} extends to the end of the enclosing scope,
1677 as was the case in old versions of G++, and other (traditional)
1678 implementations of C++.
1679
1680 The default if neither flag is given to follow the standard,
1681 but to allow and give a warning for old-style code that would
1682 otherwise be invalid, or have different behavior.
1683
1684 @item -fno-gnu-keywords
1685 @opindex fno-gnu-keywords
1686 Do not recognize @code{typeof} as a keyword, so that code can use this
1687 word as an identifier.  You can use the keyword @code{__typeof__} instead.
1688 @option{-ansi} implies @option{-fno-gnu-keywords}.
1689
1690 @item -fno-implicit-templates
1691 @opindex fno-implicit-templates
1692 Never emit code for non-inline templates which are instantiated
1693 implicitly (i.e.@: by use); only emit code for explicit instantiations.
1694 @xref{Template Instantiation}, for more information.
1695
1696 @item -fno-implicit-inline-templates
1697 @opindex fno-implicit-inline-templates
1698 Don't emit code for implicit instantiations of inline templates, either.
1699 The default is to handle inlines differently so that compiles with and
1700 without optimization will need the same set of explicit instantiations.
1701
1702 @item -fno-implement-inlines
1703 @opindex fno-implement-inlines
1704 To save space, do not emit out-of-line copies of inline functions
1705 controlled by @samp{#pragma implementation}.  This will cause linker
1706 errors if these functions are not inlined everywhere they are called.
1707
1708 @item -fms-extensions
1709 @opindex fms-extensions
1710 Disable pedantic warnings about constructs used in MFC, such as implicit
1711 int and getting a pointer to member function via non-standard syntax.
1712
1713 @item -fno-nonansi-builtins
1714 @opindex fno-nonansi-builtins
1715 Disable built-in declarations of functions that are not mandated by
1716 ANSI/ISO C@.  These include @code{ffs}, @code{alloca}, @code{_exit},
1717 @code{index}, @code{bzero}, @code{conjf}, and other related functions.
1718
1719 @item -fno-operator-names
1720 @opindex fno-operator-names
1721 Do not treat the operator name keywords @code{and}, @code{bitand},
1722 @code{bitor}, @code{compl}, @code{not}, @code{or} and @code{xor} as
1723 synonyms as keywords.
1724
1725 @item -fno-optional-diags
1726 @opindex fno-optional-diags
1727 Disable diagnostics that the standard says a compiler does not need to
1728 issue.  Currently, the only such diagnostic issued by G++ is the one for
1729 a name having multiple meanings within a class.
1730
1731 @item -fpermissive
1732 @opindex fpermissive
1733 Downgrade some diagnostics about nonconformant code from errors to
1734 warnings.  Thus, using @option{-fpermissive} will allow some
1735 nonconforming code to compile.
1736
1737 @item -frepo
1738 @opindex frepo
1739 Enable automatic template instantiation at link time.  This option also
1740 implies @option{-fno-implicit-templates}.  @xref{Template
1741 Instantiation}, for more information.
1742
1743 @item -fno-rtti
1744 @opindex fno-rtti
1745 Disable generation of information about every class with virtual
1746 functions for use by the C++ runtime type identification features
1747 (@samp{dynamic_cast} and @samp{typeid}).  If you don't use those parts
1748 of the language, you can save some space by using this flag.  Note that
1749 exception handling uses the same information, but it will generate it as
1750 needed. The @samp{dynamic_cast} operator can still be used for casts that
1751 do not require runtime type information, i.e. casts to @code{void *} or to
1752 unambiguous base classes.
1753
1754 @item -fstats
1755 @opindex fstats
1756 Emit statistics about front-end processing at the end of the compilation.
1757 This information is generally only useful to the G++ development team.
1758
1759 @item -ftemplate-depth-@var{n}
1760 @opindex ftemplate-depth
1761 Set the maximum instantiation depth for template classes to @var{n}.
1762 A limit on the template instantiation depth is needed to detect
1763 endless recursions during template class instantiation.  ANSI/ISO C++
1764 conforming programs must not rely on a maximum depth greater than 17.
1765
1766 @item -fno-threadsafe-statics
1767 @opindex fno-threadsafe-statics
1768 Do not emit the extra code to use the routines specified in the C++
1769 ABI for thread-safe initialization of local statics.  You can use this
1770 option to reduce code size slightly in code that doesn't need to be
1771 thread-safe.
1772
1773 @item -fuse-cxa-atexit
1774 @opindex fuse-cxa-atexit
1775 Register destructors for objects with static storage duration with the
1776 @code{__cxa_atexit} function rather than the @code{atexit} function.
1777 This option is required for fully standards-compliant handling of static
1778 destructors, but will only work if your C library supports
1779 @code{__cxa_atexit}.
1780
1781 @item -fno-use-cxa-get-exception-ptr
1782 @opindex fno-use-cxa-get-exception-ptr
1783 Don't use the @code{__cxa_get_exception_ptr} runtime routine.  This
1784 will cause @code{std::uncaught_exception} to be incorrect, but is necessary
1785 if the runtime routine is not available.
1786
1787 @item -fvisibility-inlines-hidden
1788 @opindex fvisibility-inlines-hidden
1789 This switch declares that the user does not attempt to compare
1790 pointers to inline methods where the addresses of the two functions
1791 were taken in different shared objects.
1792
1793 The effect of this is that GCC may, effectively, mark inline methods with
1794 @code{__attribute__ ((visibility ("hidden")))} so that they do not
1795 appear in the export table of a DSO and do not require a PLT indirection
1796 when used within the DSO@.  Enabling this option can have a dramatic effect
1797 on load and link times of a DSO as it massively reduces the size of the
1798 dynamic export table when the library makes heavy use of templates.
1799
1800 The behavior of this switch is not quite the same as marking the
1801 methods as hidden directly, because it does not affect static variables
1802 local to the function or cause the compiler to deduce that
1803 the function is defined in only one shared object.
1804
1805 You may mark a method as having a visibility explicitly to negate the
1806 effect of the switch for that method.  For example, if you do want to
1807 compare pointers to a particular inline method, you might mark it as
1808 having default visibility.  Marking the enclosing class with explicit
1809 visibility will have no effect.
1810
1811 Explicitly instantiated inline methods are unaffected by this option
1812 as their linkage might otherwise cross a shared library boundary.
1813 @xref{Template Instantiation}.
1814
1815 @item -fno-weak
1816 @opindex fno-weak
1817 Do not use weak symbol support, even if it is provided by the linker.
1818 By default, G++ will use weak symbols if they are available.  This
1819 option exists only for testing, and should not be used by end-users;
1820 it will result in inferior code and has no benefits.  This option may
1821 be removed in a future release of G++.
1822
1823 @item -nostdinc++
1824 @opindex nostdinc++
1825 Do not search for header files in the standard directories specific to
1826 C++, but do still search the other standard directories.  (This option
1827 is used when building the C++ library.)
1828 @end table
1829
1830 In addition, these optimization, warning, and code generation options
1831 have meanings only for C++ programs:
1832
1833 @table @gcctabopt
1834 @item -fno-default-inline
1835 @opindex fno-default-inline
1836 Do not assume @samp{inline} for functions defined inside a class scope.
1837 @xref{Optimize Options,,Options That Control Optimization}.  Note that these
1838 functions will have linkage like inline functions; they just won't be
1839 inlined by default.
1840
1841 @item -Wabi @r{(C++ only)}
1842 @opindex Wabi
1843 Warn when G++ generates code that is probably not compatible with the
1844 vendor-neutral C++ ABI@.  Although an effort has been made to warn about
1845 all such cases, there are probably some cases that are not warned about,
1846 even though G++ is generating incompatible code.  There may also be
1847 cases where warnings are emitted even though the code that is generated
1848 will be compatible.
1849
1850 You should rewrite your code to avoid these warnings if you are
1851 concerned about the fact that code generated by G++ may not be binary
1852 compatible with code generated by other compilers.
1853
1854 The known incompatibilities at this point include:
1855
1856 @itemize @bullet
1857
1858 @item
1859 Incorrect handling of tail-padding for bit-fields.  G++ may attempt to
1860 pack data into the same byte as a base class.  For example:
1861
1862 @smallexample
1863 struct A @{ virtual void f(); int f1 : 1; @};
1864 struct B : public A @{ int f2 : 1; @};
1865 @end smallexample
1866
1867 @noindent
1868 In this case, G++ will place @code{B::f2} into the same byte
1869 as@code{A::f1}; other compilers will not.  You can avoid this problem
1870 by explicitly padding @code{A} so that its size is a multiple of the
1871 byte size on your platform; that will cause G++ and other compilers to
1872 layout @code{B} identically.
1873
1874 @item
1875 Incorrect handling of tail-padding for virtual bases.  G++ does not use
1876 tail padding when laying out virtual bases.  For example:
1877
1878 @smallexample
1879 struct A @{ virtual void f(); char c1; @};
1880 struct B @{ B(); char c2; @};
1881 struct C : public A, public virtual B @{@};
1882 @end smallexample
1883
1884 @noindent
1885 In this case, G++ will not place @code{B} into the tail-padding for
1886 @code{A}; other compilers will.  You can avoid this problem by
1887 explicitly padding @code{A} so that its size is a multiple of its
1888 alignment (ignoring virtual base classes); that will cause G++ and other
1889 compilers to layout @code{C} identically.
1890
1891 @item
1892 Incorrect handling of bit-fields with declared widths greater than that
1893 of their underlying types, when the bit-fields appear in a union.  For
1894 example:
1895
1896 @smallexample
1897 union U @{ int i : 4096; @};
1898 @end smallexample
1899
1900 @noindent
1901 Assuming that an @code{int} does not have 4096 bits, G++ will make the
1902 union too small by the number of bits in an @code{int}.
1903
1904 @item
1905 Empty classes can be placed at incorrect offsets.  For example:
1906
1907 @smallexample
1908 struct A @{@};
1909
1910 struct B @{
1911   A a;
1912   virtual void f ();
1913 @};
1914
1915 struct C : public B, public A @{@};
1916 @end smallexample
1917
1918 @noindent
1919 G++ will place the @code{A} base class of @code{C} at a nonzero offset;
1920 it should be placed at offset zero.  G++ mistakenly believes that the
1921 @code{A} data member of @code{B} is already at offset zero.
1922
1923 @item
1924 Names of template functions whose types involve @code{typename} or
1925 template template parameters can be mangled incorrectly.
1926
1927 @smallexample
1928 template <typename Q>
1929 void f(typename Q::X) @{@}
1930
1931 template <template <typename> class Q>
1932 void f(typename Q<int>::X) @{@}
1933 @end smallexample
1934
1935 @noindent
1936 Instantiations of these templates may be mangled incorrectly.
1937
1938 @end itemize
1939
1940 @item -Wctor-dtor-privacy @r{(C++ only)}
1941 @opindex Wctor-dtor-privacy
1942 Warn when a class seems unusable because all the constructors or
1943 destructors in that class are private, and it has neither friends nor
1944 public static member functions.
1945
1946 @item -Wnon-virtual-dtor @r{(C++ only)}
1947 @opindex Wnon-virtual-dtor
1948 Warn when a class appears to be polymorphic, thereby requiring a virtual
1949 destructor, yet it declares a non-virtual one.  This warning is also
1950 enabled if -Weffc++ is specified.
1951
1952 @item -Wreorder @r{(C++ only)}
1953 @opindex Wreorder
1954 @cindex reordering, warning
1955 @cindex warning for reordering of member initializers
1956 Warn when the order of member initializers given in the code does not
1957 match the order in which they must be executed.  For instance:
1958
1959 @smallexample
1960 struct A @{
1961   int i;
1962   int j;
1963   A(): j (0), i (1) @{ @}
1964 @};
1965 @end smallexample
1966
1967 The compiler will rearrange the member initializers for @samp{i}
1968 and @samp{j} to match the declaration order of the members, emitting
1969 a warning to that effect.  This warning is enabled by @option{-Wall}.
1970 @end table
1971
1972 The following @option{-W@dots{}} options are not affected by @option{-Wall}.
1973
1974 @table @gcctabopt
1975 @item -Weffc++ @r{(C++ only)}
1976 @opindex Weffc++
1977 Warn about violations of the following style guidelines from Scott Meyers'
1978 @cite{Effective C++} book:
1979
1980 @itemize @bullet
1981 @item
1982 Item 11:  Define a copy constructor and an assignment operator for classes
1983 with dynamically allocated memory.
1984
1985 @item
1986 Item 12:  Prefer initialization to assignment in constructors.
1987
1988 @item
1989 Item 14:  Make destructors virtual in base classes.
1990
1991 @item
1992 Item 15:  Have @code{operator=} return a reference to @code{*this}.
1993
1994 @item
1995 Item 23:  Don't try to return a reference when you must return an object.
1996
1997 @end itemize
1998
1999 Also warn about violations of the following style guidelines from
2000 Scott Meyers' @cite{More Effective C++} book:
2001
2002 @itemize @bullet
2003 @item
2004 Item 6:  Distinguish between prefix and postfix forms of increment and
2005 decrement operators.
2006
2007 @item
2008 Item 7:  Never overload @code{&&}, @code{||}, or @code{,}.
2009
2010 @end itemize
2011
2012 When selecting this option, be aware that the standard library
2013 headers do not obey all of these guidelines; use @samp{grep -v}
2014 to filter out those warnings.
2015
2016 @item -Wno-deprecated @r{(C++ only)}
2017 @opindex Wno-deprecated
2018 Do not warn about usage of deprecated features.  @xref{Deprecated Features}.
2019
2020 @item -Wstrict-null-sentinel @r{(C++ only)}
2021 @opindex Wstrict-null-sentinel
2022 Warn also about the use of an uncasted @code{NULL} as sentinel.  When
2023 compiling only with GCC this is a valid sentinel, as @code{NULL} is defined
2024 to @code{__null}.  Although it is a null pointer constant not a null pointer,
2025 it is guaranteed to of the same size as a pointer.  But this use is
2026 not portable across different compilers.
2027
2028 @item -Wno-non-template-friend @r{(C++ only)}
2029 @opindex Wno-non-template-friend
2030 Disable warnings when non-templatized friend functions are declared
2031 within a template.  Since the advent of explicit template specification
2032 support in G++, if the name of the friend is an unqualified-id (i.e.,
2033 @samp{friend foo(int)}), the C++ language specification demands that the
2034 friend declare or define an ordinary, nontemplate function.  (Section
2035 14.5.3).  Before G++ implemented explicit specification, unqualified-ids
2036 could be interpreted as a particular specialization of a templatized
2037 function.  Because this non-conforming behavior is no longer the default
2038 behavior for G++, @option{-Wnon-template-friend} allows the compiler to
2039 check existing code for potential trouble spots and is on by default.
2040 This new compiler behavior can be turned off with
2041 @option{-Wno-non-template-friend} which keeps the conformant compiler code
2042 but disables the helpful warning.
2043
2044 @item -Wold-style-cast @r{(C++ only)}
2045 @opindex Wold-style-cast
2046 Warn if an old-style (C-style) cast to a non-void type is used within
2047 a C++ program.  The new-style casts (@samp{dynamic_cast},
2048 @samp{static_cast}, @samp{reinterpret_cast}, and @samp{const_cast}) are
2049 less vulnerable to unintended effects and much easier to search for.
2050
2051 @item -Woverloaded-virtual @r{(C++ only)}
2052 @opindex Woverloaded-virtual
2053 @cindex overloaded virtual fn, warning
2054 @cindex warning for overloaded virtual fn
2055 Warn when a function declaration hides virtual functions from a
2056 base class.  For example, in:
2057
2058 @smallexample
2059 struct A @{
2060   virtual void f();
2061 @};
2062
2063 struct B: public A @{
2064   void f(int);
2065 @};
2066 @end smallexample
2067
2068 the @code{A} class version of @code{f} is hidden in @code{B}, and code
2069 like:
2070
2071 @smallexample
2072 B* b;
2073 b->f();
2074 @end smallexample
2075
2076 will fail to compile.
2077
2078 @item -Wno-pmf-conversions @r{(C++ only)}
2079 @opindex Wno-pmf-conversions
2080 Disable the diagnostic for converting a bound pointer to member function
2081 to a plain pointer.
2082
2083 @item -Wsign-promo @r{(C++ only)}
2084 @opindex Wsign-promo
2085 Warn when overload resolution chooses a promotion from unsigned or
2086 enumerated type to a signed type, over a conversion to an unsigned type of
2087 the same size.  Previous versions of G++ would try to preserve
2088 unsignedness, but the standard mandates the current behavior.
2089
2090 @smallexample
2091 struct A @{
2092   operator int ();
2093   A& operator = (int);
2094 @};
2095
2096 main ()
2097 @{
2098   A a,b;
2099   a = b;
2100 @}
2101 @end smallexample
2102
2103 In this example, G++ will synthesize a default @samp{A& operator =
2104 (const A&);}, while cfront will use the user-defined @samp{operator =}.
2105 @end table
2106
2107 @node Objective-C and Objective-C++ Dialect Options
2108 @section Options Controlling Objective-C and Objective-C++ Dialects
2109
2110 @cindex compiler options, Objective-C and Objective-C++
2111 @cindex Objective-C and Objective-C++ options, command line
2112 @cindex options, Objective-C and Objective-C++
2113 (NOTE: This manual does not describe the Objective-C and Objective-C++
2114 languages themselves.  See @xref{Standards,,Language Standards
2115 Supported by GCC}, for references.)
2116
2117 This section describes the command-line options that are only meaningful
2118 for Objective-C and Objective-C++ programs, but you can also use most of
2119 the language-independent GNU compiler options.
2120 For example, you might compile a file @code{some_class.m} like this:
2121
2122 @smallexample
2123 gcc -g -fgnu-runtime -O -c some_class.m
2124 @end smallexample
2125
2126 @noindent
2127 In this example, @option{-fgnu-runtime} is an option meant only for
2128 Objective-C and Objective-C++ programs; you can use the other options with
2129 any language supported by GCC@.
2130
2131 Note that since Objective-C is an extension of the C language, Objective-C
2132 compilations may also use options specific to the C front-end (e.g.,
2133 @option{-Wtraditional}).  Similarly, Objective-C++ compilations may use
2134 C++-specific options (e.g., @option{-Wabi}).
2135
2136 Here is a list of options that are @emph{only} for compiling Objective-C
2137 and Objective-C++ programs:
2138
2139 @table @gcctabopt
2140 @item -fconstant-string-class=@var{class-name}
2141 @opindex fconstant-string-class
2142 Use @var{class-name} as the name of the class to instantiate for each
2143 literal string specified with the syntax @code{@@"@dots{}"}.  The default
2144 class name is @code{NXConstantString} if the GNU runtime is being used, and
2145 @code{NSConstantString} if the NeXT runtime is being used (see below).  The
2146 @option{-fconstant-cfstrings} option, if also present, will override the
2147 @option{-fconstant-string-class} setting and cause @code{@@"@dots{}"} literals
2148 to be laid out as constant CoreFoundation strings.
2149
2150 @item -fgnu-runtime
2151 @opindex fgnu-runtime
2152 Generate object code compatible with the standard GNU Objective-C
2153 runtime.  This is the default for most types of systems.
2154
2155 @item -fnext-runtime
2156 @opindex fnext-runtime
2157 Generate output compatible with the NeXT runtime.  This is the default
2158 for NeXT-based systems, including Darwin and Mac OS X@.  The macro
2159 @code{__NEXT_RUNTIME__} is predefined if (and only if) this option is
2160 used.
2161
2162 @item -fno-nil-receivers
2163 @opindex fno-nil-receivers
2164 Assume that all Objective-C message dispatches (e.g.,
2165 @code{[receiver message:arg]}) in this translation unit ensure that the receiver
2166 is not @code{nil}.  This allows for more efficient entry points in the runtime
2167 to be used.  Currently, this option is only available in conjunction with
2168 the NeXT runtime on Mac OS X 10.3 and later.
2169
2170 @item -fobjc-call-cxx-cdtors
2171 @opindex fobjc-call-cxx-cdtors
2172 For each Objective-C class, check if any of its instance variables is a
2173 C++ object with a non-trivial default constructor.  If so, synthesize a
2174 special @code{- (id) .cxx_construct} instance method that will run
2175 non-trivial default constructors on any such instance variables, in order,
2176 and then return @code{self}.  Similarly, check if any instance variable
2177 is a C++ object with a non-trivial destructor, and if so, synthesize a
2178 special @code{- (void) .cxx_destruct} method that will run
2179 all such default destructors, in reverse order.
2180
2181 The @code{- (id) .cxx_construct} and/or @code{- (void) .cxx_destruct} methods
2182 thusly generated will only operate on instance variables declared in the
2183 current Objective-C class, and not those inherited from superclasses.  It
2184 is the responsibility of the Objective-C runtime to invoke all such methods
2185 in an object's inheritance hierarchy.  The @code{- (id) .cxx_construct} methods
2186 will be invoked by the runtime immediately after a new object
2187 instance is allocated; the @code{- (void) .cxx_destruct} methods will
2188 be invoked immediately before the runtime deallocates an object instance.
2189
2190 As of this writing, only the NeXT runtime on Mac OS X 10.4 and later has
2191 support for invoking the @code{- (id) .cxx_construct} and
2192 @code{- (void) .cxx_destruct} methods.
2193
2194 @item -fobjc-direct-dispatch
2195 @opindex fobjc-direct-dispatch
2196 Allow fast jumps to the message dispatcher.  On Darwin this is
2197 accomplished via the comm page.
2198
2199 @item -fobjc-exceptions
2200 @opindex fobjc-exceptions
2201 Enable syntactic support for structured exception handling in Objective-C,
2202 similar to what is offered by C++ and Java.  This option is
2203 unavailable in conjunction with the NeXT runtime on Mac OS X 10.2 and
2204 earlier.
2205
2206 @smallexample
2207   @@try @{
2208     @dots{}
2209        @@throw expr;
2210     @dots{}
2211   @}
2212   @@catch (AnObjCClass *exc) @{
2213     @dots{}
2214       @@throw expr;
2215     @dots{}
2216       @@throw;
2217     @dots{}
2218   @}
2219   @@catch (AnotherClass *exc) @{
2220     @dots{}
2221   @}
2222   @@catch (id allOthers) @{
2223     @dots{}
2224   @}
2225   @@finally @{
2226     @dots{}
2227       @@throw expr;
2228     @dots{}
2229   @}
2230 @end smallexample
2231
2232 The @code{@@throw} statement may appear anywhere in an Objective-C or
2233 Objective-C++ program; when used inside of a @code{@@catch} block, the
2234 @code{@@throw} may appear without an argument (as shown above), in which case
2235 the object caught by the @code{@@catch} will be rethrown.
2236
2237 Note that only (pointers to) Objective-C objects may be thrown and
2238 caught using this scheme.  When an object is thrown, it will be caught
2239 by the nearest @code{@@catch} clause capable of handling objects of that type,
2240 analogously to how @code{catch} blocks work in C++ and Java.  A
2241 @code{@@catch(id @dots{})} clause (as shown above) may also be provided to catch
2242 any and all Objective-C exceptions not caught by previous @code{@@catch}
2243 clauses (if any).
2244
2245 The @code{@@finally} clause, if present, will be executed upon exit from the
2246 immediately preceding @code{@@try @dots{} @@catch} section.  This will happen
2247 regardless of whether any exceptions are thrown, caught or rethrown
2248 inside the @code{@@try @dots{} @@catch} section, analogously to the behavior
2249 of the @code{finally} clause in Java.
2250
2251 There are several caveats to using the new exception mechanism:
2252
2253 @itemize @bullet
2254 @item
2255 Although currently designed to be binary compatible with @code{NS_HANDLER}-style
2256 idioms provided by the @code{NSException} class, the new
2257 exceptions can only be used on Mac OS X 10.3 (Panther) and later
2258 systems, due to additional functionality needed in the (NeXT) Objective-C
2259 runtime.
2260
2261 @item
2262 As mentioned above, the new exceptions do not support handling
2263 types other than Objective-C objects.   Furthermore, when used from
2264 Objective-C++, the Objective-C exception model does not interoperate with C++
2265 exceptions at this time.  This means you cannot @code{@@throw} an exception
2266 from Objective-C and @code{catch} it in C++, or vice versa
2267 (i.e., @code{throw @dots{} @@catch}).
2268 @end itemize
2269
2270 The @option{-fobjc-exceptions} switch also enables the use of synchronization
2271 blocks for thread-safe execution:
2272
2273 @smallexample
2274   @@synchronized (ObjCClass *guard) @{
2275     @dots{}
2276   @}
2277 @end smallexample
2278
2279 Upon entering the @code{@@synchronized} block, a thread of execution shall
2280 first check whether a lock has been placed on the corresponding @code{guard}
2281 object by another thread.  If it has, the current thread shall wait until
2282 the other thread relinquishes its lock.  Once @code{guard} becomes available,
2283 the current thread will place its own lock on it, execute the code contained in
2284 the @code{@@synchronized} block, and finally relinquish the lock (thereby
2285 making @code{guard} available to other threads).
2286
2287 Unlike Java, Objective-C does not allow for entire methods to be marked
2288 @code{@@synchronized}.  Note that throwing exceptions out of
2289 @code{@@synchronized} blocks is allowed, and will cause the guarding object
2290 to be unlocked properly.
2291
2292 @item -fobjc-gc
2293 @opindex fobjc-gc
2294 Enable garbage collection (GC) in Objective-C and Objective-C++ programs.
2295
2296 @item -freplace-objc-classes
2297 @opindex freplace-objc-classes
2298 Emit a special marker instructing @command{ld(1)} not to statically link in
2299 the resulting object file, and allow @command{dyld(1)} to load it in at
2300 run time instead.  This is used in conjunction with the Fix-and-Continue
2301 debugging mode, where the object file in question may be recompiled and
2302 dynamically reloaded in the course of program execution, without the need
2303 to restart the program itself.  Currently, Fix-and-Continue functionality
2304 is only available in conjunction with the NeXT runtime on Mac OS X 10.3
2305 and later.
2306
2307 @item -fzero-link
2308 @opindex fzero-link
2309 When compiling for the NeXT runtime, the compiler ordinarily replaces calls
2310 to @code{objc_getClass("@dots{}")} (when the name of the class is known at
2311 compile time) with static class references that get initialized at load time,
2312 which improves run-time performance.  Specifying the @option{-fzero-link} flag
2313 suppresses this behavior and causes calls to @code{objc_getClass("@dots{}")}
2314 to be retained.  This is useful in Zero-Link debugging mode, since it allows
2315 for individual class implementations to be modified during program execution.
2316
2317 @item -gen-decls
2318 @opindex gen-decls
2319 Dump interface declarations for all classes seen in the source file to a
2320 file named @file{@var{sourcename}.decl}.
2321
2322 @item -Wassign-intercept
2323 @opindex Wassign-intercept
2324 Warn whenever an Objective-C assignment is being intercepted by the
2325 garbage collector.
2326
2327 @item -Wno-protocol
2328 @opindex Wno-protocol
2329 If a class is declared to implement a protocol, a warning is issued for
2330 every method in the protocol that is not implemented by the class.  The
2331 default behavior is to issue a warning for every method not explicitly
2332 implemented in the class, even if a method implementation is inherited
2333 from the superclass.  If you use the @option{-Wno-protocol} option, then
2334 methods inherited from the superclass are considered to be implemented,
2335 and no warning is issued for them.
2336
2337 @item -Wselector
2338 @opindex Wselector
2339 Warn if multiple methods of different types for the same selector are
2340 found during compilation.  The check is performed on the list of methods
2341 in the final stage of compilation.  Additionally, a check is performed
2342 for each selector appearing in a @code{@@selector(@dots{})}
2343 expression, and a corresponding method for that selector has been found
2344 during compilation.  Because these checks scan the method table only at
2345 the end of compilation, these warnings are not produced if the final
2346 stage of compilation is not reached, for example because an error is
2347 found during compilation, or because the @option{-fsyntax-only} option is
2348 being used.
2349
2350 @item -Wstrict-selector-match
2351 @opindex Wstrict-selector-match
2352 Warn if multiple methods with differing argument and/or return types are
2353 found for a given selector when attempting to send a message using this
2354 selector to a receiver of type @code{id} or @code{Class}.  When this flag
2355 is off (which is the default behavior), the compiler will omit such warnings
2356 if any differences found are confined to types which share the same size
2357 and alignment.
2358
2359 @item -Wundeclared-selector
2360 @opindex Wundeclared-selector
2361 Warn if a @code{@@selector(@dots{})} expression referring to an
2362 undeclared selector is found.  A selector is considered undeclared if no
2363 method with that name has been declared before the
2364 @code{@@selector(@dots{})} expression, either explicitly in an
2365 @code{@@interface} or @code{@@protocol} declaration, or implicitly in
2366 an @code{@@implementation} section.  This option always performs its
2367 checks as soon as a @code{@@selector(@dots{})} expression is found,
2368 while @option{-Wselector} only performs its checks in the final stage of
2369 compilation.  This also enforces the coding style convention
2370 that methods and selectors must be declared before being used.
2371
2372 @item -print-objc-runtime-info
2373 @opindex print-objc-runtime-info
2374 Generate C header describing the largest structure that is passed by
2375 value, if any.
2376
2377 @end table
2378
2379 @node Language Independent Options
2380 @section Options to Control Diagnostic Messages Formatting
2381 @cindex options to control diagnostics formatting
2382 @cindex diagnostic messages
2383 @cindex message formatting
2384
2385 Traditionally, diagnostic messages have been formatted irrespective of
2386 the output device's aspect (e.g.@: its width, @dots{}).  The options described
2387 below can be used to control the diagnostic messages formatting
2388 algorithm, e.g.@: how many characters per line, how often source location
2389 information should be reported.  Right now, only the C++ front end can
2390 honor these options.  However it is expected, in the near future, that
2391 the remaining front ends would be able to digest them correctly.
2392
2393 @table @gcctabopt
2394 @item -fmessage-length=@var{n}
2395 @opindex fmessage-length
2396 Try to format error messages so that they fit on lines of about @var{n}
2397 characters.  The default is 72 characters for @command{g++} and 0 for the rest of
2398 the front ends supported by GCC@.  If @var{n} is zero, then no
2399 line-wrapping will be done; each error message will appear on a single
2400 line.
2401
2402 @opindex fdiagnostics-show-location
2403 @item -fdiagnostics-show-location=once
2404 Only meaningful in line-wrapping mode.  Instructs the diagnostic messages
2405 reporter to emit @emph{once} source location information; that is, in
2406 case the message is too long to fit on a single physical line and has to
2407 be wrapped, the source location won't be emitted (as prefix) again,
2408 over and over, in subsequent continuation lines.  This is the default
2409 behavior.
2410
2411 @item -fdiagnostics-show-location=every-line
2412 Only meaningful in line-wrapping mode.  Instructs the diagnostic
2413 messages reporter to emit the same source location information (as
2414 prefix) for physical lines that result from the process of breaking
2415 a message which is too long to fit on a single line.
2416
2417 @item -fdiagnostics-show-option
2418 @opindex fdiagnostics-show-option
2419 This option instructs the diagnostic machinery to add text to each
2420 diagnostic emitted, which indicates which command line option directly
2421 controls that diagnostic, when such an option is known to the
2422 diagnostic machinery.
2423
2424 @item -Wcoverage-mismatch
2425 @opindex Wcoverage-mismatch
2426 Warn if feedback profiles do not match when using the
2427 @option{-fprofile-use} option.
2428 If a source file was changed between @option{-fprofile-gen} and
2429 @option{-fprofile-use}, the files with the profile feedback can fail
2430 to match the source file and GCC can not use the profile feedback
2431 information.  By default, GCC emits an error message in this case.
2432 The option @option{-Wcoverage-mismatch} emits a warning instead of an
2433 error.  GCC does not use appropriate feedback profiles, so using this
2434 option can result in poorly optimized code.  This option is useful
2435 only in the case of very minor changes such as bug fixes to an
2436 existing code-base.
2437
2438 @end table
2439
2440 @node Warning Options
2441 @section Options to Request or Suppress Warnings
2442 @cindex options to control warnings
2443 @cindex warning messages
2444 @cindex messages, warning
2445 @cindex suppressing warnings
2446
2447 Warnings are diagnostic messages that report constructions which
2448 are not inherently erroneous but which are risky or suggest there
2449 may have been an error.
2450
2451 You can request many specific warnings with options beginning @samp{-W},
2452 for example @option{-Wimplicit} to request warnings on implicit
2453 declarations.  Each of these specific warning options also has a
2454 negative form beginning @samp{-Wno-} to turn off warnings;
2455 for example, @option{-Wno-implicit}.  This manual lists only one of the
2456 two forms, whichever is not the default.
2457
2458 The following options control the amount and kinds of warnings produced
2459 by GCC; for further, language-specific options also refer to
2460 @ref{C++ Dialect Options} and @ref{Objective-C and Objective-C++ Dialect
2461 Options}.
2462
2463 @table @gcctabopt
2464 @cindex syntax checking
2465 @item -fsyntax-only
2466 @opindex fsyntax-only
2467 Check the code for syntax errors, but don't do anything beyond that.
2468
2469 @item -pedantic
2470 @opindex pedantic
2471 Issue all the warnings demanded by strict ISO C and ISO C++;
2472 reject all programs that use forbidden extensions, and some other
2473 programs that do not follow ISO C and ISO C++.  For ISO C, follows the
2474 version of the ISO C standard specified by any @option{-std} option used.
2475
2476 Valid ISO C and ISO C++ programs should compile properly with or without
2477 this option (though a rare few will require @option{-ansi} or a
2478 @option{-std} option specifying the required version of ISO C)@.  However,
2479 without this option, certain GNU extensions and traditional C and C++
2480 features are supported as well.  With this option, they are rejected.
2481
2482 @option{-pedantic} does not cause warning messages for use of the
2483 alternate keywords whose names begin and end with @samp{__}.  Pedantic
2484 warnings are also disabled in the expression that follows
2485 @code{__extension__}.  However, only system header files should use
2486 these escape routes; application programs should avoid them.
2487 @xref{Alternate Keywords}.
2488
2489 Some users try to use @option{-pedantic} to check programs for strict ISO
2490 C conformance.  They soon find that it does not do quite what they want:
2491 it finds some non-ISO practices, but not all---only those for which
2492 ISO C @emph{requires} a diagnostic, and some others for which
2493 diagnostics have been added.
2494
2495 A feature to report any failure to conform to ISO C might be useful in
2496 some instances, but would require considerable additional work and would
2497 be quite different from @option{-pedantic}.  We don't have plans to
2498 support such a feature in the near future.
2499
2500 Where the standard specified with @option{-std} represents a GNU
2501 extended dialect of C, such as @samp{gnu89} or @samp{gnu99}, there is a
2502 corresponding @dfn{base standard}, the version of ISO C on which the GNU
2503 extended dialect is based.  Warnings from @option{-pedantic} are given
2504 where they are required by the base standard.  (It would not make sense
2505 for such warnings to be given only for features not in the specified GNU
2506 C dialect, since by definition the GNU dialects of C include all
2507 features the compiler supports with the given option, and there would be
2508 nothing to warn about.)
2509
2510 @item -pedantic-errors
2511 @opindex pedantic-errors
2512 Like @option{-pedantic}, except that errors are produced rather than
2513 warnings.
2514
2515 @item -w
2516 @opindex w
2517 Inhibit all warning messages.
2518
2519 @item -Wno-import
2520 @opindex Wno-import
2521 Inhibit warning messages about the use of @samp{#import}.
2522
2523 @item -Wchar-subscripts
2524 @opindex Wchar-subscripts
2525 Warn if an array subscript has type @code{char}.  This is a common cause
2526 of error, as programmers often forget that this type is signed on some
2527 machines.
2528 This warning is enabled by @option{-Wall}.
2529
2530 @item -Wcomment
2531 @opindex Wcomment
2532 Warn whenever a comment-start sequence @samp{/*} appears in a @samp{/*}
2533 comment, or whenever a Backslash-Newline appears in a @samp{//} comment.
2534 This warning is enabled by @option{-Wall}.
2535
2536 @item -Wfatal-errors
2537 @opindex Wfatal-errors
2538 This option causes the compiler to abort compilation on the first error
2539 occurred rather than trying to keep going and printing further error
2540 messages.
2541
2542 @item -Wformat
2543 @opindex Wformat
2544 @opindex ffreestanding
2545 @opindex fno-builtin
2546 Check calls to @code{printf} and @code{scanf}, etc., to make sure that
2547 the arguments supplied have types appropriate to the format string
2548 specified, and that the conversions specified in the format string make
2549 sense.  This includes standard functions, and others specified by format
2550 attributes (@pxref{Function Attributes}), in the @code{printf},
2551 @code{scanf}, @code{strftime} and @code{strfmon} (an X/Open extension,
2552 not in the C standard) families (or other target-specific families).
2553 Which functions are checked without format attributes having been
2554 specified depends on the standard version selected, and such checks of
2555 functions without the attribute specified are disabled by
2556 @option{-ffreestanding} or @option{-fno-builtin}.
2557
2558 The formats are checked against the format features supported by GNU
2559 libc version 2.2.  These include all ISO C90 and C99 features, as well
2560 as features from the Single Unix Specification and some BSD and GNU
2561 extensions.  Other library implementations may not support all these
2562 features; GCC does not support warning about features that go beyond a
2563 particular library's limitations.  However, if @option{-pedantic} is used
2564 with @option{-Wformat}, warnings will be given about format features not
2565 in the selected standard version (but not for @code{strfmon} formats,
2566 since those are not in any version of the C standard).  @xref{C Dialect
2567 Options,,Options Controlling C Dialect}.
2568
2569 Since @option{-Wformat} also checks for null format arguments for
2570 several functions, @option{-Wformat} also implies @option{-Wnonnull}.
2571
2572 @option{-Wformat} is included in @option{-Wall}.  For more control over some
2573 aspects of format checking, the options @option{-Wformat-y2k},
2574 @option{-Wno-format-extra-args}, @option{-Wno-format-zero-length},
2575 @option{-Wformat-nonliteral}, @option{-Wformat-security}, and
2576 @option{-Wformat=2} are available, but are not included in @option{-Wall}.
2577
2578 @item -Wformat-y2k
2579 @opindex Wformat-y2k
2580 If @option{-Wformat} is specified, also warn about @code{strftime}
2581 formats which may yield only a two-digit year.
2582
2583 @item -Wno-format-extra-args
2584 @opindex Wno-format-extra-args
2585 If @option{-Wformat} is specified, do not warn about excess arguments to a
2586 @code{printf} or @code{scanf} format function.  The C standard specifies
2587 that such arguments are ignored.
2588
2589 Where the unused arguments lie between used arguments that are
2590 specified with @samp{$} operand number specifications, normally
2591 warnings are still given, since the implementation could not know what
2592 type to pass to @code{va_arg} to skip the unused arguments.  However,
2593 in the case of @code{scanf} formats, this option will suppress the
2594 warning if the unused arguments are all pointers, since the Single
2595 Unix Specification says that such unused arguments are allowed.
2596
2597 @item -Wno-format-zero-length
2598 @opindex Wno-format-zero-length
2599 If @option{-Wformat} is specified, do not warn about zero-length formats.
2600 The C standard specifies that zero-length formats are allowed.
2601
2602 @item -Wformat-nonliteral
2603 @opindex Wformat-nonliteral
2604 If @option{-Wformat} is specified, also warn if the format string is not a
2605 string literal and so cannot be checked, unless the format function
2606 takes its format arguments as a @code{va_list}.
2607
2608 @item -Wformat-security
2609 @opindex Wformat-security
2610 If @option{-Wformat} is specified, also warn about uses of format
2611 functions that represent possible security problems.  At present, this
2612 warns about calls to @code{printf} and @code{scanf} functions where the
2613 format string is not a string literal and there are no format arguments,
2614 as in @code{printf (foo);}.  This may be a security hole if the format
2615 string came from untrusted input and contains @samp{%n}.  (This is
2616 currently a subset of what @option{-Wformat-nonliteral} warns about, but
2617 in future warnings may be added to @option{-Wformat-security} that are not
2618 included in @option{-Wformat-nonliteral}.)
2619
2620 @item -Wformat=2
2621 @opindex Wformat=2
2622 Enable @option{-Wformat} plus format checks not included in
2623 @option{-Wformat}.  Currently equivalent to @samp{-Wformat
2624 -Wformat-nonliteral -Wformat-security -Wformat-y2k}.
2625
2626 @item -Wnonnull
2627 @opindex Wnonnull
2628 Warn about passing a null pointer for arguments marked as
2629 requiring a non-null value by the @code{nonnull} function attribute.
2630
2631 @option{-Wnonnull} is included in @option{-Wall} and @option{-Wformat}.  It
2632 can be disabled with the @option{-Wno-nonnull} option.
2633
2634 @item -Winit-self @r{(C, C++, Objective-C and Objective-C++ only)}
2635 @opindex Winit-self
2636 Warn about uninitialized variables which are initialized with themselves.
2637 Note this option can only be used with the @option{-Wuninitialized} option,
2638 which in turn only works with @option{-O1} and above.
2639
2640 For example, GCC will warn about @code{i} being uninitialized in the
2641 following snippet only when @option{-Winit-self} has been specified:
2642 @smallexample
2643 @group
2644 int f()
2645 @{
2646   int i = i;
2647   return i;
2648 @}
2649 @end group
2650 @end smallexample
2651
2652 @item -Wimplicit-int
2653 @opindex Wimplicit-int
2654 Warn when a declaration does not specify a type.
2655 This warning is enabled by @option{-Wall}.
2656
2657 @item -Wimplicit-function-declaration
2658 @opindex Wimplicit-function-declaration
2659 @opindex Wno-implicit-function-declaration
2660 Give a warning whenever a function is used before being declared. In
2661 C99 mode (@option{-std=c99} or @option{-std=gnu99}), this warning is
2662 enabled by default and it is made into an error by
2663 @option{-pedantic-errors}. This warning is also enabled by
2664 @option{-Wall}.
2665
2666 @item -Wimplicit
2667 @opindex Wimplicit
2668 Same as @option{-Wimplicit-int} and @option{-Wimplicit-function-declaration}.
2669 This warning is enabled by @option{-Wall}.
2670
2671 @item -Wmain
2672 @opindex Wmain
2673 Warn if the type of @samp{main} is suspicious.  @samp{main} should be a
2674 function with external linkage, returning int, taking either zero
2675 arguments, two, or three arguments of appropriate types.
2676 This warning is enabled by @option{-Wall}.
2677
2678 @item -Wmissing-braces
2679 @opindex Wmissing-braces
2680 Warn if an aggregate or union initializer is not fully bracketed.  In
2681 the following example, the initializer for @samp{a} is not fully
2682 bracketed, but that for @samp{b} is fully bracketed.
2683
2684 @smallexample
2685 int a[2][2] = @{ 0, 1, 2, 3 @};
2686 int b[2][2] = @{ @{ 0, 1 @}, @{ 2, 3 @} @};
2687 @end smallexample
2688
2689 This warning is enabled by @option{-Wall}.
2690
2691 @item -Wmissing-include-dirs @r{(C, C++, Objective-C and Objective-C++ only)}
2692 @opindex Wmissing-include-dirs
2693 Warn if a user-supplied include directory does not exist.
2694
2695 @item -Wparentheses
2696 @opindex Wparentheses
2697 Warn if parentheses are omitted in certain contexts, such
2698 as when there is an assignment in a context where a truth value
2699 is expected, or when operators are nested whose precedence people
2700 often get confused about.
2701
2702 Also warn if a comparison like @samp{x<=y<=z} appears; this is
2703 equivalent to @samp{(x<=y ? 1 : 0) <= z}, which is a different
2704 interpretation from that of ordinary mathematical notation.
2705
2706 Also warn about constructions where there may be confusion to which
2707 @code{if} statement an @code{else} branch belongs.  Here is an example of
2708 such a case:
2709
2710 @smallexample
2711 @group
2712 @{
2713   if (a)
2714     if (b)
2715       foo ();
2716   else
2717     bar ();
2718 @}
2719 @end group
2720 @end smallexample
2721
2722 In C/C++, every @code{else} branch belongs to the innermost possible
2723 @code{if} statement, which in this example is @code{if (b)}.  This is
2724 often not what the programmer expected, as illustrated in the above
2725 example by indentation the programmer chose.  When there is the
2726 potential for this confusion, GCC will issue a warning when this flag
2727 is specified.  To eliminate the warning, add explicit braces around
2728 the innermost @code{if} statement so there is no way the @code{else}
2729 could belong to the enclosing @code{if}.  The resulting code would
2730 look like this:
2731
2732 @smallexample
2733 @group
2734 @{
2735   if (a)
2736     @{
2737       if (b)
2738         foo ();
2739       else
2740         bar ();
2741     @}
2742 @}
2743 @end group
2744 @end smallexample
2745
2746 This warning is enabled by @option{-Wall}.
2747
2748 @item -Wsequence-point
2749 @opindex Wsequence-point
2750 Warn about code that may have undefined semantics because of violations
2751 of sequence point rules in the C and C++ standards.
2752
2753 The C and C++ standards defines the order in which expressions in a C/C++
2754 program are evaluated in terms of @dfn{sequence points}, which represent
2755 a partial ordering between the execution of parts of the program: those
2756 executed before the sequence point, and those executed after it.  These
2757 occur after the evaluation of a full expression (one which is not part
2758 of a larger expression), after the evaluation of the first operand of a
2759 @code{&&}, @code{||}, @code{? :} or @code{,} (comma) operator, before a
2760 function is called (but after the evaluation of its arguments and the
2761 expression denoting the called function), and in certain other places.
2762 Other than as expressed by the sequence point rules, the order of
2763 evaluation of subexpressions of an expression is not specified.  All
2764 these rules describe only a partial order rather than a total order,
2765 since, for example, if two functions are called within one expression
2766 with no sequence point between them, the order in which the functions
2767 are called is not specified.  However, the standards committee have
2768 ruled that function calls do not overlap.
2769
2770 It is not specified when between sequence points modifications to the
2771 values of objects take effect.  Programs whose behavior depends on this
2772 have undefined behavior; the C and C++ standards specify that ``Between
2773 the previous and next sequence point an object shall have its stored
2774 value modified at most once by the evaluation of an expression.  
2775 Furthermore, the prior value shall be read only to determine the value
2776 to be stored.''.  If a program breaks these rules, the results on any
2777 particular implementation are entirely unpredictable.
2778
2779 Examples of code with undefined behavior are @code{a = a++;}, @code{a[n]
2780 = b[n++]} and @code{a[i++] = i;}.  Some more complicated cases are not
2781 diagnosed by this option, and it may give an occasional false positive
2782 result, but in general it has been found fairly effective at detecting
2783 this sort of problem in programs.
2784
2785 The standard is worded confusingly, therefore there is some debate
2786 over the precise meaning of the sequence point rules in subtle cases.
2787 Links to discussions of the problem, including proposed formal
2788 definitions, may be found on the GCC readings page, at
2789 @w{@uref{http://gcc.gnu.org/readings.html}}.
2790
2791 This warning is enabled by @option{-Wall} for C and C++.
2792
2793 @item -Wreturn-type
2794 @opindex Wreturn-type
2795 Warn whenever a function is defined with a return-type that defaults to
2796 @code{int}.  Also warn about any @code{return} statement with no
2797 return-value in a function whose return-type is not @code{void}.
2798
2799 Also warn if the return type of a function has a type qualifier
2800 such as @code{const}.  For ISO C such a type qualifier has no effect,
2801 since the value returned by a function is not an lvalue.
2802 For C++, the warning is only emitted for scalar types or @code{void}.
2803 ISO C prohibits qualified @code{void} return types on function
2804 definitions, so such return types always receive a warning
2805 even without this option.
2806
2807 For C++, a function without return type always produces a diagnostic
2808 message, even when @option{-Wno-return-type} is specified.  The only
2809 exceptions are @samp{main} and functions defined in system headers.
2810
2811 This warning is enabled by @option{-Wall}.
2812
2813 @item -Wswitch
2814 @opindex Wswitch
2815 Warn whenever a @code{switch} statement has an index of enumerated type
2816 and lacks a @code{case} for one or more of the named codes of that
2817 enumeration.  (The presence of a @code{default} label prevents this
2818 warning.)  @code{case} labels outside the enumeration range also
2819 provoke warnings when this option is used.
2820 This warning is enabled by @option{-Wall}.
2821
2822 @item -Wswitch-default
2823 @opindex Wswitch-switch
2824 Warn whenever a @code{switch} statement does not have a @code{default}
2825 case.
2826
2827 @item -Wswitch-enum
2828 @opindex Wswitch-enum
2829 Warn whenever a @code{switch} statement has an index of enumerated type
2830 and lacks a @code{case} for one or more of the named codes of that
2831 enumeration.  @code{case} labels outside the enumeration range also
2832 provoke warnings when this option is used.
2833
2834 @item -Wtrigraphs
2835 @opindex Wtrigraphs
2836 Warn if any trigraphs are encountered that might change the meaning of
2837 the program (trigraphs within comments are not warned about).
2838 This warning is enabled by @option{-Wall}.
2839
2840 @item -Wunused-function
2841 @opindex Wunused-function
2842 Warn whenever a static function is declared but not defined or a
2843 non-inline static function is unused.
2844 This warning is enabled by @option{-Wall}.
2845
2846 @item -Wunused-label
2847 @opindex Wunused-label
2848 Warn whenever a label is declared but not used.
2849 This warning is enabled by @option{-Wall}.
2850
2851 To suppress this warning use the @samp{unused} attribute
2852 (@pxref{Variable Attributes}).
2853
2854 @item -Wunused-parameter
2855 @opindex Wunused-parameter
2856 Warn whenever a function parameter is unused aside from its declaration.
2857
2858 To suppress this warning use the @samp{unused} attribute
2859 (@pxref{Variable Attributes}).
2860
2861 @item -Wunused-variable
2862 @opindex Wunused-variable
2863 Warn whenever a local variable or non-constant static variable is unused
2864 aside from its declaration.
2865 This warning is enabled by @option{-Wall}.
2866
2867 To suppress this warning use the @samp{unused} attribute
2868 (@pxref{Variable Attributes}).
2869
2870 @item -Wunused-value
2871 @opindex Wunused-value
2872 Warn whenever a statement computes a result that is explicitly not
2873 used. To suppress this warning cast the unused expression to
2874 @samp{void}. This includes an expression-statement or the left-hand
2875 side of a comma expression that contains no side effects. For example,
2876 an expression such as @samp{x[i,j]} will cause a warning, while
2877 @samp{x[(void)i,j]} will not.
2878
2879 This warning is enabled by @option{-Wall}.
2880
2881 @item -Wunused
2882 @opindex Wunused
2883 All the above @option{-Wunused} options combined.
2884
2885 In order to get a warning about an unused function parameter, you must
2886 either specify @samp{-Wextra -Wunused} (note that @samp{-Wall} implies
2887 @samp{-Wunused}), or separately specify @option{-Wunused-parameter}.
2888
2889 @item -Wuninitialized
2890 @opindex Wuninitialized
2891 Warn if an automatic variable is used without first being initialized or
2892 if a variable may be clobbered by a @code{setjmp} call.
2893
2894 These warnings are possible only in optimizing compilation,
2895 because they require data flow information that is computed only
2896 when optimizing.  If you do not specify @option{-O}, you will not get
2897 these warnings. Instead, GCC will issue a warning about @option{-Wuninitialized}
2898 requiring @option{-O}.
2899
2900 If you want to warn about code which uses the uninitialized value of the
2901 variable in its own initializer, use the @option{-Winit-self} option.
2902
2903 These warnings occur for individual uninitialized or clobbered
2904 elements of structure, union or array variables as well as for
2905 variables which are uninitialized or clobbered as a whole.  They do
2906 not occur for variables or elements declared @code{volatile}.  Because
2907 these warnings depend on optimization, the exact variables or elements
2908 for which there are warnings will depend on the precise optimization
2909 options and version of GCC used.
2910
2911 Note that there may be no warning about a variable that is used only
2912 to compute a value that itself is never used, because such
2913 computations may be deleted by data flow analysis before the warnings
2914 are printed.
2915
2916 These warnings are made optional because GCC is not smart
2917 enough to see all the reasons why the code might be correct
2918 despite appearing to have an error.  Here is one example of how
2919 this can happen:
2920
2921 @smallexample
2922 @group
2923 @{
2924   int x;
2925   switch (y)
2926     @{
2927     case 1: x = 1;
2928       break;
2929     case 2: x = 4;
2930       break;
2931     case 3: x = 5;
2932     @}
2933   foo (x);
2934 @}
2935 @end group
2936 @end smallexample
2937
2938 @noindent
2939 If the value of @code{y} is always 1, 2 or 3, then @code{x} is
2940 always initialized, but GCC doesn't know this.  Here is
2941 another common case:
2942
2943 @smallexample
2944 @{
2945   int save_y;
2946   if (change_y) save_y = y, y = new_y;
2947   @dots{}
2948   if (change_y) y = save_y;
2949 @}
2950 @end smallexample
2951
2952 @noindent
2953 This has no bug because @code{save_y} is used only if it is set.
2954
2955 @cindex @code{longjmp} warnings
2956 This option also warns when a non-volatile automatic variable might be
2957 changed by a call to @code{longjmp}.  These warnings as well are possible
2958 only in optimizing compilation.
2959
2960 The compiler sees only the calls to @code{setjmp}.  It cannot know
2961 where @code{longjmp} will be called; in fact, a signal handler could
2962 call it at any point in the code.  As a result, you may get a warning
2963 even when there is in fact no problem because @code{longjmp} cannot
2964 in fact be called at the place which would cause a problem.
2965
2966 Some spurious warnings can be avoided if you declare all the functions
2967 you use that never return as @code{noreturn}.  @xref{Function
2968 Attributes}.
2969
2970 This warning is enabled by @option{-Wall}.
2971
2972 @item -Wunknown-pragmas
2973 @opindex Wunknown-pragmas
2974 @cindex warning for unknown pragmas
2975 @cindex unknown pragmas, warning
2976 @cindex pragmas, warning of unknown
2977 Warn when a #pragma directive is encountered which is not understood by
2978 GCC@.  If this command line option is used, warnings will even be issued
2979 for unknown pragmas in system header files.  This is not the case if
2980 the warnings were only enabled by the @option{-Wall} command line option.
2981
2982 @item -Wno-pragmas
2983 @opindex Wno-pragmas
2984 @opindex Wpragmas
2985 Do not warn about misuses of pragmas, such as incorrect parameters,
2986 invalid syntax, or conflicts between pragmas.  See also
2987 @samp{-Wunknown-pragmas}.
2988
2989 @item -Wstrict-aliasing
2990 @opindex Wstrict-aliasing
2991 This option is only active when @option{-fstrict-aliasing} is active.
2992 It warns about code which might break the strict aliasing rules that the
2993 compiler is using for optimization.  The warning does not catch all
2994 cases, but does attempt to catch the more common pitfalls.  It is
2995 included in @option{-Wall}.
2996
2997 @item -Wstrict-aliasing=2
2998 @opindex Wstrict-aliasing=2
2999 This option is only active when @option{-fstrict-aliasing} is active.
3000 It warns about code which might break the strict aliasing rules that the
3001 compiler is using for optimization.  This warning catches more cases than
3002 @option{-Wstrict-aliasing}, but it will also give a warning for some ambiguous
3003 cases that are safe.
3004
3005 @item -Wstrict-overflow
3006 @item -Wstrict-overflow=@var{n}
3007 @opindex -Wstrict-overflow
3008 This option is only active when @option{-fstrict-overflow} is active.
3009 It warns about cases where the compiler optimizes based on the
3010 assumption that signed overflow does not occur.  Note that it does not
3011 warn about all cases where the code might overflow: it only warns
3012 about cases where the compiler implements some optimization.  Thus
3013 this warning depends on the optimization level.
3014
3015 An optimization which assumes that signed overflow does not occur is
3016 perfectly safe if the values of the variables involved are such that
3017 overflow never does, in fact, occur.  Therefore this warning can
3018 easily give a false positive: a warning about code which is not
3019 actually a problem.  To help focus on important issues, several
3020 warning levels are defined.
3021
3022 @table @option
3023 @item -Wstrict-overflow=1
3024 Warn about cases which are both questionable and easy to avoid.  For
3025 example: @code{x + 1 > x}; with @option{-fstrict-overflow}, the
3026 compiler will simplify this to @code{1}.  This level of
3027 @option{-Wstrict-overflow} is enabled by @option{-Wall}; higher levels
3028 are not, and must be explicitly requested.
3029
3030 @item -Wstrict-overflow=2
3031 Also warn about other cases where a comparison is simplified to a
3032 constant.  For example: @code{abs (x) >= 0}.  This can only be
3033 simplified when @option{-fstrict-overflow} is in effect, because
3034 @code{abs (INT_MIN)} overflows to @code{INT_MIN}, which is less than
3035 zero.  @option{-Wstrict-overflow} (with no level) is the same as
3036 @option{-Wstrict-overflow=2}.
3037
3038 @item -Wstrict-overflow=3
3039 Also warn about other cases where a comparison is simplified.  For
3040 example: @code{x + 1 > 1} will be simplified to @code{x > 0}.
3041
3042 @item -Wstrict-overflow=4
3043 Also warn about other simplifications not covered by the above cases.
3044 For example: @code{(x * 10) / 5} will be simplified to @code{x * 2}.
3045
3046 @item -Wstrict-overflow=5
3047 Also warn about cases where the compiler reduces the magnitude of a
3048 constant involved in a comparison.  For example: @code{x + 2 > y} will
3049 be simplified to @code{x + 1 >= y}.  This is reported only at the
3050 highest warning level because this simplification applies to many
3051 comparisons, so this warning level will give a very large number of
3052 false positives.
3053 @end table
3054
3055 @item -Warray-bounds
3056 @opindex Wno-array-bounds
3057 @opindex Warray-bounds
3058 This option is only active when @option{-ftree-vrp} is active
3059 (default for -O2 and above). It warns about subscripts to arrays
3060 that are always out of bounds. This warning is enabled by @option{-Wall}.
3061
3062 @item -Wall
3063 @opindex Wall
3064 All of the above @samp{-W} options combined.  This enables all the
3065 warnings about constructions that some users consider questionable, and
3066 that are easy to avoid (or modify to prevent the warning), even in
3067 conjunction with macros.  This also enables some language-specific
3068 warnings described in @ref{C++ Dialect Options} and
3069 @ref{Objective-C and Objective-C++ Dialect Options}.
3070 @end table
3071
3072 The following @option{-W@dots{}} options are not implied by @option{-Wall}.
3073 Some of them warn about constructions that users generally do not
3074 consider questionable, but which occasionally you might wish to check
3075 for; others warn about constructions that are necessary or hard to avoid
3076 in some cases, and there is no simple way to modify the code to suppress
3077 the warning.
3078
3079 @table @gcctabopt
3080 @item -Wextra
3081 @opindex W
3082 @opindex Wextra
3083 (This option used to be called @option{-W}.  The older name is still
3084 supported, but the newer name is more descriptive.)  Print extra warning
3085 messages for these events:
3086
3087 @itemize @bullet
3088 @item
3089 A function can return either with or without a value.  (Falling
3090 off the end of the function body is considered returning without
3091 a value.)  For example, this function would evoke such a
3092 warning:
3093
3094 @smallexample
3095 @group
3096 foo (a)
3097 @{
3098   if (a > 0)
3099     return a;
3100 @}
3101 @end group
3102 @end smallexample
3103
3104 @item
3105 An unsigned value is compared against zero with @samp{<} or @samp{>=}.
3106
3107 @item @r{(C only)}
3108 Storage-class specifiers like @code{static} are not the first things
3109 in a declaration.  According to the C Standard, this usage is
3110 obsolescent.  This warning can be independently controlled by
3111 @option{-Wold-style-declaration}.
3112
3113 @item
3114 If @option{-Wall} or @option{-Wunused} is also specified, warn about unused
3115 arguments.
3116
3117 @item
3118 A comparison between signed and unsigned values could produce an
3119 incorrect result when the signed value is converted to unsigned.
3120 (But don't warn if @option{-Wno-sign-compare} is also specified.)
3121
3122 @item
3123 An aggregate has an initializer which does not initialize all members.
3124 This warning can be independently controlled by
3125 @option{-Wmissing-field-initializers}.
3126
3127 @item
3128 An initialized field without side effects is overridden when using
3129 designated initializers (@pxref{Designated Inits, , Designated
3130 Initializers}).  This warning can be independently controlled by
3131 @option{-Woverride-init}.
3132
3133 @item @r{(C only)}
3134 A function parameter is declared without a type specifier in K&R-style
3135 functions.  This warning can be independently controlled by
3136 @option{-Wmissing-parameter-type}.
3137
3138 @item
3139 An empty body occurs in an @samp{if}, @samp{else} or
3140 @samp{do while} statement. This warning can be independently
3141 controlled by @option{-Wempty-body}.
3142
3143 @item
3144 A pointer is compared against integer zero with @samp{<}, @samp{<=},
3145 @samp{>}, or @samp{>=}.
3146
3147 @item
3148 A variable might be changed by @samp{longjmp} or @samp{vfork}.
3149 This warning can be independently controlled by @option{-Wclobbered}.
3150
3151 @item @r{(C++ only)}
3152 An enumerator and a non-enumerator both appear in a conditional expression.
3153
3154 @item @r{(C++ only)}
3155 A non-static reference or non-static @samp{const} member appears in a
3156 class without constructors.
3157
3158 @item @r{(C++ only)}
3159 Ambiguous virtual bases.
3160
3161 @item @r{(C++ only)}
3162 Subscripting an array which has been declared @samp{register}.
3163
3164 @item @r{(C++ only)}
3165 Taking the address of a variable which has been declared @samp{register}.
3166
3167 @item @r{(C++ only)}
3168 A base class is not initialized in a derived class' copy constructor.
3169 @end itemize
3170
3171 @item -Wno-div-by-zero
3172 @opindex Wno-div-by-zero
3173 @opindex Wdiv-by-zero
3174 Do not warn about compile-time integer division by zero.  Floating point
3175 division by zero is not warned about, as it can be a legitimate way of
3176 obtaining infinities and NaNs.
3177
3178 @item -Wsystem-headers
3179 @opindex Wsystem-headers
3180 @cindex warnings from system headers
3181 @cindex system headers, warnings from
3182 Print warning messages for constructs found in system header files.
3183 Warnings from system headers are normally suppressed, on the assumption
3184 that they usually do not indicate real problems and would only make the
3185 compiler output harder to read.  Using this command line option tells
3186 GCC to emit warnings from system headers as if they occurred in user
3187 code.  However, note that using @option{-Wall} in conjunction with this
3188 option will @emph{not} warn about unknown pragmas in system
3189 headers---for that, @option{-Wunknown-pragmas} must also be used.
3190
3191 @item -Wfloat-equal
3192 @opindex Wfloat-equal
3193 Warn if floating point values are used in equality comparisons.
3194
3195 The idea behind this is that sometimes it is convenient (for the
3196 programmer) to consider floating-point values as approximations to
3197 infinitely precise real numbers.  If you are doing this, then you need
3198 to compute (by analyzing the code, or in some other way) the maximum or
3199 likely maximum error that the computation introduces, and allow for it
3200 when performing comparisons (and when producing output, but that's a
3201 different problem).  In particular, instead of testing for equality, you
3202 would check to see whether the two values have ranges that overlap; and
3203 this is done with the relational operators, so equality comparisons are
3204 probably mistaken.
3205
3206 @item -Wtraditional @r{(C only)}
3207 @opindex Wtraditional
3208 Warn about certain constructs that behave differently in traditional and
3209 ISO C@.  Also warn about ISO C constructs that have no traditional C
3210 equivalent, and/or problematic constructs which should be avoided.
3211
3212 @itemize @bullet
3213 @item
3214 Macro parameters that appear within string literals in the macro body.
3215 In traditional C macro replacement takes place within string literals,
3216 but does not in ISO C@.
3217
3218 @item
3219 In traditional C, some preprocessor directives did not exist.
3220 Traditional preprocessors would only consider a line to be a directive
3221 if the @samp{#} appeared in column 1 on the line.  Therefore
3222 @option{-Wtraditional} warns about directives that traditional C
3223 understands but would ignore because the @samp{#} does not appear as the
3224 first character on the line.  It also suggests you hide directives like
3225 @samp{#pragma} not understood by traditional C by indenting them.  Some
3226 traditional implementations would not recognize @samp{#elif}, so it
3227 suggests avoiding it altogether.
3228
3229 @item
3230 A function-like macro that appears without arguments.
3231
3232 @item
3233 The unary plus operator.
3234
3235 @item
3236 The @samp{U} integer constant suffix, or the @samp{F} or @samp{L} floating point
3237 constant suffixes.  (Traditional C does support the @samp{L} suffix on integer
3238 constants.)  Note, these suffixes appear in macros defined in the system
3239 headers of most modern systems, e.g.@: the @samp{_MIN}/@samp{_MAX} macros in @code{<limits.h>}.
3240 Use of these macros in user code might normally lead to spurious
3241 warnings, however GCC's integrated preprocessor has enough context to
3242 avoid warning in these cases.
3243
3244 @item
3245 A function declared external in one block and then used after the end of
3246 the block.
3247
3248 @item
3249 A @code{switch} statement has an operand of type @code{long}.
3250
3251 @item
3252 A non-@code{static} function declaration follows a @code{static} one.
3253 This construct is not accepted by some traditional C compilers.
3254
3255 @item
3256 The ISO type of an integer constant has a different width or
3257 signedness from its traditional type.  This warning is only issued if
3258 the base of the constant is ten.  I.e.@: hexadecimal or octal values, which
3259 typically represent bit patterns, are not warned about.
3260
3261 @item
3262 Usage of ISO string concatenation is detected.
3263
3264 @item
3265 Initialization of automatic aggregates.
3266
3267 @item
3268 Identifier conflicts with labels.  Traditional C lacks a separate
3269 namespace for labels.
3270
3271 @item
3272 Initialization of unions.  If the initializer is zero, the warning is
3273 omitted.  This is done under the assumption that the zero initializer in
3274 user code appears conditioned on e.g.@: @code{__STDC__} to avoid missing
3275 initializer warnings and relies on default initialization to zero in the
3276 traditional C case.
3277
3278 @item
3279 Conversions by prototypes between fixed/floating point values and vice
3280 versa.  The absence of these prototypes when compiling with traditional
3281 C would cause serious problems.  This is a subset of the possible
3282 conversion warnings, for the full set use @option{-Wtraditional-conversion}.
3283
3284 @item
3285 Use of ISO C style function definitions.  This warning intentionally is
3286 @emph{not} issued for prototype declarations or variadic functions
3287 because these ISO C features will appear in your code when using
3288 libiberty's traditional C compatibility macros, @code{PARAMS} and
3289 @code{VPARAMS}.  This warning is also bypassed for nested functions
3290 because that feature is already a GCC extension and thus not relevant to
3291 traditional C compatibility.
3292 @end itemize
3293
3294 @item -Wtraditional-conversion @r{(C only)}
3295 @opindex Wtraditional-conversion
3296 Warn if a prototype causes a type conversion that is different from what
3297 would happen to the same argument in the absence of a prototype.  This
3298 includes conversions of fixed point to floating and vice versa, and
3299 conversions changing the width or signedness of a fixed point argument
3300 except when the same as the default promotion.
3301
3302 @item -Wdeclaration-after-statement @r{(C only)}
3303 @opindex Wdeclaration-after-statement
3304 Warn when a declaration is found after a statement in a block.  This
3305 construct, known from C++, was introduced with ISO C99 and is by default
3306 allowed in GCC@.  It is not supported by ISO C90 and was not supported by
3307 GCC versions before GCC 3.0.  @xref{Mixed Declarations}.
3308
3309 @item -Wundef
3310 @opindex Wundef
3311 Warn if an undefined identifier is evaluated in an @samp{#if} directive.
3312
3313 @item -Wno-endif-labels
3314 @opindex Wno-endif-labels
3315 @opindex Wendif-labels
3316 Do not warn whenever an @samp{#else} or an @samp{#endif} are followed by text.
3317
3318 @item -Wshadow
3319 @opindex Wshadow
3320 Warn whenever a local variable shadows another local variable, parameter or
3321 global variable or whenever a built-in function is shadowed.
3322
3323 @item -Wlarger-than-@var{len}
3324 @opindex Wlarger-than
3325 Warn whenever an object of larger than @var{len} bytes is defined.
3326
3327 @item -Wunsafe-loop-optimizations
3328 @opindex Wunsafe-loop-optimizations
3329 Warn if the loop cannot be optimized because the compiler could not
3330 assume anything on the bounds of the loop indices.  With
3331 @option{-funsafe-loop-optimizations} warn if the compiler made
3332 such assumptions.
3333
3334 @item -Wpointer-arith
3335 @opindex Wpointer-arith
3336 Warn about anything that depends on the ``size of'' a function type or
3337 of @code{void}.  GNU C assigns these types a size of 1, for
3338 convenience in calculations with @code{void *} pointers and pointers
3339 to functions.  In C++, warn also when an arithmetic operation involves
3340 @code{NULL}.  This warning is also enabled by @option{-pedantic}.
3341
3342 @item -Wbad-function-cast @r{(C only)}
3343 @opindex Wbad-function-cast
3344 Warn whenever a function call is cast to a non-matching type.
3345 For example, warn if @code{int malloc()} is cast to @code{anything *}.
3346
3347 @item -Wc++-compat
3348 Warn about ISO C constructs that are outside of the common subset of
3349 ISO C and ISO C++, e.g.@: request for implicit conversion from
3350 @code{void *} to a pointer to non-@code{void} type.
3351
3352 @item -Wc++0x-compat @r{(C++ and Objective-C++ only)}
3353 Warn about C++ constructs whose meaning differs between ISO C++ 1998 and
3354 ISO C++ 200x, e.g., identifiers in ISO C++ 1998 that will become keywords 
3355 in ISO C++ 200x.  This warning is enabled by @option{-Wall}.
3356
3357 @item -Wcast-qual
3358 @opindex Wcast-qual
3359 Warn whenever a pointer is cast so as to remove a type qualifier from
3360 the target type.  For example, warn if a @code{const char *} is cast
3361 to an ordinary @code{char *}.
3362
3363 @item -Wcast-align
3364 @opindex Wcast-align
3365 Warn whenever a pointer is cast such that the required alignment of the
3366 target is increased.  For example, warn if a @code{char *} is cast to
3367 an @code{int *} on machines where integers can only be accessed at
3368 two- or four-byte boundaries.
3369
3370 @item -Wwrite-strings
3371 @opindex Wwrite-strings
3372 When compiling C, give string constants the type @code{const
3373 char[@var{length}]} so that
3374 copying the address of one into a non-@code{const} @code{char *}
3375 pointer will get a warning; when compiling C++, warn about the
3376 deprecated conversion from string literals to @code{char *}.  This
3377 warning, by default, is enabled for C++ programs.
3378 These warnings will help you find at
3379 compile time code that can try to write into a string constant, but
3380 only if you have been very careful about using @code{const} in
3381 declarations and prototypes.  Otherwise, it will just be a nuisance;
3382 this is why we did not make @option{-Wall} request these warnings.
3383
3384 @item -Wclobbered
3385 @opindex Wclobbered
3386 Warn for variables that might be changed by @samp{longjmp} or
3387 @samp{vfork}.  This warning is also enabled by @option{-Wextra}.
3388
3389 @item -Wconversion
3390 @opindex Wconversion
3391 Warn for implicit conversions that may alter a value. This includes
3392 conversions between real and integer, like @code{abs (x)} when
3393 @code{x} is @code{double}; conversions between signed and unsigned,
3394 like @code{unsigned ui = -1}; and conversions to smaller types, like
3395 @code{sqrtf (M_PI)}. Do not warn for explicit casts like @code{abs
3396 ((int) x)} and @code{ui = (unsigned) -1}, or if the value is not
3397 changed by the conversion like in @code{abs (2.0)}.
3398
3399 @item -Wempty-body
3400 @opindex Wempty-body
3401 An empty body occurs in an @samp{if}, @samp{else} or @samp{do while}
3402 statement.  This warning is also enabled by @option{-Wextra}.
3403
3404 @item -Wsign-compare
3405 @opindex Wsign-compare
3406 @cindex warning for comparison of signed and unsigned values
3407 @cindex comparison of signed and unsigned values, warning
3408 @cindex signed and unsigned values, comparison warning
3409 Warn when a comparison between signed and unsigned values could produce
3410 an incorrect result when the signed value is converted to unsigned.
3411 This warning is also enabled by @option{-Wextra}; to get the other warnings
3412 of @option{-Wextra} without this warning, use @samp{-Wextra -Wno-sign-compare}.
3413
3414 @item -Waddress
3415 @opindex Waddress
3416 @opindex Wno-address
3417 Warn about suspicious uses of memory addresses. These include using
3418 the address of a function in a conditional expression, such as
3419 @code{void func(void); if (func)}, and comparisons against the memory
3420 address of a string literal, such as @code{if (x == "abc")}.  Such
3421 uses typically indicate a programmer error: the address of a function
3422 always evaluates to true, so their use in a conditional usually
3423 indicate that the programmer forgot the parentheses in a function
3424 call; and comparisons against string literals result in unspecified
3425 behavior and are not portable in C, so they usually indicate that the
3426 programmer intended to use @code{strcmp}.  This warning is enabled by
3427 @option{-Wall}.
3428
3429 @item -Wlogical-op
3430 @opindex Wlogical-op
3431 @opindex Wno-logical-op
3432 Warn about suspicious uses of logical operators in expressions.
3433 This includes using logical operators in contexts where a
3434 bit-wise operator is likely to be expected.
3435
3436 @item -Waggregate-return
3437 @opindex Waggregate-return
3438 Warn if any functions that return structures or unions are defined or
3439 called.  (In languages where you can return an array, this also elicits
3440 a warning.)
3441
3442 @item -Wno-attributes
3443 @opindex Wno-attributes
3444 @opindex Wattributes
3445 Do not warn if an unexpected @code{__attribute__} is used, such as
3446 unrecognized attributes, function attributes applied to variables,
3447 etc.  This will not stop errors for incorrect use of supported
3448 attributes.
3449
3450 @item -Wstrict-prototypes @r{(C only)}
3451 @opindex Wstrict-prototypes
3452 Warn if a function is declared or defined without specifying the
3453 argument types.  (An old-style function definition is permitted without
3454 a warning if preceded by a declaration which specifies the argument
3455 types.)
3456
3457 @item -Wold-style-declaration @r{(C only)}
3458 @opindex Wold-style-declaration
3459 Warn for obsolescent usages, according to the C Standard, in a
3460 declaration. For example, warn if storage-class specifiers like
3461 @code{static} are not the first things in a declaration.  This warning
3462 is also enabled by @option{-Wextra}.
3463
3464 @item -Wold-style-definition @r{(C only)}
3465 @opindex Wold-style-definition
3466 Warn if an old-style function definition is used.  A warning is given
3467 even if there is a previous prototype.
3468
3469 @item -Wmissing-parameter-type @r{(C only)}
3470 @opindex Wmissing-parameter-type
3471 A function parameter is declared without a type specifier in K&R-style
3472 functions:
3473
3474 @smallexample
3475 void foo(bar) @{ @}
3476 @end smallexample
3477
3478 This warning is also enabled by @option{-Wextra}.
3479
3480 @item -Wmissing-prototypes @r{(C only)}
3481 @opindex Wmissing-prototypes
3482 Warn if a global function is defined without a previous prototype
3483 declaration.  This warning is issued even if the definition itself
3484 provides a prototype.  The aim is to detect global functions that fail
3485 to be declared in header files.
3486
3487 @item -Wmissing-declarations @r{(C and C++ only)}
3488 @opindex Wmissing-declarations
3489 Warn if a global function is defined without a previous declaration.
3490 Do so even if the definition itself provides a prototype.
3491 Use this option to detect global functions that are not declared in
3492 header files.  In C++, no warnings are issued for function templates,
3493 or for inline functions, or for functions in anonymous namespaces.
3494
3495 @item -Wmissing-field-initializers
3496 @opindex Wmissing-field-initializers
3497 @opindex W
3498 @opindex Wextra
3499 Warn if a structure's initializer has some fields missing.  For
3500 example, the following code would cause such a warning, because
3501 @code{x.h} is implicitly zero:
3502
3503 @smallexample
3504 struct s @{ int f, g, h; @};
3505 struct s x = @{ 3, 4 @};
3506 @end smallexample
3507
3508 This option does not warn about designated initializers, so the following
3509 modification would not trigger a warning:
3510
3511 @smallexample
3512 struct s @{ int f, g, h; @};
3513 struct s x = @{ .f = 3, .g = 4 @};
3514 @end smallexample
3515
3516 This warning is included in @option{-Wextra}.  To get other @option{-Wextra}
3517 warnings without this one, use @samp{-Wextra -Wno-missing-field-initializers}.
3518
3519 @item -Wmissing-noreturn
3520 @opindex Wmissing-noreturn
3521 Warn about functions which might be candidates for attribute @code{noreturn}.
3522 Note these are only possible candidates, not absolute ones.  Care should
3523 be taken to manually verify functions actually do not ever return before
3524 adding the @code{noreturn} attribute, otherwise subtle code generation
3525 bugs could be introduced.  You will not get a warning for @code{main} in
3526 hosted C environments.
3527
3528 @item -Wmissing-format-attribute
3529 @opindex Wmissing-format-attribute
3530 @opindex Wformat
3531 Warn about function pointers which might be candidates for @code{format}
3532 attributes.  Note these are only possible candidates, not absolute ones.
3533 GCC will guess that function pointers with @code{format} attributes that
3534 are used in assignment, initialization, parameter passing or return
3535 statements should have a corresponding @code{format} attribute in the
3536 resulting type.  I.e.@: the left-hand side of the assignment or
3537 initialization, the type of the parameter variable, or the return type
3538 of the containing function respectively should also have a @code{format}
3539 attribute to avoid the warning.
3540
3541 GCC will also warn about function definitions which might be
3542 candidates for @code{format} attributes.  Again, these are only
3543 possible candidates.  GCC will guess that @code{format} attributes
3544 might be appropriate for any function that calls a function like
3545 @code{vprintf} or @code{vscanf}, but this might not always be the
3546 case, and some functions for which @code{format} attributes are
3547 appropriate may not be detected.
3548
3549 @item -Wno-multichar
3550 @opindex Wno-multichar
3551 @opindex Wmultichar
3552 Do not warn if a multicharacter constant (@samp{'FOOF'}) is used.
3553 Usually they indicate a typo in the user's code, as they have
3554 implementation-defined values, and should not be used in portable code.
3555
3556 @item -Wnormalized=<none|id|nfc|nfkc>
3557 @opindex Wnormalized
3558 @cindex NFC
3559 @cindex NFKC
3560 @cindex character set, input normalization
3561 In ISO C and ISO C++, two identifiers are different if they are
3562 different sequences of characters.  However, sometimes when characters
3563 outside the basic ASCII character set are used, you can have two
3564 different character sequences that look the same.  To avoid confusion,
3565 the ISO 10646 standard sets out some @dfn{normalization rules} which
3566 when applied ensure that two sequences that look the same are turned into
3567 the same sequence.  GCC can warn you if you are using identifiers which
3568 have not been normalized; this option controls that warning.
3569
3570 There are four levels of warning that GCC supports.  The default is
3571 @option{-Wnormalized=nfc}, which warns about any identifier which is
3572 not in the ISO 10646 ``C'' normalized form, @dfn{NFC}.  NFC is the
3573 recommended form for most uses.
3574
3575 Unfortunately, there are some characters which ISO C and ISO C++ allow
3576 in identifiers that when turned into NFC aren't allowable as
3577 identifiers.  That is, there's no way to use these symbols in portable
3578 ISO C or C++ and have all your identifiers in NFC.
3579 @option{-Wnormalized=id} suppresses the warning for these characters.
3580 It is hoped that future versions of the standards involved will correct
3581 this, which is why this option is not the default.
3582
3583 You can switch the warning off for all characters by writing
3584 @option{-Wnormalized=none}.  You would only want to do this if you
3585 were using some other normalization scheme (like ``D''), because
3586 otherwise you can easily create bugs that are literally impossible to see.
3587
3588 Some characters in ISO 10646 have distinct meanings but look identical
3589 in some fonts or display methodologies, especially once formatting has
3590 been applied.  For instance @code{\u207F}, ``SUPERSCRIPT LATIN SMALL
3591 LETTER N'', will display just like a regular @code{n} which has been
3592 placed in a superscript.  ISO 10646 defines the @dfn{NFKC}
3593 normalization scheme to convert all these into a standard form as
3594 well, and GCC will warn if your code is not in NFKC if you use
3595 @option{-Wnormalized=nfkc}.  This warning is comparable to warning
3596 about every identifier that contains the letter O because it might be
3597 confused with the digit 0, and so is not the default, but may be
3598 useful as a local coding convention if the programming environment is
3599 unable to be fixed to display these characters distinctly.
3600
3601 @item -Wno-deprecated-declarations
3602 @opindex Wno-deprecated-declarations
3603 Do not warn about uses of functions (@pxref{Function Attributes}),
3604 variables (@pxref{Variable Attributes}), and types (@pxref{Type
3605 Attributes}) marked as deprecated by using the @code{deprecated}
3606 attribute.
3607
3608 @item -Wno-overflow
3609 @opindex Wno-overflow
3610 Do not warn about compile-time overflow in constant expressions.
3611
3612 @item -Woverride-init
3613 @opindex Woverride-init
3614 @opindex W
3615 @opindex Wextra
3616 Warn if an initialized field without side effects is overridden when
3617 using designated initializers (@pxref{Designated Inits, , Designated
3618 Initializers}).
3619
3620 This warning is included in @option{-Wextra}.  To get other
3621 @option{-Wextra} warnings without this one, use @samp{-Wextra
3622 -Wno-override-init}.
3623
3624 @item -Wpacked
3625 @opindex Wpacked
3626 Warn if a structure is given the packed attribute, but the packed
3627 attribute has no effect on the layout or size of the structure.
3628 Such structures may be mis-aligned for little benefit.  For
3629 instance, in this code, the variable @code{f.x} in @code{struct bar}
3630 will be misaligned even though @code{struct bar} does not itself
3631 have the packed attribute:
3632
3633 @smallexample
3634 @group
3635 struct foo @{
3636   int x;
3637   char a, b, c, d;
3638 @} __attribute__((packed));
3639 struct bar @{
3640   char z;
3641   struct foo f;
3642 @};
3643 @end group
3644 @end smallexample
3645
3646 @item -Wpadded
3647 @opindex Wpadded
3648 Warn if padding is included in a structure, either to align an element
3649 of the structure or to align the whole structure.  Sometimes when this
3650 happens it is possible to rearrange the fields of the structure to
3651 reduce the padding and so make the structure smaller.
3652
3653 @item -Wredundant-decls
3654 @opindex Wredundant-decls
3655 Warn if anything is declared more than once in the same scope, even in
3656 cases where multiple declaration is valid and changes nothing.
3657
3658 @item -Wnested-externs @r{(C only)}
3659 @opindex Wnested-externs
3660 Warn if an @code{extern} declaration is encountered within a function.
3661
3662 @item -Wunreachable-code
3663 @opindex Wunreachable-code
3664 Warn if the compiler detects that code will never be executed.
3665
3666 This option is intended to warn when the compiler detects that at
3667 least a whole line of source code will never be executed, because
3668 some condition is never satisfied or because it is after a
3669 procedure that never returns.
3670
3671 It is possible for this option to produce a warning even though there
3672 are circumstances under which part of the affected line can be executed,
3673 so care should be taken when removing apparently-unreachable code.
3674
3675 For instance, when a function is inlined, a warning may mean that the
3676 line is unreachable in only one inlined copy of the function.
3677
3678 This option is not made part of @option{-Wall} because in a debugging
3679 version of a program there is often substantial code which checks
3680 correct functioning of the program and is, hopefully, unreachable
3681 because the program does work.  Another common use of unreachable
3682 code is to provide behavior which is selectable at compile-time.
3683
3684 @item -Winline
3685 @opindex Winline
3686 Warn if a function can not be inlined and it was declared as inline.
3687 Even with this option, the compiler will not warn about failures to
3688 inline functions declared in system headers.
3689
3690 The compiler uses a variety of heuristics to determine whether or not
3691 to inline a function.  For example, the compiler takes into account
3692 the size of the function being inlined and the amount of inlining
3693 that has already been done in the current function.  Therefore,
3694 seemingly insignificant changes in the source program can cause the
3695 warnings produced by @option{-Winline} to appear or disappear.
3696
3697 @item -Wno-invalid-offsetof @r{(C++ only)}
3698 @opindex Wno-invalid-offsetof
3699 Suppress warnings from applying the @samp{offsetof} macro to a non-POD
3700 type.  According to the 1998 ISO C++ standard, applying @samp{offsetof}
3701 to a non-POD type is undefined.  In existing C++ implementations,
3702 however, @samp{offsetof} typically gives meaningful results even when
3703 applied to certain kinds of non-POD types. (Such as a simple
3704 @samp{struct} that fails to be a POD type only by virtue of having a
3705 constructor.)  This flag is for users who are aware that they are
3706 writing nonportable code and who have deliberately chosen to ignore the
3707 warning about it.
3708
3709 The restrictions on @samp{offsetof} may be relaxed in a future version
3710 of the C++ standard.
3711
3712 @item -Wno-int-to-pointer-cast @r{(C only)}
3713 @opindex Wno-int-to-pointer-cast
3714 Suppress warnings from casts to pointer type of an integer of a
3715 different size.
3716
3717 @item -Wno-pointer-to-int-cast @r{(C only)}
3718 @opindex Wno-pointer-to-int-cast
3719 Suppress warnings from casts from a pointer to an integer type of a
3720 different size.
3721
3722 @item -Winvalid-pch
3723 @opindex Winvalid-pch
3724 Warn if a precompiled header (@pxref{Precompiled Headers}) is found in
3725 the search path but can't be used.
3726
3727 @item -Wlong-long
3728 @opindex Wlong-long
3729 @opindex Wno-long-long
3730 Warn if @samp{long long} type is used.  This is default.  To inhibit
3731 the warning messages, use @option{-Wno-long-long}.  Flags
3732 @option{-Wlong-long} and @option{-Wno-long-long} are taken into account
3733 only when @option{-pedantic} flag is used.
3734
3735 @item -Wvariadic-macros
3736 @opindex Wvariadic-macros
3737 @opindex Wno-variadic-macros
3738 Warn if variadic macros are used in pedantic ISO C90 mode, or the GNU
3739 alternate syntax when in pedantic ISO C99 mode.  This is default.
3740 To inhibit the warning messages, use @option{-Wno-variadic-macros}.
3741
3742 @item -Wvla
3743 @opindex Wvla
3744 @opindex Wno-vla
3745 Warn if variable length array is used in the code.
3746 @option{-Wno-vla} will prevent the @option{-pedantic} warning of
3747 the variable length array.
3748
3749 @item -Wvolatile-register-var
3750 @opindex Wvolatile-register-var
3751 @opindex Wno-volatile-register-var
3752 Warn if a register variable is declared volatile.  The volatile
3753 modifier does not inhibit all optimizations that may eliminate reads
3754 and/or writes to register variables.
3755
3756 @item -Wdisabled-optimization
3757 @opindex Wdisabled-optimization
3758 Warn if a requested optimization pass is disabled.  This warning does
3759 not generally indicate that there is anything wrong with your code; it
3760 merely indicates that GCC's optimizers were unable to handle the code
3761 effectively.  Often, the problem is that your code is too big or too
3762 complex; GCC will refuse to optimize programs when the optimization
3763 itself is likely to take inordinate amounts of time.
3764
3765 @item -Wpointer-sign
3766 @opindex Wpointer-sign
3767 @opindex Wno-pointer-sign
3768 Warn for pointer argument passing or assignment with different signedness.
3769 This option is only supported for C and Objective-C@.  It is implied by
3770 @option{-Wall} and by @option{-pedantic}, which can be disabled with
3771 @option{-Wno-pointer-sign}.
3772
3773 @item -Werror
3774 @opindex Werror
3775 Make all warnings into errors.
3776
3777 @item -Werror=
3778 @opindex Werror=
3779 Make the specified warning into an errors.  The specifier for a
3780 warning is appended, for example @option{-Werror=switch} turns the
3781 warnings controlled by @option{-Wswitch} into errors.  This switch
3782 takes a negative form, to be used to negate @option{-Werror} for
3783 specific warnings, for example @option{-Wno-error=switch} makes
3784 @option{-Wswitch} warnings not be errors, even when @option{-Werror}
3785 is in effect.  You can use the @option{-fdiagnostics-show-option}
3786 option to have each controllable warning amended with the option which
3787 controls it, to determine what to use with this option.
3788
3789 Note that specifying @option{-Werror=}@var{foo} automatically implies
3790 @option{-W}@var{foo}.  However, @option{-Wno-error=}@var{foo} does not
3791 imply anything.
3792
3793 @item -Wstack-protector
3794 @opindex Wstack-protector
3795 This option is only active when @option{-fstack-protector} is active.  It
3796 warns about functions that will not be protected against stack smashing.
3797
3798 @item -Woverlength-strings
3799 @opindex Woverlength-strings
3800 Warn about string constants which are longer than the ``minimum
3801 maximum'' length specified in the C standard.  Modern compilers
3802 generally allow string constants which are much longer than the
3803 standard's minimum limit, but very portable programs should avoid
3804 using longer strings.
3805
3806 The limit applies @emph{after} string constant concatenation, and does
3807 not count the trailing NUL@.  In C89, the limit was 509 characters; in
3808 C99, it was raised to 4095.  C++98 does not specify a normative
3809 minimum maximum, so we do not diagnose overlength strings in C++@.
3810
3811 This option is implied by @option{-pedantic}, and can be disabled with
3812 @option{-Wno-overlength-strings}.
3813 @end table
3814
3815 @node Debugging Options
3816 @section Options for Debugging Your Program or GCC
3817 @cindex options, debugging
3818 @cindex debugging information options
3819
3820 GCC has various special options that are used for debugging
3821 either your program or GCC:
3822
3823 @table @gcctabopt
3824 @item -g
3825 @opindex g
3826 Produce debugging information in the operating system's native format
3827 (stabs, COFF, XCOFF, or DWARF 2)@.  GDB can work with this debugging
3828 information.
3829
3830 On most systems that use stabs format, @option{-g} enables use of extra
3831 debugging information that only GDB can use; this extra information
3832 makes debugging work better in GDB but will probably make other debuggers
3833 crash or
3834 refuse to read the program.  If you want to control for certain whether
3835 to generate the extra information, use @option{-gstabs+}, @option{-gstabs},
3836 @option{-gxcoff+}, @option{-gxcoff}, or @option{-gvms} (see below).
3837
3838 GCC allows you to use @option{-g} with
3839 @option{-O}.  The shortcuts taken by optimized code may occasionally
3840 produce surprising results: some variables you declared may not exist
3841 at all; flow of control may briefly move where you did not expect it;
3842 some statements may not be executed because they compute constant
3843 results or their values were already at hand; some statements may
3844 execute in different places because they were moved out of loops.
3845
3846 Nevertheless it proves possible to debug optimized output.  This makes
3847 it reasonable to use the optimizer for programs that might have bugs.
3848
3849 The following options are useful when GCC is generated with the
3850 capability for more than one debugging format.
3851
3852 @item -ggdb
3853 @opindex ggdb
3854 Produce debugging information for use by GDB@.  This means to use the
3855 most expressive format available (DWARF 2, stabs, or the native format
3856 if neither of those are supported), including GDB extensions if at all
3857 possible.
3858
3859 @item -gstabs
3860 @opindex gstabs
3861 Produce debugging information in stabs format (if that is supported),
3862 without GDB extensions.  This is the format used by DBX on most BSD
3863 systems.  On MIPS, Alpha and System V Release 4 systems this option
3864 produces stabs debugging output which is not understood by DBX or SDB@.
3865 On System V Release 4 systems this option requires the GNU assembler.
3866
3867 @item -feliminate-unused-debug-symbols
3868 @opindex feliminate-unused-debug-symbols
3869 Produce debugging information in stabs format (if that is supported),
3870 for only symbols that are actually used.
3871
3872 @item -femit-class-debug-always
3873 Instead of emitting debugging information for a C++ class in only one
3874 object file, emit it in all object files using the class.  This option
3875 should be used only with debuggers that are unable to handle the way GCC
3876 normally emits debugging information for classes because using this
3877 option will increase the size of debugging information by as much as a
3878 factor of two.
3879
3880 @item -gstabs+
3881 @opindex gstabs+
3882 Produce debugging information in stabs format (if that is supported),
3883 using GNU extensions understood only by the GNU debugger (GDB)@.  The
3884 use of these extensions is likely to make other debuggers crash or
3885 refuse to read the program.
3886
3887 @item -gcoff
3888 @opindex gcoff
3889 Produce debugging information in COFF format (if that is supported).
3890 This is the format used by SDB on most System V systems prior to
3891 System V Release 4.
3892
3893 @item -gxcoff
3894 @opindex gxcoff
3895 Produce debugging information in XCOFF format (if that is supported).
3896 This is the format used by the DBX debugger on IBM RS/6000 systems.
3897
3898 @item -gxcoff+
3899 @opindex gxcoff+
3900 Produce debugging information in XCOFF format (if that is supported),
3901 using GNU extensions understood only by the GNU debugger (GDB)@.  The
3902 use of these extensions is likely to make other debuggers crash or
3903 refuse to read the program, and may cause assemblers other than the GNU
3904 assembler (GAS) to fail with an error.
3905
3906 @item -gdwarf-2
3907 @opindex gdwarf-2
3908 Produce debugging information in DWARF version 2 format (if that is
3909 supported).  This is the format used by DBX on IRIX 6.  With this
3910 option, GCC uses features of DWARF version 3 when they are useful;
3911 version 3 is upward compatible with version 2, but may still cause
3912 problems for older debuggers.
3913
3914 @item -gvms
3915 @opindex gvms
3916 Produce debugging information in VMS debug format (if that is
3917 supported).  This is the format used by DEBUG on VMS systems.
3918
3919 @item -g@var{level}
3920 @itemx -ggdb@var{level}
3921 @itemx -gstabs@var{level}
3922 @itemx -gcoff@var{level}
3923 @itemx -gxcoff@var{level}
3924 @itemx -gvms@var{level}
3925 Request debugging information and also use @var{level} to specify how
3926 much information.  The default level is 2.
3927
3928 Level 0 produces no debug information at all.  Thus, @option{-g0} negates
3929 @option{-g}.
3930
3931 Level 1 produces minimal information, enough for making backtraces in
3932 parts of the program that you don't plan to debug.  This includes
3933 descriptions of functions and external variables, but no information
3934 about local variables and no line numbers.
3935
3936 Level 3 includes extra information, such as all the macro definitions
3937 present in the program.  Some debuggers support macro expansion when
3938 you use @option{-g3}.
3939
3940 @option{-gdwarf-2} does not accept a concatenated debug level, because
3941 GCC used to support an option @option{-gdwarf} that meant to generate
3942 debug information in version 1 of the DWARF format (which is very
3943 different from version 2), and it would have been too confusing.  That
3944 debug format is long obsolete, but the option cannot be changed now.
3945 Instead use an additional @option{-g@var{level}} option to change the
3946 debug level for DWARF2.
3947
3948 @item -feliminate-dwarf2-dups
3949 @opindex feliminate-dwarf2-dups
3950 Compress DWARF2 debugging information by eliminating duplicated
3951 information about each symbol.  This option only makes sense when
3952 generating DWARF2 debugging information with @option{-gdwarf-2}.
3953
3954 @cindex @command{prof}
3955 @item -p
3956 @opindex p
3957 Generate extra code to write profile information suitable for the
3958 analysis program @command{prof}.  You must use this option when compiling
3959 the source files you want data about, and you must also use it when
3960 linking.
3961
3962 @cindex @command{gprof}
3963 @item -pg
3964 @opindex pg
3965 Generate extra code to write profile information suitable for the
3966 analysis program @command{gprof}.  You must use this option when compiling
3967 the source files you want data about, and you must also use it when
3968 linking.
3969
3970 @item -Q
3971 @opindex Q
3972 Makes the compiler print out each function name as it is compiled, and
3973 print some statistics about each pass when it finishes.
3974
3975 @item -ftime-report
3976 @opindex ftime-report
3977 Makes the compiler print some statistics about the time consumed by each
3978 pass when it finishes.
3979
3980 @item -fmem-report
3981 @opindex fmem-report
3982 Makes the compiler print some statistics about permanent memory
3983 allocation when it finishes.
3984
3985 @item -fpre-ipa-mem-report
3986 @opindex fpre-ipa-mem-report
3987 @item -fpost-ipa-mem-report
3988 @opindex fpost-ipa-mem-report
3989 Makes the compiler print some statistics about permanent memory
3990 allocation before or after interprocedural optimization.
3991
3992 @item -fprofile-arcs
3993 @opindex fprofile-arcs
3994 Add code so that program flow @dfn{arcs} are instrumented.  During
3995 execution the program records how many times each branch and call is
3996 executed and how many times it is taken or returns.  When the compiled
3997 program exits it saves this data to a file called
3998 @file{@var{auxname}.gcda} for each source file.  The data may be used for
3999 profile-directed optimizations (@option{-fbranch-probabilities}), or for
4000 test coverage analysis (@option{-ftest-coverage}).  Each object file's
4001 @var{auxname} is generated from the name of the output file, if
4002 explicitly specified and it is not the final executable, otherwise it is
4003 the basename of the source file.  In both cases any suffix is removed
4004 (e.g.@: @file{foo.gcda} for input file @file{dir/foo.c}, or
4005 @file{dir/foo.gcda} for output file specified as @option{-o dir/foo.o}).
4006 @xref{Cross-profiling}.
4007
4008 @cindex @command{gcov}
4009 @item --coverage
4010 @opindex coverage
4011
4012 This option is used to compile and link code instrumented for coverage
4013 analysis.  The option is a synonym for @option{-fprofile-arcs}
4014 @option{-ftest-coverage} (when compiling) and @option{-lgcov} (when
4015 linking).  See the documentation for those options for more details.
4016
4017 @itemize
4018
4019 @item
4020 Compile the source files with @option{-fprofile-arcs} plus optimization
4021 and code generation options.  For test coverage analysis, use the
4022 additional @option{-ftest-coverage} option.  You do not need to profile
4023 every source file in a program.
4024
4025 @item
4026 Link your object files with @option{-lgcov} or @option{-fprofile-arcs}
4027 (the latter implies the former).
4028
4029 @item
4030 Run the program on a representative workload to generate the arc profile
4031 information.  This may be repeated any number of times.  You can run
4032 concurrent instances of your program, and provided that the file system
4033 supports locking, the data files will be correctly updated.  Also
4034 @code{fork} calls are detected and correctly handled (double counting
4035 will not happen).
4036
4037 @item
4038 For profile-directed optimizations, compile the source files again with
4039 the same optimization and code generation options plus
4040 @option{-fbranch-probabilities} (@pxref{Optimize Options,,Options that
4041 Control Optimization}).
4042
4043 @item
4044 For test coverage analysis, use @command{gcov} to produce human readable
4045 information from the @file{.gcno} and @file{.gcda} files.  Refer to the
4046 @command{gcov} documentation for further information.
4047
4048 @end itemize
4049
4050 With @option{-fprofile-arcs}, for each function of your program GCC
4051 creates a program flow graph, then finds a spanning tree for the graph.
4052 Only arcs that are not on the spanning tree have to be instrumented: the
4053 compiler adds code to count the number of times that these arcs are
4054 executed.  When an arc is the only exit or only entrance to a block, the
4055 instrumentation code can be added to the block; otherwise, a new basic
4056 block must be created to hold the instrumentation code.
4057
4058 @need 2000
4059 @item -ftest-coverage
4060 @opindex ftest-coverage
4061 Produce a notes file that the @command{gcov} code-coverage utility
4062 (@pxref{Gcov,, @command{gcov}---a Test Coverage Program}) can use to
4063 show program coverage.  Each source file's note file is called
4064 @file{@var{auxname}.gcno}.  Refer to the @option{-fprofile-arcs} option
4065 above for a description of @var{auxname} and instructions on how to
4066 generate test coverage data.  Coverage data will match the source files
4067 more closely, if you do not optimize.
4068
4069 @item -d@var{letters}
4070 @item -fdump-rtl-@var{pass}
4071 @opindex d
4072 Says to make debugging dumps during compilation at times specified by
4073 @var{letters}.    This is used for debugging the RTL-based passes of the
4074 compiler.  The file names for most of the dumps are made by appending a
4075 pass number and a word to the @var{dumpname}.  @var{dumpname} is generated
4076 from the name of the output file, if explicitly specified and it is not
4077 an executable, otherwise it is the basename of the source file.
4078
4079 Most debug dumps can be enabled either passing a letter to the @option{-d}
4080 option, or with a long @option{-fdump-rtl} switch; here are the possible
4081 letters for use in @var{letters} and @var{pass}, and their meanings:
4082
4083 @table @gcctabopt
4084 @item -dA
4085 @opindex dA
4086 Annotate the assembler output with miscellaneous debugging information.
4087
4088 @item -dB
4089 @itemx -fdump-rtl-bbro
4090 @opindex dB
4091 @opindex fdump-rtl-bbro
4092 Dump after block reordering, to @file{@var{file}.148r.bbro}.
4093
4094 @item -dc
4095 @itemx -fdump-rtl-combine
4096 @opindex dc
4097 @opindex fdump-rtl-combine
4098 Dump after the RTL instruction combination pass, to the file
4099 @file{@var{file}.129r.combine}.
4100
4101 @item -dC
4102 @itemx -fdump-rtl-ce1
4103 @itemx -fdump-rtl-ce2
4104 @opindex dC
4105 @opindex fdump-rtl-ce1
4106 @opindex fdump-rtl-ce2
4107 @option{-dC} and @option{-fdump-rtl-ce1} enable dumping after the
4108 first if conversion, to the file @file{@var{file}.117r.ce1}.  @option{-dC}
4109 and @option{-fdump-rtl-ce2} enable dumping after the second if
4110 conversion, to the file @file{@var{file}.130r.ce2}.
4111
4112 @item -dd
4113 @itemx -fdump-rtl-btl
4114 @itemx -fdump-rtl-dbr
4115 @opindex dd
4116 @opindex fdump-rtl-btl
4117 @opindex fdump-rtl-dbr
4118 @option{-dd} and @option{-fdump-rtl-btl} enable dumping after branch
4119 target load optimization, to @file{@var{file}.31.btl}.  @option{-dd}
4120 and @option{-fdump-rtl-dbr} enable dumping after delayed branch
4121 scheduling, to @file{@var{file}.36.dbr}.
4122
4123 @item -dD
4124 @opindex dD
4125 Dump all macro definitions, at the end of preprocessing, in addition to
4126 normal output.
4127
4128 @item -dE
4129 @itemx -fdump-rtl-ce3
4130 @opindex dE
4131 @opindex fdump-rtl-ce3
4132 Dump after the third if conversion, to @file{@var{file}.146r.ce3}.
4133
4134 @item -df
4135 @itemx -fdump-rtl-cfg
4136 @itemx -fdump-rtl-life
4137 @opindex df
4138 @opindex fdump-rtl-cfg
4139 @opindex fdump-rtl-life
4140 @option{-df} and @option{-fdump-rtl-cfg} enable dumping after control
4141 and data flow analysis, to @file{@var{file}.116r.cfg}.  @option{-df}
4142 and @option{-fdump-rtl-cfg} enable dumping dump after life analysis,
4143 to @file{@var{file}.128r.life1} and @file{@var{file}.135r.life2}.
4144
4145 @item -dg
4146 @itemx -fdump-rtl-greg
4147 @opindex dg
4148 @opindex fdump-rtl-greg
4149 Dump after global register allocation, to @file{@var{file}.139r.greg}.
4150
4151 @item -dG
4152 @itemx -fdump-rtl-gcse
4153 @itemx -fdump-rtl-bypass
4154 @opindex dG
4155 @opindex fdump-rtl-gcse
4156 @opindex fdump-rtl-bypass
4157 @option{-dG} and @option{-fdump-rtl-gcse} enable dumping after GCSE, to
4158 @file{@var{file}.114r.gcse}.  @option{-dG} and @option{-fdump-rtl-bypass}
4159 enable dumping after jump bypassing and control flow optimizations, to
4160 @file{@var{file}.115r.bypass}.
4161
4162 @item -dh
4163 @itemx -fdump-rtl-eh
4164 @opindex dh
4165 @opindex fdump-rtl-eh
4166 Dump after finalization of EH handling code, to @file{@var{file}.02.eh}.
4167
4168 @item -di
4169 @itemx -fdump-rtl-sibling
4170 @opindex di
4171 @opindex fdump-rtl-sibling
4172 Dump after sibling call optimizations, to @file{@var{file}.106r.sibling}.
4173
4174 @item -dj
4175 @itemx -fdump-rtl-jump
4176 @opindex dj
4177 @opindex fdump-rtl-jump
4178 Dump after the first jump optimization, to @file{@var{file}.112r.jump}.
4179
4180 @item -dk
4181 @itemx -fdump-rtl-stack
4182 @opindex dk
4183 @opindex fdump-rtl-stack
4184 Dump after conversion from GCC's "flat register file" registers to the
4185 x87's stack-like registers, to @file{@var{file}.152r.stack}.
4186
4187 @item -dl
4188 @itemx -fdump-rtl-lreg
4189 @opindex dl
4190 @opindex fdump-rtl-lreg
4191 Dump after local register allocation, to @file{@var{file}.138r.lreg}.
4192
4193 @item -dL
4194 @itemx -fdump-rtl-loop2
4195 @opindex dL
4196 @opindex fdump-rtl-loop2
4197 @option{-dL} and @option{-fdump-rtl-loop2} enable dumping after the
4198 loop optimization pass, to @file{@var{file}.119r.loop2},
4199 @file{@var{file}.120r.loop2_init},
4200 @file{@var{file}.121r.loop2_invariant}, and
4201 @file{@var{file}.125r.loop2_done}.
4202
4203 @item -dm
4204 @itemx -fdump-rtl-sms
4205 @opindex dm
4206 @opindex fdump-rtl-sms
4207 Dump after modulo scheduling, to @file{@var{file}.136r.sms}.
4208
4209 @item -dM
4210 @itemx -fdump-rtl-mach
4211 @opindex dM
4212 @opindex fdump-rtl-mach
4213 Dump after performing the machine dependent reorganization pass, to
4214 @file{@var{file}.155r.mach}.
4215
4216 @item -dn
4217 @itemx -fdump-rtl-rnreg
4218 @opindex dn
4219 @opindex fdump-rtl-rnreg
4220 Dump after register renumbering, to @file{@var{file}.147r.rnreg}.
4221
4222 @item -dN
4223 @itemx -fdump-rtl-regmove
4224 @opindex dN
4225 @opindex fdump-rtl-regmove
4226 Dump after the register move pass, to @file{@var{file}.132r.regmove}.
4227
4228 @item -do
4229 @itemx -fdump-rtl-postreload
4230 @opindex do
4231 @opindex fdump-rtl-postreload
4232 Dump after post-reload optimizations, to @file{@var{file}.24.postreload}.
4233
4234 @item -dr
4235 @itemx -fdump-rtl-expand
4236 @opindex dr
4237 @opindex fdump-rtl-expand
4238 Dump after RTL generation, to @file{@var{file}.104r.expand}.
4239
4240 @item -dR
4241 @itemx -fdump-rtl-sched2
4242 @opindex dR
4243 @opindex fdump-rtl-sched2
4244 Dump after the second scheduling pass, to @file{@var{file}.149r.sched2}.
4245
4246 @item -ds
4247 @itemx -fdump-rtl-cse
4248 @opindex ds
4249 @opindex fdump-rtl-cse
4250 Dump after CSE (including the jump optimization that sometimes follows
4251 CSE), to @file{@var{file}.113r.cse}.
4252
4253 @item -dS
4254 @itemx -fdump-rtl-sched1
4255 @opindex dS
4256 @opindex fdump-rtl-sched1
4257 Dump after the first scheduling pass, to @file{@var{file}.136r.sched1}.
4258
4259 @item -dt
4260 @itemx -fdump-rtl-cse2
4261 @opindex dt
4262 @opindex fdump-rtl-cse2
4263 Dump after the second CSE pass (including the jump optimization that
4264 sometimes follows CSE), to @file{@var{file}.127r.cse2}.
4265
4266 @item -dT
4267 @itemx -fdump-rtl-tracer
4268 @opindex dT
4269 @opindex fdump-rtl-tracer
4270 Dump after running tracer, to @file{@var{file}.118r.tracer}.
4271
4272 @item -dV
4273 @itemx -fdump-rtl-vpt
4274 @itemx -fdump-rtl-vartrack
4275 @opindex dV
4276 @opindex fdump-rtl-vpt
4277 @opindex fdump-rtl-vartrack
4278 @option{-dV} and @option{-fdump-rtl-vpt} enable dumping after the value
4279 profile transformations, to @file{@var{file}.10.vpt}.  @option{-dV}
4280 and @option{-fdump-rtl-vartrack} enable dumping after variable tracking,
4281 to @file{@var{file}.154r.vartrack}.
4282
4283 @item -dw
4284 @itemx -fdump-rtl-flow2
4285 @opindex dw
4286 @opindex fdump-rtl-flow2
4287 Dump after the second flow pass, to @file{@var{file}.142r.flow2}.
4288
4289 @item -dz
4290 @itemx -fdump-rtl-peephole2
4291 @opindex dz
4292 @opindex fdump-rtl-peephole2
4293 Dump after the peephole pass, to @file{@var{file}.145r.peephole2}.
4294