-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathDebugging-Options.html
More file actions
652 lines (506 loc) · 50.1 KB
/
Debugging-Options.html
File metadata and controls
652 lines (506 loc) · 50.1 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
<html lang="en">
<head>
<title>Debugging Options - Using the GNU Compiler Collection (GCC)</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNU Compiler Collection (GCC)">
<meta name="generator" content="makeinfo 4.8">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Invoking-GCC.html#Invoking-GCC" title="Invoking GCC">
<link rel="prev" href="Warning-Options.html#Warning-Options" title="Warning Options">
<link rel="next" href="Optimize-Options.html#Optimize-Options" title="Optimize Options">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``GNU General Public License'' and ``Funding
Free Software'', the Front-Cover texts being (a) (see below), and with
the Back-Cover Texts being (b) (see below). A copy of the license is
included in the section entitled ``GNU Free Documentation License''.
(a) The FSF's Front-Cover Text is:
A GNU Manual
(b) The FSF's Back-Cover Text is:
You have freedom to copy and modify this GNU Manual, like GNU
software. Copies published by the Free Software Foundation raise
funds for GNU development.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<p>
<a name="Debugging-Options"></a>
Next: <a rel="next" accesskey="n" href="Optimize-Options.html#Optimize-Options">Optimize Options</a>,
Previous: <a rel="previous" accesskey="p" href="Warning-Options.html#Warning-Options">Warning Options</a>,
Up: <a rel="up" accesskey="u" href="Invoking-GCC.html#Invoking-GCC">Invoking GCC</a>
<hr>
</div>
<h3 class="section">3.9 Options for Debugging Your Program or GCC</h3>
<p><a name="index-options_002c-debugging-328"></a><a name="index-debugging-information-options-329"></a>
GCC has various special options that are used for debugging
either your program or GCC:
<dl>
<dt><code>-g</code><dd><a name="index-g-330"></a>Produce debugging information in the operating system's native format
(stabs, COFF, XCOFF, or DWARF 2). GDB can work with this debugging
information.
<p>On most systems that use stabs format, <samp><span class="option">-g</span></samp> enables use of extra
debugging information that only GDB can use; this extra information
makes debugging work better in GDB but will probably make other debuggers
crash or
refuse to read the program. If you want to control for certain whether
to generate the extra information, use <samp><span class="option">-gstabs+</span></samp>, <samp><span class="option">-gstabs</span></samp>,
<samp><span class="option">-gxcoff+</span></samp>, <samp><span class="option">-gxcoff</span></samp>, or <samp><span class="option">-gvms</span></samp> (see below).
<p>GCC allows you to use <samp><span class="option">-g</span></samp> with
<samp><span class="option">-O</span></samp>. The shortcuts taken by optimized code may occasionally
produce surprising results: some variables you declared may not exist
at all; flow of control may briefly move where you did not expect it;
some statements may not be executed because they compute constant
results or their values were already at hand; some statements may
execute in different places because they were moved out of loops.
<p>Nevertheless it proves possible to debug optimized output. This makes
it reasonable to use the optimizer for programs that might have bugs.
<p>The following options are useful when GCC is generated with the
capability for more than one debugging format.
<br><dt><code>-ggdb</code><dd><a name="index-ggdb-331"></a>Produce debugging information for use by GDB. This means to use the
most expressive format available (DWARF 2, stabs, or the native format
if neither of those are supported), including GDB extensions if at all
possible.
<br><dt><code>-gstabs</code><dd><a name="index-gstabs-332"></a>Produce debugging information in stabs format (if that is supported),
without GDB extensions. This is the format used by DBX on most BSD
systems. On MIPS, Alpha and System V Release 4 systems this option
produces stabs debugging output which is not understood by DBX or SDB.
On System V Release 4 systems this option requires the GNU assembler.
<br><dt><code>-feliminate-unused-debug-symbols</code><dd><a name="index-feliminate_002dunused_002ddebug_002dsymbols-333"></a>Produce debugging information in stabs format (if that is supported),
for only symbols that are actually used.
<br><dt><code>-femit-class-debug-always</code><dd>Instead of emitting debugging information for a C++ class in only one
object file, emit it in all object files using the class. This option
should be used only with debuggers that are unable to handle the way GCC
normally emits debugging information for classes because using this
option will increase the size of debugging information by as much as a
factor of two.
<br><dt><code>-gstabs+</code><dd><a name="index-gstabs_002b-334"></a>Produce debugging information in stabs format (if that is supported),
using GNU extensions understood only by the GNU debugger (GDB). The
use of these extensions is likely to make other debuggers crash or
refuse to read the program.
<br><dt><code>-gcoff</code><dd><a name="index-gcoff-335"></a>Produce debugging information in COFF format (if that is supported).
This is the format used by SDB on most System V systems prior to
System V Release 4.
<br><dt><code>-gxcoff</code><dd><a name="index-gxcoff-336"></a>Produce debugging information in XCOFF format (if that is supported).
This is the format used by the DBX debugger on IBM RS/6000 systems.
<br><dt><code>-gxcoff+</code><dd><a name="index-gxcoff_002b-337"></a>Produce debugging information in XCOFF format (if that is supported),
using GNU extensions understood only by the GNU debugger (GDB). The
use of these extensions is likely to make other debuggers crash or
refuse to read the program, and may cause assemblers other than the GNU
assembler (GAS) to fail with an error.
<br><dt><code>-gdwarf-2</code><dd><a name="index-gdwarf_002d2-338"></a>Produce debugging information in DWARF version 2 format (if that is
supported). This is the format used by DBX on IRIX 6. With this
option, GCC uses features of DWARF version 3 when they are useful;
version 3 is upward compatible with version 2, but may still cause
problems for older debuggers.
<br><dt><code>-gvms</code><dd><a name="index-gvms-339"></a>Produce debugging information in VMS debug format (if that is
supported). This is the format used by DEBUG on VMS systems.
<br><dt><code>-g</code><var>level</var><dt><code>-ggdb</code><var>level</var><dt><code>-gstabs</code><var>level</var><dt><code>-gcoff</code><var>level</var><dt><code>-gxcoff</code><var>level</var><dt><code>-gvms</code><var>level</var><dd>Request debugging information and also use <var>level</var> to specify how
much information. The default level is 2.
<p>Level 1 produces minimal information, enough for making backtraces in
parts of the program that you don't plan to debug. This includes
descriptions of functions and external variables, but no information
about local variables and no line numbers.
<p>Level 3 includes extra information, such as all the macro definitions
present in the program. Some debuggers support macro expansion when
you use <samp><span class="option">-g3</span></samp>.
<p><samp><span class="option">-gdwarf-2</span></samp> does not accept a concatenated debug level, because
GCC used to support an option <samp><span class="option">-gdwarf</span></samp> that meant to generate
debug information in version 1 of the DWARF format (which is very
different from version 2), and it would have been too confusing. That
debug format is long obsolete, but the option cannot be changed now.
Instead use an additional <samp><span class="option">-g</span><var>level</var></samp> option to change the
debug level for DWARF2.
<br><dt><code>-feliminate-dwarf2-dups</code><dd><a name="index-feliminate_002ddwarf2_002ddups-340"></a>Compress DWARF2 debugging information by eliminating duplicated
information about each symbol. This option only makes sense when
generating DWARF2 debugging information with <samp><span class="option">-gdwarf-2</span></samp>.
<p><a name="index-g_t_0040command_007bprof_007d-341"></a><br><dt><code>-p</code><dd><a name="index-p-342"></a>Generate extra code to write profile information suitable for the
analysis program <samp><span class="command">prof</span></samp>. You must use this option when compiling
the source files you want data about, and you must also use it when
linking.
<p><a name="index-g_t_0040command_007bgprof_007d-343"></a><br><dt><code>-pg</code><dd><a name="index-pg-344"></a>Generate extra code to write profile information suitable for the
analysis program <samp><span class="command">gprof</span></samp>. You must use this option when compiling
the source files you want data about, and you must also use it when
linking.
<br><dt><code>-Q</code><dd><a name="index-Q-345"></a>Makes the compiler print out each function name as it is compiled, and
print some statistics about each pass when it finishes.
<br><dt><code>-ftime-report</code><dd><a name="index-ftime_002dreport-346"></a>Makes the compiler print some statistics about the time consumed by each
pass when it finishes.
<br><dt><code>-fmem-report</code><dd><a name="index-fmem_002dreport-347"></a>Makes the compiler print some statistics about permanent memory
allocation when it finishes.
<br><dt><code>-fprofile-arcs</code><dd><a name="index-fprofile_002darcs-348"></a>Add code so that program flow <dfn>arcs</dfn> are instrumented. During
execution the program records how many times each branch and call is
executed and how many times it is taken or returns. When the compiled
program exits it saves this data to a file called
<samp><var>auxname</var><span class="file">.gcda</span></samp> for each source file. The data may be used for
profile-directed optimizations (<samp><span class="option">-fbranch-probabilities</span></samp>), or for
test coverage analysis (<samp><span class="option">-ftest-coverage</span></samp>). Each object file's
<var>auxname</var> is generated from the name of the output file, if
explicitly specified and it is not the final executable, otherwise it is
the basename of the source file. In both cases any suffix is removed
(e.g. <samp><span class="file">foo.gcda</span></samp> for input file <samp><span class="file">dir/foo.c</span></samp>, or
<samp><span class="file">dir/foo.gcda</span></samp> for output file specified as <samp><span class="option">-o dir/foo.o</span></samp>).
See <a href="Cross_002dprofiling.html#Cross_002dprofiling">Cross-profiling</a>.
<p><a name="index-g_t_0040command_007bgcov_007d-349"></a><br><dt><code>--coverage</code><dd><a name="index-coverage-350"></a>
This option is used to compile and link code instrumented for coverage
analysis. The option is a synonym for <samp><span class="option">-fprofile-arcs</span></samp>
<samp><span class="option">-ftest-coverage</span></samp> (when compiling) and <samp><span class="option">-lgcov</span></samp> (when
linking). See the documentation for those options for more details.
<ul>
<li>Compile the source files with <samp><span class="option">-fprofile-arcs</span></samp> plus optimization
and code generation options. For test coverage analysis, use the
additional <samp><span class="option">-ftest-coverage</span></samp> option. You do not need to profile
every source file in a program.
<li>Link your object files with <samp><span class="option">-lgcov</span></samp> or <samp><span class="option">-fprofile-arcs</span></samp>
(the latter implies the former).
<li>Run the program on a representative workload to generate the arc profile
information. This may be repeated any number of times. You can run
concurrent instances of your program, and provided that the file system
supports locking, the data files will be correctly updated. Also
<code>fork</code> calls are detected and correctly handled (double counting
will not happen).
<li>For profile-directed optimizations, compile the source files again with
the same optimization and code generation options plus
<samp><span class="option">-fbranch-probabilities</span></samp> (see <a href="Optimize-Options.html#Optimize-Options">Options that Control Optimization</a>).
<li>For test coverage analysis, use <samp><span class="command">gcov</span></samp> to produce human readable
information from the <samp><span class="file">.gcno</span></samp> and <samp><span class="file">.gcda</span></samp> files. Refer to the
<samp><span class="command">gcov</span></samp> documentation for further information.
</ul>
<p>With <samp><span class="option">-fprofile-arcs</span></samp>, for each function of your program GCC
creates a program flow graph, then finds a spanning tree for the graph.
Only arcs that are not on the spanning tree have to be instrumented: the
compiler adds code to count the number of times that these arcs are
executed. When an arc is the only exit or only entrance to a block, the
instrumentation code can be added to the block; otherwise, a new basic
block must be created to hold the instrumentation code.
<br><dt><code>-ftest-coverage</code><dd><a name="index-ftest_002dcoverage-351"></a>Produce a notes file that the <samp><span class="command">gcov</span></samp> code-coverage utility
(see <a href="Gcov.html#Gcov"><samp><span class="command">gcov</span></samp>—a Test Coverage Program</a>) can use to
show program coverage. Each source file's note file is called
<samp><var>auxname</var><span class="file">.gcno</span></samp>. Refer to the <samp><span class="option">-fprofile-arcs</span></samp> option
above for a description of <var>auxname</var> and instructions on how to
generate test coverage data. Coverage data will match the source files
more closely, if you do not optimize.
<br><dt><code>-d</code><var>letters</var><br><dt><code>-fdump-rtl-</code><var>pass</var><dd><a name="index-d-352"></a>Says to make debugging dumps during compilation at times specified by
<var>letters</var>. This is used for debugging the RTL-based passes of the
compiler. The file names for most of the dumps are made by appending a
pass number and a word to the <var>dumpname</var>. <var>dumpname</var> is generated
from the name of the output file, if explicitly specified and it is not
an executable, otherwise it is the basename of the source file.
<p>Most debug dumps can be enabled either passing a letter to the <samp><span class="option">-d</span></samp>
option, or with a long <samp><span class="option">-fdump-rtl</span></samp> switch; here are the possible
letters for use in <var>letters</var> and <var>pass</var>, and their meanings:
<dl>
<dt><code>-dA</code><dd><a name="index-dA-353"></a>Annotate the assembler output with miscellaneous debugging information.
<br><dt><code>-dB</code><dt><code>-fdump-rtl-bbro</code><dd><a name="index-dB-354"></a><a name="index-fdump_002drtl_002dbbro-355"></a>Dump after block reordering, to <samp><var>file</var><span class="file">.148r.bbro</span></samp>.
<br><dt><code>-dc</code><dt><code>-fdump-rtl-combine</code><dd><a name="index-dc-356"></a><a name="index-fdump_002drtl_002dcombine-357"></a>Dump after instruction combination, to the file <samp><var>file</var><span class="file">.129r.combine</span></samp>.
<br><dt><code>-dC</code><dt><code>-fdump-rtl-ce1</code><dt><code>-fdump-rtl-ce2</code><dd><a name="index-dC-358"></a><a name="index-fdump_002drtl_002dce1-359"></a><a name="index-fdump_002drtl_002dce2-360"></a><samp><span class="option">-dC</span></samp> and <samp><span class="option">-fdump-rtl-ce1</span></samp> enable dumping after the
first if conversion, to the file <samp><var>file</var><span class="file">.117r.ce1</span></samp>. <samp><span class="option">-dC</span></samp>
and <samp><span class="option">-fdump-rtl-ce2</span></samp> enable dumping after the second if
conversion, to the file <samp><var>file</var><span class="file">.130r.ce2</span></samp>.
<br><dt><code>-dd</code><dt><code>-fdump-rtl-btl</code><dt><code>-fdump-rtl-dbr</code><dd><a name="index-dd-361"></a><a name="index-fdump_002drtl_002dbtl-362"></a><a name="index-fdump_002drtl_002ddbr-363"></a><samp><span class="option">-dd</span></samp> and <samp><span class="option">-fdump-rtl-btl</span></samp> enable dumping after branch
target load optimization, to <samp><var>file</var><span class="file">.31.btl</span></samp>. <samp><span class="option">-dd</span></samp>
and <samp><span class="option">-fdump-rtl-dbr</span></samp> enable dumping after delayed branch
scheduling, to <samp><var>file</var><span class="file">.36.dbr</span></samp>.
<br><dt><code>-dD</code><dd><a name="index-dD-364"></a>Dump all macro definitions, at the end of preprocessing, in addition to
normal output.
<br><dt><code>-dE</code><dt><code>-fdump-rtl-ce3</code><dd><a name="index-dE-365"></a><a name="index-fdump_002drtl_002dce3-366"></a>Dump after the third if conversion, to <samp><var>file</var><span class="file">.146r.ce3</span></samp>.
<br><dt><code>-df</code><dt><code>-fdump-rtl-cfg</code><dt><code>-fdump-rtl-life</code><dd><a name="index-df-367"></a><a name="index-fdump_002drtl_002dcfg-368"></a><a name="index-fdump_002drtl_002dlife-369"></a><samp><span class="option">-df</span></samp> and <samp><span class="option">-fdump-rtl-cfg</span></samp> enable dumping after control
and data flow analysis, to <samp><var>file</var><span class="file">.116r.cfg</span></samp>. <samp><span class="option">-df</span></samp>
and <samp><span class="option">-fdump-rtl-cfg</span></samp> enable dumping dump after life analysis,
to <samp><var>file</var><span class="file">.128r.life1</span></samp> and <samp><var>file</var><span class="file">.135r.life2</span></samp>.
<br><dt><code>-dg</code><dt><code>-fdump-rtl-greg</code><dd><a name="index-dg-370"></a><a name="index-fdump_002drtl_002dgreg-371"></a>Dump after global register allocation, to <samp><var>file</var><span class="file">.139r.greg</span></samp>.
<br><dt><code>-dG</code><dt><code>-fdump-rtl-gcse</code><dt><code>-fdump-rtl-bypass</code><dd><a name="index-dG-372"></a><a name="index-fdump_002drtl_002dgcse-373"></a><a name="index-fdump_002drtl_002dbypass-374"></a><samp><span class="option">-dG</span></samp> and <samp><span class="option">-fdump-rtl-gcse</span></samp> enable dumping after GCSE, to
<samp><var>file</var><span class="file">.114r.gcse</span></samp>. <samp><span class="option">-dG</span></samp> and <samp><span class="option">-fdump-rtl-bypass</span></samp>
enable dumping after jump bypassing and control flow optimizations, to
<samp><var>file</var><span class="file">.115r.bypass</span></samp>.
<br><dt><code>-dh</code><dt><code>-fdump-rtl-eh</code><dd><a name="index-dh-375"></a><a name="index-fdump_002drtl_002deh-376"></a>Dump after finalization of EH handling code, to <samp><var>file</var><span class="file">.02.eh</span></samp>.
<br><dt><code>-di</code><dt><code>-fdump-rtl-sibling</code><dd><a name="index-di-377"></a><a name="index-fdump_002drtl_002dsibling-378"></a>Dump after sibling call optimizations, to <samp><var>file</var><span class="file">.106r.sibling</span></samp>.
<br><dt><code>-dj</code><dt><code>-fdump-rtl-jump</code><dd><a name="index-dj-379"></a><a name="index-fdump_002drtl_002djump-380"></a>Dump after the first jump optimization, to <samp><var>file</var><span class="file">.112r.jump</span></samp>.
<br><dt><code>-dk</code><dt><code>-fdump-rtl-stack</code><dd><a name="index-dk-381"></a><a name="index-fdump_002drtl_002dstack-382"></a>Dump after conversion from registers to stack, to <samp><var>file</var><span class="file">.152r.stack</span></samp>.
<br><dt><code>-dl</code><dt><code>-fdump-rtl-lreg</code><dd><a name="index-dl-383"></a><a name="index-fdump_002drtl_002dlreg-384"></a>Dump after local register allocation, to <samp><var>file</var><span class="file">.138r.lreg</span></samp>.
<br><dt><code>-dL</code><dt><code>-fdump-rtl-loop2</code><dd><a name="index-dL-385"></a><a name="index-fdump_002drtl_002dloop2-386"></a><samp><span class="option">-dL</span></samp> and <samp><span class="option">-fdump-rtl-loop2</span></samp> enable dumping after the
loop optimization pass, to <samp><var>file</var><span class="file">.119r.loop2</span></samp>,
<samp><var>file</var><span class="file">.120r.loop2_init</span></samp>,
<samp><var>file</var><span class="file">.121r.loop2_invariant</span></samp>, and
<samp><var>file</var><span class="file">.125r.loop2_done</span></samp>.
<br><dt><code>-dm</code><dt><code>-fdump-rtl-sms</code><dd><a name="index-dm-387"></a><a name="index-fdump_002drtl_002dsms-388"></a>Dump after modulo scheduling, to <samp><var>file</var><span class="file">.136r.sms</span></samp>.
<br><dt><code>-dM</code><dt><code>-fdump-rtl-mach</code><dd><a name="index-dM-389"></a><a name="index-fdump_002drtl_002dmach-390"></a>Dump after performing the machine dependent reorganization pass, to
<samp><var>file</var><span class="file">.155r.mach</span></samp>.
<br><dt><code>-dn</code><dt><code>-fdump-rtl-rnreg</code><dd><a name="index-dn-391"></a><a name="index-fdump_002drtl_002drnreg-392"></a>Dump after register renumbering, to <samp><var>file</var><span class="file">.147r.rnreg</span></samp>.
<br><dt><code>-dN</code><dt><code>-fdump-rtl-regmove</code><dd><a name="index-dN-393"></a><a name="index-fdump_002drtl_002dregmove-394"></a>Dump after the register move pass, to <samp><var>file</var><span class="file">.132r.regmove</span></samp>.
<br><dt><code>-do</code><dt><code>-fdump-rtl-postreload</code><dd><a name="index-do-395"></a><a name="index-fdump_002drtl_002dpostreload-396"></a>Dump after post-reload optimizations, to <samp><var>file</var><span class="file">.24.postreload</span></samp>.
<br><dt><code>-dr</code><dt><code>-fdump-rtl-expand</code><dd><a name="index-dr-397"></a><a name="index-fdump_002drtl_002dexpand-398"></a>Dump after RTL generation, to <samp><var>file</var><span class="file">.104r.expand</span></samp>.
<br><dt><code>-dR</code><dt><code>-fdump-rtl-sched2</code><dd><a name="index-dR-399"></a><a name="index-fdump_002drtl_002dsched2-400"></a>Dump after the second scheduling pass, to <samp><var>file</var><span class="file">.150r.sched2</span></samp>.
<br><dt><code>-ds</code><dt><code>-fdump-rtl-cse</code><dd><a name="index-ds-401"></a><a name="index-fdump_002drtl_002dcse-402"></a>Dump after CSE (including the jump optimization that sometimes follows
CSE), to <samp><var>file</var><span class="file">.113r.cse</span></samp>.
<br><dt><code>-dS</code><dt><code>-fdump-rtl-sched</code><dd><a name="index-dS-403"></a><a name="index-fdump_002drtl_002dsched-404"></a>Dump after the first scheduling pass, to <samp><var>file</var><span class="file">.21.sched</span></samp>.
<br><dt><code>-dt</code><dt><code>-fdump-rtl-cse2</code><dd><a name="index-dt-405"></a><a name="index-fdump_002drtl_002dcse2-406"></a>Dump after the second CSE pass (including the jump optimization that
sometimes follows CSE), to <samp><var>file</var><span class="file">.127r.cse2</span></samp>.
<br><dt><code>-dT</code><dt><code>-fdump-rtl-tracer</code><dd><a name="index-dT-407"></a><a name="index-fdump_002drtl_002dtracer-408"></a>Dump after running tracer, to <samp><var>file</var><span class="file">.118r.tracer</span></samp>.
<br><dt><code>-dV</code><dt><code>-fdump-rtl-vpt</code><dt><code>-fdump-rtl-vartrack</code><dd><a name="index-dV-409"></a><a name="index-fdump_002drtl_002dvpt-410"></a><a name="index-fdump_002drtl_002dvartrack-411"></a><samp><span class="option">-dV</span></samp> and <samp><span class="option">-fdump-rtl-vpt</span></samp> enable dumping after the value
profile transformations, to <samp><var>file</var><span class="file">.10.vpt</span></samp>. <samp><span class="option">-dV</span></samp>
and <samp><span class="option">-fdump-rtl-vartrack</span></samp> enable dumping after variable tracking,
to <samp><var>file</var><span class="file">.154r.vartrack</span></samp>.
<br><dt><code>-dw</code><dt><code>-fdump-rtl-flow2</code><dd><a name="index-dw-412"></a><a name="index-fdump_002drtl_002dflow2-413"></a>Dump after the second flow pass, to <samp><var>file</var><span class="file">.142r.flow2</span></samp>.
<br><dt><code>-dz</code><dt><code>-fdump-rtl-peephole2</code><dd><a name="index-dz-414"></a><a name="index-fdump_002drtl_002dpeephole2-415"></a>Dump after the peephole pass, to <samp><var>file</var><span class="file">.145r.peephole2</span></samp>.
<br><dt><code>-dZ</code><dt><code>-fdump-rtl-web</code><dd><a name="index-dZ-416"></a><a name="index-fdump_002drtl_002dweb-417"></a>Dump after live range splitting, to <samp><var>file</var><span class="file">.126r.web</span></samp>.
<br><dt><code>-da</code><dt><code>-fdump-rtl-all</code><dd><a name="index-da-418"></a><a name="index-fdump_002drtl_002dall-419"></a>Produce all the dumps listed above.
<br><dt><code>-dH</code><dd><a name="index-dH-420"></a>Produce a core dump whenever an error occurs.
<br><dt><code>-dm</code><dd><a name="index-dm-421"></a>Print statistics on memory usage, at the end of the run, to
standard error.
<br><dt><code>-dp</code><dd><a name="index-dp-422"></a>Annotate the assembler output with a comment indicating which
pattern and alternative was used. The length of each instruction is
also printed.
<br><dt><code>-dP</code><dd><a name="index-dP-423"></a>Dump the RTL in the assembler output as a comment before each instruction.
Also turns on <samp><span class="option">-dp</span></samp> annotation.
<br><dt><code>-dv</code><dd><a name="index-dv-424"></a>For each of the other indicated dump files (either with <samp><span class="option">-d</span></samp> or
<samp><span class="option">-fdump-rtl-</span><var>pass</var></samp>), dump a representation of the control flow
graph suitable for viewing with VCG to <samp><var>file</var><span class="file">.</span><var>pass</var><span class="file">.vcg</span></samp>.
<br><dt><code>-dx</code><dd><a name="index-dx-425"></a>Just generate RTL for a function instead of compiling it. Usually used
with `<samp><span class="samp">r</span></samp>' (<samp><span class="option">-fdump-rtl-expand</span></samp>).
<br><dt><code>-dy</code><dd><a name="index-dy-426"></a>Dump debugging information during parsing, to standard error.
</dl>
<br><dt><code>-fdump-noaddr</code><dd><a name="index-fdump_002dnoaddr-427"></a>When doing debugging dumps (see <samp><span class="option">-d</span></samp> option above), suppress
address output. This makes it more feasible to use diff on debugging
dumps for compiler invocations with different compiler binaries and/or
different text / bss / data / heap / stack / dso start locations.
<br><dt><code>-fdump-unnumbered</code><dd><a name="index-fdump_002dunnumbered-428"></a>When doing debugging dumps (see <samp><span class="option">-d</span></samp> option above), suppress instruction
numbers, line number note and address output. This makes it more feasible to
use diff on debugging dumps for compiler invocations with different
options, in particular with and without <samp><span class="option">-g</span></samp>.
<br><dt><code>-fdump-translation-unit </code><span class="roman">(C++ only)</span><dt><code>-fdump-translation-unit-</code><var>options</var> <span class="roman">(C++ only)</span><dd><a name="index-fdump_002dtranslation_002dunit-429"></a>Dump a representation of the tree structure for the entire translation
unit to a file. The file name is made by appending <samp><span class="file">.tu</span></samp> to the
source file name. If the `<samp><span class="samp">-</span><var>options</var></samp>' form is used, <var>options</var>
controls the details of the dump as described for the
<samp><span class="option">-fdump-tree</span></samp> options.
<br><dt><code>-fdump-class-hierarchy </code><span class="roman">(C++ only)</span><dt><code>-fdump-class-hierarchy-</code><var>options</var> <span class="roman">(C++ only)</span><dd><a name="index-fdump_002dclass_002dhierarchy-430"></a>Dump a representation of each class's hierarchy and virtual function
table layout to a file. The file name is made by appending <samp><span class="file">.class</span></samp>
to the source file name. If the `<samp><span class="samp">-</span><var>options</var></samp>' form is used,
<var>options</var> controls the details of the dump as described for the
<samp><span class="option">-fdump-tree</span></samp> options.
<br><dt><code>-fdump-ipa-</code><var>switch</var><dd><a name="index-fdump_002dipa-431"></a>Control the dumping at various stages of inter-procedural analysis
language tree to a file. The file name is generated by appending a switch
specific suffix to the source file name. The following dumps are possible:
<dl>
<dt>`<samp><span class="samp">all</span></samp>'<dd>Enables all inter-procedural analysis dumps; currently the only produced
dump is the `<samp><span class="samp">cgraph</span></samp>' dump.
<br><dt>`<samp><span class="samp">cgraph</span></samp>'<dd>Dumps information about call-graph optimization, unused function removal,
and inlining decisions.
</dl>
<br><dt><code>-fdump-tree-</code><var>switch</var><dt><code>-fdump-tree-</code><var>switch</var><code>-</code><var>options</var><dd><a name="index-fdump_002dtree-432"></a>Control the dumping at various stages of processing the intermediate
language tree to a file. The file name is generated by appending a switch
specific suffix to the source file name. If the `<samp><span class="samp">-</span><var>options</var></samp>'
form is used, <var>options</var> is a list of `<samp><span class="samp">-</span></samp>' separated options that
control the details of the dump. Not all options are applicable to all
dumps, those which are not meaningful will be ignored. The following
options are available
<dl>
<dt>`<samp><span class="samp">address</span></samp>'<dd>Print the address of each node. Usually this is not meaningful as it
changes according to the environment and source file. Its primary use
is for tying up a dump file with a debug environment.
<br><dt>`<samp><span class="samp">slim</span></samp>'<dd>Inhibit dumping of members of a scope or body of a function merely
because that scope has been reached. Only dump such items when they
are directly reachable by some other path. When dumping pretty-printed
trees, this option inhibits dumping the bodies of control structures.
<br><dt>`<samp><span class="samp">raw</span></samp>'<dd>Print a raw representation of the tree. By default, trees are
pretty-printed into a C-like representation.
<br><dt>`<samp><span class="samp">details</span></samp>'<dd>Enable more detailed dumps (not honored by every dump option).
<br><dt>`<samp><span class="samp">stats</span></samp>'<dd>Enable dumping various statistics about the pass (not honored by every dump
option).
<br><dt>`<samp><span class="samp">blocks</span></samp>'<dd>Enable showing basic block boundaries (disabled in raw dumps).
<br><dt>`<samp><span class="samp">vops</span></samp>'<dd>Enable showing virtual operands for every statement.
<br><dt>`<samp><span class="samp">lineno</span></samp>'<dd>Enable showing line numbers for statements.
<br><dt>`<samp><span class="samp">uid</span></samp>'<dd>Enable showing the unique ID (<code>DECL_UID</code>) for each variable.
<br><dt>`<samp><span class="samp">all</span></samp>'<dd>Turn on all options, except <samp><span class="option">raw</span></samp>, <samp><span class="option">slim</span></samp> and <samp><span class="option">lineno</span></samp>.
</dl>
<p>The following tree dumps are possible:
<dl>
<dt>`<samp><span class="samp">original</span></samp>'<dd>Dump before any tree based optimization, to <samp><var>file</var><span class="file">.original</span></samp>.
<br><dt>`<samp><span class="samp">optimized</span></samp>'<dd>Dump after all tree based optimization, to <samp><var>file</var><span class="file">.optimized</span></samp>.
<br><dt>`<samp><span class="samp">inlined</span></samp>'<dd>Dump after function inlining, to <samp><var>file</var><span class="file">.inlined</span></samp>.
<br><dt>`<samp><span class="samp">gimple</span></samp>'<dd><a name="index-fdump_002dtree_002dgimple-433"></a>Dump each function before and after the gimplification pass to a file. The
file name is made by appending <samp><span class="file">.gimple</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">cfg</span></samp>'<dd><a name="index-fdump_002dtree_002dcfg-434"></a>Dump the control flow graph of each function to a file. The file name is
made by appending <samp><span class="file">.cfg</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">vcg</span></samp>'<dd><a name="index-fdump_002dtree_002dvcg-435"></a>Dump the control flow graph of each function to a file in VCG format. The
file name is made by appending <samp><span class="file">.vcg</span></samp> to the source file name. Note
that if the file contains more than one function, the generated file cannot
be used directly by VCG. You will need to cut and paste each function's
graph into its own separate file first.
<br><dt>`<samp><span class="samp">ch</span></samp>'<dd><a name="index-fdump_002dtree_002dch-436"></a>Dump each function after copying loop headers. The file name is made by
appending <samp><span class="file">.ch</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">ssa</span></samp>'<dd><a name="index-fdump_002dtree_002dssa-437"></a>Dump SSA related information to a file. The file name is made by appending
<samp><span class="file">.ssa</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">salias</span></samp>'<dd><a name="index-fdump_002dtree_002dsalias-438"></a>Dump structure aliasing variable information to a file. This file name
is made by appending <samp><span class="file">.salias</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">alias</span></samp>'<dd><a name="index-fdump_002dtree_002dalias-439"></a>Dump aliasing information for each function. The file name is made by
appending <samp><span class="file">.alias</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">ccp</span></samp>'<dd><a name="index-fdump_002dtree_002dccp-440"></a>Dump each function after CCP. The file name is made by appending
<samp><span class="file">.ccp</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">storeccp</span></samp>'<dd><a name="index-fdump_002dtree_002dstoreccp-441"></a>Dump each function after STORE-CCP. The file name is made by appending
<samp><span class="file">.storeccp</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">pre</span></samp>'<dd><a name="index-fdump_002dtree_002dpre-442"></a>Dump trees after partial redundancy elimination. The file name is made
by appending <samp><span class="file">.pre</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">fre</span></samp>'<dd><a name="index-fdump_002dtree_002dfre-443"></a>Dump trees after full redundancy elimination. The file name is made
by appending <samp><span class="file">.fre</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">copyprop</span></samp>'<dd><a name="index-fdump_002dtree_002dcopyprop-444"></a>Dump trees after copy propagation. The file name is made
by appending <samp><span class="file">.copyprop</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">store_copyprop</span></samp>'<dd><a name="index-fdump_002dtree_002dstore_005fcopyprop-445"></a>Dump trees after store copy-propagation. The file name is made
by appending <samp><span class="file">.store_copyprop</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">dce</span></samp>'<dd><a name="index-fdump_002dtree_002ddce-446"></a>Dump each function after dead code elimination. The file name is made by
appending <samp><span class="file">.dce</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">mudflap</span></samp>'<dd><a name="index-fdump_002dtree_002dmudflap-447"></a>Dump each function after adding mudflap instrumentation. The file name is
made by appending <samp><span class="file">.mudflap</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">sra</span></samp>'<dd><a name="index-fdump_002dtree_002dsra-448"></a>Dump each function after performing scalar replacement of aggregates. The
file name is made by appending <samp><span class="file">.sra</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">sink</span></samp>'<dd><a name="index-fdump_002dtree_002dsink-449"></a>Dump each function after performing code sinking. The file name is made
by appending <samp><span class="file">.sink</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">dom</span></samp>'<dd><a name="index-fdump_002dtree_002ddom-450"></a>Dump each function after applying dominator tree optimizations. The file
name is made by appending <samp><span class="file">.dom</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">dse</span></samp>'<dd><a name="index-fdump_002dtree_002ddse-451"></a>Dump each function after applying dead store elimination. The file
name is made by appending <samp><span class="file">.dse</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">phiopt</span></samp>'<dd><a name="index-fdump_002dtree_002dphiopt-452"></a>Dump each function after optimizing PHI nodes into straightline code. The file
name is made by appending <samp><span class="file">.phiopt</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">forwprop</span></samp>'<dd><a name="index-fdump_002dtree_002dforwprop-453"></a>Dump each function after forward propagating single use variables. The file
name is made by appending <samp><span class="file">.forwprop</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">copyrename</span></samp>'<dd><a name="index-fdump_002dtree_002dcopyrename-454"></a>Dump each function after applying the copy rename optimization. The file
name is made by appending <samp><span class="file">.copyrename</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">nrv</span></samp>'<dd><a name="index-fdump_002dtree_002dnrv-455"></a>Dump each function after applying the named return value optimization on
generic trees. The file name is made by appending <samp><span class="file">.nrv</span></samp> to the source
file name.
<br><dt>`<samp><span class="samp">vect</span></samp>'<dd><a name="index-fdump_002dtree_002dvect-456"></a>Dump each function after applying vectorization of loops. The file name is
made by appending <samp><span class="file">.vect</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">vrp</span></samp>'<dd><a name="index-fdump_002dtree_002dvrp-457"></a>Dump each function after Value Range Propagation (VRP). The file name
is made by appending <samp><span class="file">.vrp</span></samp> to the source file name.
<br><dt>`<samp><span class="samp">all</span></samp>'<dd><a name="index-fdump_002dtree_002dall-458"></a>Enable all the available tree dumps with the flags provided in this option.
</dl>
<br><dt><code>-ftree-vectorizer-verbose=</code><var>n</var><dd><a name="index-ftree_002dvectorizer_002dverbose-459"></a>This option controls the amount of debugging output the vectorizer prints.
This information is written to standard error, unless
<samp><span class="option">-fdump-tree-all</span></samp> or <samp><span class="option">-fdump-tree-vect</span></samp> is specified,
in which case it is output to the usual dump listing file, <samp><span class="file">.vect</span></samp>.
For <var>n</var>=0 no diagnostic information is reported.
If <var>n</var>=1 the vectorizer reports each loop that got vectorized,
and the total number of loops that got vectorized.
If <var>n</var>=2 the vectorizer also reports non-vectorized loops that passed
the first analysis phase (vect_analyze_loop_form) - i.e. countable,
inner-most, single-bb, single-entry/exit loops. This is the same verbosity
level that <samp><span class="option">-fdump-tree-vect-stats</span></samp> uses.
Higher verbosity levels mean either more information dumped for each
reported loop, or same amount of information reported for more loops:
If <var>n</var>=3, alignment related information is added to the reports.
If <var>n</var>=4, data-references related information (e.g. memory dependences,
memory access-patterns) is added to the reports.
If <var>n</var>=5, the vectorizer reports also non-vectorized inner-most loops
that did not pass the first analysis phase (i.e. may not be countable, or
may have complicated control-flow).
If <var>n</var>=6, the vectorizer reports also non-vectorized nested loops.
For <var>n</var>=7, all the information the vectorizer generates during its
analysis and transformation is reported. This is the same verbosity level
that <samp><span class="option">-fdump-tree-vect-details</span></samp> uses.
<br><dt><code>-frandom-seed=</code><var>string</var><dd><a name="index-frandom_002dstring-460"></a>This option provides a seed that GCC uses when it would otherwise use
random numbers. It is used to generate certain symbol names
that have to be different in every compiled file. It is also used to
place unique stamps in coverage data files and the object files that
produce them. You can use the <samp><span class="option">-frandom-seed</span></samp> option to produce
reproducibly identical object files.
<p>The <var>string</var> should be different for every file you compile.
<br><dt><code>-fsched-verbose=</code><var>n</var><dd><a name="index-fsched_002dverbose-461"></a>On targets that use instruction scheduling, this option controls the
amount of debugging output the scheduler prints. This information is
written to standard error, unless <samp><span class="option">-dS</span></samp> or <samp><span class="option">-dR</span></samp> is
specified, in which case it is output to the usual dump
listing file, <samp><span class="file">.sched</span></samp> or <samp><span class="file">.sched2</span></samp> respectively. However
for <var>n</var> greater than nine, the output is always printed to standard
error.
<p>For <var>n</var> greater than zero, <samp><span class="option">-fsched-verbose</span></samp> outputs the
same information as <samp><span class="option">-dRS</span></samp>. For <var>n</var> greater than one, it
also output basic block probabilities, detailed ready list information
and unit/insn info. For <var>n</var> greater than two, it includes RTL
at abort point, control-flow and regions info. And for <var>n</var> over
four, <samp><span class="option">-fsched-verbose</span></samp> also includes dependence info.
<br><dt><code>-save-temps</code><dd><a name="index-save_002dtemps-462"></a>Store the usual “temporary” intermediate files permanently; place them
in the current directory and name them based on the source file. Thus,
compiling <samp><span class="file">foo.c</span></samp> with `<samp><span class="samp">-c -save-temps</span></samp>' would produce files
<samp><span class="file">foo.i</span></samp> and <samp><span class="file">foo.s</span></samp>, as well as <samp><span class="file">foo.o</span></samp>. This creates a
preprocessed <samp><span class="file">foo.i</span></samp> output file even though the compiler now
normally uses an integrated preprocessor.
<p>When used in combination with the <samp><span class="option">-x</span></samp> command line option,
<samp><span class="option">-save-temps</span></samp> is sensible enough to avoid over writing an
input source file with the same extension as an intermediate file.
The corresponding intermediate file may be obtained by renaming the
source file before using <samp><span class="option">-save-temps</span></samp>.
<br><dt><code>-time</code><dd><a name="index-time-463"></a>Report the CPU time taken by each subprocess in the compilation
sequence. For C source files, this is the compiler proper and assembler
(plus the linker if linking is done). The output looks like this:
<pre class="smallexample"> # cc1 0.12 0.01
# as 0.00 0.01
</pre>
<p>The first number on each line is the “user time”, that is time spent
executing the program itself. The second number is “system time”,
time spent executing operating system routines on behalf of the program.
Both numbers are in seconds.
<br><dt><code>-fvar-tracking</code><dd><a name="index-fvar_002dtracking-464"></a>Run variable tracking pass. It computes where variables are stored at each
position in code. Better debugging information is then generated
(if the debugging information format supports this information).
<p>It is enabled by default when compiling with optimization (<samp><span class="option">-Os</span></samp>,
<samp><span class="option">-O</span></samp>, <samp><span class="option">-O2</span></samp>, ...), debugging information (<samp><span class="option">-g</span></samp>) and
the debug info format supports it.
<br><dt><code>-print-file-name=</code><var>library</var><dd><a name="index-print_002dfile_002dname-465"></a>Print the full absolute name of the library file <var>library</var> that
would be used when linking—and don't do anything else. With this
option, GCC does not compile or link anything; it just prints the
file name.
<br><dt><code>-print-multi-directory</code><dd><a name="index-print_002dmulti_002ddirectory-466"></a>Print the directory name corresponding to the multilib selected by any
other switches present in the command line. This directory is supposed
to exist in <samp><span class="env">GCC_EXEC_PREFIX</span></samp>.
<br><dt><code>-print-multi-lib</code><dd><a name="index-print_002dmulti_002dlib-467"></a>Print the mapping from multilib directory names to compiler switches
that enable them. The directory name is separated from the switches by
`<samp><span class="samp">;</span></samp>', and each switch starts with an `<samp><span class="samp">@</span></samp>' instead of the
`<samp><span class="samp">-</span></samp>', without spaces between multiple switches. This is supposed to
ease shell-processing.
<br><dt><code>-print-prog-name=</code><var>program</var><dd><a name="index-print_002dprog_002dname-468"></a>Like <samp><span class="option">-print-file-name</span></samp>, but searches for a program such as `<samp><span class="samp">cpp</span></samp>'.
<br><dt><code>-print-libgcc-file-name</code><dd><a name="index-print_002dlibgcc_002dfile_002dname-469"></a>Same as <samp><span class="option">-print-file-name=libgcc.a</span></samp>.
<p>This is useful when you use <samp><span class="option">-nostdlib</span></samp> or <samp><span class="option">-nodefaultlibs</span></samp>
but you do want to link with <samp><span class="file">libgcc.a</span></samp>. You can do
<pre class="smallexample"> gcc -nostdlib <var>files</var>... `gcc -print-libgcc-file-name`
</pre>
<br><dt><code>-print-search-dirs</code><dd><a name="index-print_002dsearch_002ddirs-470"></a>Print the name of the configured installation directory and a list of
program and library directories <samp><span class="command">gcc</span></samp> will search—and don't do anything else.
<p>This is useful when <samp><span class="command">gcc</span></samp> prints the error message
`<samp><span class="samp">installation problem, cannot exec cpp0: No such file or directory</span></samp>'.
To resolve this you either need to put <samp><span class="file">cpp0</span></samp> and the other compiler
components where <samp><span class="command">gcc</span></samp> expects to find them, or you can set the environment
variable <samp><span class="env">GCC_EXEC_PREFIX</span></samp> to the directory where you installed them.
Don't forget the trailing `<samp><span class="samp">/</span></samp>'.
See <a href="Environment-Variables.html#Environment-Variables">Environment Variables</a>.
<br><dt><code>-dumpmachine</code><dd><a name="index-dumpmachine-471"></a>Print the compiler's target machine (for example,
`<samp><span class="samp">i686-pc-linux-gnu</span></samp>')—and don't do anything else.
<br><dt><code>-dumpversion</code><dd><a name="index-dumpversion-472"></a>Print the compiler version (for example, `<samp><span class="samp">3.0</span></samp>')—and don't do
anything else.
<br><dt><code>-dumpspecs</code><dd><a name="index-dumpspecs-473"></a>Print the compiler's built-in specs—and don't do anything else. (This
is used when GCC itself is being built.) See <a href="Spec-Files.html#Spec-Files">Spec Files</a>.
<br><dt><code>-feliminate-unused-debug-types</code><dd><a name="index-feliminate_002dunused_002ddebug_002dtypes-474"></a>Normally, when producing DWARF2 output, GCC will emit debugging
information for all types declared in a compilation
unit, regardless of whether or not they are actually used
in that compilation unit. Sometimes this is useful, such as
if, in the debugger, you want to cast a value to a type that is
not actually used in your program (but is declared). More often,
however, this results in a significant amount of wasted space.
With this option, GCC will avoid producing debug symbol output
for types that are nowhere used in the source file being compiled.
</dl>
</body></html>