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