OSDN Git Service

5dc36e0a03a3870ba304f8c9251f75bbf07d77e7
[pf3gnuchains/gcc-fork.git] / gcc / doc / install.texi
1 \input texinfo.tex    @c -*-texinfo-*-
2 @c @ifnothtml
3 @c %**start of header
4 @setfilename gccinstall.info
5 @settitle Installing GCC
6 @setchapternewpage odd
7 @c %**end of header
8 @c @end ifnothtml
9
10 @c Specify title for specific html page
11 @ifset indexhtml
12 @settitle Installing GCC
13 @end ifset
14 @ifset specifichtml
15 @settitle Host/Target specific installation notes for GCC
16 @end ifset
17 @ifset prerequisiteshtml
18 @settitle Prerequisites for GCC
19 @end ifset
20 @ifset downloadhtml
21 @settitle Downloading GCC
22 @end ifset
23 @ifset configurehtml
24 @settitle Installing GCC: Configuration
25 @end ifset
26 @ifset buildhtml
27 @settitle Installing GCC: Building
28 @end ifset
29 @ifset testhtml
30 @settitle Installing GCC: Testing
31 @end ifset
32 @ifset finalinstallhtml
33 @settitle Installing GCC: Final installation
34 @end ifset
35 @ifset binarieshtml
36 @settitle Installing GCC: Binaries
37 @end ifset
38 @ifset oldhtml
39 @settitle Installing GCC: Old documentation
40 @end ifset
41 @ifset gfdlhtml
42 @settitle Installing GCC: GNU Free Documentation License
43 @end ifset
44
45 @c Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
46 @c 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
47 @c *** Converted to texinfo by Dean Wakerley, dean@wakerley.com
48
49 @c Include everything if we're not making html
50 @ifnothtml
51 @set indexhtml
52 @set specifichtml
53 @set prerequisiteshtml
54 @set downloadhtml
55 @set configurehtml
56 @set buildhtml
57 @set testhtml
58 @set finalinstallhtml
59 @set binarieshtml
60 @set oldhtml
61 @set gfdlhtml
62 @end ifnothtml
63
64 @c Part 2 Summary Description and Copyright
65 @copying
66 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
67 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
68 @sp 1
69 Permission is granted to copy, distribute and/or modify this document
70 under the terms of the GNU Free Documentation License, Version 1.2 or
71 any later version published by the Free Software Foundation; with no
72 Invariant Sections, the Front-Cover texts being (a) (see below), and
73 with the Back-Cover Texts being (b) (see below).  A copy of the
74 license is included in the section entitled ``@uref{./gfdl.html,,GNU
75 Free Documentation License}''.
76
77 (a) The FSF's Front-Cover Text is:
78
79      A GNU Manual
80
81 (b) The FSF's Back-Cover Text is:
82
83      You have freedom to copy and modify this GNU Manual, like GNU
84      software.  Copies published by the Free Software Foundation raise
85      funds for GNU development.
86 @end copying
87 @ifinfo
88 @insertcopying
89 @end ifinfo
90
91 @c Part 3 Titlepage and Copyright
92 @titlepage
93 @sp 10
94 @comment The title is printed in a large font.
95 @center @titlefont{Installing GCC}
96
97 @c The following two commands start the copyright page.
98 @page
99 @vskip 0pt plus 1filll
100 @insertcopying
101 @end titlepage
102
103 @c Part 4 Top node and Master Menu
104 @ifinfo
105 @node    Top, , , (dir)
106 @comment node-name, next,          Previous, up
107
108 @menu
109 * Installing GCC::  This document describes the generic installation
110                     procedure for GCC as well as detailing some target
111                     specific installation instructions.
112
113 * Specific::        Host/target specific installation notes for GCC.
114 * Binaries::        Where to get pre-compiled binaries.
115
116 * Old::             Old installation documentation.
117
118 * GNU Free Documentation License:: How you can copy and share this manual.
119 * Concept Index::   This index has two entries.
120 @end menu
121 @end ifinfo
122
123 @c Part 5 The Body of the Document
124 @c ***Installing GCC**********************************************************
125 @ifnothtml
126 @comment node-name,     next,          previous, up
127 @node    Installing GCC, Binaries, , Top
128 @end ifnothtml
129 @ifset indexhtml
130 @ifnothtml
131 @chapter Installing GCC
132 @end ifnothtml
133
134 The latest version of this document is always available at
135 @uref{http://gcc.gnu.org/install/,,http://gcc.gnu.org/install/}.
136
137 This document describes the generic installation procedure for GCC as well
138 as detailing some target specific installation instructions.
139
140 GCC includes several components that previously were separate distributions
141 with their own installation instructions.  This document supersedes all
142 package specific installation instructions.
143
144 @emph{Before} starting the build/install procedure please check the
145 @ifnothtml
146 @ref{Specific, host/target specific installation notes}.
147 @end ifnothtml
148 @ifhtml
149 @uref{specific.html,,host/target specific installation notes}.
150 @end ifhtml
151 We recommend you browse the entire generic installation instructions before
152 you proceed.
153
154 Lists of successful builds for released versions of GCC are
155 available at @uref{http://gcc.gnu.org/buildstat.html}.
156 These lists are updated as new information becomes available.
157
158 The installation procedure itself is broken into five steps.
159
160 @ifinfo
161 @menu
162 * Prerequisites::
163 * Downloading the source::
164 * Configuration::
165 * Building::
166 * Testing:: (optional)
167 * Final install::
168 @end menu
169 @end ifinfo
170 @ifhtml
171 @enumerate
172 @item
173 @uref{prerequisites.html,,Prerequisites}
174 @item
175 @uref{download.html,,Downloading the source}
176 @item
177 @uref{configure.html,,Configuration}
178 @item
179 @uref{build.html,,Building}
180 @item
181 @uref{test.html,,Testing} (optional)
182 @item
183 @uref{finalinstall.html,,Final install}
184 @end enumerate
185 @end ifhtml
186
187 Please note that GCC does not support @samp{make uninstall} and probably
188 won't do so in the near future as this would open a can of worms.  Instead,
189 we suggest that you install GCC into a directory of its own and simply
190 remove that directory when you do not need that specific version of GCC
191 any longer, and, if shared libraries are installed there as well, no
192 more binaries exist that use them.
193
194 @ifhtml
195 There are also some @uref{old.html,,old installation instructions},
196 which are mostly obsolete but still contain some information which has
197 not yet been merged into the main part of this manual.
198 @end ifhtml
199
200 @html
201 <hr />
202 <p>
203 @end html
204 @ifhtml
205 @uref{./index.html,,Return to the GCC Installation page}
206
207 @insertcopying
208 @end ifhtml
209 @end ifset
210
211 @c ***Prerequisites**************************************************
212 @ifnothtml
213 @comment node-name,     next,          previous, up
214 @node    Prerequisites, Downloading the source, , Installing GCC
215 @end ifnothtml
216 @ifset prerequisiteshtml
217 @ifnothtml
218 @chapter Prerequisites
219 @end ifnothtml
220 @cindex Prerequisites
221
222 GCC requires that various tools and packages be available for use in the
223 build procedure.  Modifying GCC sources requires additional tools
224 described below.
225
226 @heading Tools/packages necessary for building GCC
227 @table @asis
228 @item ISO C90 compiler
229 Necessary to bootstrap the GCC package, although versions of GCC prior
230 to 3.4 also allow bootstrapping with a traditional (K&R) C compiler.
231
232 To make all languages in a cross-compiler or other configuration where
233 3-stage bootstrap is not performed, you need to start with an existing
234 GCC binary (version 2.95 or later) because source code for language
235 frontends other than C might use GCC extensions.
236
237 @item GNAT
238
239 In order to build the Ada compiler (GNAT) you must already have GNAT
240 installed because portions of the Ada frontend are written in Ada (with
241 GNAT extensions.)  Refer to the Ada installation instructions for more
242 specific information.
243
244 @item A ``working'' POSIX compatible shell, or GNU bash
245
246 Necessary when running @command{configure} because some
247 @command{/bin/sh} shells have bugs and may crash when configuring the
248 target libraries.  In other cases, @command{/bin/sh} or even some
249 @command{ksh} have disastrous corner-case performance problems.  This
250 can cause target @command{configure} runs to literally take days to
251 complete in some cases.
252
253 So on some platforms @command{/bin/ksh} is sufficient, on others it
254 isn't.  See the host/target specific instructions for your platform, or
255 use @command{bash} to be sure.  Then set @env{CONFIG_SHELL} in your
256 environment to your ``good'' shell prior to running
257 @command{configure}/@command{make}.
258
259 @command{zsh} is not a fully compliant POSIX shell and will not
260 work when configuring GCC.
261
262 @item GNU binutils
263
264 Necessary in some circumstances, optional in others.  See the
265 host/target specific instructions for your platform for the exact
266 requirements.
267
268 @item gzip version 1.2.4 (or later) or
269 @itemx bzip2 version 1.0.2 (or later)
270
271 Necessary to uncompress GCC @command{tar} files when source code is
272 obtained via FTP mirror sites.
273
274 @item GNU make version 3.79.1 (or later)
275
276 You must have GNU make installed to build GCC.
277
278 @item GNU tar version 1.12 (or later)
279
280 Necessary (only on some platforms) to untar the source code.  Many
281 systems' @command{tar} programs will also work, only try GNU
282 @command{tar} if you have problems.
283
284 @end table
285
286
287 @heading Tools/packages necessary for modifying GCC
288 @table @asis
289
290 @item autoconf versions 2.13 and 2.57
291 @itemx GNU m4 version 1.4 (or later)
292
293 Necessary when modifying @file{configure.in}, @file{aclocal.m4}, etc.@:
294 to regenerate @file{configure} and @file{config.in} files.  Most
295 directories require autoconf 2.13 (exactly), but @file{libiberty},
296 @file{fastjar}, @file{libstdc++-v3}, @file{libjava/libltdl}, @file{boehm-gc},
297 @file{intl}, @file{libada}, and @file{gcc} require autoconf 2.57 (exactly).
298
299 @item automake versions 1.4-gcj and 1.7.9
300
301 Necessary when modifying a @file{Makefile.am} file to regenerate its
302 associated @file{Makefile.in}.
303
304 Much of GCC does not use automake, so directly edit the @file{Makefile.in}
305 file.  Specifically this applies to the @file{gcc}, @file{intl},
306 @file{libf2c}, @file{libiberty}, @file{libobjc} directories as well as any
307 of their subdirectories.
308
309 The @file{libstdc++-v3}, @file{libjava/libltdl}, and @file{fastjar}
310 directories require automake 1.7.9.  However, the Java directories, which
311 include @file{boehm-gc}, @file{libffi}, @file{libjava}, and @file{zlib},
312 require a modified version of automake 1.4 downloadable from
313 @uref{ftp://gcc.gnu.org/pub/java/automake-gcj-1.4.tar.gz}.
314
315 @item gettext version 0.12 (or later)
316
317 Needed to regenerate @file{gcc.pot}.
318
319 @item gperf version 2.7.2 (or later)
320
321 Necessary when modifying @command{gperf} input files, e.g.@:
322 @file{gcc/cp/cfns.gperf} to regenerate its associated header file, e.g.@:
323 @file{gcc/cp/cfns.h}.
324
325 @item expect version ???
326 @itemx tcl version ???
327 @itemx dejagnu version ???
328
329 Necessary to run the GCC testsuite.
330
331 @item autogen version 5.5.4 (or later) and
332 @itemx guile version 1.4.1 (or later)
333
334 Necessary to regenerate @file{fixinc/fixincl.x} from
335 @file{fixinc/inclhack.def} and @file{fixinc/*.tpl}.
336
337 Necessary to run the @file{fixinc} @command{make check}.
338
339 Necessary to regenerate the top level @file{Makefile.in} file from
340 @file{Makefile.tpl} and @file{Makefile.def}.
341
342 @item GNU Bison version 1.28 (or later)
343 Berkeley @command{yacc} (@command{byacc}) is also reported to work other
344 than for java.
345
346 Necessary when modifying @file{*.y} files.
347
348 Necessary to build GCC during development because the generated output
349 files are not included in the CVS repository.  They are included in
350 releases.
351
352 @item Flex version 2.5.4 (or later)
353
354 Necessary when modifying @file{*.l} files.
355
356 Necessary to build GCC during development because the generated output
357 files are not included in the CVS repository.  They are included in
358 releases.
359
360 @item Texinfo version 4.2 (or later)
361
362 Necessary for running @command{makeinfo} when modifying @file{*.texi}
363 files to test your changes.
364
365 Necessary to build GCC documentation during development because the
366 generated output files are not included in the CVS repository.  They are
367 included in releases.
368
369 @item @TeX{} (any working version)
370
371 Necessary for running @command{texi2dvi}, used when running
372 @command{make dvi} to create DVI files.
373
374 @item cvs version 1.10 (or later)
375 @itemx ssh (any version)
376
377 Necessary to access the CVS repository.  Public releases and weekly
378 snapshots of the development sources are also available via FTP.
379
380 @item perl version 5.6.1 (or later)
381
382 Necessary when regenerating @file{Makefile} dependencies in libiberty.
383 Necessary when regenerating @file{libiberty/functions.texi}.
384 Necessary when generating manpages from Texinfo manuals.
385 Used by various scripts to generate some files included in CVS (mainly
386 Unicode-related and rarely changing) from source tables.
387
388 @item GNU diffutils version 2.7 (or later)
389
390 Necessary when creating changes to GCC source code to submit for review.
391
392 @item patch version 2.5.4 (or later)
393
394 Necessary when applying patches, created with @command{diff}, to one's
395 own sources.
396
397 @end table
398
399 @html
400 <hr />
401 <p>
402 @end html
403 @ifhtml
404 @uref{./index.html,,Return to the GCC Installation page}
405 @end ifhtml
406 @end ifset
407
408 @c ***Downloading the source**************************************************
409 @ifnothtml
410 @comment node-name,     next,          previous, up
411 @node    Downloading the source, Configuration, Prerequisites, Installing GCC
412 @end ifnothtml
413 @ifset downloadhtml
414 @ifnothtml
415 @chapter Downloading GCC
416 @end ifnothtml
417 @cindex Downloading GCC
418 @cindex Downloading the Source
419
420 GCC is distributed via @uref{http://gcc.gnu.org/cvs.html,,CVS} and FTP
421 tarballs compressed with @command{gzip} or
422 @command{bzip2}.  It is possible to download a full distribution or specific
423 components.
424
425 Please refer to our @uref{http://gcc.gnu.org/releases.html,,releases web page}
426 for information on how to obtain GCC@.
427
428 The full distribution includes the C, C++, Objective-C, Fortran, Java,
429 and Ada (in case of GCC 3.1 and later) compilers.  The full distribution
430 also includes runtime libraries for C++, Objective-C, Fortran, and Java.
431 In GCC 3.0 and later versions, GNU compiler testsuites are also included
432 in the full distribution.
433
434 If you choose to download specific components, you must download the core
435 GCC distribution plus any language specific distributions you wish to
436 use.  The core distribution includes the C language front end as well as the
437 shared components.  Each language has a tarball which includes the language
438 front end as well as the language runtime (when appropriate).
439
440 Unpack the core distribution as well as any language specific
441 distributions in the same directory.
442
443 If you also intend to build binutils (either to upgrade an existing
444 installation or for use in place of the corresponding tools of your
445 OS), unpack the binutils distribution either in the same directory or
446 a separate one.  In the latter case, add symbolic links to any
447 components of the binutils you intend to build alongside the compiler
448 (@file{bfd}, @file{binutils}, @file{gas}, @file{gprof}, @file{ld},
449 @file{opcodes}, @dots{}) to the directory containing the GCC sources.
450
451 @html
452 <hr />
453 <p>
454 @end html
455 @ifhtml
456 @uref{./index.html,,Return to the GCC Installation page}
457 @end ifhtml
458 @end ifset
459
460 @c ***Configuration***********************************************************
461 @ifnothtml
462 @comment node-name,     next,          previous, up
463 @node    Configuration, Building, Downloading the source, Installing GCC
464 @end ifnothtml
465 @ifset configurehtml
466 @ifnothtml
467 @chapter Installing GCC: Configuration
468 @end ifnothtml
469 @cindex Configuration
470 @cindex Installing GCC: Configuration
471
472 Like most GNU software, GCC must be configured before it can be built.
473 This document describes the recommended configuration procedure
474 for both native and cross targets.
475
476 We use @var{srcdir} to refer to the toplevel source directory for
477 GCC; we use @var{objdir} to refer to the toplevel build/object directory.
478
479 If you obtained the sources via CVS, @var{srcdir} must refer to the top
480 @file{gcc} directory, the one where the @file{MAINTAINERS} can be found,
481 and not its @file{gcc} subdirectory, otherwise the build will fail.
482
483 If either @var{srcdir} or @var{objdir} is located on an automounted NFS
484 file system, the shell's built-in @command{pwd} command will return
485 temporary pathnames.  Using these can lead to various sorts of build
486 problems.  To avoid this issue, set the @env{PWDCMD} environment
487 variable to an automounter-aware @command{pwd} command, e.g.,
488 @command{pawd} or @samp{amq -w}, during the configuration and build
489 phases.
490
491 First, we @strong{highly} recommend that GCC be built into a
492 separate directory than the sources which does @strong{not} reside
493 within the source tree.  This is how we generally build GCC; building
494 where @var{srcdir} == @var{objdir} should still work, but doesn't
495 get extensive testing; building where @var{objdir} is a subdirectory
496 of @var{srcdir} is unsupported.
497
498 If you have previously built GCC in the same directory for a
499 different target machine, do @samp{make distclean} to delete all files
500 that might be invalid.  One of the files this deletes is @file{Makefile};
501 if @samp{make distclean} complains that @file{Makefile} does not exist
502 or issues a message like ``don't know how to make distclean'' it probably
503 means that the directory is already suitably clean.  However, with the
504 recommended method of building in a separate @var{objdir}, you should
505 simply use a different @var{objdir} for each target.
506
507 Second, when configuring a native system, either @command{cc} or
508 @command{gcc} must be in your path or you must set @env{CC} in
509 your environment before running configure.  Otherwise the configuration
510 scripts may fail.
511
512 Note that the bootstrap compiler and the resulting GCC must be link
513 compatible, else the bootstrap will fail with linker errors about
514 incompatible object file formats.  Several multilibed targets are
515 affected by this requirement, see
516 @ifnothtml
517 @ref{Specific, host/target specific installation notes}.
518 @end ifnothtml
519 @ifhtml
520 @uref{specific.html,,host/target specific installation notes}.
521 @end ifhtml
522
523 To configure GCC:
524
525 @smallexample
526    % mkdir @var{objdir}
527    % cd @var{objdir}
528    % @var{srcdir}/configure [@var{options}] [@var{target}]
529 @end smallexample
530
531
532 @heading Target specification
533 @itemize @bullet
534 @item
535 GCC has code to correctly determine the correct value for @var{target}
536 for nearly all native systems.  Therefore, we highly recommend you not
537 provide a configure target when configuring a native compiler.
538
539 @item
540 @var{target} must be specified as @option{--target=@var{target}}
541 when configuring a cross compiler; examples of valid targets would be
542 m68k-coff, sh-elf, etc.
543
544 @item
545 Specifying just @var{target} instead of @option{--target=@var{target}}
546 implies that the host defaults to @var{target}.
547 @end itemize
548
549
550 @heading Options specification
551
552 Use @var{options} to override several configure time options for
553 GCC@.  A list of supported @var{options} follows; @samp{configure
554 --help} may list other options, but those not listed below may not
555 work and should not normally be used.
556
557 Note that each @option{--enable} option has a corresponding
558 @option{--disable} option and that each @option{--with} option has a
559 corresponding @option{--without} option.
560
561 @table @code
562 @item --prefix=@var{dirname}
563 Specify the toplevel installation
564 directory.  This is the recommended way to install the tools into a directory
565 other than the default.  The toplevel installation directory defaults to
566 @file{/usr/local}.
567
568 We @strong{highly} recommend against @var{dirname} being the same or a
569 subdirectory of @var{objdir} or vice versa.  If specifying a directory
570 beneath a user's home directory tree, some shells will not expand
571 @var{dirname} correctly if it contains the @samp{~} metacharacter; use
572 @env{$HOME} instead.
573
574 The following standard @command{autoconf} options are supported.  Normally you
575 should not need to use these options.
576 @table @code
577 @item --exec-prefix=@var{dirname}
578 Specify the toplevel installation directory for architecture-dependent
579 files.  The default is @file{@var{prefix}}.
580
581 @item --bindir=@var{dirname}
582 Specify the installation directory for the executables called by users
583 (such as @command{gcc} and @command{g++}).  The default is
584 @file{@var{exec-prefix}/bin}.
585
586 @item --libdir=@var{dirname}
587 Specify the installation directory for object code libraries and
588 internal data files of GCC@.  The default is @file{@var{exec-prefix}/lib}.
589
590 @item --libexecdir=@var{dirname}
591 Specify the installation directory for internal executables of GCC@.
592   The default is @file{@var{exec-prefix}/libexec}.
593
594 @item --with-slibdir=@var{dirname}
595 Specify the installation directory for the shared libgcc library.  The
596 default is @file{@var{libdir}}.
597
598 @item --infodir=@var{dirname}
599 Specify the installation directory for documentation in info format.
600 The default is @file{@var{prefix}/info}.
601
602 @item --datadir=@var{dirname}
603 Specify the installation directory for some architecture-independent
604 data files referenced by GCC@.  The default is @file{@var{prefix}/share}.
605
606 @item --mandir=@var{dirname}
607 Specify the installation directory for manual pages.  The default is
608 @file{@var{prefix}/man}.  (Note that the manual pages are only extracts from
609 the full GCC manuals, which are provided in Texinfo format.  The manpages
610 are derived by an automatic conversion process from parts of the full
611 manual.)
612
613 @item --with-gxx-include-dir=@var{dirname}
614 Specify
615 the installation directory for G++ header files.  The default is
616 @file{@var{prefix}/include/c++/@var{version}}.
617
618 @end table
619
620 @item --program-prefix=@var{prefix}
621 GCC supports some transformations of the names of its programs when
622 installing them. This option prepends @var{prefix} to the names of
623 programs to install in @var{bindir} (see above). For example, specifying
624 @option{--program-prefix=foo-} would result in @samp{gcc}
625 being installed as @file{/usr/local/bin/foo-gcc}.
626
627 @item --program-suffix=@var{suffix}
628 Appends @var{suffix} to the names of programs to install in @var{bindir}
629 (see above). For example, specifying @option{--program-suffix=-3.1}
630 would result in @samp{gcc} being installed as
631 @file{/usr/local/bin/gcc-3.1}.
632
633 @item --program-transform-name=@var{pattern}
634 Applies the @samp{sed} script @var{pattern} to be applied to the names
635 of programs to install in @var{bindir} (see above). @var{pattern} has to
636 consist of one or more basic @samp{sed} editing commands, separated by
637 semicolons. For example, if you want the @samp{gcc} program name to be
638 transformed to the installed program @file{/usr/local/bin/myowngcc} and
639 the @samp{g++} program name to be transformed to
640 @file{/usr/local/bin/gspecial++} without changing other program names,
641 you could use the pattern
642 @option{--program-transform-name='s/^gcc$/myowngcc/; s/^g++$/gspecial++/'}
643 to achieve this effect.
644
645 All three options can be combined and used together, resulting in more
646 complex conversion patterns. As a basic rule, @var{prefix} (and
647 @var{suffix}) are prepended (appended) before further transformations
648 can happen with a special transformation script @var{pattern}.
649
650 As currently implemented, this option only takes effect for native
651 builds; cross compiler binaries' names are not transformed even when a
652 transformation is explicitly asked for by one of these options.
653
654 For native builds, some of the installed programs are also installed
655 with the target alias in front of their name, as in
656 @samp{i686-pc-linux-gnu-gcc}. All of the above transformations happen
657 before the target alias is prepended to the name - so, specifying
658 @option{--program-prefix=foo-} and @option{program-suffix=-3.1}, the
659 resulting binary would be installed as
660 @file{/usr/local/bin/i686-pc-linux-gnu-foo-gcc-3.1}.
661
662 As a last shortcoming, none of the installed Ada programs are
663 transformed yet, which will be fixed in some time.
664
665 @item --with-local-prefix=@var{dirname}
666 Specify the
667 installation directory for local include files.  The default is
668 @file{/usr/local}.  Specify this option if you want the compiler to
669 search directory @file{@var{dirname}/include} for locally installed
670 header files @emph{instead} of @file{/usr/local/include}.
671
672 You should specify @option{--with-local-prefix} @strong{only} if your
673 site has a different convention (not @file{/usr/local}) for where to put
674 site-specific files.
675
676 The default value for @option{--with-local-prefix} is @file{/usr/local}
677 regardless of the value of @option{--prefix}.  Specifying
678 @option{--prefix} has no effect on which directory GCC searches for
679 local header files.  This may seem counterintuitive, but actually it is
680 logical.
681
682 The purpose of @option{--prefix} is to specify where to @emph{install
683 GCC}.  The local header files in @file{/usr/local/include}---if you put
684 any in that directory---are not part of GCC@.  They are part of other
685 programs---perhaps many others.  (GCC installs its own header files in
686 another directory which is based on the @option{--prefix} value.)
687
688 Both the local-prefix include directory and the GCC-prefix include
689 directory are part of GCC's "system include" directories.  Although these
690 two directories are not fixed, they need to be searched in the proper
691 order for the correct processing of the include_next directive.  The
692 local-prefix include directory is searched before the GCC-prefix
693 include directory.  Another characteristic of system include directories
694 is that pedantic warnings are turned off for headers in these directories.
695
696 Some autoconf macros add @option{-I @var{directory}} options to the
697 compiler command line, to ensure that directories containing installed
698 packages' headers are searched.  When @var{directory} is one of GCC's
699 system include directories, GCC will ignore the option so that system
700 directories continue to be processed in the correct order.  This
701 may result in a search order different from what was specified but the
702 directory will still be searched.
703
704 GCC automatically searches for ordinary libraries using
705 @env{GCC_EXEC_PREFIX}.  Thus, when the same installation prefix is
706 used for both GCC and packages, GCC will automatically search for
707 both headers and libraries.  This provides a configuration that is
708 easy to use.  GCC behaves in a manner similar to that when it is
709 installed as a system compiler in @file{/usr}.
710
711 Sites that need to install multiple versions of GCC may not want to
712 use the above simple configuration.  It is possible to use the
713 @option{--program-prefix}, @option{--program-suffix} and
714 @option{--program-transform-name} options to install multiple versions
715 into a single directory, but it may be simpler to use different prefixes
716 and the @option{--with-local-prefix} option to specify the location of the
717 site-specific files for each version.  It will then be necessary for
718 users to specify explicitly the location of local site libraries
719 (e.g., with @env{LIBRARY_PATH}).
720
721 The same value can be used for both @option{--with-local-prefix} and
722 @option{--prefix} provided it is not @file{/usr}.  This can be used
723 to avoid the default search of @file{/usr/local/include}.
724
725 @strong{Do not} specify @file{/usr} as the @option{--with-local-prefix}!
726 The directory you use for @option{--with-local-prefix} @strong{must not}
727 contain any of the system's standard header files.  If it did contain
728 them, certain programs would be miscompiled (including GNU Emacs, on
729 certain targets), because this would override and nullify the header
730 file corrections made by the @command{fixincludes} script.
731
732 Indications are that people who use this option use it based on mistaken
733 ideas of what it is for.  People use it as if it specified where to
734 install part of GCC@.  Perhaps they make this assumption because
735 installing GCC creates the directory.
736
737 @item --enable-shared[=@var{package}[,@dots{}]]
738 Build shared versions of libraries, if shared libraries are supported on
739 the target platform.  Unlike GCC 2.95.x and earlier, shared libraries
740 are enabled by default on all platforms that support shared libraries,
741 except for @samp{libobjc} which is built as a static library only by
742 default.
743
744 If a list of packages is given as an argument, build shared libraries
745 only for the listed packages.  For other packages, only static libraries
746 will be built.  Package names currently recognized in the GCC tree are
747 @samp{libgcc} (also known as @samp{gcc}), @samp{libstdc++} (not
748 @samp{libstdc++-v3}), @samp{libffi}, @samp{zlib}, @samp{boehm-gc} and
749 @samp{libjava}.  Note that @samp{libobjc} does not recognize itself by
750 any name, so, if you list package names in @option{--enable-shared},
751 you will only get static Objective-C libraries.  @samp{libf2c} and
752 @samp{libiberty} do not support shared libraries at all.
753
754 Use @option{--disable-shared} to build only static libraries.  Note that
755 @option{--disable-shared} does not accept a list of package names as
756 argument, only @option{--enable-shared} does.
757
758 @item @anchor{with-gnu-as}--with-gnu-as
759 Specify that the compiler should assume that the
760 assembler it finds is the GNU assembler.  However, this does not modify
761 the rules to find an assembler and will result in confusion if the
762 assembler found is not actually the GNU assembler.  (Confusion may also
763 result if the compiler finds the GNU assembler but has not been
764 configured with @option{--with-gnu-as}.)  If you have more than one
765 assembler installed on your system, you may want to use this option in
766 connection with @option{--with-as=@var{pathname}}.
767
768 The following systems are the only ones where it makes a difference
769 whether you use the GNU assembler.  On any other system,
770 @option{--with-gnu-as} has no effect.
771
772 @itemize @bullet
773 @item @samp{hppa1.0-@var{any}-@var{any}}
774 @item @samp{hppa1.1-@var{any}-@var{any}}
775 @item @samp{i386-@var{any}-sysv}
776 @item @samp{m68k-bull-sysv}
777 @item @samp{m68k-hp-hpux}
778 @item @samp{m68000-hp-hpux}
779 @item @samp{m68000-att-sysv}
780 @item @samp{@var{any}-lynx-lynxos}
781 @item @samp{mips-@var{any}}
782 @item @samp{sparc-sun-solaris2.@var{any}}
783 @item @samp{sparc64-@var{any}-solaris2.@var{any}}
784 @end itemize
785
786 On the systems listed above (except for the HP-PA, the SPARC, for ISC on
787 the 386, and for @samp{mips-sgi-irix5.*}), if you use the GNU assembler,
788 you should also use the GNU linker (and specify @option{--with-gnu-ld}).
789
790 @item @anchor{with-as}--with-as=@var{pathname}
791 Specify that the
792 compiler should use the assembler pointed to by @var{pathname}, rather
793 than the one found by the standard rules to find an assembler, which
794 are:
795 @itemize @bullet
796 @item
797 Check the @file{@var{libexec}/gcc/@var{target}/@var{version}}
798 directory, where @var{libexec} defaults to
799 @file{@var{exec-prefix}/libexec} and @var{exec-prefix} defaults to
800 @var{prefix} which defaults to @file{/usr/local} unless overridden by
801 the @option{--prefix=@var{pathname}} switch described
802 above. @var{target} is the target system triple, such as
803 @samp{sparc-sun-solaris2.7}, and @var{version} denotes the GCC
804 version, such as 3.0.
805 @item
806 Check operating system specific directories (e.g.@: @file{/usr/ccs/bin} on
807 Sun Solaris 2).
808 @end itemize
809 Note that these rules do not check for the value of @env{PATH}.  You may
810 want to use @option{--with-as} if no assembler is installed in the
811 directories listed above, or if you have multiple assemblers installed
812 and want to choose one that is not found by the above rules.
813
814 @item @anchor{with-gnu-ld}--with-gnu-ld
815 Same as @uref{#with-gnu-as,,@option{--with-gnu-as}}
816 but for the linker.
817
818 @item --with-ld=@var{pathname}
819 Same as @uref{#with-as,,@option{--with-as}}
820 but for the linker.
821
822 @item --with-stabs
823 Specify that stabs debugging
824 information should be used instead of whatever format the host normally
825 uses.  Normally GCC uses the same debug format as the host system.
826
827 On MIPS based systems and on Alphas, you must specify whether you want
828 GCC to create the normal ECOFF debugging format, or to use BSD-style
829 stabs passed through the ECOFF symbol table.  The normal ECOFF debug
830 format cannot fully handle languages other than C@.  BSD stabs format can
831 handle other languages, but it only works with the GNU debugger GDB@.
832
833 Normally, GCC uses the ECOFF debugging format by default; if you
834 prefer BSD stabs, specify @option{--with-stabs} when you configure GCC@.
835
836 No matter which default you choose when you configure GCC, the user
837 can use the @option{-gcoff} and @option{-gstabs+} options to specify explicitly
838 the debug format for a particular compilation.
839
840 @option{--with-stabs} is meaningful on the ISC system on the 386, also, if
841 @option{--with-gas} is used.  It selects use of stabs debugging
842 information embedded in COFF output.  This kind of debugging information
843 supports C++ well; ordinary COFF debugging information does not.
844
845 @option{--with-stabs} is also meaningful on 386 systems running SVR4.  It
846 selects use of stabs debugging information embedded in ELF output.  The
847 C++ compiler currently (2.6.0) does not support the DWARF debugging
848 information normally used on 386 SVR4 platforms; stabs provide a
849 workable alternative.  This requires gas and gdb, as the normal SVR4
850 tools can not generate or interpret stabs.
851
852 @item --disable-multilib
853 Specify that multiple target
854 libraries to support different target variants, calling
855 conventions, etc should not be built.  The default is to build a
856 predefined set of them.
857
858 Some targets provide finer-grained control over which multilibs are built
859 (e.g., @option{--disable-softfloat}):
860 @table @code
861 @item arc-*-elf*
862 biendian.
863
864 @item arm-*-*
865 fpu, 26bit, underscore, interwork, biendian, nofmult.
866
867 @item m68*-*-*
868 softfloat, m68881, m68000, m68020.
869
870 @item mips*-*-*
871 single-float, biendian, softfloat.
872
873 @item powerpc*-*-*, rs6000*-*-*
874 aix64, pthread, softfloat, powercpu, powerpccpu, powerpcos, biendian,
875 sysv, aix.
876
877 @end table
878
879 @item --enable-threads
880 Specify that the target
881 supports threads.  This affects the Objective-C compiler and runtime
882 library, and exception handling for other languages like C++ and Java.
883 On some systems, this is the default.
884
885 In general, the best (and, in many cases, the only known) threading
886 model available will be configured for use.  Beware that on some
887 systems, gcc has not been taught what threading models are generally
888 available for the system.  In this case, @option{--enable-threads} is an
889 alias for @option{--enable-threads=single}.
890
891 @item --disable-threads
892 Specify that threading support should be disabled for the system.
893 This is an alias for @option{--enable-threads=single}.
894
895 @item --enable-threads=@var{lib}
896 Specify that
897 @var{lib} is the thread support library.  This affects the Objective-C
898 compiler and runtime library, and exception handling for other languages
899 like C++ and Java.  The possibilities for @var{lib} are:
900
901 @table @code
902 @item aix
903 AIX thread support.
904 @item dce
905 DCE thread support.
906 @item gnat
907 Ada tasking support.  For non-Ada programs, this setting is equivalent
908 to @samp{single}. When used in conjunction with the Ada run time, it
909 causes GCC to use the same thread primitives as Ada uses.  This option
910 is necessary when using both Ada and the back end exception handling,
911 which is the default for most Ada targets.
912 @item mach
913 Generic MACH thread support, known to work on NeXTSTEP@.  (Please note
914 that the file needed to support this configuration, @file{gthr-mach.h}, is
915 missing and thus this setting will cause a known bootstrap failure.)
916 @item no
917 This is an alias for @samp{single}.
918 @item posix
919 Generic POSIX thread support.
920 @item rtems
921 RTEMS thread support.
922 @item single
923 Disable thread support, should work for all platforms.
924 @item solaris
925 Sun Solaris 2 thread support.
926 @item vxworks
927 VxWorks thread support.
928 @item win32
929 Microsoft Win32 API thread support.
930 @end table
931
932 @item --with-cpu=@var{cpu}
933 Specify which cpu variant the compiler should generate code for by default.
934 @var{cpu} will be used as the default value of the @option{-mcpu=} switch.
935 This option is only supported on some targets, including ARM, i386, PowerPC,
936 and SPARC@.
937
938 @item --with-schedule=@var{cpu}
939 @itemx --with-arch=@var{cpu}
940 @itemx --with-tune=@var{cpu}
941 @itemx --with-abi=@var{abi}
942 @itemx --with-fpu=@var{type}
943 @itemx --with-float=@var{type}
944 These configure options provide default values for the @option{-mschedule=},
945 @option{-march=}, @option{-mtune=}, @option{-mabi=}, and @option{-mfpu=}
946 options and for @option{-mhard-float} or @option{-msoft-float}.  As with
947 @option{--with-cpu}, which switches will be accepted and acceptable values
948 of the arguments depend on the target.
949
950 @item --enable-altivec
951 Specify that the target supports AltiVec vector enhancements.  This
952 option will adjust the ABI for AltiVec enhancements, as well as generate
953 AltiVec code when appropriate.  This option is only available for
954 PowerPC systems.
955
956 @item --enable-__cxa_atexit
957 Define if you want to use __cxa_atexit, rather than atexit, to
958 register C++ destructors for local statics and global objects.
959 This is essential for fully standards-compliant handling of
960 destructors, but requires __cxa_atexit in libc. This option is currently
961 only available on systems with GNU libc. When enabled, this will cause
962 @option{-fuse-cxa-exit} to be passed by default.
963
964 @item --enable-target-optspace
965 Specify that target
966 libraries should be optimized for code space instead of code speed.
967 This is the default for the m32r platform.
968
969 @item --disable-cpp
970 Specify that a user visible @command{cpp} program should not be installed.
971
972 @item --with-cpp-install-dir=@var{dirname}
973 Specify that the user visible @command{cpp} program should be installed
974 in @file{@var{prefix}/@var{dirname}/cpp}, in addition to @var{bindir}.
975
976 @item --enable-initfini-array
977 Force the use of sections @code{.init_array} and @code{.fini_array}
978 (instead of @code{.init} and @code{.fini}) for constructors and
979 destructors.  Option @option{--disable-initfini-array} has the
980 opposite effect.  If neither option is specified, the configure script
981 will try to guess whether the @code{.init_array} and
982 @code{.fini_array} sections are supported and, if they are, use them.
983
984 @item --enable-maintainer-mode
985 The build rules that
986 regenerate the GCC master message catalog @file{gcc.pot} are normally
987 disabled.  This is because it can only be rebuilt if the complete source
988 tree is present.  If you have changed the sources and want to rebuild the
989 catalog, configuring with @option{--enable-maintainer-mode} will enable
990 this.  Note that you need a recent version of the @code{gettext} tools
991 to do so.
992
993 @item --enable-generated-files-in-srcdir
994 Neither the .c and .h files that are generated from bison and flex nor the
995 info manuals and man pages that are built from the .texi files are present
996 in the CVS development tree.  When building GCC from that development tree,
997 or from a snapshot which are created from CVS, then those generated files
998 are placed in your build directory, which allows for the source to be in a
999 readonly directory.
1000
1001 If you configure with @option{--enable-generated-files-in-srcdir} then those
1002 generated files will go into the source directory.  This is mainly intended
1003 for generating release or prerelease tarballs of the GCC sources, since it
1004 is not a requirement that the users of source releases to have flex, bison, or
1005 makeinfo.
1006
1007 @item --enable-version-specific-runtime-libs
1008 Specify
1009 that runtime libraries should be installed in the compiler specific
1010 subdirectory (@file{@var{libdir}/gcc}) rather than the usual places.  In
1011 addition, @samp{libstdc++}'s include files will be installed into
1012 @file{@var{libdir}} unless you overruled it by using
1013 @option{--with-gxx-include-dir=@var{dirname}}.  Using this option is
1014 particularly useful if you intend to use several versions of GCC in
1015 parallel. This is currently supported by @samp{libf2c} and
1016 @samp{libstdc++}, and is the default for @samp{libobjc} which cannot be
1017 changed in this case.
1018
1019 @item --enable-languages=@var{lang1},@var{lang2},@dots{}
1020 Specify that only a particular subset of compilers and
1021 their runtime libraries should be built.  For a list of valid values for
1022 @var{langN} you can issue the following command in the
1023 @file{gcc} directory of your GCC source tree:@*
1024 @smallexample
1025 grep language= */config-lang.in
1026 @end smallexample
1027 Currently, you can use any of the following:
1028 @code{ada}, @code{c}, @code{c++}, @code{f77}, @code{java}, @code{objc}.
1029 Building the Ada compiler has special requirements, see below.@*
1030 If you do not pass this flag, all languages available in the @file{gcc}
1031 sub-tree will be configured.  Re-defining @code{LANGUAGES} when calling
1032 @samp{make bootstrap} @strong{does not} work anymore, as those
1033 language sub-directories might not have been configured!
1034
1035 @item --disable-libada
1036 Specify that the run-time libraries and tools used by GNAT should not
1037 be built.  This can be useful for debugging, or for compatibility with
1038 previous Ada build procedures, when it was required to explicitly
1039 do a @samp{make -C gcc gnatlib_and_tools}.
1040
1041 @item --with-dwarf2
1042 Specify that the compiler should
1043 use DWARF 2 debugging information as the default.
1044
1045 @item --enable-win32-registry
1046 @itemx --enable-win32-registry=@var{key}
1047 @itemx --disable-win32-registry
1048 The @option{--enable-win32-registry} option enables Microsoft Windows-hosted GCC
1049 to look up installations paths in the registry using the following key:
1050
1051 @smallexample
1052 @code{HKEY_LOCAL_MACHINE\SOFTWARE\Free Software Foundation\@var{key}}
1053 @end smallexample
1054
1055 @var{key} defaults to GCC version number, and can be overridden by the
1056 @option{--enable-win32-registry=@var{key}} option. Vendors and distributors
1057 who use custom installers are encouraged to provide a different key,
1058 perhaps one comprised of vendor name and GCC version number, to
1059 avoid conflict with existing installations.  This feature is enabled
1060 by default, and can be disabled by @option{--disable-win32-registry}
1061 option.  This option has no effect on the other hosts.
1062
1063 @item --nfp
1064 Specify that the machine does not have a floating point unit.  This
1065 option only applies to @samp{m68k-sun-sunos@var{n}}.  On any other
1066 system, @option{--nfp} has no effect.
1067
1068 @item --enable-werror
1069 @itemx --disable-werror
1070 @itemx --enable-werror=yes
1071 @itemx --enable-werror=no
1072 When you specify this option, it controls whether certain files in the
1073 compiler are built with @option{-Werror} in bootstrap stage2 and later.
1074 If you don't specify it, @option{-Werror} is turned on for the main
1075 development trunk.  However it defaults to off for release branches and
1076 final releases.  The specific files which get @option{-Werror} are
1077 controlled by the Makefiles.
1078
1079 @item --enable-checking
1080 @itemx --enable-checking=@var{list}
1081 When you specify this option, the compiler is built to perform checking
1082 of tree node types when referencing fields of that node, and some other
1083 internal consistency checks.  This does not change the generated code,
1084 but adds error checking within the compiler.  This will slow down the
1085 compiler and may only work properly if you are building the compiler
1086 with GCC@.  This is on by default when building from CVS or snapshots,
1087 but off for releases.  More control over the checks may be had by
1088 specifying @var{list}; the categories of checks available are
1089 @samp{misc}, @samp{tree}, @samp{gc}, @samp{rtl}, @samp{rtlflag},
1090 @samp{fold}, @samp{gcac} and @samp{valgrind}.  The check @samp{valgrind}
1091 requires the external @command{valgrind} simulator, available from
1092 @uref{http://valgrind.kde.org/}.  The default when @var{list} is
1093 not specified is @samp{misc,tree,gc,rtlflag}; the checks @samp{rtl},
1094 @samp{gcac} and @samp{valgrind} are very expensive.
1095
1096 @item --enable-coverage
1097 @itemx --enable-coverage=@var{level}
1098 With this option, the compiler is built to collect self coverage
1099 information, every time it is run. This is for internal development
1100 purposes, and only works when the compiler is being built with gcc. The
1101 @var{level} argument controls whether the compiler is built optimized or
1102 not, values are @samp{opt} and @samp{noopt}. For coverage analysis you
1103 want to disable optimization, for performance analysis you want to
1104 enable optimization. When coverage is enabled, the default level is
1105 without optimization.
1106
1107 @item --enable-gather-detailed-mem-stats
1108 When this option is specified more detailed information on memory
1109 allocation is gathered.  This information is printed when using
1110 @option{-fmem-report}.
1111
1112 @item --enable-nls
1113 @itemx --disable-nls
1114 The @option{--enable-nls} option enables Native Language Support (NLS),
1115 which lets GCC output diagnostics in languages other than American
1116 English.  Native Language Support is enabled by default if not doing a
1117 canadian cross build.  The @option{--disable-nls} option disables NLS@.
1118
1119 @item --with-included-gettext
1120 If NLS is enabled, the @option{--with-included-gettext} option causes the build
1121 procedure to prefer its copy of GNU @command{gettext}.
1122
1123 @item --with-catgets
1124 If NLS is enabled, and if the host lacks @code{gettext} but has the
1125 inferior @code{catgets} interface, the GCC build procedure normally
1126 ignores @code{catgets} and instead uses GCC's copy of the GNU
1127 @code{gettext} library.  The @option{--with-catgets} option causes the
1128 build procedure to use the host's @code{catgets} in this situation.
1129
1130 @item --with-libiconv-prefix=@var{dir}
1131 Search for libiconv header files in @file{@var{dir}/include} and
1132 libiconv library files in @file{@var{dir}/lib}.
1133
1134 @item --enable-obsolete
1135 Enable configuration for an obsoleted system.  If you attempt to
1136 configure GCC for a system (build, host, or target) which has been
1137 obsoleted, and you do not specify this flag, configure will halt with an
1138 error message.
1139
1140 All support for systems which have been obsoleted in one release of GCC
1141 is removed entirely in the next major release, unless someone steps
1142 forward to maintain the port.
1143 @end table
1144
1145 @subheading Cross-Compiler-Specific Options
1146 The following options only apply to building cross compilers.
1147 @table @code
1148 @item --with-sysroot
1149 @itemx --with-sysroot=@var{dir}
1150 Tells GCC to consider @var{dir} as the root of a tree that contains a
1151 (subset of) the root filesystem of the target operating system.
1152 Target system headers, libraries and run-time object files will be
1153 searched in there.  The specified directory is not copied into the
1154 install tree, unlike the options @option{--with-headers} and
1155 @option{--with-libs} that this option obsoletes.  The default value,
1156 in case @option{--with-sysroot} is not given an argument, is
1157 @option{$@{gcc_tooldir@}/sys-root}.  If the specified directory is a
1158 subdirectory of @option{$@{exec_prefix@}}, then it will be found relative to
1159 the GCC binaries if the installation tree is moved.
1160
1161 @item --with-headers
1162 @itemx --with-headers=@var{dir}
1163 Deprecated in favor of @option{--with-sysroot}.
1164 Specifies that target headers are available when building a cross compiler.
1165 The @var{dir} argument specifies a directory which has the target include
1166 files.  These include files will be copied into the @file{gcc} install
1167 directory.  @emph{This option with the @var{dir} argument is required} when
1168 building a cross compiler, if @file{@var{prefix}/@var{target}/sys-include}
1169 doesn't pre-exist.  If @file{@var{prefix}/@var{target}/sys-include} does
1170 pre-exist, the @var{dir} argument may be omitted.  @command{fixincludes}
1171 will be run on these files to make them compatible with GCC.
1172
1173 @item --without-headers
1174 Tells GCC not use any target headers from a libc when building a cross
1175 compiler.  When crossing to GNU/Linux, you need the headers so gcc
1176 can build the exception handling for libgcc.
1177 See @uref{http://www.objsw.com/CrossGCC/,,CrossGCC} for more information
1178 on this option.
1179
1180 @item --with-libs
1181 @itemx --with-libs=``@var{dir1} @var{dir2} @dots{} @var{dirN}''
1182 Deprecated in favor of @option{--with-sysroot}.
1183 Specifies a list of directories which contain the target runtime
1184 libraries.  These libraries will be copied into the @file{gcc} install
1185 directory.  If the directory list is omitted, this option has no
1186 effect.
1187 @item --with-newlib
1188 Specifies that @samp{newlib} is
1189 being used as the target C library.  This causes @code{__eprintf} to be
1190 omitted from @file{libgcc.a} on the assumption that it will be provided by
1191 @samp{newlib}.
1192 @end table
1193
1194 @subheading Java-Specific Options
1195
1196 The following option applies to the build of the Java front end.
1197
1198 @table @code
1199 @item --disable-libgcj
1200 Specify that the run-time libraries
1201 used by GCJ should not be built.  This is useful in case you intend
1202 to use GCJ with some other run-time, or you're going to install it
1203 separately, or it just happens not to build on your particular
1204 machine.  In general, if the Java front end is enabled, the GCJ
1205 libraries will be enabled too, unless they're known to not work on
1206 the target platform.  If GCJ is enabled but @samp{libgcj} isn't built, you
1207 may need to port it; in this case, before modifying the top-level
1208 @file{configure.in} so that @samp{libgcj} is enabled by default on this platform,
1209 you may use @option{--enable-libgcj} to override the default.
1210
1211 @end table
1212
1213 The following options apply to building @samp{libgcj}.
1214
1215 @subsubheading General Options
1216
1217 @table @code
1218 @item --disable-getenv-properties
1219 Don't set system properties from @env{GCJ_PROPERTIES}.
1220
1221 @item --enable-hash-synchronization
1222 Use a global hash table for monitor locks. Ordinarily,
1223 @samp{libgcj}'s @samp{configure} script automatically makes
1224 the correct choice for this option for your platform. Only use
1225 this if you know you need the library to be configured differently.
1226
1227 @item --enable-interpreter
1228 Enable the Java interpreter. The interpreter is automatically
1229 enabled by default on all platforms that support it. This option
1230 is really only useful if you want to disable the interpreter
1231 (using @option{--disable-interpreter}).
1232
1233 @item --disable-java-net
1234 Disable java.net. This disables the native part of java.net only,
1235 using non-functional stubs for native method implementations.
1236
1237 @item --disable-jvmpi
1238 Disable JVMPI support.
1239
1240 @item --with-ecos
1241 Enable runtime eCos target support.
1242
1243 @item --without-libffi
1244 Don't use @samp{libffi}. This will disable the interpreter and JNI
1245 support as well, as these require @samp{libffi} to work.
1246
1247 @item --enable-libgcj-debug
1248 Enable runtime debugging code.
1249
1250 @item --enable-libgcj-multifile
1251 If specified, causes all @file{.java} source files to be
1252 compiled into @file{.class} files in one invocation of
1253 @samp{gcj}. This can speed up build time, but is more
1254 resource-intensive. If this option is unspecified or
1255 disabled, @samp{gcj} is invoked once for each @file{.java}
1256 file to compile into a @file{.class} file.
1257
1258 @item --with-libiconv-prefix=DIR
1259 Search for libiconv in @file{DIR/include} and @file{DIR/lib}.
1260
1261 @item --enable-sjlj-exceptions
1262 Force use of @code{builtin_setjmp} for exceptions. @samp{configure}
1263 ordinarily picks the correct value based on the platform. Only use
1264 this option if you are sure you need a different setting.
1265
1266 @item --with-system-zlib
1267 Use installed @samp{zlib} rather than that included with GCC@.
1268
1269 @item --with-win32-nlsapi=ansi, unicows or unicode
1270 Indicates how MinGW @samp{libgcj} translates between UNICODE
1271 characters and the Win32 API.
1272 @table @code
1273 @item ansi
1274 Use the single-byte @code{char} and the Win32 A functions natively,
1275 translating to and from UNICODE when using these functions. If
1276 unspecified, this is the default.
1277
1278 @item unicows
1279 Use the @code{WCHAR} and Win32 W functions natively. Adds
1280 @code{-lunicows} to @file{libgcj.spec} to link with @samp{libunicows}.
1281 @file{unicows.dll} needs to be deployed on Microsoft Windows 9X machines
1282 running built executables. @file{libunicows.a}, an open-source
1283 import library around Microsoft's @code{unicows.dll}, is obtained from
1284 @uref{http://libunicows.sourceforge.net/}, which also gives details
1285 on getting @file{unicows.dll} from Microsoft.
1286
1287 @item unicode
1288 Use the @code{WCHAR} and Win32 W functions natively. Does @emph{not}
1289 add @code{-lunicows} to @file{libgcj.spec}. The built executables will
1290 only run on Microsoft Windows NT and above.
1291 @end table
1292 @end table
1293
1294 @subsubheading AWT-Specific Options
1295
1296 @table @code
1297 @item --with-x
1298 Use the X Window System.
1299
1300 @item --enable-java-awt=PEER(S)
1301 Specifies the AWT peer library or libraries to build alongside
1302 @samp{libgcj}. If this option is unspecified or disabled, AWT
1303 will be non-functional. Current valid values are @option{gtk} and
1304 @option{xlib}. Multiple libraries should be separated by a
1305 comma (i.e. @option{--enable-java-awt=gtk,xlib}).
1306
1307 @item --enable-gtk-cairo
1308 Build the cairo Graphics2D implementation on GTK.
1309
1310 @item --enable-java-gc=TYPE
1311 Choose garbage collector. Defaults to @option{boehm} if unspecified.
1312
1313 @item --disable-gtktest
1314 Do not try to compile and run a test GTK+ program.
1315
1316 @item --disable-glibtest
1317 Do not try to compile and run a test GLIB program.
1318
1319 @item --with-libart-prefix=PFX
1320 Prefix where libart is installed (optional).
1321
1322 @item --with-libart-exec-prefix=PFX
1323 Exec prefix where libart is installed (optional).
1324
1325 @item --disable-libarttest
1326 Do not try to compile and run a test libart program.
1327
1328 @end table
1329
1330 @html
1331 <hr />
1332 <p>
1333 @end html
1334 @ifhtml
1335 @uref{./index.html,,Return to the GCC Installation page}
1336 @end ifhtml
1337 @end ifset
1338
1339 @c ***Building****************************************************************
1340 @ifnothtml
1341 @comment node-name,     next,          previous, up
1342 @node    Building, Testing, Configuration, Installing GCC
1343 @end ifnothtml
1344 @ifset buildhtml
1345 @ifnothtml
1346 @chapter Building
1347 @end ifnothtml
1348 @cindex Installing GCC: Building
1349
1350 Now that GCC is configured, you are ready to build the compiler and
1351 runtime libraries.
1352
1353 We @strong{highly} recommend that GCC be built using GNU make;
1354 other versions may work, then again they might not.
1355 GNU make is required for compiling GNAT (the Ada compiler) and the Java
1356 runtime library.
1357
1358 (For example, many broken versions of make will fail if you use the
1359 recommended setup where @var{objdir} is different from @var{srcdir}.
1360 Other broken versions may recompile parts of the compiler when
1361 installing the compiler.)
1362
1363 Some commands executed when making the compiler may fail (return a
1364 nonzero status) and be ignored by @command{make}.  These failures, which
1365 are often due to files that were not found, are expected, and can safely
1366 be ignored.
1367
1368 It is normal to have compiler warnings when compiling certain files.
1369 Unless you are a GCC developer, you can generally ignore these warnings
1370 unless they cause compilation to fail.  Developers should attempt to fix
1371 any warnings encountered, however they can temporarily continue past
1372 warnings-as-errors by specifying the configure flag
1373 @option{--disable-werror}.
1374
1375 On certain old systems, defining certain environment variables such as
1376 @env{CC} can interfere with the functioning of @command{make}.
1377
1378 If you encounter seemingly strange errors when trying to build the
1379 compiler in a directory other than the source directory, it could be
1380 because you have previously configured the compiler in the source
1381 directory.  Make sure you have done all the necessary preparations.
1382
1383 If you build GCC on a BSD system using a directory stored in an old System
1384 V file system, problems may occur in running @command{fixincludes} if the
1385 System V file system doesn't support symbolic links.  These problems
1386 result in a failure to fix the declaration of @code{size_t} in
1387 @file{sys/types.h}.  If you find that @code{size_t} is a signed type and
1388 that type mismatches occur, this could be the cause.
1389
1390 The solution is not to use such a directory for building GCC@.
1391
1392 When building from CVS or snapshots, or if you modify parser sources,
1393 you need the Bison parser generator installed.  Any version 1.25 or
1394 later should work; older versions may also work.  If you do not modify
1395 parser sources, releases contain the Bison-generated files and you do
1396 not need Bison installed to build them.
1397
1398 When building from CVS or snapshots, or if you modify Texinfo
1399 documentation, you need version 4.2 or later of Texinfo installed if you
1400 want Info documentation to be regenerated.  Releases contain Info
1401 documentation pre-built for the unmodified documentation in the release.
1402
1403 @section Building a native compiler
1404
1405 For a native build issue the command @samp{make bootstrap}.  This
1406 will build the entire GCC system, which includes the following steps:
1407
1408 @itemize @bullet
1409 @item
1410 Build host tools necessary to build the compiler such as texinfo, bison,
1411 gperf.
1412
1413 @item
1414 Build target tools for use by the compiler such as binutils (bfd,
1415 binutils, gas, gprof, ld, and opcodes)
1416 if they have been individually linked
1417 or moved into the top level GCC source tree before configuring.
1418
1419 @item
1420 Perform a 3-stage bootstrap of the compiler.
1421
1422 @item
1423 Perform a comparison test of the stage2 and stage3 compilers.
1424
1425 @item
1426 Build runtime libraries using the stage3 compiler from the previous step.
1427
1428 @end itemize
1429
1430 If you are short on disk space you might consider @samp{make
1431 bootstrap-lean} instead.  This is identical to @samp{make
1432 bootstrap} except that object files from the stage1 and
1433 stage2 of the 3-stage bootstrap of the compiler are deleted as
1434 soon as they are no longer needed.
1435
1436 If you want to save additional space during the bootstrap and in
1437 the final installation as well, you can build the compiler binaries
1438 without debugging information as in the following example.  This will save
1439 roughly 40% of disk space both for the bootstrap and the final installation.
1440 (Libraries will still contain debugging information.)
1441
1442 @smallexample
1443      make CFLAGS='-O' LIBCFLAGS='-g -O2' \
1444        LIBCXXFLAGS='-g -O2 -fno-implicit-templates' bootstrap
1445 @end smallexample
1446
1447 If you wish to use non-default GCC flags when compiling the stage2 and
1448 stage3 compilers, set @code{BOOT_CFLAGS} on the command line when doing
1449 @samp{make bootstrap}.  Non-default optimization flags are less well
1450 tested here than the default of @samp{-g -O2}, but should still work.
1451 In a few cases, you may find that you need to specify special flags such
1452 as @option{-msoft-float} here to complete the bootstrap; or, if the
1453 native compiler miscompiles the stage1 compiler, you may need to work
1454 around this, by choosing @code{BOOT_CFLAGS} to avoid the parts of the
1455 stage1 compiler that were miscompiled, or by using @samp{make
1456 bootstrap4} to increase the number of stages of bootstrap.
1457
1458 If you used the flag @option{--enable-languages=@dots{}} to restrict
1459 the compilers to be built, only those you've actually enabled will be
1460 built.  This will of course only build those runtime libraries, for
1461 which the particular compiler has been built.  Please note,
1462 that re-defining @env{LANGUAGES} when calling @samp{make bootstrap}
1463 @strong{does not} work anymore!
1464
1465 If the comparison of stage2 and stage3 fails, this normally indicates
1466 that the stage2 compiler has compiled GCC incorrectly, and is therefore
1467 a potentially serious bug which you should investigate and report.  (On
1468 a few systems, meaningful comparison of object files is impossible; they
1469 always appear ``different''.  If you encounter this problem, you will
1470 need to disable comparison in the @file{Makefile}.)
1471
1472 @section Building a cross compiler
1473
1474 We recommend reading the
1475 @uref{http://www.objsw.com/CrossGCC/,,crossgcc FAQ}
1476 for information about building cross compilers.
1477
1478 When building a cross compiler, it is not generally possible to do a
1479 3-stage bootstrap of the compiler.  This makes for an interesting problem
1480 as parts of GCC can only be built with GCC@.
1481
1482 To build a cross compiler, we first recommend building and installing a
1483 native compiler.  You can then use the native GCC compiler to build the
1484 cross compiler.  The installed native compiler needs to be GCC version
1485 2.95 or later.
1486
1487 Assuming you have already installed a native copy of GCC and configured
1488 your cross compiler, issue the command @command{make}, which performs the
1489 following steps:
1490
1491 @itemize @bullet
1492 @item
1493 Build host tools necessary to build the compiler such as texinfo, bison,
1494 gperf.
1495
1496 @item
1497 Build target tools for use by the compiler such as binutils (bfd,
1498 binutils, gas, gprof, ld, and opcodes)
1499 if they have been individually linked or moved into the top level GCC source
1500 tree before configuring.
1501
1502 @item
1503 Build the compiler (single stage only).
1504
1505 @item
1506 Build runtime libraries using the compiler from the previous step.
1507 @end itemize
1508
1509 Note that if an error occurs in any step the make process will exit.
1510
1511 If you are not building GNU binutils in the same source tree as GCC,
1512 you will need a cross-assembler and cross-linker installed before
1513 configuring GCC@.  Put them in the directory
1514 @file{@var{prefix}/@var{target}/bin}.  Here is a table of the tools
1515 you should put in this directory:
1516
1517 @table @file
1518 @item as
1519 This should be the cross-assembler.
1520
1521 @item ld
1522 This should be the cross-linker.
1523
1524 @item ar
1525 This should be the cross-archiver: a program which can manipulate
1526 archive files (linker libraries) in the target machine's format.
1527
1528 @item ranlib
1529 This should be a program to construct a symbol table in an archive file.
1530 @end table
1531
1532 The installation of GCC will find these programs in that directory,
1533 and copy or link them to the proper place to for the cross-compiler to
1534 find them when run later.
1535
1536 The easiest way to provide these files is to build the Binutils package.
1537 Configure it with the same @option{--host} and @option{--target}
1538 options that you use for configuring GCC, then build and install
1539 them.  They install their executables automatically into the proper
1540 directory.  Alas, they do not support all the targets that GCC
1541 supports.
1542
1543 If you are not building a C library in the same source tree as GCC,
1544 you should also provide the target libraries and headers before
1545 configuring GCC, specifying the directories with
1546 @option{--with-sysroot} or @option{--with-headers} and
1547 @option{--with-libs}.  Many targets also require ``start files'' such
1548 as @file{crt0.o} and
1549 @file{crtn.o} which are linked into each executable.  There may be several
1550 alternatives for @file{crt0.o}, for use with profiling or other
1551 compilation options.  Check your target's definition of
1552 @code{STARTFILE_SPEC} to find out what start files it uses.
1553
1554 @section Building in parallel
1555
1556 You can use @samp{make bootstrap MAKE="make -j 2" -j 2}, or just
1557 @samp{make -j 2 bootstrap} for GNU Make 3.79 and above, instead of
1558 @samp{make bootstrap} to build GCC in parallel.
1559 You can also specify a bigger number, and in most cases using a value
1560 greater than the number of processors in your machine will result in
1561 fewer and shorter I/O latency hits, thus improving overall throughput;
1562 this is especially true for slow drives and network filesystems.
1563
1564 @section Building the Ada compiler
1565
1566 In order to build GNAT, the Ada compiler, you need a working GNAT
1567 compiler (GNAT version 3.14 or later, or GCC version 3.1 or later),
1568 including GNAT tools such as @command{gnatmake} and @command{gnatlink},
1569 since the Ada front end is written in Ada (with some
1570 GNAT-specific extensions), and GNU make.
1571
1572 @command{configure} does not test whether the GNAT installation works
1573 and has a sufficiently recent version; if too old a GNAT version is
1574 installed, the build will fail unless @option{--enable-languages} is
1575 used to disable building the Ada front end.
1576
1577 @section Building with profile feedback
1578
1579 It is possible to use profile feedback to optimize the compiler itself.  This
1580 should result in a faster compiler binary.  Experiments done on x86 using gcc
1581 3.3 showed approximately 7 percent speedup on compiling C programs.  To
1582 bootstrap compiler with profile feedback, use @code{make profiledbootstrap}.
1583
1584 When @samp{make profiledbootstrap} is run, it will first build a @code{stage1}
1585 compiler.  This compiler is used to build a @code{stageprofile} compiler
1586 instrumented to collect execution counts of instruction and branch
1587 probabilities.  Then runtime libraries are compiled with profile collected.
1588 Finally a @code{stagefeedback} compiler is built using the information collected.
1589
1590 Unlike @samp{make bootstrap} several additional restrictions apply.  The
1591 compiler used to build @code{stage1} needs to support a 64-bit integral type.
1592 It is recommended to only use GCC for this.  Also parallel make is currently
1593 not supported since collisions in profile collecting may occur.
1594
1595 @html
1596 <hr />
1597 <p>
1598 @end html
1599 @ifhtml
1600 @uref{./index.html,,Return to the GCC Installation page}
1601 @end ifhtml
1602 @end ifset
1603
1604 @c ***Testing*****************************************************************
1605 @ifnothtml
1606 @comment node-name,     next,          previous, up
1607 @node    Testing, Final install, Building, Installing GCC
1608 @end ifnothtml
1609 @ifset testhtml
1610 @ifnothtml
1611 @chapter Installing GCC: Testing
1612 @end ifnothtml
1613 @cindex Testing
1614 @cindex Installing GCC: Testing
1615 @cindex Testsuite
1616
1617 Before you install GCC, we encourage you to run the testsuites and to
1618 compare your results with results from a similar configuration that have
1619 been submitted to the
1620 @uref{http://gcc.gnu.org/ml/gcc-testresults/,,gcc-testresults mailing list}.
1621 Some of these archived results are linked from the build status lists
1622 at @uref{http://gcc.gnu.org/buildstat.html}, although not everyone who
1623 reports a successful build runs the testsuites and submits the results.
1624 This step is optional and may require you to download additional software,
1625 but it can give you confidence in your new GCC installation or point out
1626 problems before you install and start using your new GCC.
1627
1628 First, you must have @uref{download.html,,downloaded the testsuites}.
1629 These are part of the full distribution, but if you downloaded the
1630 ``core'' compiler plus any front ends, you must download the testsuites
1631 separately.
1632
1633 Second, you must have the testing tools installed.  This includes
1634 @uref{http://www.gnu.org/software/dejagnu/,,DejaGnu} 1.4.1 or 1.4.3
1635 and later, Tcl, and Expect; the DejaGnu site has links to these.
1636
1637 If the directories where @command{runtest} and @command{expect} were
1638 installed are not in the @env{PATH}, you may need to set the following
1639 environment variables appropriately, as in the following example (which
1640 assumes that DejaGnu has been installed under @file{/usr/local}):
1641
1642 @smallexample
1643      TCL_LIBRARY = /usr/local/share/tcl8.0
1644      DEJAGNULIBS = /usr/local/share/dejagnu
1645 @end smallexample
1646
1647 (On systems such as Cygwin, these paths are required to be actual
1648 paths, not mounts or links; presumably this is due to some lack of
1649 portability in the DejaGnu code.)
1650
1651
1652 Finally, you can run the testsuite (which may take a long time):
1653 @smallexample
1654      cd @var{objdir}; make -k check
1655 @end smallexample
1656
1657 This will test various components of GCC, such as compiler
1658 front ends and runtime libraries.  While running the testsuite, DejaGnu
1659 might emit some harmless messages resembling
1660 @samp{WARNING: Couldn't find the global config file.} or
1661 @samp{WARNING: Couldn't find tool init file} that can be ignored.
1662
1663 @section How can I run the test suite on selected tests?
1664
1665 In order to run sets of tests selectively, there are targets
1666 @samp{make check-gcc} and @samp{make check-g++}
1667 in the @file{gcc} subdirectory of the object directory.  You can also
1668 just run @samp{make check} in a subdirectory of the object directory.
1669
1670
1671 A more selective way to just run all @command{gcc} execute tests in the
1672 testsuite is to use
1673
1674 @smallexample
1675     make check-gcc RUNTESTFLAGS="execute.exp @var{other-options}"
1676 @end smallexample
1677
1678 Likewise, in order to run only the @command{g++} ``old-deja'' tests in
1679 the testsuite with filenames matching @samp{9805*}, you would use
1680
1681 @smallexample
1682     make check-g++ RUNTESTFLAGS="old-deja.exp=9805* @var{other-options}"
1683 @end smallexample
1684
1685 The @file{*.exp} files are located in the testsuite directories of the GCC
1686 source, the most important ones being @file{compile.exp},
1687 @file{execute.exp}, @file{dg.exp} and @file{old-deja.exp}.
1688 To get a list of the possible @file{*.exp} files, pipe the
1689 output of @samp{make check} into a file and look at the
1690 @samp{Running @dots{}  .exp} lines.
1691
1692 @section Passing options and running multiple testsuites
1693
1694 You can pass multiple options to the testsuite using the
1695 @samp{--target_board} option of DejaGNU, either passed as part of
1696 @samp{RUNTESTFLAGS}, or directly to @command{runtest} if you prefer to
1697 work outside the makefiles.  For example,
1698
1699 @smallexample
1700     make check-g++ RUNTESTFLAGS="--target_board=unix/-O3/-fno-strength-reduce"
1701 @end smallexample
1702
1703 will run the standard @command{g++} testsuites (``unix'' is the target name
1704 for a standard native testsuite situation), passing
1705 @samp{-O3 -fno-strength-reduce} to the compiler on every test, i.e.,
1706 slashes separate options.
1707
1708 You can run the testsuites multiple times using combinations of options
1709 with a syntax similar to the brace expansion of popular shells:
1710
1711 @smallexample
1712     @dots{}"--target_board=arm-sim@{-mhard-float,-msoft-float@}@{-O1,-O2,-O3,@}"
1713 @end smallexample
1714
1715 (Note the empty option caused by the trailing comma in the final group.)
1716 The following will run each testsuite eight times using the @samp{arm-sim}
1717 target, as if you had specified all possible combinations yourself:
1718
1719 @smallexample
1720     --target_board=arm-sim/-mhard-float/-O1
1721     --target_board=arm-sim/-mhard-float/-O2
1722     --target_board=arm-sim/-mhard-float/-O3
1723     --target_board=arm-sim/-mhard-float
1724     --target_board=arm-sim/-msoft-float/-O1
1725     --target_board=arm-sim/-msoft-float/-O2
1726     --target_board=arm-sim/-msoft-float/-O3
1727     --target_board=arm-sim/-msoft-float
1728 @end smallexample
1729
1730 They can be combined as many times as you wish, in arbitrary ways.  This
1731 list:
1732
1733 @smallexample
1734     @dots{}"--target_board=unix/-Wextra@{-O3,-fno-strength-reduce@}@{-fomit-frame-pointer,@}"
1735 @end smallexample
1736
1737 will generate four combinations, all involving @samp{-Wextra}.
1738
1739 The disadvantage to this method is that the testsuites are run in serial,
1740 which is a waste on multiprocessor systems.  For users with GNU Make and
1741 a shell which performs brace expansion, you can run the testsuites in
1742 parallel by having the shell perform the combinations and @command{make}
1743 do the parallel runs.  Instead of using @samp{--target_board}, use a
1744 special makefile target:
1745
1746 @smallexample
1747     make -j@var{N} check-@var{testsuite}//@var{test-target}/@var{option1}/@var{option2}/@dots{}
1748 @end smallexample
1749
1750 For example,
1751
1752 @smallexample
1753     make -j3 check-gcc//sh-hms-sim/@{-m1,-m2,-m3,-m3e,-m4@}/@{,-nofpu@}
1754 @end smallexample
1755
1756 will run three concurrent ``make-gcc'' testsuites, eventually testing all
1757 ten combinations as described above.  Note that this is currently only
1758 supported in the @file{gcc} subdirectory.  (To see how this works, try
1759 typing @command{echo} before the example given here.)
1760
1761
1762 @section Additional testing for Java Class Libraries
1763
1764 The Java runtime tests can be executed via @samp{make check}
1765 in the @file{@var{target}/libjava/testsuite} directory in
1766 the build tree.
1767
1768 The @uref{http://sources.redhat.com/mauve/,,Mauve Project} provides
1769 a suite of tests for the Java Class Libraries.  This suite can be run
1770 as part of libgcj testing by placing the Mauve tree within the libjava
1771 testsuite at @file{libjava/testsuite/libjava.mauve/mauve}, or by
1772 specifying the location of that tree when invoking @samp{make}, as in
1773 @samp{make MAUVEDIR=~/mauve check}.
1774
1775 @uref{http://www-124.ibm.com/developerworks/oss/cvs/jikes/~checkout~/jacks/jacks.html,,Jacks}
1776 is a free test suite that tests Java compiler front ends.  This suite
1777 can be run as part of libgcj testing by placing the Jacks tree within
1778 the libjava testsuite at @file{libjava/testsuite/libjava.jacks/jacks}.
1779
1780 @section How to interpret test results
1781
1782 The result of running the testsuite are various @file{*.sum} and @file{*.log}
1783 files in the testsuite subdirectories.  The @file{*.log} files contain a
1784 detailed log of the compiler invocations and the corresponding
1785 results, the @file{*.sum} files summarize the results.  These summaries
1786 contain status codes for all tests:
1787
1788 @itemize @bullet
1789 @item
1790 PASS: the test passed as expected
1791 @item
1792 XPASS: the test unexpectedly passed
1793 @item
1794 FAIL: the test unexpectedly failed
1795 @item
1796 XFAIL: the test failed as expected
1797 @item
1798 UNSUPPORTED: the test is not supported on this platform
1799 @item
1800 ERROR: the testsuite detected an error
1801 @item
1802 WARNING: the testsuite detected a possible problem
1803 @end itemize
1804
1805 It is normal for some tests to report unexpected failures.  At the
1806 current time our testing harness does not allow fine grained control
1807 over whether or not a test is expected to fail.  We expect to fix this
1808 problem in future releases.
1809
1810
1811 @section Submitting test results
1812
1813 If you want to report the results to the GCC project, use the
1814 @file{contrib/test_summary} shell script.  Start it in the @var{objdir} with
1815
1816 @smallexample
1817     @var{srcdir}/contrib/test_summary -p your_commentary.txt \
1818         -m gcc-testresults@@gcc.gnu.org |sh
1819 @end smallexample
1820
1821 This script uses the @command{Mail} program to send the results, so
1822 make sure it is in your @env{PATH}.  The file @file{your_commentary.txt} is
1823 prepended to the testsuite summary and should contain any special
1824 remarks you have on your results or your build environment.  Please
1825 do not edit the testsuite result block or the subject line, as these
1826 messages may be automatically processed.
1827
1828 @html
1829 <hr />
1830 <p>
1831 @end html
1832 @ifhtml
1833 @uref{./index.html,,Return to the GCC Installation page}
1834 @end ifhtml
1835 @end ifset
1836
1837 @c ***Final install***********************************************************
1838 @ifnothtml
1839 @comment node-name,     next,          previous, up
1840 @node    Final install, , Testing, Installing GCC
1841 @end ifnothtml
1842 @ifset finalinstallhtml
1843 @ifnothtml
1844 @chapter Installing GCC: Final installation
1845 @end ifnothtml
1846
1847 Now that GCC has been built (and optionally tested), you can install it with
1848 @smallexample
1849 cd @var{objdir}; make install
1850 @end smallexample
1851
1852 We strongly recommend to install into a target directory where there is
1853 no previous version of GCC present.
1854
1855 That step completes the installation of GCC; user level binaries can
1856 be found in @file{@var{prefix}/bin} where @var{prefix} is the value
1857 you specified with the @option{--prefix} to configure (or
1858 @file{/usr/local} by default).  (If you specified @option{--bindir},
1859 that directory will be used instead; otherwise, if you specified
1860 @option{--exec-prefix}, @file{@var{exec-prefix}/bin} will be used.)
1861 Headers for the C++ and Java libraries are installed in
1862 @file{@var{prefix}/include}; libraries in @file{@var{libdir}}
1863 (normally @file{@var{prefix}/lib}); internal parts of the compiler in
1864 @file{@var{libdir}/gcc} and @file{@var{libexecdir}/gcc}; documentation
1865 in info format in @file{@var{infodir}} (normally
1866 @file{@var{prefix}/info}).
1867
1868 When installing cross-compilers, GCC's executables
1869 are not only installed into @file{@var{bindir}}, that
1870 is, @file{@var{exec-prefix}/bin}, but additionally into
1871 @file{@var{exec-prefix}/@var{target-alias}/bin}, if that directory
1872 exists.  Typically, such @dfn{tooldirs} hold target-specific
1873 binutils, including assembler and linker.
1874
1875 Installation into a temporary staging area or into a @command{chroot}
1876 jail can be achieved with the command
1877
1878 @smallexample
1879 make DESTDIR=@var{path-to-rootdir} install
1880 @end smallexample
1881
1882 @noindent where @var{path-to-rootdir} is the absolute path of
1883 a directory relative to which all installation paths will be
1884 interpreted.  Note that the directory specified by @code{DESTDIR}
1885 need not exist yet; it will be created if necessary.
1886
1887 There is a subtle point with tooldirs and @code{DESTDIR}:
1888 If you relocate a cross-compiler installation with
1889 e.g.@: @samp{DESTDIR=@var{rootdir}}, then the directory
1890 @file{@var{rootdir}/@var{exec-prefix}/@var{target-alias}/bin} will
1891 be filled with duplicated GCC executables only if it already exists,
1892 it will not be created otherwise.  This is regarded as a feature,
1893 not as a bug, because it gives slightly more control to the packagers
1894 using the @code{DESTDIR} feature.
1895
1896 If you built a released version of GCC using @samp{make bootstrap} then please
1897 quickly review the build status page for your release, available from
1898 @uref{http://gcc.gnu.org/buildstat.html}.
1899 If your system is not listed for the version of GCC that you built,
1900 send a note to
1901 @email{gcc@@gcc.gnu.org} indicating
1902 that you successfully built and installed GCC.
1903 Include the following information:
1904
1905 @itemize @bullet
1906 @item
1907 Output from running @file{@var{srcdir}/config.guess}.  Do not send us
1908 that file itself, just the one-line output from running it.
1909
1910 @item
1911 The output of @samp{gcc -v} for your newly installed gcc.
1912 This tells us which version of GCC you built and the options you passed to
1913 configure.
1914
1915 @item
1916 Whether you enabled all languages or a subset of them.  If you used a
1917 full distribution then this information is part of the configure
1918 options in the output of @samp{gcc -v}, but if you downloaded the
1919 ``core'' compiler plus additional front ends then it isn't apparent
1920 which ones you built unless you tell us about it.
1921
1922 @item
1923 If the build was for GNU/Linux, also include:
1924 @itemize @bullet
1925 @item
1926 The distribution name and version (e.g., Red Hat 7.1 or Debian 2.2.3);
1927 this information should be available from @file{/etc/issue}.
1928
1929 @item
1930 The version of the Linux kernel, available from @samp{uname --version}
1931 or @samp{uname -a}.
1932
1933 @item
1934 The version of glibc you used; for RPM-based systems like Red Hat,
1935 Mandrake, and SuSE type @samp{rpm -q glibc} to get the glibc version,
1936 and on systems like Debian and Progeny use @samp{dpkg -l libc6}.
1937 @end itemize
1938 For other systems, you can include similar information if you think it is
1939 relevant.
1940
1941 @item
1942 Any other information that you think would be useful to people building
1943 GCC on the same configuration.  The new entry in the build status list
1944 will include a link to the archived copy of your message.
1945 @end itemize
1946
1947 We'd also like to know if the
1948 @ifnothtml
1949 @ref{Specific, host/target specific installation notes}
1950 @end ifnothtml
1951 @ifhtml
1952 @uref{specific.html,,host/target specific installation notes}
1953 @end ifhtml
1954 didn't include your host/target information or if that information is
1955 incomplete or out of date.  Send a note to
1956 @email{gcc@@gcc.gnu.org} telling us how the information should be changed.
1957
1958 If you find a bug, please report it following our
1959 @uref{../bugs.html,,bug reporting guidelines}.
1960
1961 If you want to print the GCC manuals, do @samp{cd @var{objdir}; make
1962 dvi}.  You will need to have @command{texi2dvi} (version at least 4.2)
1963 and @TeX{} installed.  This creates a number of @file{.dvi} files in
1964 subdirectories of @file{@var{objdir}}; these may be converted for
1965 printing with programs such as @command{dvips}.  You can also
1966 @uref{http://www.gnu.org/order/order.html,,buy printed manuals from the
1967 Free Software Foundation}, though such manuals may not be for the most
1968 recent version of GCC@.
1969
1970 @html
1971 <hr />
1972 <p>
1973 @end html
1974 @ifhtml
1975 @uref{./index.html,,Return to the GCC Installation page}
1976 @end ifhtml
1977 @end ifset
1978
1979 @c ***Binaries****************************************************************
1980 @ifnothtml
1981 @comment node-name,     next,          previous, up
1982 @node    Binaries, Specific, Installing GCC, Top
1983 @end ifnothtml
1984 @ifset binarieshtml
1985 @ifnothtml
1986 @chapter Installing GCC: Binaries
1987 @end ifnothtml
1988 @cindex Binaries
1989 @cindex Installing GCC: Binaries
1990
1991 We are often asked about pre-compiled versions of GCC@.  While we cannot
1992 provide these for all platforms, below you'll find links to binaries for
1993 various platforms where creating them by yourself is not easy due to various
1994 reasons.
1995
1996 Please note that we did not create these binaries, nor do we
1997 support them.  If you have any problems installing them, please
1998 contact their makers.
1999
2000 @itemize
2001 @item
2002 AIX:
2003 @itemize
2004 @item
2005 @uref{http://www.bullfreeware.com,,Bull's Freeware and Shareware Archive for AIX};
2006
2007 @item
2008 @uref{http://aixpdslib.seas.ucla.edu,,UCLA Software Library for AIX}.
2009 @end itemize
2010
2011 @item
2012 DOS---@uref{http://www.delorie.com/djgpp/,,DJGPP}.
2013
2014 @item
2015 Renesas H8/300[HS]---@uref{http://h8300-hms.sourceforge.net/,,GNU
2016 Development Tools for the Renesas H8/300[HS] Series}.
2017
2018 @item
2019 HP-UX:
2020 @itemize
2021 @item
2022 @uref{http://hpux.cae.wisc.edu/,,HP-UX Porting Center};
2023
2024 @item
2025 @uref{ftp://sunsite.informatik.rwth-aachen.de/pub/packages/gcc_hpux/,,Binaries for HP-UX 11.00 at Aachen University of Technology}.
2026 @end itemize
2027
2028 @item
2029 Motorola 68HC11/68HC12---@uref{http://www.gnu-m68hc11.org,,GNU
2030 Development Tools for the Motorola 68HC11/68HC12}.
2031
2032 @item
2033 @uref{http://www.sco.com/skunkware/devtools/index.html#gcc,,SCO
2034 OpenServer/Unixware}.
2035
2036 @item
2037 Sinix/Reliant Unix---@uref{ftp://ftp.fujitsu-siemens.com/pub/pd/gnu/gcc/,,Siemens}.
2038
2039 @item
2040 Solaris 2 (SPARC, Intel)---@uref{http://www.sunfreeware.com/,,Sunfreeware}.
2041
2042 @item
2043 SGI---@uref{http://freeware.sgi.com/,,SGI Freeware}.
2044
2045 @item
2046 Microsoft Windows:
2047 @itemize
2048 @item
2049 The @uref{http://sources.redhat.com/cygwin/,,Cygwin} project;
2050 @item
2051 The @uref{http://www.mingw.org/,,MinGW} project.
2052 @end itemize
2053
2054 @item
2055 @uref{ftp://ftp.thewrittenword.com/packages/by-name/,,The
2056 Written Word} offers binaries for
2057 AIX 4.3.2.
2058 IRIX 6.5,
2059 Digital UNIX 4.0D and 5.1,
2060 GNU/Linux (i386),
2061 HP-UX 10.20, 11.00, and 11.11, and
2062 Solaris/SPARC 2.5.1, 2.6, 2.7, 8, and 9,
2063 @end itemize
2064
2065 In addition to those specific offerings, you can get a binary
2066 distribution CD-ROM from the
2067 @uref{http://www.fsf.org/order/order.html,,Free Software Foundation}.
2068 It contains binaries for a number of platforms, and
2069 includes not only GCC, but other stuff as well.  The current CD does
2070 not contain the latest version of GCC, but it should allow
2071 bootstrapping the compiler.  An updated version of that disk is in the
2072 works.
2073
2074 @html
2075 <hr />
2076 <p>
2077 @end html
2078 @ifhtml
2079 @uref{./index.html,,Return to the GCC Installation page}
2080 @end ifhtml
2081 @end ifset
2082
2083 @c ***Specific****************************************************************
2084 @ifnothtml
2085 @comment node-name,     next,          previous, up
2086 @node    Specific, Old, Binaries, Top
2087 @end ifnothtml
2088 @ifset specifichtml
2089 @ifnothtml
2090 @chapter Host/target specific installation notes for GCC
2091 @end ifnothtml
2092 @cindex Specific
2093 @cindex Specific installation notes
2094 @cindex Target specific installation
2095 @cindex Host specific installation
2096 @cindex Target specific installation notes
2097
2098 Please read this document carefully @emph{before} installing the
2099 GNU Compiler Collection on your machine.
2100
2101 @ifhtml
2102 @itemize
2103 @item
2104 @uref{#alpha*-*-*,,alpha*-*-*}
2105 @item
2106 @uref{#alpha*-dec-osf*,,alpha*-dec-osf*}
2107 @item
2108 @uref{#alphaev5-cray-unicosmk*,,alphaev5-cray-unicosmk*}
2109 @item
2110 @uref{#arc-*-elf,,arc-*-elf}
2111 @item
2112 @uref{#arm-*-elf,,arm-*-elf}
2113 @uref{#arm-*-coff,,arm-*-coff}
2114 @uref{#arm-*-aout,,arm-*-aout}
2115 @item
2116 @uref{#xscale-*-*,,xscale-*-*}
2117 @item
2118 @uref{#avr,,avr}
2119 @item
2120 @uref{#c4x,,c4x}
2121 @item
2122 @uref{#dos,,DOS}
2123 @item
2124 @uref{#*-*-freebsd*,,*-*-freebsd*}
2125 @item
2126 @uref{#h8300-hms,,h8300-hms}
2127 @item
2128 @uref{#hppa*-hp-hpux*,,hppa*-hp-hpux*}
2129 @item
2130 @uref{#hppa*-hp-hpux10,,hppa*-hp-hpux10}
2131 @item
2132 @uref{#hppa*-hp-hpux11,,hppa*-hp-hpux11}
2133 @item
2134 @uref{#*-*-linux-gnu,,*-*-linux-gnu}
2135 @item
2136 @uref{#ix86-*-linux*aout,,i?86-*-linux*aout}
2137 @item
2138 @uref{#ix86-*-linux*,,i?86-*-linux*}
2139 @item
2140 @uref{#ix86-*-sco3.2v5*,,i?86-*-sco3.2v5*}
2141 @item
2142 @uref{#ix86-*-udk,,i?86-*-udk}
2143 @item
2144 @uref{#ix86-*-esix,,i?86-*-esix}
2145 @item
2146 @uref{#ia64-*-linux,,ia64-*-linux}
2147 @item
2148 @uref{#ia64-*-hpux*,,ia64-*-hpux*}
2149 @item
2150 @uref{#*-ibm-aix*,,*-ibm-aix*}
2151 @item
2152 @uref{#ip2k-*-elf,,ip2k-*-elf}
2153 @item
2154 @uref{#iq2000-*-elf,,iq2000-*-elf}
2155 @item
2156 @uref{#m32r-*-elf,,m32r-*-elf}
2157 @item
2158 @uref{#m6811-elf,,m6811-elf}
2159 @item
2160 @uref{#m6812-elf,,m6812-elf}
2161 @item
2162 @uref{#m68k-hp-hpux,,m68k-hp-hpux}
2163 @item
2164 @uref{#mips-*-*,,mips-*-*}
2165 @item
2166 @uref{#mips-sgi-irix5,,mips-sgi-irix5}
2167 @item
2168 @uref{#mips-sgi-irix6,,mips-sgi-irix6}
2169 @item
2170 @uref{#powerpc*-*-*,,powerpc*-*-*, powerpc-*-sysv4}
2171 @item
2172 @uref{#powerpc-*-darwin*,,powerpc-*-darwin*}
2173 @item
2174 @uref{#powerpc-*-elf,,powerpc-*-elf, powerpc-*-sysv4}
2175 @item
2176 @uref{#powerpc-*-linux-gnu*,,powerpc-*-linux-gnu*}
2177 @item
2178 @uref{#powerpc-*-netbsd*,,powerpc-*-netbsd*}
2179 @item
2180 @uref{#powerpc-*-eabiaix,,powerpc-*-eabiaix}
2181 @item
2182 @uref{#powerpc-*-eabisim,,powerpc-*-eabisim}
2183 @item
2184 @uref{#powerpc-*-eabi,,powerpc-*-eabi}
2185 @item
2186 @uref{#powerpcle-*-elf,,powerpcle-*-elf, powerpcle-*-sysv4}
2187 @item
2188 @uref{#powerpcle-*-eabisim,,powerpcle-*-eabisim}
2189 @item
2190 @uref{#powerpcle-*-eabi,,powerpcle-*-eabi}
2191 @item
2192 @uref{#s390-*-linux*,,s390-*-linux*}
2193 @item
2194 @uref{#s390x-*-linux*,,s390x-*-linux*}
2195 @item
2196 @uref{#s390x-ibm-tpf*,,s390x-ibm-tpf*}
2197 @item
2198 @uref{#*-*-solaris2*,,*-*-solaris2*}
2199 @item
2200 @uref{#sparc-sun-solaris2*,,sparc-sun-solaris2*}
2201 @item
2202 @uref{#sparc-sun-solaris2.7,,sparc-sun-solaris2.7}
2203 @item
2204 @uref{#sparc-*-linux*,,sparc-*-linux*}
2205 @item
2206 @uref{#sparc64-*-solaris2*,,sparc64-*-solaris2*}
2207 @item
2208 @uref{#sparcv9-*-solaris2*,,sparcv9-*-solaris2*}
2209 @item
2210 @uref{#*-*-sysv*,,*-*-sysv*}
2211 @item
2212 @uref{#vax-dec-ultrix,,vax-dec-ultrix}
2213 @item
2214 @uref{#*-*-vxworks*,,*-*-vxworks*}
2215 @item
2216 @uref{#x86_64-*-*,,x86_64-*-*, amd64-*-*}
2217 @item
2218 @uref{#xtensa-*-elf,,xtensa-*-elf}
2219 @item
2220 @uref{#xtensa-*-linux*,,xtensa-*-linux*}
2221 @item
2222 @uref{#windows,,Microsoft Windows}
2223 @item
2224 @uref{#os2,,OS/2}
2225 @item
2226 @uref{#older,,Older systems}
2227 @end itemize
2228
2229 @itemize
2230 @item
2231 @uref{#elf_targets,,all ELF targets} (SVR4, Solaris 2, etc.)
2232 @end itemize
2233 @end ifhtml
2234
2235
2236 @html
2237 <!-- -------- host/target specific issues start here ---------------- -->
2238 <hr />
2239 @end html
2240 @heading @anchor{alpha*-*-*}alpha*-*-*
2241
2242 This section contains general configuration information for all
2243 alpha-based platforms using ELF (in particular, ignore this section for
2244 DEC OSF/1, Digital UNIX and Tru64 UNIX)@.  In addition to reading this
2245 section, please read all other sections that match your target.
2246
2247 We require binutils 2.11.2 or newer.
2248 Previous binutils releases had a number of problems with DWARF 2
2249 debugging information, not the least of which is incorrect linking of
2250 shared libraries.
2251
2252 @html
2253 <hr />
2254 @end html
2255 @heading @anchor{alpha*-dec-osf*}alpha*-dec-osf*
2256 Systems using processors that implement the DEC Alpha architecture and
2257 are running the DEC/Compaq Unix (DEC OSF/1, Digital UNIX, or Compaq
2258 Tru64 UNIX) operating system, for example the DEC Alpha AXP systems.
2259
2260 As of GCC 3.2, versions before @code{alpha*-dec-osf4} are no longer
2261 supported.  (These are the versions which identify themselves as DEC
2262 OSF/1.)
2263
2264 In Digital Unix V4.0, virtual memory exhausted bootstrap failures
2265 may be fixed by configuring with @option{--with-gc=simple},
2266 reconfiguring Kernel Virtual Memory and Swap parameters
2267 per the @command{/usr/sbin/sys_check} Tuning Suggestions,
2268 or applying the patch in
2269 @uref{http://gcc.gnu.org/ml/gcc/2002-08/msg00822.html}.
2270
2271 In Tru64 UNIX V5.1, Compaq introduced a new assembler that does not
2272 currently (2001-06-13) work with @command{mips-tfile}.  As a workaround,
2273 we need to use the old assembler, invoked via the barely documented
2274 @option{-oldas} option.  To bootstrap GCC, you either need to use the
2275 Compaq C Compiler:
2276
2277 @smallexample
2278    % CC=cc @var{srcdir}/configure [@var{options}] [@var{target}]
2279 @end smallexample
2280
2281 or you can use a copy of GCC 2.95.3 or higher built on Tru64 UNIX V4.0:
2282
2283 @smallexample
2284    % CC=gcc -Wa,-oldas @var{srcdir}/configure [@var{options}] [@var{target}]
2285 @end smallexample
2286
2287 As of GNU binutils 2.11.2, neither GNU @command{as} nor GNU @command{ld}
2288 are supported on Tru64 UNIX, so you must not configure GCC with
2289 @option{--with-gnu-as} or @option{--with-gnu-ld}.
2290
2291 GCC writes a @samp{.verstamp} directive to the assembler output file
2292 unless it is built as a cross-compiler.  It gets the version to use from
2293 the system header file @file{/usr/include/stamp.h}.  If you install a
2294 new version of DEC Unix, you should rebuild GCC to pick up the new version
2295 stamp.
2296
2297 Note that since the Alpha is a 64-bit architecture, cross-compilers from
2298 32-bit machines will not generate code as efficient as that generated
2299 when the compiler is running on a 64-bit machine because many
2300 optimizations that depend on being able to represent a word on the
2301 target in an integral value on the host cannot be performed.  Building
2302 cross-compilers on the Alpha for 32-bit machines has only been tested in
2303 a few cases and may not work properly.
2304
2305 @samp{make compare} may fail on old versions of DEC Unix unless you add
2306 @option{-save-temps} to @code{CFLAGS}.  On these systems, the name of the
2307 assembler input file is stored in the object file, and that makes
2308 comparison fail if it differs between the @code{stage1} and
2309 @code{stage2} compilations.  The option @option{-save-temps} forces a
2310 fixed name to be used for the assembler input file, instead of a
2311 randomly chosen name in @file{/tmp}.  Do not add @option{-save-temps}
2312 unless the comparisons fail without that option.  If you add
2313 @option{-save-temps}, you will have to manually delete the @samp{.i} and
2314 @samp{.s} files after each series of compilations.
2315
2316 GCC now supports both the native (ECOFF) debugging format used by DBX
2317 and GDB and an encapsulated STABS format for use only with GDB@.  See the
2318 discussion of the @option{--with-stabs} option of @file{configure} above
2319 for more information on these formats and how to select them.
2320
2321 There is a bug in DEC's assembler that produces incorrect line numbers
2322 for ECOFF format when the @samp{.align} directive is used.  To work
2323 around this problem, GCC will not emit such alignment directives
2324 while writing ECOFF format debugging information even if optimization is
2325 being performed.  Unfortunately, this has the very undesirable
2326 side-effect that code addresses when @option{-O} is specified are
2327 different depending on whether or not @option{-g} is also specified.
2328
2329 To avoid this behavior, specify @option{-gstabs+} and use GDB instead of
2330 DBX@.  DEC is now aware of this problem with the assembler and hopes to
2331 provide a fix shortly.
2332
2333 @html
2334 <hr />
2335 @end html
2336 @heading @anchor{alphaev5-cray-unicosmk*}alphaev5-cray-unicosmk*
2337 Cray T3E systems running Unicos/Mk.
2338
2339 This port is incomplete and has many known bugs.  We hope to improve the
2340 support for this target soon.  Currently, only the C front end is supported,
2341 and it is not possible to build parallel applications.  Cray modules are not
2342 supported; in particular, Craylibs are assumed to be in
2343 @file{/opt/ctl/craylibs/craylibs}.
2344
2345 You absolutely @strong{must} use GNU make on this platform.  Also, you
2346 need to tell GCC where to find the assembler and the linker.  The
2347 simplest way to do so is by providing @option{--with-as} and
2348 @option{--with-ld} to @file{configure}, e.g.@:
2349
2350 @smallexample
2351     configure --with-as=/opt/ctl/bin/cam --with-ld=/opt/ctl/bin/cld \
2352       --enable-languages=c
2353 @end smallexample
2354
2355 The comparison test during @samp{make bootstrap} fails on Unicos/Mk
2356 because the assembler inserts timestamps into object files.  You should
2357 be able to work around this by doing @samp{make all} after getting this
2358 failure.
2359
2360 @html
2361 <hr />
2362 @end html
2363 @heading @anchor{arc-*-elf}arc-*-elf
2364 Argonaut ARC processor.
2365 This configuration is intended for embedded systems.
2366
2367 @html
2368 <hr />
2369 @end html
2370 @heading @anchor{arm-*-elf}arm-*-elf
2371 @heading @anchor{xscale-*-*}xscale-*-*
2372 ARM-family processors.  Subtargets that use the ELF object format
2373 require GNU binutils 2.13 or newer.  Such subtargets include:
2374 @code{arm-*-freebsd}, @code{arm-*-netbsdelf}, @code{arm-*-*linux},
2375 @code{arm-*-rtems} and @code{arm-*-kaos}.
2376
2377 @html
2378 <hr />
2379 @end html
2380 @heading @anchor{arm-*-coff}arm-*-coff
2381 ARM-family processors.  Note that there are two different varieties
2382 of PE format subtarget supported: @code{arm-wince-pe} and
2383 @code{arm-pe} as well as a standard COFF target @code{arm-*-coff}.
2384
2385 @html
2386 <hr />
2387 @end html
2388 @heading @anchor{arm-*-aout}arm-*-aout
2389 ARM-family processors.  These targets support the AOUT file format:
2390 @code{arm-*-aout}, @code{arm-*-netbsd}.
2391
2392 @html
2393 <hr />
2394 @end html
2395 @heading @anchor{avr}avr
2396
2397 ATMEL AVR-family micro controllers.  These are used in embedded
2398 applications.  There are no standard Unix configurations.
2399 @ifnothtml
2400 @xref{AVR Options,, AVR Options, gcc, Using and Porting the GNU Compiler
2401 Collection (GCC)},
2402 @end ifnothtml
2403 @ifhtml
2404 See ``AVR Options'' in the main manual
2405 @end ifhtml
2406 for the list of supported MCU types.
2407
2408 Use @samp{configure --target=avr --enable-languages="c"} to configure GCC@.
2409
2410 Further installation notes and other useful information about AVR tools
2411 can also be obtained from:
2412
2413 @itemize @bullet
2414 @item
2415 @uref{http://www.openavr.org,,http://www.openavr.org}
2416 @item
2417 @uref{http://home.overta.ru/users/denisc/,,http://home.overta.ru/users/denisc/}
2418 @item
2419 @uref{http://www.amelek.gda.pl/avr/,,http://www.amelek.gda.pl/avr/}
2420 @end itemize
2421
2422 We @emph{strongly} recommend using binutils 2.13 or newer.
2423
2424 The following error:
2425 @smallexample
2426   Error: register required
2427 @end smallexample
2428
2429 indicates that you should upgrade to a newer version of the binutils.
2430
2431 @html
2432 <hr />
2433 @end html
2434 @heading @anchor{c4x}c4x
2435
2436 Texas Instruments TMS320C3x and TMS320C4x Floating Point Digital Signal
2437 Processors.  These are used in embedded applications.  There are no
2438 standard Unix configurations.
2439 @ifnothtml
2440 @xref{TMS320C3x/C4x Options,, TMS320C3x/C4x Options, gcc, Using and
2441 Porting the GNU Compiler Collection (GCC)},
2442 @end ifnothtml
2443 @ifhtml
2444 See ``TMS320C3x/C4x Options'' in the main manual
2445 @end ifhtml
2446 for the list of supported MCU types.
2447
2448 GCC can be configured as a cross compiler for both the C3x and C4x
2449 architectures on the same system.  Use @samp{configure --target=c4x
2450 --enable-languages="c,c++"} to configure.
2451
2452
2453 Further installation notes and other useful information about C4x tools
2454 can also be obtained from:
2455
2456 @itemize @bullet
2457 @item
2458 @uref{http://www.elec.canterbury.ac.nz/c4x/,,http://www.elec.canterbury.ac.nz/c4x/}
2459 @end itemize
2460
2461 @html
2462 <hr />
2463 @end html
2464 @heading @anchor{cris}CRIS
2465
2466 CRIS is the CPU architecture in Axis Communications ETRAX system-on-a-chip
2467 series.  These are used in embedded applications.
2468
2469 @ifnothtml
2470 @xref{CRIS Options,, CRIS Options, gcc, Using and Porting the GNU Compiler
2471 Collection (GCC)},
2472 @end ifnothtml
2473 @ifhtml
2474 See ``CRIS Options'' in the main manual
2475 @end ifhtml
2476 for a list of CRIS-specific options.
2477
2478 There are a few different CRIS targets:
2479 @table @code
2480 @item cris-axis-aout
2481 Old target.  Includes a multilib for the @samp{elinux} a.out-based
2482 target.  No multilibs for newer architecture variants.
2483 @item cris-axis-elf
2484 Mainly for monolithic embedded systems.  Includes a multilib for the
2485 @samp{v10} core used in @samp{ETRAX 100 LX}.
2486 @item cris-axis-linux-gnu
2487 A GNU/Linux port for the CRIS architecture, currently targeting
2488 @samp{ETRAX 100 LX} by default.
2489 @end table
2490
2491 For @code{cris-axis-aout} and @code{cris-axis-elf} you need binutils 2.11
2492 or newer.  For @code{cris-axis-linux-gnu} you need binutils 2.12 or newer.
2493
2494 Pre-packaged tools can be obtained from
2495 @uref{ftp://ftp.axis.com/pub/axis/tools/cris/compiler-kit/}.  More
2496 information about this platform is available at
2497 @uref{http://developer.axis.com/}.
2498
2499 @html
2500 <hr />
2501 @end html
2502 @heading @anchor{dos}DOS
2503
2504 Please have a look at our @uref{binaries.html,,binaries page}.
2505
2506 You cannot install GCC by itself on MSDOS; it will not compile under
2507 any MSDOS compiler except itself.  You need to get the complete
2508 compilation package DJGPP, which includes binaries as well as sources,
2509 and includes all the necessary compilation tools and libraries.
2510
2511 @html
2512 <hr />
2513 @end html
2514 @heading @anchor{*-*-freebsd*}*-*-freebsd*
2515
2516 The version of binutils installed in @file{/usr/bin} is known to work unless
2517 otherwise specified in any per-architecture notes.  However, binutils
2518 2.12.1 or greater is known to improve overall testsuite results.
2519
2520 Support for FreeBSD 1 was discontinued in GCC 3.2.
2521
2522 For FreeBSD 2 or any mutant a.out versions of FreeBSD 3: All
2523 configuration support and files as shipped with GCC 2.95 are still in
2524 place.  FreeBSD 2.2.7 has been known to bootstrap completely; however,
2525 it is unknown which version of binutils was used (it is assumed that it
2526 was the system copy in @file{/usr/bin}) and C++ EH failures were noted.
2527
2528 For FreeBSD using the ELF file format: DWARF 2 debugging is now the
2529 default for all CPU architectures.  It had been the default on
2530 FreeBSD/alpha since its inception.  You may use @option{-gstabs} instead
2531 of @option{-g}, if you really want the old debugging format.  There are
2532 no known issues with mixing object files and libraries with different
2533 debugging formats.  Otherwise, this release of GCC should now match more
2534 of the configuration used in the stock FreeBSD configuration of GCC.  In
2535 particular, @option{--enable-threads} is now configured by default.
2536 However, as a general user, do not attempt to replace the system
2537 compiler with this release.  Known to bootstrap and check with good
2538 results on FreeBSD 4.8-STABLE and 5-CURRENT@.  In the past, known to
2539 bootstrap and check with good results on FreeBSD 3.0, 3.4, 4.0, 4.2,
2540 4.3, 4.4, 4.5-STABLE@.
2541
2542 In principle, @option{--enable-threads} is now compatible with
2543 @option{--enable-libgcj} on FreeBSD@.  However, it has only been built
2544 and tested on @samp{i386-*-freebsd[45]} and @samp{alpha-*-freebsd[45]}.
2545 The static
2546 library may be incorrectly built (symbols are missing at link time).
2547 There is a rare timing-based startup hang (probably involves an
2548 assumption about the thread library).  Multi-threaded boehm-gc (required for
2549 libjava) exposes severe threaded signal-handling bugs on FreeBSD before
2550 4.5-RELEASE@.  Other CPU architectures
2551 supported by FreeBSD will require additional configuration tuning in, at
2552 the very least, both boehm-gc and libffi.
2553
2554 Shared @file{libgcc_s.so} is now built and installed by default.
2555
2556 @html
2557 <hr />
2558 @end html
2559 @heading @anchor{h8300-hms}h8300-hms
2560 Renesas H8/300 series of processors.
2561
2562 Please have a look at our @uref{binaries.html,,binaries page}.
2563
2564 The calling convention and structure layout has changed in release 2.6.
2565 All code must be recompiled.  The calling convention now passes the
2566 first three arguments in function calls in registers.  Structures are no
2567 longer a multiple of 2 bytes.
2568
2569 @html
2570 <hr />
2571 @end html
2572 @heading @anchor{hppa*-hp-hpux*}hppa*-hp-hpux*
2573 Support for HP-UX version 9 and older was discontinued in GCC 3.4.
2574
2575 We @emph{highly} recommend using gas/binutils 2.8 or newer on all hppa
2576 platforms; you may encounter a variety of problems when using the HP
2577 assembler.
2578
2579 Specifically, @option{-g} does not work on HP-UX (since that system
2580 uses a peculiar debugging format which GCC does not know about), unless you
2581 use GAS and GDB and configure GCC with the
2582 @uref{./configure.html#with-gnu-as,,@option{--with-gnu-as}} and
2583 @option{--with-as=@dots{}} options.
2584
2585 If you wish to use the pa-risc 2.0 architecture support with a 32-bit
2586 runtime, you must use either the HP assembler, gas/binutils 2.11 or newer,
2587 or a recent
2588 @uref{ftp://sources.redhat.com/pub/binutils/snapshots,,snapshot of gas}.
2589
2590 There are two default scheduling models for instructions.  These are
2591 PROCESSOR_7100LC and PROCESSOR_8000.  They are selected from the pa-risc
2592 architecture specified for the target machine when configuring.
2593 PROCESSOR_8000 is the default.  PROCESSOR_7100LC is selected when
2594 the target is a @samp{hppa1*} machine.
2595
2596 The PROCESSOR_8000 model is not well suited to older processors.  Thus,
2597 it is important to completely specify the machine architecture when
2598 configuring if you want a model other than PROCESSOR_8000.  The macro
2599 TARGET_SCHED_DEFAULT can be defined in BOOT_CFLAGS if a different
2600 default scheduling model is desired.
2601
2602 More specific information to @samp{hppa*-hp-hpux*} targets follows.
2603
2604 @html
2605 <hr />
2606 @end html
2607 @heading @anchor{hppa*-hp-hpux10}hppa*-hp-hpux10
2608
2609 For hpux10.20, we @emph{highly} recommend you pick up the latest sed patch
2610 @code{PHCO_19798} from HP@.  HP has two sites which provide patches free of
2611 charge:
2612
2613 @itemize @bullet
2614 @item
2615 @html
2616 <a href="http://us.itrc.hp.com/service/home/home.do">US, Canada, Asia-Pacific, and
2617 Latin-America</a>
2618 @end html
2619 @ifnothtml
2620 @uref{http://us.itrc.hp.com/service/home/home.do,,} US, Canada, Asia-Pacific,
2621 and Latin-America.
2622 @end ifnothtml
2623 @item
2624 @uref{http://europe.itrc.hp.com/service/home/home.do,,} Europe.
2625 @end itemize
2626
2627 The HP assembler on these systems has some problems.  Most notably the
2628 assembler inserts timestamps into each object file it creates, causing
2629 the 3-stage comparison test to fail during a @samp{make bootstrap}.
2630 You should be able to continue by saying @samp{make all} after getting
2631 the failure from @samp{make bootstrap}.
2632
2633
2634 @html
2635 <hr />
2636 @end html
2637 @heading @anchor{hppa*-hp-hpux11}hppa*-hp-hpux11
2638
2639 GCC 3.0 and up support HP-UX 11.  On 64-bit capable systems, there
2640 are two distinct ports.  The @samp{hppa2.0w-hp-hpux11*} port generates
2641 code for the 32-bit pa-risc runtime architecture.  It uses the HP
2642 linker.  The @samp{hppa64-hp-hpux11*} port generates 64-bit code for the
2643 pa-risc 2.0 architecture.  The script config.guess now selects the port
2644 type based on the type compiler detected during configuration.  You must
2645 set your @env{PATH} or define @env{CC} so that configure finds an appropriate
2646 compiler for the initial bootstrap.  Different prefixes must be used if
2647 both ports are to be installed on the same system.
2648
2649 It is best to explicitly configure the @samp{hppa64-hp-hpux11*} target
2650 with the @option{--with-ld=@dots{}} option.  We support both the HP
2651 and GNU linkers for this target.  The two linkers require different
2652 link commands.  Thus, it's not possible to switch linkers during a
2653 GCC build.  This has been been reported to occur in a unified build
2654 of binutils and GCC.
2655
2656 GCC 2.95.x is not supported under HP-UX 11 and cannot be used to
2657 compile GCC 3.0 and up.  Refer to @uref{binaries.html,,binaries} for
2658 information about obtaining precompiled GCC binaries for HP-UX.
2659
2660 You must use GNU binutils 2.11 or above with the 32-bit port.  Thread
2661 support is not currently implemented, so @option{--enable-threads} does
2662 not work.  See:
2663
2664 @itemize
2665 @item @uref{http://gcc.gnu.org/ml/gcc-prs/2002-01/msg00551.html}
2666 @item @uref{http://gcc.gnu.org/ml/gcc-bugs/2002-01/msg00663.html}
2667 @end itemize
2668
2669 GCC 3.3 and later support weak symbols on the 32-bit port using SOM
2670 secondary definition symbols.  This feature is not enabled for earlier
2671 versions of HP-UX since there have been bugs in the linker support for
2672 secondary symbols.  The HP linker patches @code{PHSS_26559} and
2673 @code{PHSS_24304} for HP-UX 11.00 and 11.11, respectively, correct the
2674 problem of linker core dumps creating C++ libraries.  Earlier patches
2675 may work but they have not been tested.
2676
2677 GCC 3.3 nows uses the ELF DT_INIT_ARRAY and DT_FINI_ARRAY capability
2678 to run initializers and finalizers on the 64-bit port.  The feature
2679 requires CVS binutils as of January 2, 2003, or a subsequent release
2680 to correct a problem arising from HP's non-standard use of the .init
2681 and .fini sections.  The 32-bit port uses the linker @option{+init}
2682 and @option{+fini} options.  As with the support for secondary symbols,
2683 there have been bugs in the order in which these options are executed
2684 by the HP linker.  So, again a recent linker patch is recommended.
2685
2686 The HP assembler has many limitations and is not recommended for either
2687 the 32 or 64-bit ports.  For example, it does not support weak symbols
2688 or alias definitions.  As a result, explicit template instantiations
2689 are required when using C++.  This will make it difficult if not
2690 impossible to build many C++ applications.  You also can't generate
2691 debugging information when using the HP assembler with GCC.
2692
2693 There are a number of issues to consider in selecting which linker to
2694 use with the 64-bit port.  The  GNU 64-bit linker can only create dynamic
2695 binaries.  The @option{-static} option causes linking with archive
2696 libraries but doesn't produce a truly static binary.  Dynamic binaries
2697 still require final binding by the dynamic loader to resolve a set of
2698 dynamic-loader-defined symbols.  The default behavior of the HP linker
2699 is the same as the GNU linker.  However, it can generate true 64-bit
2700 static binaries using the @option{+compat} option.
2701
2702 The HP 64-bit linker doesn't support linkonce semantics.  As a
2703 result, C++ programs have many more sections than they should.
2704
2705 The GNU 64-bit linker has some issues with shared library support
2706 and exceptions.  As a result, we only support libgcc in archive
2707 format.  For similar reasons, dwarf2 unwind and exception support
2708 are disabled.  The GNU linker also has problems creating binaries
2709 with @option{-static}.  It doesn't provide stubs for internal
2710 calls to global functions in shared libraries, so these calls
2711 can't be overloaded.
2712
2713 There are several possible approaches to building the distribution.
2714 Binutils can be built first using the HP tools.  Then, the GCC
2715 distribution can be built.  The second approach is to build GCC
2716 first using the HP tools, then build binutils, then rebuild GCC.
2717 There have been problems with various binary distributions, so
2718 it is best not to start from a binary distribution.
2719
2720 Starting with GCC 3.4 an ISO C compiler is required to bootstrap.
2721 The bundled compiler supports only traditional C; you will need
2722 either HP's unbundled compiler, or a binary distribution of GCC@.
2723
2724 This port still is undergoing significant development.
2725
2726 @html
2727 <hr />
2728 @end html
2729 @heading @anchor{*-*-linux-gnu}*-*-linux-gnu
2730
2731 Versions of libstdc++-v3 starting with 3.2.1 require bugfixes present
2732 in glibc 2.2.5 and later.  More information is available in the
2733 libstdc++-v3 documentation.
2734
2735 @html
2736 <hr />
2737 @end html
2738 @heading @anchor{ix86-*-linux*aout}i?86-*-linux*aout
2739 Use this configuration to generate @file{a.out} binaries on Linux-based
2740 GNU systems.  This configuration is being superseded.
2741
2742 @html
2743 <hr />
2744 @end html
2745 @heading @anchor{ix86-*-linux*}i?86-*-linux*
2746
2747 As of GCC 3.3, binutils 2.13.1 or later is required for this platform.
2748 See @uref{http://gcc.gnu.org/PR10877,,bug 10877} for more information.
2749
2750 If you receive Signal 11 errors when building on GNU/Linux, then it is
2751 possible you have a hardware problem.  Further information on this can be
2752 found on @uref{http://www.bitwizard.nl/sig11/,,www.bitwizard.nl}.
2753
2754 @html
2755 <hr />
2756 @end html
2757 @heading @anchor{ix86-*-sco3.2v5*}i?86-*-sco3.2v5*
2758 Use this for the SCO OpenServer Release 5 family of operating systems.
2759
2760 Unlike earlier versions of GCC, the ability to generate COFF with this
2761 target is no longer provided.
2762
2763 Earlier versions of GCC emitted DWARF 1 when generating ELF to allow
2764 the system debugger to be used.  That support was too burdensome to
2765 maintain.  GCC now emits only DWARF 2 for this target.  This means you
2766 may use either the UDK debugger or GDB to debug programs built by this
2767 version of GCC@.
2768
2769 GCC is now only supported on releases 5.0.4 and later, and requires that
2770 you install Support Level Supplement OSS646B or later, and Support Level
2771 Supplement OSS631C or later.  If you are using release 5.0.7 of
2772 OpenServer, you must have at least the first maintenance pack installed
2773 (this includes the relevant portions of OSS646).  OSS646, also known as
2774 the "Execution Environment Update", provides updated link editors and
2775 assemblers, as well as updated standard C and math libraries.  The C
2776 startup modules are also updated to support the System V gABI draft, and
2777 GCC relies on that behavior.  OSS631 provides a collection of commonly
2778 used open source libraries, some of which GCC depends on (such as GNU
2779 gettext and zlib).  SCO OpenServer Release 5.0.7 has all of this built
2780 in by default, but OSS631C and later also apply to that release.  Please
2781 visit
2782 @uref{ftp://ftp.sco.com/pub/openserver5,,ftp://ftp.sco.com/pub/openserver5}
2783 for the latest versions of these (and other potentially useful)
2784 supplements.
2785
2786 Although there is support for using the native assembler, it is
2787 recommended that you configure GCC to use the GNU assembler.  You do
2788 this by using the flags
2789 @uref{./configure.html#with-gnu-as,,@option{--with-gnu-as}}.  You should
2790 use a modern version of GNU binutils.  Version 2.13.2.1 was used for all
2791 testing.  In general, only the @option{--with-gnu-as} option is tested.
2792 A modern bintuils (as well as a plethora of other development related
2793 GNU utilities) can be found in Support Level Supplement OSS658A, the
2794 "GNU Development Tools" package.  See the SCO web and ftp sites for details.
2795 That package also contains the currently "officially supported" version of
2796 GCC, version 2.95.3.  It is useful for bootstrapping this version.
2797
2798 @html
2799 <hr />
2800 @end html
2801 @heading @anchor{ix86-*-udk}i?86-*-udk
2802
2803 This target emulates the SCO Universal Development Kit and requires that
2804 package be installed.  (If it is installed, you will have a
2805 @file{/udk/usr/ccs/bin/cc} file present.)  It's very much like the
2806 @samp{i?86-*-unixware7*} target
2807 but is meant to be used when hosting on a system where UDK isn't the
2808 default compiler such as OpenServer 5 or Unixware 2.  This target will
2809 generate binaries that will run on OpenServer, Unixware 2, or Unixware 7,
2810 with the same warnings and caveats as the SCO UDK@.
2811
2812 This target is a little tricky to build because we have to distinguish
2813 it from the native tools (so it gets headers, startups, and libraries
2814 from the right place) while making the tools not think we're actually
2815 building a cross compiler.   The easiest way to do this is with a configure
2816 command like this:
2817
2818 @smallexample
2819     CC=/udk/usr/ccs/bin/cc @var{/your/path/to}/gcc/configure \
2820       --host=i686-pc-udk --target=i686-pc-udk --program-prefix=udk-
2821 @end smallexample
2822
2823 @emph{You should substitute @samp{i686} in the above command with the appropriate
2824 processor for your host.}
2825
2826 After the usual @samp{make bootstrap} and
2827 @samp{make install}, you can then access the UDK-targeted GCC
2828 tools by adding @command{udk-} before the commonly known name.  For
2829 example, to invoke the C compiler, you would use @command{udk-gcc}.
2830 They will coexist peacefully with any native-target GCC tools you may
2831 have installed.
2832
2833
2834 @html
2835 <hr />
2836 @end html
2837 @heading @anchor{ia64-*-linux}ia64-*-linux
2838 IA-64 processor (also known as IPF, or Itanium Processor Family)
2839 running GNU/Linux.
2840
2841 If you are using the optional libunwind library, then you must use
2842 libunwind 0.96 or later.
2843
2844 None of the following versions of GCC has an ABI that is compatible
2845 with any of the other versions in this list, with the exception that
2846 Red Hat 2.96 and Trillian 000171 are compatible with each other:
2847 3.1, 3.0.2, 3.0.1, 3.0, Red Hat 2.96, and Trillian 000717.
2848 This primarily affects C++ programs and programs that create shared libraries.
2849 GCC 3.1 or later is recommended for compiling linux, the kernel.
2850 As of version 3.1 GCC is believed to be fully ABI compliant, and hence no
2851 more major ABI changes are expected.
2852
2853 @html
2854 <hr />
2855 @end html
2856 @heading @anchor{ia64-*-hpux*}ia64-*-hpux*
2857 Building GCC on this target requires the GNU Assembler. The bundled HP
2858 assembler will not work. To prevent GCC from using the wrong assembler,
2859 the option @option{--with-gnu-as} may be necessary.
2860
2861 The GCC libunwind library has not been ported to HPUX. This means that for
2862 GCC versions 3.2.3 and earlier, @option{--enable-libunwind-exceptions}
2863 is required to build GCC. For GCC 3.3 and later, this is the default.
2864
2865 @html
2866 <hr />
2867 <!-- rs6000-ibm-aix*, powerpc-ibm-aix* -->
2868 @end html
2869 @heading @anchor{*-ibm-aix*}*-ibm-aix*
2870 Support for AIX version 3 and older was discontinued in GCC 3.4.
2871
2872 AIX Make frequently has problems with GCC makefiles.  GNU Make 3.79.1 or
2873 newer is recommended to build on this platform.
2874
2875 Errors involving @code{alloca} when building GCC generally are due
2876 to an incorrect definition of @code{CC} in the Makefile or mixing files
2877 compiled with the native C compiler and GCC@.  During the stage1 phase of
2878 the build, the native AIX compiler @strong{must} be invoked as @command{cc}
2879 (not @command{xlc}).  Once @command{configure} has been informed of
2880 @command{xlc}, one needs to use @samp{make distclean} to remove the
2881 configure cache files and ensure that @env{CC} environment variable
2882 does not provide a definition that will confuse @command{configure}.
2883 If this error occurs during stage2 or later, then the problem most likely
2884 is the version of Make (see above).
2885
2886 The native @command{as} and @command{ld} are recommended for bootstrapping
2887 on AIX 4 and required for bootstrapping on AIX 5L.  The GNU Assembler
2888 reports that it supports WEAK symbols on AIX 4, which causes GCC to try to
2889 utilize weak symbol functionality although it is not supported.  The GNU
2890 Assembler and Linker do not support AIX 5L sufficiently to bootstrap GCC.
2891 The native AIX tools do interoperate with GCC@.
2892
2893 Building @file{libstdc++.a} requires a fix for an AIX Assembler bug
2894 APAR IY26685 (AIX 4.3) or APAR IY25528 (AIX 5.1).
2895
2896 @samp{libstdc++} in GCC 3.2 increments the major version number of the
2897 shared object and GCC installation places the @file{libstdc++.a}
2898 shared library in a common location which will overwrite the GCC 3.1
2899 version of the shared library.  Applications either need to be
2900 re-linked against the new shared library or the GCC 3.1 version of the
2901 @samp{libstdc++} shared object needs to be available to the AIX
2902 runtime loader.  The GCC 3.1 @samp{libstdc++.so.4} shared object can
2903 be installed for runtime dynamic loading using the following steps to
2904 set the @samp{F_LOADONLY} flag in the shared object for @emph{each}
2905 multilib @file{libstdc++.a} installed:
2906
2907 Extract the shared object from each the GCC 3.1 @file{libstdc++.a}
2908 archive:
2909 @smallexample
2910    % ar -x libstdc++.a libstdc++.so.4
2911 @end smallexample
2912
2913 Enable the @samp{F_LOADONLY} flag so that the shared object will be
2914 available for runtime dynamic loading, but not linking:
2915 @smallexample
2916    % strip -e libstdc++.so.4
2917 @end smallexample
2918
2919 Archive the runtime-only shared object in the GCC 3.2
2920 @file{libstdc++.a} archive:
2921 @smallexample
2922    % ar -q libstdc++.a libstdc++.so.4
2923 @end smallexample
2924
2925 Linking executables and shared libraries may produce warnings of
2926 duplicate symbols.  The assembly files generated by GCC for AIX always
2927 have included multiple symbol definitions for certain global variable
2928 and function declarations in the original program.  The warnings should
2929 not prevent the linker from producing a correct library or runnable
2930 executable.
2931
2932 AIX 4.3 utilizes a ``large format'' archive to support both 32-bit and
2933 64-bit object modules.  The routines provided in AIX 4.3.0 and AIX 4.3.1
2934 to parse archive libraries did not handle the new format correctly.
2935 These routines are used by GCC and result in error messages during
2936 linking such as ``not a COFF file''.  The version of the routines shipped
2937 with AIX 4.3.1 should work for a 32-bit environment.  The @option{-g}
2938 option of the archive command may be used to create archives of 32-bit
2939 objects using the original ``small format''.  A correct version of the
2940 routines is shipped with AIX 4.3.2 and above.
2941
2942 Some versions of the AIX binder (linker) can fail with a relocation
2943 overflow severe error when the @option{-bbigtoc} option is used to link
2944 GCC-produced object files into an executable that overflows the TOC@.  A fix
2945 for APAR IX75823 (OVERFLOW DURING LINK WHEN USING GCC AND -BBIGTOC) is
2946 available from IBM Customer Support and from its
2947 @uref{http://techsupport.services.ibm.com/,,techsupport.services.ibm.com}
2948 website as PTF U455193.
2949
2950 The AIX 4.3.2.1 linker (bos.rte.bind_cmds Level 4.3.2.1) will dump core
2951 with a segmentation fault when invoked by any version of GCC@.  A fix for
2952 APAR IX87327 is available from IBM Customer Support and from its
2953 @uref{http://techsupport.services.ibm.com/,,techsupport.services.ibm.com}
2954 website as PTF U461879.  This fix is incorporated in AIX 4.3.3 and above.
2955
2956 The initial assembler shipped with AIX 4.3.0 generates incorrect object
2957 files.  A fix for APAR IX74254 (64BIT DISASSEMBLED OUTPUT FROM COMPILER FAILS
2958 TO ASSEMBLE/BIND) is available from IBM Customer Support and from its
2959 @uref{http://techsupport.services.ibm.com/,,techsupport.services.ibm.com}
2960 website as PTF U453956.  This fix is incorporated in AIX 4.3.1 and above.
2961
2962 AIX provides National Language Support (NLS)@.  Compilers and assemblers
2963 use NLS to support locale-specific representations of various data
2964 formats including floating-point numbers (e.g., @samp{.}  vs @samp{,} for
2965 separating decimal fractions).  There have been problems reported where
2966 GCC does not produce the same floating-point formats that the assembler
2967 expects.  If one encounters this problem, set the @env{LANG}
2968 environment variable to @samp{C} or @samp{En_US}.
2969
2970 By default, GCC for AIX 4.1 and above produces code that can be used on
2971 both Power or PowerPC processors.
2972
2973 A default can be specified with the @option{-mcpu=@var{cpu_type}}
2974 switch and using the configure option @option{--with-cpu-@var{cpu_type}}.
2975
2976 @html
2977 <hr />
2978 @end html
2979 @heading @anchor{ip2k-*-elf}ip2k-*-elf
2980 Ubicom IP2022 micro controller.
2981 This configuration is intended for embedded systems.
2982 There are no standard Unix configurations.
2983
2984 Use @samp{configure --target=ip2k-elf --enable-languages=c} to configure GCC@.
2985
2986 @html
2987 <hr />
2988 @end html
2989 @heading @anchor{iq2000-*-elf}iq2000-*-elf
2990 Vitesse IQ2000 processors.  These are used in embedded
2991 applications.  There are no standard Unix configurations.
2992
2993 @html
2994 <hr />
2995 @end html
2996 @heading @anchor{m32r-*-elf}m32r-*-elf
2997 Renesas M32R processor.
2998 This configuration is intended for embedded systems.
2999
3000 @html
3001 <hr />
3002 @end html
3003 @heading @anchor{m6811-elf}m6811-elf
3004 Motorola 68HC11 family micro controllers.  These are used in embedded
3005 applications.  There are no standard Unix configurations.
3006
3007 @html
3008 <hr />
3009 @end html
3010 @heading @anchor{m6812-elf}m6812-elf
3011 Motorola 68HC12 family micro controllers.  These are used in embedded
3012 applications.  There are no standard Unix configurations.
3013
3014 @html
3015 <hr />
3016 @end html
3017 @heading @anchor{m68k-hp-hpux}m68k-hp-hpux
3018 HP 9000 series 300 or 400 running HP-UX@.  HP-UX version 8.0 has a bug in
3019 the assembler that prevents compilation of GCC@.  This
3020 bug manifests itself during the first stage of compilation, while
3021 building @file{libgcc2.a}:
3022
3023 @smallexample
3024 _floatdisf
3025 cc1: warning: `-g' option not supported on this version of GCC
3026 cc1: warning: `-g1' option not supported on this version of GCC
3027 ./xgcc: Internal compiler error: program as got fatal signal 11
3028 @end smallexample
3029
3030 A patched version of the assembler is available as the file
3031 @uref{ftp://altdorf.ai.mit.edu/archive/cph/hpux-8.0-assembler}.  If you
3032 have HP software support, the patch can also be obtained directly from
3033 HP, as described in the following note:
3034
3035 @quotation
3036 This is the patched assembler, to patch SR#1653-010439, where the
3037 assembler aborts on floating point constants.
3038
3039 The bug is not really in the assembler, but in the shared library
3040 version of the function ``cvtnum(3c)''.  The bug on ``cvtnum(3c)'' is
3041 SR#4701-078451.  Anyway, the attached assembler uses the archive
3042 library version of ``cvtnum(3c)'' and thus does not exhibit the bug.
3043 @end quotation
3044
3045 This patch is also known as PHCO_4484.
3046
3047 In addition gdb does not understand that native HP-UX format, so
3048 you must use gas if you wish to use gdb.
3049
3050 On HP-UX version 8.05, but not on 8.07 or more recent versions, the
3051 @command{fixproto} shell script triggers a bug in the system shell.  If you
3052 encounter this problem, upgrade your operating system or use BASH (the
3053 GNU shell) to run @command{fixproto}.  This bug will cause the fixproto
3054 program to report an error of the form:
3055
3056 @smallexample
3057 ./fixproto: sh internal 1K buffer overflow
3058 @end smallexample
3059
3060 To fix this, you can also change the first line of the fixproto script
3061 to look like:
3062
3063 @smallexample
3064 #!/bin/ksh
3065 @end smallexample
3066
3067 @html
3068 <hr />
3069 @end html
3070 @heading @anchor{mips-*-*}mips-*-*
3071 If on a MIPS system you get an error message saying ``does not have gp
3072 sections for all it's [sic] sectons [sic]'', don't worry about it.  This
3073 happens whenever you use GAS with the MIPS linker, but there is not
3074 really anything wrong, and it is okay to use the output file.  You can
3075 stop such warnings by installing the GNU linker.
3076
3077 It would be nice to extend GAS to produce the gp tables, but they are
3078 optional, and there should not be a warning about their absence.
3079
3080 The libstdc++ atomic locking routines for MIPS targets requires MIPS II
3081 and later.  A patch went in just after the GCC 3.3 release to
3082 make @samp{mips*-*-*} use the generic implementation instead.  You can also
3083 configure for @samp{mipsel-elf} as a workaround.  The
3084 @samp{mips*-*-linux*} target continues to use the MIPS II routines.  More
3085 work on this is expected in future releases.
3086
3087 Cross-compilers for the Mips as target using the Mips assembler
3088 currently do not work, because the auxiliary programs
3089 @file{mips-tdump.c} and @file{mips-tfile.c} can't be compiled on
3090 anything but a Mips.  It does work to cross compile for a Mips
3091 if you use the GNU assembler and linker.
3092
3093 @html
3094 <hr />
3095 @end html
3096 @heading @anchor{mips-sgi-irix5}mips-sgi-irix5
3097
3098 This configuration has considerable problems, which will be fixed in a
3099 future release.
3100
3101 In order to compile GCC on an SGI running IRIX 5, the ``compiler_dev.hdr''
3102 subsystem must be installed from the IDO CD-ROM supplied by Silicon
3103 Graphics.  It is also available for download from
3104 @uref{http://www.sgi.com/developers/devtools/apis/ido.html,,http://www.sgi.com/developers/devtools/apis/ido.html}.
3105
3106 @samp{make compare} may fail on version 5 of IRIX unless you add
3107 @option{-save-temps} to @code{CFLAGS}.  On these systems, the name of the
3108 assembler input file is stored in the object file, and that makes
3109 comparison fail if it differs between the @code{stage1} and
3110 @code{stage2} compilations.  The option @option{-save-temps} forces a
3111 fixed name to be used for the assembler input file, instead of a
3112 randomly chosen name in @file{/tmp}.  Do not add @option{-save-temps}
3113 unless the comparisons fail without that option.  If you do you
3114 @option{-save-temps}, you will have to manually delete the @samp{.i} and
3115 @samp{.s} files after each series of compilations.
3116
3117 If you use the MIPS C compiler to bootstrap, it may be necessary
3118 to increase its table size for switch statements with the
3119 @option{-Wf,-XNg1500} option.  If you use the @option{-O2}
3120 optimization option, you also need to use @option{-Olimit 3000}.
3121
3122 To enable debugging under IRIX 5, you must use GNU @command{as} 2.11.2
3123 or later,
3124 and use the @option{--with-gnu-as} configure option when configuring GCC.
3125 GNU @command{as} is distributed as part of the binutils package.
3126 When using release 2.11.2, you need to apply a patch
3127 @uref{http://sources.redhat.com/ml/binutils/2001-07/msg00352.html,,http://sources.redhat.com/ml/binutils/2001-07/msg00352.html}
3128 which will be included in the next release of binutils.
3129
3130 When building GCC, the build process loops rebuilding @command{cc1} over
3131 and over again.  This happens on @samp{mips-sgi-irix5.2}, and possibly
3132 other platforms.  It has been reported that this is a known bug in the
3133 @command{make} shipped with IRIX 5.2.  We recommend you use GNU
3134 @command{make} instead of the vendor supplied @command{make} program;
3135 however, you may have success with @command{smake} on IRIX 5.2 if you do
3136 not have GNU @command{make} available.
3137
3138 @html
3139 <hr />
3140 @end html
3141 @heading @anchor{mips-sgi-irix6}mips-sgi-irix6
3142
3143 If you are using IRIX @command{cc} as your bootstrap compiler, you must
3144 ensure that the N32 ABI is in use.  To test this, compile a simple C
3145 file with @command{cc} and then run @command{file} on the
3146 resulting object file.  The output should look like:
3147
3148 @smallexample
3149 test.o: ELF N32 MSB @dots{}
3150 @end smallexample
3151
3152 If you see:
3153
3154 @smallexample
3155 test.o: ELF 32-bit MSB @dots{}
3156 @end smallexample
3157
3158 or
3159
3160 @smallexample
3161 test.o: ELF 64-bit MSB @dots{}
3162 @end smallexample
3163
3164 then your version of @command{cc} uses the O32 or N64 ABI by default.  You
3165 should set the environment variable @env{CC} to @samp{cc -n32}
3166 before configuring GCC@.
3167
3168 If you want the resulting @command{gcc} to run on old 32-bit systems
3169 with the MIPS R4400 CPU, you need to ensure that only code for the mips3
3170 instruction set architecture (ISA) is generated.  While GCC 3.x does
3171 this correctly, both GCC 2.95 and SGI's MIPSpro @command{cc} may change
3172 the ISA depending on the machine where GCC is built.  Using one of them
3173 as the bootstrap compiler may result in mips4 code, which won't run at
3174 all on mips3-only systems.  For the test program above, you should see:
3175
3176 @smallexample
3177 test.o: ELF N32 MSB mips-3 @dots{}
3178 @end smallexample
3179
3180 If you get:
3181
3182 @smallexample
3183 test.o: ELF N32 MSB mips-4 @dots{}
3184 @end smallexample
3185
3186 instead, you should set the environment variable @env{CC} to @samp{cc
3187 -n32 -mips3} or @samp{gcc -mips3} respectively before configuring GCC@.
3188
3189 GCC on IRIX 6 is usually built to support both the N32 and N64 ABIs.  If
3190 you build GCC on a system that doesn't have the N64 libraries installed,
3191 you need to configure with @option{--disable-multilib} so GCC doesn't
3192 try to use them.  Look for @file{/usr/lib64/libc.so.1} to see if you
3193 have the 64-bit libraries installed.
3194
3195 You must @emph{not} use GNU @command{as} (which isn't built anyway as of
3196 binutils 2.11.2) on IRIX 6 platforms; doing so will only cause problems.
3197
3198 GCC does not currently support generating O32 ABI binaries in the
3199 @samp{mips-sgi-irix6} configurations.  It is possible to create a GCC
3200 with O32 ABI only support by configuring it for the @samp{mips-sgi-irix5}
3201 target and using a patched GNU @command{as} 2.11.2 as documented in the
3202 @uref{#mips-sgi-irix5,,@samp{mips-sgi-irix5}} section above.  Using the
3203 native assembler requires patches to GCC which will be included in a
3204 future release.  It is
3205 expected that O32 ABI support will be available again in a future release.
3206
3207 The @option{--enable-threads} option doesn't currently work, a patch is
3208 in preparation for a future release.  The @option{--enable-libgcj}
3209 option is disabled by default: IRIX 6 uses a very low default limit
3210 (20480) for the command line length.  Although libtool contains a
3211 workaround for this problem, at least the N64 @samp{libgcj} is known not
3212 to build despite this, running into an internal error of the native
3213 @command{ld}.  A sure fix is to increase this limit (@samp{ncargs}) to
3214 its maximum of 262144 bytes.  If you have root access, you can use the
3215 @command{systune} command to do this.
3216
3217 GCC does not correctly pass/return structures which are
3218 smaller than 16 bytes and which are not 8 bytes.  The problem is very
3219 involved and difficult to fix.  It affects a number of other targets also,
3220 but IRIX 6 is affected the most, because it is a 64-bit target, and 4 byte
3221 structures are common.  The exact problem is that structures are being padded
3222 at the wrong end, e.g.@: a 4 byte structure is loaded into the lower 4 bytes
3223 of the register when it should be loaded into the upper 4 bytes of the
3224 register.
3225
3226 GCC is consistent with itself, but not consistent with the SGI C compiler
3227 (and the SGI supplied runtime libraries), so the only failures that can
3228 happen are when there are library functions that take/return such
3229 structures. There are very few such library functions.  Currently this
3230 is known to affect @code{inet_ntoa}, @code{inet_lnaof},
3231 @code{inet_netof}, @code{inet_makeaddr}, and @code{semctl}.  Until the
3232 bug is fixed, GCC contains workarounds for the known affected functions.
3233
3234 See @uref{http://freeware.sgi.com/,,http://freeware.sgi.com/} for more
3235 information about using GCC on IRIX platforms.
3236
3237 @html
3238 <hr />
3239 @end html
3240 @heading @anchor{powerpc*-*-*}powerpc-*-*
3241
3242 You can specify a default version for the @option{-mcpu=@var{cpu_type}}
3243 switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
3244
3245 @html
3246 <hr />
3247 @end html
3248 @heading @anchor{powerpc-*-darwin*}powerpc-*-darwin*
3249 PowerPC running Darwin (Mac OS X kernel).
3250
3251 Pre-installed versions of Mac OS X may not include any developer tools,
3252 meaning that you will not be able to build GCC from source.  Tool
3253 binaries are available at
3254 @uref{http://developer.apple.com/tools/compilers.html} (free
3255 registration required).
3256
3257 The default stack limit of 512K is too small, which may cause compiles
3258 to fail with 'Bus error'.  Set the stack larger, for instance
3259 by doing @samp{limit stack 800}.  It's a good idea to use the GNU
3260 preprocessor instead of Apple's @file{cpp-precomp} during the first stage of
3261 bootstrapping; this is automatic when doing @samp{make bootstrap}, but
3262 to do it from the toplevel objdir you will need to say @samp{make
3263 CC='cc -no-cpp-precomp' bootstrap}.
3264
3265 The version of GCC shipped by Apple typically includes a number of
3266 extensions not available in a standard GCC release.  These extensions
3267 are generally specific to Mac programming.
3268
3269 @html
3270 <hr />
3271 @end html
3272 @heading @anchor{powerpc-*-elf}powerpc-*-elf, powerpc-*-sysv4
3273 PowerPC system in big endian mode, running System V.4.
3274
3275 @html
3276 <hr />
3277 @end html
3278 @heading @anchor{powerpc-*-linux-gnu*}powerpc-*-linux-gnu*
3279
3280 You will need
3281 @uref{ftp://ftp.kernel.org/pub/linux/devel/binutils,,binutils 2.13.90.0.10}
3282 or newer for a working GCC@.
3283
3284 @html
3285 <hr />
3286 @end html
3287 @heading @anchor{powerpc-*-netbsd*}powerpc-*-netbsd*
3288 PowerPC system in big endian mode running NetBSD@.  To build the
3289 documentation you will need Texinfo version 4.2 (NetBSD 1.5.1 included
3290 Texinfo version 3.12).
3291
3292 @html
3293 <hr />
3294 @end html
3295 @heading @anchor{powerpc-*-eabisim}powerpc-*-eabisim
3296 Embedded PowerPC system in big endian mode for use in running under the
3297 PSIM simulator.
3298
3299 @html
3300 <hr />
3301 @end html
3302 @heading @anchor{powerpc-*-eabi}powerpc-*-eabi
3303 Embedded PowerPC system in big endian mode.
3304
3305 @html
3306 <hr />
3307 @end html
3308 @heading @anchor{powerpcle-*-elf}powerpcle-*-elf, powerpcle-*-sysv4
3309 PowerPC system in little endian mode, running System V.4.
3310
3311 @html
3312 <hr />
3313 @end html
3314 @heading @anchor{powerpcle-*-eabisim}powerpcle-*-eabisim
3315 Embedded PowerPC system in little endian mode for use in running under
3316 the PSIM simulator.
3317
3318 @html
3319 <hr />
3320 @end html
3321 @heading @anchor{powerpcle-*-eabi}powerpcle-*-eabi
3322 Embedded PowerPC system in little endian mode.
3323
3324 @html
3325 <hr />
3326 @end html
3327 @heading @anchor{s390-*-linux*}s390-*-linux*
3328 S/390 system running GNU/Linux for S/390@.
3329
3330 @html
3331 <hr />
3332 @end html
3333 @heading @anchor{s390x-*-linux*}s390x-*-linux*
3334 zSeries system (64-bit) running GNU/Linux for zSeries@.
3335
3336 @html
3337 <hr />
3338 @end html
3339 @heading @anchor{s390x-ibm-tpf*}s390x-ibm-tpf*
3340 zSeries system (64-bit) running TPF.  This platform is
3341 supported as cross-compilation target only.
3342
3343 @html
3344 <hr />
3345 @end html
3346 @c Please use Solaris 2 to refer to all release of Solaris, starting
3347 @c with 2.0 until 2.6, 7, and 8.  Solaris 1 was a marketing name for
3348 @c SunOS 4 releases which we don't use to avoid confusion.  Solaris
3349 @c alone is too unspecific and must be avoided.
3350 @heading @anchor{*-*-solaris2*}*-*-solaris2*
3351
3352 Sun does not ship a C compiler with Solaris 2.  To bootstrap and install
3353 GCC you first have to install a pre-built compiler, see our
3354 @uref{binaries.html,,binaries page} for details.
3355
3356 The Solaris 2 @command{/bin/sh} will often fail to configure
3357 @file{libstdc++-v3}, @file{boehm-gc} or @file{libjava}.  We therefore
3358 recommend to use the following sequence of commands to bootstrap and
3359 install GCC:
3360
3361 @smallexample
3362    % CONFIG_SHELL=/bin/ksh
3363    % export CONFIG_SHELL
3364 @end smallexample
3365
3366 and then proceed as described in @uref{build.html,,the build instructions},
3367 where we strongly recommend using GNU make and specifying an absolute path
3368 to invoke @var{srcdir}/configure.
3369
3370 Solaris 2 comes with a number of optional OS packages.  Some of these
3371 are needed to use GCC fully, namely @code{SUNWarc},
3372 @code{SUNWbtool}, @code{SUNWesu}, @code{SUNWhea}, @code{SUNWlibm},
3373 @code{SUNWsprot}, and @code{SUNWtoo}.  If you did not install all
3374 optional packages when installing Solaris 2, you will need to verify that
3375 the packages that GCC needs are installed.
3376
3377 To check whether an optional package is installed, use
3378 the @command{pkginfo} command.  To add an optional package, use the
3379 @command{pkgadd} command.  For further details, see the Solaris 2
3380 documentation.
3381
3382 Trying to use the linker and other tools in
3383 @file{/usr/ucb} to install GCC has been observed to cause trouble.
3384 For example, the linker may hang indefinitely.  The fix is to remove
3385 @file{/usr/ucb} from your @env{PATH}.
3386
3387 The build process works more smoothly with the legacy Sun tools so, if you
3388 have @file{/usr/xpg4/bin} in your @env{PATH}, we recommend that you place
3389 @file{/usr/bin} before @file{/usr/xpg4/bin} for the duration of the build.
3390
3391 All releases of GNU binutils prior to 2.11.2 have known bugs on this
3392 platform.  We recommend the use of GNU binutils 2.11.2 or the vendor
3393 tools (Sun @command{as}, Sun @command{ld}).
3394
3395 Sun bug 4296832 turns up when compiling X11 headers with GCC 2.95 or
3396 newer: @command{g++} will complain that types are missing.  These headers assume
3397 that omitting the type means @code{int}; this assumption worked for C89 but
3398 is wrong for C++, and is now wrong for C99 also.
3399
3400 @command{g++} accepts such (invalid) constructs with the option
3401 @option{-fpermissive}; it
3402 will assume that any missing type is @code{int} (as defined by C89).
3403
3404 There are patches for Solaris 2.6 (105633-56 or newer for SPARC,
3405 106248-42 or newer for Intel), Solaris 7 (108376-21 or newer for SPARC,
3406 108377-20 for Intel), and Solaris 8 (108652-24 or newer for SPARC,
3407 108653-22 for Intel) that fix this bug.
3408
3409 @html
3410 <hr />
3411 @end html
3412 @heading @anchor{sparc-sun-solaris2*}sparc-sun-solaris2*
3413
3414 When GCC is configured to use binutils 2.11.2 or later the binaries
3415 produced are smaller than the ones produced using Sun's native tools;
3416 this difference is quite significant for binaries containing debugging
3417 information.
3418
3419 Sun @command{as} 4.x is broken in that it cannot cope with long symbol names.
3420 A typical error message might look similar to the following:
3421
3422 @smallexample
3423 /usr/ccs/bin/as: "/var/tmp/ccMsw135.s", line 11041: error:
3424   can't compute value of an expression involving an external symbol.
3425 @end smallexample
3426
3427 This is Sun bug 4237974.  This is fixed with patch 108908-02 for Solaris
3428 2.6 and has been fixed in later (5.x) versions of the assembler,
3429 starting with Solaris 7.
3430
3431 Starting with Solaris 7, the operating system is capable of executing
3432 64-bit SPARC V9 binaries.  GCC 3.1 and later properly supports
3433 this; the @option{-m64} option enables 64-bit code generation.
3434 However, if all you want is code tuned for the UltraSPARC CPU, you
3435 should try the @option{-mtune=ultrasparc} option instead, which produces
3436 code that, unlike full 64-bit code, can still run on non-UltraSPARC
3437 machines.
3438
3439 When configuring on a Solaris 7 or later system that is running a kernel
3440 that supports only 32-bit binaries, one must configure with
3441 @option{--disable-multilib}, since we will not be able to build the
3442 64-bit target libraries.
3443
3444 GCC 3.4 triggers a code generation bug in versions 5.4 (Sun ONE Studio 7)
3445 and 5.5 (Sun ONE Studio 8) of the Sun compiler, which causes a bootstrap
3446 failure in form of a miscompilation of the stage1 compiler by the Sun
3447 compiler.  This is Sun bug 4974440.  This is fixed with patch 112760-07.
3448
3449 @html
3450 <hr />
3451 @end html
3452 @heading @anchor{sparc-sun-solaris2.7}sparc-sun-solaris2.7
3453
3454 Sun patch 107058-01 (1999-01-13) for Solaris 7/SPARC triggers a bug in
3455 the dynamic linker.  This problem (Sun bug 4210064) affects GCC 2.8
3456 and later, including all EGCS releases.  Sun formerly recommended
3457 107058-01 for all Solaris 7 users, but around 1999-09-01 it started to
3458 recommend it only for people who use Sun's compilers.
3459
3460 Here are some workarounds to this problem:
3461 @itemize @bullet
3462 @item
3463 Do not install Sun patch 107058-01 until after Sun releases a
3464 complete patch for bug 4210064.  This is the simplest course to take,
3465 unless you must also use Sun's C compiler.  Unfortunately 107058-01
3466 is preinstalled on some new Solaris 7-based hosts, so you may have to
3467 back it out.
3468
3469 @item
3470 Copy the original, unpatched Solaris 7
3471 @command{/usr/ccs/bin/as} into
3472 @command{/usr/local/libexec/gcc/sparc-sun-solaris2.7/3.4/as},
3473 adjusting the latter name to fit your local conventions and software
3474 version numbers.
3475
3476 @item
3477 Install Sun patch 106950-03 (1999-05-25) or later.  Nobody with
3478 both 107058-01 and 106950-03 installed has reported the bug with GCC
3479 and Sun's dynamic linker.  This last course of action is riskiest,
3480 for two reasons.  First, you must install 106950 on all hosts that
3481 run code generated by GCC; it doesn't suffice to install it only on
3482 the hosts that run GCC itself.  Second, Sun says that 106950-03 is
3483 only a partial fix for bug 4210064, but Sun doesn't know whether the
3484 partial fix is adequate for GCC@.  Revision -08 or later should fix
3485 the bug.  The current (as of 2001-09-24) revision is -14, and is included in
3486 the Solaris 7 Recommended Patch Cluster.
3487 @end itemize
3488
3489 GCC 3.3 triggers a bug in version 5.0 Alpha 03/27/98 of the Sun assembler,
3490 which causes a bootstrap failure when linking the 64-bit shared version of
3491 libgcc. A typical error message is:
3492
3493 @smallexample
3494 ld: fatal: relocation error: R_SPARC_32: file libgcc/sparcv9/_muldi3.o:
3495   symbol <unknown>:  offset 0xffffffff7ec133e7 is non-aligned.
3496 @end smallexample
3497
3498 This bug has been fixed in the final 5.0 version of the assembler.
3499
3500 @html
3501 <hr />
3502 @end html
3503 @heading @anchor{sparc-*-linux*}sparc-*-linux*
3504
3505 GCC versions 3.0 and higher require binutils 2.11.2 and glibc 2.2.4
3506 or newer on this platform.  All earlier binutils and glibc
3507 releases mishandled unaligned relocations on @code{sparc-*-*} targets.
3508
3509
3510 @html
3511 <hr />
3512 @end html
3513 @heading @anchor{sparc64-*-solaris2*}sparc64-*-solaris2*
3514
3515 The following compiler flags must be specified in the configure
3516 step in order to bootstrap this target with the Sun compiler:
3517
3518 @smallexample
3519    % CC="cc -xildoff -xarch=v9" @var{srcdir}/configure [@var{options}] [@var{target}]
3520 @end smallexample
3521
3522 @option{-xildoff} turns off the incremental linker, and @option{-xarch=v9}
3523 specifies the SPARC-V9 architecture to the Sun linker and assembler.
3524
3525 @html
3526 <hr />
3527 @end html
3528 @heading @anchor{sparcv9-*-solaris2*}sparcv9-*-solaris2*
3529
3530 This is a synonym for sparc64-*-solaris2*.
3531
3532 @html
3533 <hr />
3534 @end html
3535 @heading @anchor{#*-*-sysv*}*-*-sysv*
3536 On System V release 3, you may get this error message
3537 while linking:
3538
3539 @smallexample
3540 ld fatal: failed to write symbol name @var{something}
3541  in strings table for file @var{whatever}
3542 @end smallexample
3543
3544 This probably indicates that the disk is full or your ulimit won't allow
3545 the file to be as large as it needs to be.
3546
3547 This problem can also result because the kernel parameter @code{MAXUMEM}
3548 is too small.  If so, you must regenerate the kernel and make the value
3549 much larger.  The default value is reported to be 1024; a value of 32768
3550 is said to work.  Smaller values may also work.
3551
3552 On System V, if you get an error like this,
3553
3554 @smallexample
3555 /usr/local/lib/bison.simple: In function `yyparse':
3556 /usr/local/lib/bison.simple:625: virtual memory exhausted
3557 @end smallexample
3558
3559 @noindent
3560 that too indicates a problem with disk space, ulimit, or @code{MAXUMEM}.
3561
3562 On a System V release 4 system, make sure @file{/usr/bin} precedes
3563 @file{/usr/ucb} in @code{PATH}.  The @command{cc} command in
3564 @file{/usr/ucb} uses libraries which have bugs.
3565
3566 @html
3567 <hr />
3568 @end html
3569 @heading @anchor{vax-dec-ultrix}vax-dec-ultrix
3570 Don't try compiling with VAX C (@command{vcc}).  It produces incorrect code
3571 in some cases (for example, when @code{alloca} is used).
3572
3573 @html
3574 <hr />
3575 @end html
3576 @heading @anchor{*-*-vxworks*}*-*-vxworks*
3577 Support for VxWorks is in flux.  At present GCC supports @emph{only} the
3578 very recent VxWorks 5.5 (aka Tornado 2.2) release, and only on PowerPC.
3579 We welcome patches for other architectures supported by VxWorks 5.5.
3580 Support for VxWorks AE would also be welcome; we believe this is merely
3581 a matter of writing an appropriate ``configlette'' (see below).  We are
3582 not interested in supporting older, a.out or COFF-based, versions of
3583 VxWorks in GCC 3.
3584
3585 VxWorks comes with an older version of GCC installed in
3586 @file{@var{$WIND_BASE}/host}; we recommend you do not overwrite it.
3587 Choose an installation @var{prefix} entirely outside @var{$WIND_BASE}.
3588 Before running @command{configure}, create the directories @file{@var{prefix}}
3589 and @file{@var{prefix}/bin}.  Link or copy the appropriate assembler,
3590 linker, etc. into @file{@var{prefix}/bin}, and set your @var{PATH} to
3591 include that directory while running both @command{configure} and
3592 @command{make}.
3593
3594 You must give @command{configure} the
3595 @option{--with-headers=@var{$WIND_BASE}/target/h} switch so that it can
3596 find the VxWorks system headers.  Since VxWorks is a cross compilation
3597 target only, you must also specify @option{--target=@var{target}}.
3598 @command{configure} will attempt to create the directory
3599 @file{@var{prefix}/@var{target}/sys-include} and copy files into it;
3600 make sure the user running @command{configure} has sufficient privilege
3601 to do so.
3602
3603 GCC's exception handling runtime requires a special ``configlette''
3604 module, @file{contrib/gthr_supp_vxw_5x.c}.  Follow the instructions in
3605 that file to add the module to your kernel build.  (Future versions of
3606 VxWorks will incorporate this module.)
3607
3608 @html
3609 <hr />
3610 @end html
3611 @heading @anchor{x86_64-*-*}x86_64-*-*, amd64-*-*
3612
3613 GCC supports the x86-64 architecture implemented by the AMD64 processor
3614 (amd64-*-* is an alias for x86_64-*-*) on GNU/Linux, FreeBSD and NetBSD.
3615 On GNU/Linux the default is a bi-arch compiler which is able to generate
3616 both 64-bit x86-64 and 32-bit x86 code (via the @option{-m32} switch).
3617
3618 @html
3619 <hr />
3620 @end html
3621 @heading @anchor{xtensa-*-elf}xtensa-*-elf
3622
3623 This target is intended for embedded Xtensa systems using the
3624 @samp{newlib} C library.  It uses ELF but does not support shared
3625 objects.  Designed-defined instructions specified via the
3626 Tensilica Instruction Extension (TIE) language are only supported
3627 through inline assembly.
3628
3629 The Xtensa configuration information must be specified prior to
3630 building GCC@.  The @file{include/xtensa-config.h} header
3631 file contains the configuration information.  If you created your
3632 own Xtensa configuration with the Xtensa Processor Generator, the
3633 downloaded files include a customized copy of this header file,
3634 which you can use to replace the default header file.
3635
3636 @html
3637 <hr />
3638 @end html
3639 @heading @anchor{xtensa-*-linux*}xtensa-*-linux*
3640
3641 This target is for Xtensa systems running GNU/Linux.  It supports ELF
3642 shared objects and the GNU C library (glibc).  It also generates
3643 position-independent code (PIC) regardless of whether the
3644 @option{-fpic} or @option{-fPIC} options are used.  In other
3645 respects, this target is the same as the
3646 @uref{#xtensa-*-elf,,@samp{xtensa-*-elf}} target.
3647
3648 @html
3649 <hr />
3650 @end html
3651 @heading @anchor{windows}Microsoft Windows (32-bit)
3652
3653 A port of GCC 2.95.2 and 3.x is included with the
3654 @uref{http://www.cygwin.com/,,Cygwin environment}.
3655
3656 Current (as of early 2001) snapshots of GCC will build under Cygwin
3657 without modification.
3658
3659 GCC does not currently build with Microsoft's C++ compiler and there
3660 are no plans to make it do so.
3661
3662 @html
3663 <hr />
3664 @end html
3665 @heading @anchor{os2}OS/2
3666
3667 GCC does not currently support OS/2.  However, Andrew Zabolotny has been
3668 working on a generic OS/2 port with pgcc.  The current code can be found
3669 at @uref{http://www.goof.com/pcg/os2/,,http://www.goof.com/pcg/os2/}.
3670
3671 An older copy of GCC 2.8.1 is included with the EMX tools available at
3672 @uref{ftp://ftp.leo.org/pub/comp/os/os2/leo/devtools/emx+gcc/,,
3673 ftp://ftp.leo.org/pub/comp/os/os2/leo/devtools/emx+gcc/}.
3674
3675 @html
3676 <hr />
3677 @end html
3678 @heading @anchor{older}Older systems
3679
3680 GCC contains support files for many older (1980s and early
3681 1990s) Unix variants.  For the most part, support for these systems
3682 has not been deliberately removed, but it has not been maintained for
3683 several years and may suffer from bitrot.
3684
3685 Starting with GCC 3.1, each release has a list of ``obsoleted'' systems.
3686 Support for these systems is still present in that release, but
3687 @command{configure} will fail unless the @option{--enable-obsolete}
3688 option is given.  Unless a maintainer steps forward, support for these
3689 systems will be removed from the next release of GCC@.
3690
3691 Support for old systems as hosts for GCC can cause problems if the
3692 workarounds for compiler, library and operating system bugs affect the
3693 cleanliness or maintainability of the rest of GCC@.  In some cases, to
3694 bring GCC up on such a system, if still possible with current GCC, may
3695 require first installing an old version of GCC which did work on that
3696 system, and using it to compile a more recent GCC, to avoid bugs in the
3697 vendor compiler.  Old releases of GCC 1 and GCC 2 are available in the
3698 @file{old-releases} directory on the @uref{../mirrors.html,,GCC mirror
3699 sites}.  Header bugs may generally be avoided using
3700 @command{fixincludes}, but bugs or deficiencies in libraries and the
3701 operating system may still cause problems.
3702
3703 Support for older systems as targets for cross-compilation is less
3704 problematic than support for them as hosts for GCC; if an enthusiast
3705 wishes to make such a target work again (including resurrecting any of
3706 the targets that never worked with GCC 2, starting from the last CVS
3707 version before they were removed), patches
3708 @uref{../contribute.html,,following the usual requirements} would be
3709 likely to be accepted, since they should not affect the support for more
3710 modern targets.
3711
3712 For some systems, old versions of GNU binutils may also be useful,
3713 and are available from @file{pub/binutils/old-releases} on
3714 @uref{http://sources.redhat.com/mirrors.html,,sources.redhat.com mirror sites}.
3715
3716 Some of the information on specific systems above relates to
3717 such older systems, but much of the information
3718 about GCC on such systems (which may no longer be applicable to
3719 current GCC) is to be found in the GCC texinfo manual.
3720
3721 @html
3722 <hr />
3723 @end html
3724 @heading @anchor{elf_targets}all ELF targets (SVR4, Solaris 2, etc.)
3725
3726 C++ support is significantly better on ELF targets if you use the
3727 @uref{./configure.html#with-gnu-ld,,GNU linker}; duplicate copies of
3728 inlines, vtables and template instantiations will be discarded
3729 automatically.
3730
3731
3732 @html
3733 <hr />
3734 <p>
3735 @end html
3736 @ifhtml
3737 @uref{./index.html,,Return to the GCC Installation page}
3738 @end ifhtml
3739 @end ifset
3740
3741 @c ***Old documentation******************************************************
3742 @ifset oldhtml
3743 @include install-old.texi
3744 @html
3745 <hr />
3746 <p>
3747 @end html
3748 @ifhtml
3749 @uref{./index.html,,Return to the GCC Installation page}
3750 @end ifhtml
3751 @end ifset
3752
3753 @c ***GFDL********************************************************************
3754 @ifset gfdlhtml
3755 @include fdl.texi
3756 @html
3757 <hr />
3758 <p>
3759 @end html
3760 @ifhtml
3761 @uref{./index.html,,Return to the GCC Installation page}
3762 @end ifhtml
3763 @end ifset
3764
3765 @c ***************************************************************************
3766 @c Part 6 The End of the Document
3767 @ifinfo
3768 @comment node-name,     next,          previous, up
3769 @node    Concept Index, , GNU Free Documentation License, Top
3770 @end ifinfo
3771
3772 @ifinfo
3773 @unnumbered Concept Index
3774
3775 @printindex cp
3776
3777 @contents
3778 @end ifinfo
3779 @bye