OSDN Git Service

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