install.texi (Specific): Markup, spelling and typo fixes.

* doc/install.texi (Specific): Markup, spelling and typo fixes.
	Fixed sorting.
	Consistently require binutils 2.11.2, not prereleases.
	(Specific, decstation-*): Canonicalize as mips-dec-*.
	(Specific, i?86-*-sco3.2v5*): Remove make bootstrap requirement,
	always necessary.
	(Specific, m68k-altos): Removed reference to README.altos, deleted.
	(Specific, mips-*): Reword MIPS C compiler requirements.
	(Specific, powerpc*-*-*): New, mention --with-cpu once.
	(Specific, sunv5): Removed, obsolete.

From-SVN: r43779
This commit is contained in:
Rainer Orth 2001-07-05 13:10:59 +00:00 committed by Rainer Orth
parent aafdcfcd2b
commit 021c4bfd95
2 changed files with 168 additions and 213 deletions

View File

@ -1,3 +1,16 @@
2001-07-05 Rainer Orth <ro@TechFak.Uni-Bielefeld.DE>
* doc/install.texi (Specific): Markup, spelling and typo fixes.
Fixed sorting.
Consistently require binutils 2.11.2, not prereleases.
(Specific, decstation-*): Canonicalize as mips-dec-*.
(Specific, i?86-*-sco3.2v5*): Remove make bootstrap requirement,
always necessary.
(Specific, m68k-altos): Removed reference to README.altos, deleted.
(Specific, mips-*): Reword MIPS C compiler requirements.
(Specific, powerpc*-*-*): New, mention --with-cpu once.
(Specific, sunv5): Removed, obsolete.
2001-07-05 Nathan Sidwell <nathan@codesourcery.com>
* dwarf2out.c (output_loc_list): Use an all ones mask for

View File

@ -668,7 +668,7 @@ canadian cross build. The @option{--disable-nls} option disables NLS@.
@item --with-included-gettext
If NLS is enabled, the @option{--with-included-gettext} option causes the build
procedure to prefer its copy of GNU @code{gettext}.
procedure to prefer its copy of GNU @command{gettext}.
@item --with-catgets
If NLS is enabled, and if the host lacks @code{gettext} but has the
@ -1236,14 +1236,14 @@ GNU Compiler Collection on your machine.
@item
@uref{#c4x,,c4x}
@item
@uref{#decstation-*,,decstation-*}
@item
@uref{#dos,,DOS}
@item
@uref{#dsp16xx,,dsp16xx}
@item
@uref{#elxsi-elxsi-bsd,,elxsi-elxsi-bsd}
@item
@uref{#*-*-freebsd*,,*-*-freebsd*}
@item
@uref{#h8300-hms,,h8300-hms}
@item
@uref{#hppa*-hp-hpux*,,hppa*-hp-hpux*}
@ -1254,8 +1254,6 @@ GNU Compiler Collection on your machine.
@item
@uref{#hppa*-hp-hpux11,,hppa*-hp-hpux11}
@item
@uref{#*-*-freebsd*,,*-*-freebsd*}
@item
@uref{#i370-*-*,,i370-*-*}
@item
@uref{#*-*-linux-gnu,,*-*-linux-gnu}
@ -1328,6 +1326,8 @@ GNU Compiler Collection on your machine.
@item
@uref{#mips-*-*,,mips-*-*}
@item
@uref{#mips-dec-*,,mips-dec-*}
@item
@uref{#mips-mips-bsd,,mips-mips-bsd}
@item
@uref{#mips-mips-riscos*,,mips-mips-riscos*}
@ -1348,6 +1348,8 @@ GNU Compiler Collection on your machine.
@item
@uref{#ns32k-utek,,ns32k-utek}
@item
@uref{#powerpc*-*-*,,powerpc*-*-*, powerpc-*-sysv4}
@item
@uref{#powerpc-*-elf,,powerpc-*-elf, powerpc-*-sysv4}
@item
@uref{#powerpc-*-linux-gnu*,,powerpc-*-linux-gnu*}
@ -1378,8 +1380,6 @@ GNU Compiler Collection on your machine.
@item
@uref{#*-sun-solaris2.8,,*-sun-solaris2.8}
@item
@uref{#sunv5,,Sun V5.0 Compiler Bugs}
@item
@uref{#sparc-sun-sunos*,,sparc-sun-sunos*}
@item
@uref{#sparc-unknown-linux-gnulibc1,,sparc-unknown-linux-gnulibc1}
@ -1414,17 +1414,17 @@ GNU Compiler Collection on your machine.
MIL-STD-1750A processors.
The MIL-STD-1750A cross configuration produces output for
@code{as1750}, an assembler/linker available under the GNU Public
@code{as1750}, an assembler/linker available under the GNU General Public
License for the 1750A@. @code{as1750} can be obtained at
@uref{ftp://ftp.fta-berlin.de/pub/crossgcc/1750gals/}.
A similarly licensed simulator for
the 1750A is available from same address.
You should ignore a fatal error during the building of libgcc (libgcc is
not yet implemented for the 1750A@.)
You should ignore a fatal error during the building of @samp{libgcc}
(@samp{libgcc} is not yet implemented for the 1750A@.)
The @code{as1750} assembler requires the file @file{ms1750.inc}, which is
found in the directory @file{config/1750a}.
found in the directory @file{gcc/config/1750a}.
GCC produced the same sections as the Fairchild F9450 C Compiler,
namely:
@ -1443,7 +1443,7 @@ The read-only (ROM) constants section.
Initialization section (code to copy KREL to SREL)@.
@end table
The smallest addressable unit is 16 bits (BITS_PER_UNIT is 16). This
The smallest addressable unit is 16 bits (@code{BITS_PER_UNIT} is 16). This
means that type @code{char} is represented with a 16-bit word per character.
The 1750A's ``Load/Store Upper/Lower Byte'' instructions are not used by
GCC@.
@ -1480,28 +1480,11 @@ alpha-based platforms using ELF (in particular, ignore this section for
DEC OSF/1, Digital UNIX and Tru64 UNIX)@. In addition to reading this
section, please read all other sections that match your target.
We require binutils 2.11.1 (as of yet unreleased), binutils with
@samp{binutils-2_11-branch} tag after May 31, 2001 (as taken below), or newer.
Previous binutils releases had a number of problems with DWARF2
We require binutils 2.11.2 or newer.
Previous binutils releases had a number of problems with DWARF 2
debugging information, not the least of which is incorrect linking of
shared libraries.
Until binutils 2.11.1 is released, these sample commands may be useful:
@smallexample
mkdir binutils-2.11.X; cd binutils-2.11.X
cvs -d :pserver:anoncvs@@anoncvs.cygnus.com:/cvs/src \
co -rbinutils-2_11-branch -P binutils
mkdir obj; cd obj
../src/configure --prefix=@emph{an-absolute-path}
make all check install
@end smallexample
When configuring gcc, provide explicit @option{--with-gnu-as}
@option{--with-as=@emph{an-absolute-path/bin/as}} and
@option{--with-gnu-ld} @option{--with-ld=@emph{an-absolute-path/bin/ld}}
options to point into the prefix used above.
@html
</p>
<hr>
@ -1678,38 +1661,6 @@ can also be obtained from:
@uref{http://www.elec.canterbury.ac.nz/c4x,,http://www.elec.canterbury.ac.nz/c4x}
@end itemize
@html
</p>
<hr>
@end html
@heading @anchor{decstation-*}decstation-*
MIPS-based DECstations can support three different personalities:
Ultrix, DEC OSF/1, and OSF/rose. (Alpha-based DECstation products have
a configuration name beginning with @samp{alpha-dec}.) To configure GCC
for these platforms use the following configurations:
@table @samp
@item decstation-ultrix
Ultrix configuration.
@item decstation-osf1
Dec's version of OSF/1.
@item decstation-osfrose
Open Software Foundation reference port of OSF/1 which uses the
OSF/rose object file format instead of ECOFF@. Normally, you
would not select this configuration.
@end table
The MIPS C compiler needs to be told to increase its table size
for switch statements with the @option{-Wf,-XNg1500} option in
order to compile @file{cp/parse.c}. If you use the @option{-O2}
optimization option, you also need to use @option{-Olimit 3000}.
Both of these options are automatically generated in the
@file{Makefile} that the shell script @file{configure} builds.
If you override the @code{CC} make variable and use the MIPS
compilers, you may need to add @option{-Wf,-XNg1500 -Olimit 3000}.
@html
</p>
<hr>
@ -1730,6 +1681,37 @@ and includes all the necessary compilation tools and libraries.
@heading @anchor{dsp16xx}dsp16xx
A port to the AT&T DSP1610 family of processors.
@html
</p>
<hr>
@end html
@heading @anchor{*-*-freebsd*}*-*-freebsd*
The version of binutils installed in @file{/usr/bin} is known to work unless
otherwise specified in any per-architecture notes. However, binutils
2.11 is known to improve overall testsuite results.
For FreeBSD 1, FreeBSD 2 or any mutant a.out versions of FreeBSD 3: All
configuration support and files as shipped with GCC 2.95 are still in
place. FreeBSD 2.2.7 has been known to bootstrap completely; however,
it is unknown which version of binutils was used (it is assumed that it
was the system copy in @file{/usr/bin}) and C++ EH failures were noted.
For FreeBSD using the ELF file format: DWARF 2 debugging is now the
default for all CPU architectures. It had been the default on
FreeBSD/alpha since its inception. You may use @option{-gstabs} instead
of @option{-g}, if you really want the old debugging format. There are
no known issues with mixing object files and libraries with different
debugging formats. Otherwise, this release of GCC should now match more
of the configuration used in the stock FreeBSD configuration of GCC. In
particular, @option{--enable-threads} is now configured by default.
However, as a general user, do not attempt to replace the system
compiler with this release. Known to bootstrap and check with good
results on FreeBSD 3.0, 3.4, 4.0, 4.2, 4.3 and 5-CURRENT@.
At this time, @option{--enable-threads} is not compatible with
@option{--enable-libgcj} on FreeBSD@.
@html
</p>
<hr>
@ -1758,7 +1740,7 @@ longer a multiple of 2 bytes.
@end html
@heading @anchor{hppa*-hp-hpux*}hppa*-hp-hpux*
We @emph{highly} recommend using gas/binutils-2.8 or newer on all hppa
We @emph{highly} recommend using gas/binutils 2.8 or newer on all hppa
platforms; you may encounter a variety of problems when using the HP
assembler.
@ -1769,10 +1751,10 @@ use GAS and GDB and configure GCC with the
@option{--with-as=@dots{}} options.
If you wish to use pa-risc 2.0 architecture support, you must use either
the HP assembler, gas/binutils-2.11 or a recent
the HP assembler, gas/binutils 2.11 or a recent
@uref{ftp://sources.redhat.com/pub/binutils/snapshots,,snapshot of gas}.
More specific information to hppa*-hp-hpux* targets follows.
More specific information to @samp{hppa*-hp-hpux*} targets follows.
@html
</p>
@ -1832,37 +1814,6 @@ bootstrap}.
GCC 3.0 supports HP-UX 11. You must use GNU binutils 2.11 or above on
this platform.
@html
</p>
<hr>
@end html
@heading @anchor{*-*-freebsd*}*-*-freebsd*
The version of binutils installed in @file{/usr/bin} is known to work unless
otherwise specified in any per-architecture notes. However, binutils
2.11 is known to improve overall testsuite results.
For FreeBSD 1, FreeBSD 2 or any mutant a.out versions of FreeBSD 3: All
configuration support and files as shipped with gcc 2.95 are still in
place. FreeBSD 2.2.7 has been known to bootstrap completely; however,
it is unknown which version of binutils was used (it is assumed that it
was the system copy in @file{/usr/bin}) and C++ EH failures were noted.
For FreeBSD using the ELF file format: DWARF2 debugging is now the
default for all CPU architectures. It had been the default on
FreeBSD/alpha since its inception. You may use @option{-gstabs} instead
of @option{-g}, if you really want the old debugging format. There are
no known issues with mixing object files and libraries with different
debugging formats. Otherwise, this release of gcc should now match more
of the configuration used in the stock FreeBSD configuration of gcc. In
particular, @option{--enable-threads} is now configured by default.
However, as a general user, do not attempt to replace the system
compiler with this release. Known to bootstrap and check with good
results on FreeBSD 3.0, 3.4, 4.0, 4.2, 4.3 and 5-CURRENT@.
At this time, @option{--enable-threads} is not compatible with
@option{--enable-libgcj} on FreeBSD@.
@html
</p>
<hr>
@ -1878,7 +1829,7 @@ have a higher-quality port for this machine soon.
@heading @anchor{*-*-linux-gnu}*-*-linux-gnu
If you use glibc 2.2 (or 2.1.9x), GCC 2.95.2 won't install
out-of-the-box. You'll get compile errors while building libstdc++.
out-of-the-box. You'll get compile errors while building @samp{libstdc++}.
The patch @uref{glibc-2.2.patch,,glibc-2.2.patch}, that is to be
applied in the GCC source tree, fixes the compatibility problems.
@ -1923,7 +1874,7 @@ gas/binutils version 2.5.2 or later.
@end html
@heading @anchor{ix86-*-linux*}i?86-*-linux*
You will need binutils-2.9.1.0.15 or newer for exception handling to work.
You will need binutils 2.9.1.0.15 or newer for exception handling to work.
If you receive Signal 11 errors when building on GNU/Linux, then it is
possible you have a hardware problem. Further information on this can be
@ -1954,20 +1905,13 @@ Use this for the SCO OpenServer Release 5 family of operating systems.
Unlike earlier versions of GCC, the ability to generate COFF with this
target is no longer provided.
Earlier versions of GCC emitted Dwarf-1 when generating ELF to allow
Earlier versions of GCC emitted DWARF 1 when generating ELF to allow
the system debugger to be used. That support was too burdensome to
maintain. GCC now emits only dwarf-2 for this target. This means you
maintain. GCC now emits only DWARF 2 for this target. This means you
may use either the UDK debugger or GDB to debug programs built by this
version of GCC@.
If you are building languages other than C, you must follow the instructions
about invoking @samp{make bootstrap} because the native OpenServer
compiler will build a @command{cc1plus} that will not correctly parse many
valid C++ programs including those in @file{libgcc.a}.
@strong{You must do a @samp{make bootstrap} if you are building with the
native compiler.}
Use of the @option{-march-pentiumpro} flag can result in
Use of the @option{-march=pentiumpro} flag can result in
unrecognized opcodes when using the native assembler on OS versions before
5.0.6. (Support for P6 opcodes was added to the native ELF assembler in
that version.) While it's rather rare to see these emitted by GCC yet,
@ -1999,7 +1943,8 @@ Look in @file{gcc/config/i386/sco5.h} (search for ``messy'') for
additional OpenServer-specific flags.
Systems based on OpenServer before 5.0.4 (@samp{uname -X}
will tell you what you're running) require TLS597 from ftp.sco.com/TLS
will tell you what you're running) require TLS597 from
@uref{ftp://ftp.sco.com/TLS/,,ftp://ftp.sco.com/TLS/}
for C++ constructors and destructors to work right.
The system linker in (at least) 5.0.4 and 5.0.5 will sometimes
@ -2012,13 +1957,13 @@ available. You must install both
and @uref{ftp://ftp.sco.com/SLS/,,OSS499A}.
The dynamic linker in OpenServer 5.0.5 (earlier versions may show
the same problem) aborts on certain g77-compiled programs. It's particularly
the same problem) aborts on certain G77-compiled programs. It's particularly
likely to be triggered by building Fortran code with the @option{-fPIC} flag.
Although it's conceivable that the error could be triggered by other
code, only G77-compiled code has been observed to cause this abort.
If you are getting core dumps immediately upon execution of your
g77 program---and especially if it's compiled with @option{-fPIC}---try applying
@uref{sco_osr5_g77.patch,,@file{sco_osr5_g77.patch}} to your libf2c and
G77 program---and especially if it's compiled with @option{-fPIC}---try applying
@uref{sco_osr5_g77.patch,,@file{sco_osr5_g77.patch}} to your @samp{libf2c} and
rebuilding GCC@.
Affected faults, when analyzed in a debugger, will show a stack
backtrace with a fault occurring in @code{rtld()} and the program
@ -2041,10 +1986,6 @@ default compiler such as OpenServer 5 or Unixware 2. This target will
generate binaries that will run on OpenServer, Unixware 2, or Unixware 7,
with the same warnings and caveats as the SCO UDK@.
You can stage1 with either your native compiler or with UDK@. If you
don't do a full bootstrap when initially building with your native compiler
you will have an utterly unusable pile of bits as your reward.
This target is a little tricky to build because we have to distinguish
it from the native tools (so it gets headers, startups, and libraries
from the right place) while making the tools not think we're actually
@ -2057,8 +1998,8 @@ command like this:
@emph{You should substitute @samp{i686} in the above command with the appropriate
processor for your host.}
You should follow this with a @samp{make bootstrap} then
@samp{make install}. You can then access the UDK-targeted GCC
After the usual @samp{make bootstrap} and
@samp{make install}, you can then access the UDK-targeted GCC
tools by adding @command{udk-} before the commonly known name. For
example, to invoke the C compiler, you would use @command{udk-gcc}.
They will coexist peacefully with any native-target GCC tools you may
@ -2104,7 +2045,7 @@ Go to the Berkeley universe before compiling.
<hr>
@end html
@heading @anchor{ix86-sequent-ptx1*}i?86-sequent-ptx1*, i?86-sequent-ptx2*
You must install GNU @file{sed} before running @file{configure}.
You must install GNU @command{sed} before running @command{configure}.
@html
</p>
@ -2113,7 +2054,7 @@ You must install GNU @file{sed} before running @file{configure}.
@heading @anchor{#ix86-*-sysv3*}i?86-*-sysv3*
The @code{fixproto} shell script may trigger a bug in the system shell.
If you encounter this problem, upgrade your operating system or
use BASH (the GNU shell) to run @code{fixproto}.
use @command{bash} (the GNU shell) to run @code{fixproto}.
@html
@ -2182,7 +2123,7 @@ AIX Make frequently has problems with GCC makefiles. GNU Make 3.76 or
newer is recommended to build on this platform.
Errors involving @code{alloca} when building GCC generally are due
to an incorrect definition of @var{CC} in the Makefile or mixing files
to an incorrect definition of @code{CC} in the Makefile or mixing files
compiled with the native C compiler and GCC@. During the stage1 phase of
the build, the native AIX compiler @strong{must} be invoked as @command{cc}
(not @command{xlc}). Once @command{configure} has been informed of
@ -2196,8 +2137,8 @@ Binutils 2.10 does not support AIX 4.3. Binutils available from the
@uref{http://www-1.ibm.com/servers/aix/products/aixos/linux/,,AIX
Toolbox for Linux: GNU and Open Source tools for AIX};
website does work. Binutils 2.11 is expected to include AIX 4.3
support. The GNU Assembler is necessary for libstdc++ to build. The
AIX native ld still is recommended. The native AIX tools do
support. The GNU Assembler is necessary for @samp{libstdc++} to build. The
AIX native @command{ld} still is recommended. The native AIX tools do
interoperate with GCC@.
Linking executables and shared libraries may produce warnings of
@ -2290,7 +2231,7 @@ applications. There are no standard Unix configurations.
@end html
@heading @anchor{m68k-altos}m68k-altos
Altos 3068. You must use the GNU assembler, linker and debugger.
Also, you must fix a kernel bug. Details in the file @file{README.ALTOS}.
Also, you must fix a kernel bug.
@html
</p>
@ -2300,8 +2241,8 @@ Also, you must fix a kernel bug. Details in the file @file{README.ALTOS}.
Apple Macintosh running A/UX@.
You may configure GCC to use either the system assembler and
linker or the GNU assembler and linker. You should use the GNU configuration
if you can, especially if you also want to use G++. You enabled
that configuration with + the @option{--with-gnu-as} and @option{--with-gnu-ld}
if you can, especially if you also want to use G++. You enable
that configuration with the @option{--with-gnu-as} and @option{--with-gnu-ld}
options to @code{configure}.
Note the C compiler that comes
@ -2328,9 +2269,9 @@ bootstrap. Binaries are available from the OSU-CIS archive, at
@heading @anchor{m68k-bull-sysv}m68k-bull-sysv
Bull DPX/2 series 200 and 300 with BOS-2.00.45 up to BOS-2.01. GCC works
either with native assembler or GNU assembler. You can use
GNU assembler with native coff generation by providing @option{--with-gnu-as} to
the configure script or use GNU assembler with dbx-in-coff encapsulation
by providing @samp{--with-gnu-as --stabs}. For any problem with native
GNU assembler with native COFF generation by providing @option{--with-gnu-as} to
the configure script or use GNU assembler with stabs-in-COFF encapsulation
by providing @samp{--with-gnu-as --stabs}. For any problem with the native
assembler or for availability of the DPX/2 port of GAS, contact
@email{F.Pierresteguy@@frcl.bull.fr}.
@ -2408,7 +2349,7 @@ library version of ``cvtnum(3c)'' and thus does not exhibit the bug.
This patch is also known as PHCO_4484.
In addition, if you wish to use gas @option{--with-gnu-as} you must use
In addition, if you wish to use gas, you must use
gas version 2.1 or later, and you must use the GNU linker version 2.1 or
later. Earlier versions of gas relied upon a program which converted the
gas output into the native HP-UX format, but that program has not been
@ -2559,7 +2500,7 @@ configuration based on the current software development environment.
@heading @anchor{m88k-tektronix-sysv3}m88k-tektronix-sysv3
Tektronix XD88 running UTekV 3.2e. Do not turn on
optimization while building stage1 if you bootstrap with
the buggy Green Hills compiler. Also, The bundled LAI
the buggy Green Hills compiler. Also, the bundled LAI
System V NFS is buggy so if you build in an NFS mounted
directory, start from a fresh reboot, or avoid NFS all together.
Otherwise you may have trouble getting clean comparisons
@ -2608,9 +2549,41 @@ possible that some old versions of the system lack the functions
system lacks these, you must remove or undo the definition of
@code{TARGET_MEM_FUNCTIONS} in @file{mips-bsd.h}.
The MIPS C compiler needs to be told to increase its table size
for switch statements with the @option{-Wf,-XNg1500} option in
order to compile @file{cp/parse.c}. If you use the @option{-O2}
If you use the MIPS C compiler to bootstrap, it may be necessary
to increase its table size for switch statements with the
@option{-Wf,-XNg1500} option. If you use the @option{-O2}
optimization option, you also need to use @option{-Olimit 3000}.
Both of these options are automatically generated in the
@file{Makefile} that the shell script @file{configure} builds.
If you override the @code{CC} make variable and use the MIPS
compilers, you may need to add @option{-Wf,-XNg1500 -Olimit 3000}.
@html
</p>
<hr>
@end html
@heading @anchor{mips-dec-*}mips-dec-*
MIPS-based DECstations can support three different personalities:
Ultrix, DEC OSF/1, and OSF/rose. (Alpha-based DECstation products have
a configuration name beginning with @samp{alpha*-dec}.) To configure GCC
for these platforms use the following configurations:
@table @samp
@item mips-dec-ultrix
Ultrix configuration.
@item mips-dec-osf1
DEC's version of OSF/1.
@item mips-dec-osfrose
Open Software Foundation reference port of OSF/1 which uses the
OSF/rose object file format instead of ECOFF@. Normally, you
would not select this configuration.
@end table
If you use the MIPS C compiler to bootstrap, it may be necessary
to increase its table size for switch statements with the
@option{-Wf,-XNg1500} option. If you use the @option{-O2}
optimization option, you also need to use @option{-Olimit 3000}.
Both of these options are automatically generated in the
@file{Makefile} that the shell script @file{configure} builds.
@ -2622,9 +2595,9 @@ compilers, you may need to add @option{-Wf,-XNg1500 -Olimit 3000}.
<hr>
@end html
@heading @anchor{mips-mips-riscos*}mips-mips-riscos*
The MIPS C compiler needs to be told to increase its table size
for switch statements with the @option{-Wf,-XNg1500} option in
order to compile @file{cp/parse.c}. If you use the @option{-O2}
If you use the MIPS C compiler to bootstrap, it may be necessary
to increase its table size for switch statements with the
@option{-Wf,-XNg1500} option. If you use the @option{-O2}
optimization option, you also need to use @option{-Olimit 3000}.
Both of these options are automatically generated in the
@file{Makefile} that the shell script @file{configure} builds.
@ -2637,21 +2610,21 @@ personalities: default, BSD 4.3, System V.3, and System V.4
for these platforms use the following configurations:
@table @samp
@item mips-mips-riscos@code{rev}
Default configuration for RISC-OS, revision @code{rev}.
@item mips-mips-riscos@var{rev}
Default configuration for RISC-OS, revision @var{rev}.
@item mips-mips-riscos@code{rev}bsd
BSD 4.3 configuration for RISC-OS, revision @code{rev}.
@item mips-mips-riscos@var{rev}bsd
BSD 4.3 configuration for RISC-OS, revision @var{rev}.
@item mips-mips-riscos@code{rev}sysv4
System V.4 configuration for RISC-OS, revision @code{rev}.
@item mips-mips-riscos@var{rev}sysv4
System V.4 configuration for RISC-OS, revision @var{rev}.
@html
</p>
<hr>
@end html
@item mips-mips-riscos@code{rev}sysv
System V.3 configuration for RISC-OS, revision @code{rev}.
@item mips-mips-riscos@var{rev}sysv
System V.3 configuration for RISC-OS, revision @var{rev}.
@end table
The revision @code{rev} mentioned above is the revision of
@ -2861,12 +2834,18 @@ binaries of GCC for bootstrapping.
</p>
<hr>
@end html
@heading @anchor{powerpc-*-elf}powerpc-*-elf, powerpc-*-sysv4
PowerPC system in big endian mode, running System V.4.
@heading @anchor{powerpc*-*-*}powerpc-*-*
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@end html
@heading @anchor{powerpc-*-elf}powerpc-*-elf, powerpc-*-sysv4
PowerPC system in big endian mode, running System V.4.
@html
</p>
<hr>
@ -2874,13 +2853,10 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@heading @anchor{powerpc-*-linux-gnu*}powerpc-*-linux-gnu*
You will need
@uref{ftp://ftp.varesearch.com/pub/support/hjl/binutils,,binutils-2.9.4.0.8}
@uref{ftp://ftp.varesearch.com/pub/support/hjl/binutils,,binutils 2.9.4.0.8}
or newer for a working GCC@. It is strongly recommended to recompile binutils
if you initially built it with gcc-2.7.2.x.
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@ -2889,9 +2865,6 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
Embedded PowerPC system in big endian mode with @option{-mcall-aix} selected as
the default.
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@ -2900,9 +2873,6 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
Embedded PowerPC system in big endian mode for use in running under the
PSIM simulator.
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@ -2910,9 +2880,6 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@heading @anchor{powerpc-*-eabi}powerpc-*-eabi
Embedded PowerPC system in big endian mode.
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@ -2920,9 +2887,6 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@heading @anchor{powerpcle-*-elf}powerpcle-*-elf, powerpcle-*-sysv4
PowerPC system in little endian mode, running System V.4.
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@ -2938,9 +2902,6 @@ the PSIM simulator.
@heading @anchor{powerpcle-*-eabi}powerpcle-*-eabi
Embedded PowerPC system in little endian mode.
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@ -2948,9 +2909,6 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@heading @anchor{powerpcle-*-winnt}powerpcle-*-winnt, powerpcle-*-pe
PowerPC system in little endian mode running Windows NT@.
You can specify a default version for the @option{-mcpu=@var{cpu_type}}
switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
@html
</p>
<hr>
@ -2959,7 +2917,7 @@ switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
The only operating systems supported for the IBM RT PC are AOS and
MACH@. GCC does not support AIX running on the RT@. We recommend you
compile GCC with an earlier version of itself; if you compile GCC
with @code{hc}, the Metaware compiler, it will work, but you will get
with @command{hc}, the Metaware compiler, it will work, but you will get
mismatches between the stage 2 and stage 3 compilers in various files.
These errors are minor differences in some floating-point constants and
can be safely ignored; the stage 3 compiler is correct.
@ -2970,18 +2928,18 @@ can be safely ignored; the stage 3 compiler is correct.
@end html
@heading @anchor{*-*-solaris*}*-*-solaris*
Starting with Solaris, Sun does not ship a C compiler any more. To
Starting with Solaris 2, Sun does not ship a C compiler any more. To
bootstrap and install GCC you first have to install a pre-built
compiler, see our @uref{binaries.html,,binaries page} for
details.
Solaris' @file{/bin/sh} will often fail to configure libstdc++-v3, boehm-gc or
libjava. If you encounter this problem, set @var{CONFIG_SHELL} to
Solaris' @file{/bin/sh} will often fail to configure @file{libstdc++-v3}, @file{boehm-gc} or
@file{libjava}. If you encounter this problem, set @env{CONFIG_SHELL} to
@file{/bin/ksh} in your environment and run @samp{make bootstrap} again.
Another possibility that sometimes helps is to remove
@file{*-*-solaris*/config.cache}.
Sun as 4.X is broken in that it cannot cope with long symbol names.
Sun @command{as} 4.X is broken in that it cannot cope with long symbol names.
A typical error message might look similar to the following:
@samp{/usr/ccs/bin/as: "/var/tmp/ccMsw135.s", line 11041:
@ -2996,10 +2954,10 @@ been fixed in later (5.x) versions of the assembler.
@end html
@heading @anchor{sparc-sun-*}sparc-sun-*
Sometimes on a Sun 4 you may observe a crash in the program
@code{genflags} or @code{genoutput} while building GCC@. This is said to
be due to a bug in @code{sh}. You can probably get around it by running
@code{genflags} or @code{genoutput} manually and then retrying the
@code{make}.
@command{genflags} or @command{genoutput} while building GCC@. This is said to
be due to a bug in @command{sh}. You can probably get around it by running
@command{genflags} or @command{genoutput} manually and then retrying the
@command{make}.
@html
<p>
@ -3036,14 +2994,14 @@ On Solaris 2, trying to use the linker and other tools in
For example, the linker may hang indefinitely. The fix is to remove
@file{/usr/ucb} from your @code{PATH}.
All releases of GNU binutils prior to 2.11.1 have known bugs on this
platform. We recommend the use of GNU binutils 2.11.1 or the vendor
tools (Sun as, Sun ld).
All releases of GNU binutils prior to 2.11.2 have known bugs on this
platform. We recommend the use of GNU binutils 2.11.2 or the vendor
tools (Sun @command{as}, Sun @command{ld}).
Unfortunately, C++ shared libraries, including libstdc++, won't work
properly if assembled with Sun as: the linker will complain about
Unfortunately, C++ shared libraries, including @samp{libstdc++}, won't work
properly if assembled with Sun @command{as}: the linker will complain about
relocations in read-only sections, in the definition of virtual
tables. Also, Sun as fails to process long symbols resulting from
tables. Also, Sun @command{as} fails to process long symbols resulting from
mangling template-heavy C++ function names.
@html
@ -3070,7 +3028,7 @@ back it out.
@item
Copy the original, unpatched Solaris 7
@command{/usr/ccs/bin/as} into
@command{/usr/local/lib/gcc-lib/sparc-sun-solaris2.7/2.95.1/as},
@command{/usr/local/lib/gcc-lib/sparc-sun-solaris2.7/3.0/as},
adjusting the latter name to fit your local conventions and software
version numbers.
@ -3105,10 +3063,10 @@ will assume that any missing type is @code{int} (as defined by C89).
For Solaris 8, this is fixed by revision 24 or later of patch 108652
(for SPARCs) or 108653 (for Intels).
Solaris 8's linker fails to link some libjava programs if
Solaris 8's linker fails to link some @samp{libjava} programs if
previously-installed GCC java libraries already exist in the configured
prefix. For this reason, libgcj is disabled by default on Solaris 8.
If you use GNU ld, or if you don't have a previously-installed libgcj in
prefix. For this reason, @samp{libgcj} is disabled by default on Solaris 8.
If you use GNU ld, or if you don't have a previously-installed @samp{libgcj} in
the same prefix, use @option{--enable-libgcj} to build and install the
Java libraries.
@ -3116,25 +3074,14 @@ Java libraries.
<p>
<hr>
@end html
@heading @anchor{sunv5}Sun V5.0 Compiler Bugs
The Sun V5.0 compilers are known to mis-compile GCC 2.95 and GCC 2.95.1,
which in turn causes GCC to fail its bootstrap comparison test.
GCC 2.95.2 has a workaround.
@html
</p>
<hr>
@end html
@heading @anchor{sparc-sun-sunos*}sparc-sun-sunos*
A bug in the SunOS4 linker will cause it to crash when linking
A bug in the SunOS 4 linker will cause it to crash when linking
@option{-fPIC} compiled objects (and will therefore not allow you to build
shared libraries).
To fix this problem you can either use the most recent version of
binutils or get the latest SunOS4 linker patch (patch ID 100170-10)
binutils or get the latest SunOS 4 linker patch (patch ID 100170-10)
from Sun's patch site.
@ -3145,7 +3092,7 @@ from Sun's patch site.
@heading @anchor{sparc-unknown-linux-gnulibc1}sparc-unknown-linux-gnulibc1
It has been reported that you might need
@uref{ftp://ftp.yggdrasil.com/private/hjl,,binutils-2.8.1.0.23}
@uref{ftp://ftp.yggdrasil.com/private/hjl,,binutils 2.8.1.0.23}
for this platform, too.
@ -3159,7 +3106,7 @@ GCC version 2.95 is not able to compile code correctly for
@code{sparc64} targets. Users of the Linux kernel, at least,
can use the @code{sparc32} program to start up a new shell
invocation with an environment that causes @command{configure} to
recognize (via @samp{uname -a}) the system as @var{sparc-*-*} instead.
recognize (via @samp{uname -a}) the system as @samp{sparc-*-*} instead.
@html
@ -3175,7 +3122,7 @@ ld fatal: failed to write symbol name @var{something}
in strings table for file @var{whatever}
@end smallexample
This probably indicates that the disk is full or your ULIMIT won't allow
This probably indicates that the disk is full or your ulimit won't allow
the file to be as large as it needs to be.
This problem can also result because the kernel parameter @code{MAXUMEM}
@ -3191,7 +3138,7 @@ On System V, if you get an error like this,
@end example
@noindent
that too indicates a problem with disk space, ULIMIT, or @code{MAXUMEM}.
that too indicates a problem with disk space, ulimit, or @code{MAXUMEM}.
On a System V release 4 system, make sure @file{/usr/bin} precedes
@file{/usr/ucb} in @code{PATH}. The @code{cc} command in
@ -3205,11 +3152,6 @@ On a System V release 4 system, make sure @file{/usr/bin} precedes
Don't try compiling with Vax C (@code{vcc}). It produces incorrect code
in some cases (for example, when @code{alloca} is used).
Meanwhile, compiling @file{cp/parse.c} with pcc does not work because of
an internal table size limitation in that compiler. To avoid this
problem, compile just the GNU C compiler first, and use it to recompile
building all the languages that you want to run.
@html
</p>
<hr>
@ -3304,13 +3246,13 @@ bring GCC up on such a system, if still possible with current GCC, may
require first installing an old version of GCC which did work on that
system, and using it to compile a more recent GCC, to avoid bugs in
the vendor compiler. Old releases of GCC 1 and GCC 2 are available in
the old-releases directory on the
the @file{old-releases} directory on the
@uref{../mirrors.html,,GCC mirror sites}. Header bugs may generally
be avoided using @command{fixincludes}, but bugs or deficiencies in
libraries and the operating system may still cause problems.
For some systems, old versions of GNU binutils may also be useful,
and are available from pub/binutils/old-releases on
and are available from @file{pub/binutils/old-releases} on
@uref{http://sources.redhat.com/mirrors.html,,sources.redhat.com mirror sites}.
Some of the information on specific systems above relates to