install.texi

GCC

@html
<hr>
<p>
@end html
@ifhtml
@uref{./index.html,,Return to the GCC Installation page}
@end ifhtml
@end ifset

@c ***Specific****************************************************************
@ifnothtml
@comment node-name,     next,          previous, up
@node    Specific, Concept Index, Binaries, Top
@end ifnothtml
@ifset specifichtml
@html
<h1 align="center">Host/target specific installation notes for GCC</h1>
@end html
@ifnothtml
@chapter Host/target specific installation notes for GCC
@end ifnothtml
@cindex Specific
@cindex Specific installation notes
@cindex Target specific installation
@cindex Host specific installation
@cindex Target specific installation notes

Please read this document carefully @emph{before} installing the
GNU Compiler Collection on your machine.

@ifhtml
@itemize
@item
@uref{#1750a-*-*,,1750a-*-*}
@item
@uref{#a29k,,a29k}
@item
@uref{#a29k-*-bsd,,a29k-*-bsd}
@item
@uref{#alpha*-*-*,,alpha*-*-*}
@item
@uref{#alpha*-dec-osf*,,alpha*-dec-osf*}
@item
@uref{#arc-*-elf,,arc-*-elf}
@item
@uref{#arm-*-aout,,arm-*-aout}
@item
@uref{#arm-*-elf,,arm-*-elf}
@item
@uref{#arm*-*-linux-gnu,,arm*-*-linux-gnu}
@item
@uref{#arm-*-riscix,,arm-*-riscix}
@item
@uref{#avr,,avr}
@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{#h8300-hms,,h8300-hms}
@item
@uref{#hppa*-hp-hpux*,,hppa*-hp-hpux*}
@item
@uref{#hppa*-hp-hpux9,,hppa*-hp-hpux9}
@item
@uref{#hppa*-hp-hpux10,,hppa*-hp-hpux10}
@item
@uref{#hppa*-hp-hpux11,,hppa*-hp-hpux11}
@item
@uref{#*-*-freebsd*,,*-*-freebsd*}
@item
@uref{#i370-*-*,,i370-*-*}
@item
@uref{#*-*-linux-gnu,,*-*-linux-gnu}
@item
@uref{#ix86-*-linux*oldld,,i?86-*-linux*oldld}
@item
@uref{#ix86-*-linux*aout,,i?86-*-linux*aout}
@item
@uref{#ix86-*-linux*,,i?86-*-linux*}
@item
@uref{#ix86-*-sco,,i?86-*-sco}
@item
@uref{#ix86-*-sco3.2v4,,i?86-*-sco3.2v4}
@item
@uref{#ix86-*-sco3.2v5*,,i?86-*-sco3.2v5*}
@item
@uref{#ix86-*-udk,,i?86-*-udk}
@item
@uref{#ix86-*-isc,,i?86-*-isc}
@item
@uref{#ix86-*-esix,,i?86-*-esix}
@item
@uref{#ix86-ibm-aix,,i?86-ibm-aix}
@item
@uref{#ix86-sequent-bsd,,i?86-sequent-bsd}
@item
@uref{#ix86-sequent-ptx1*,,i?86-sequent-ptx1*, i?86-sequent-ptx2*}
@item
@uref{#ix86-*-sysv3*,,i?86-*-sysv3*}
@item
@uref{#i860-intel-osf*,,i860-intel-osf*}
@item
@uref{#*-lynx-lynxos,,*-lynx-lynxos}
@item
@uref{#*-ibm-aix*,,*-ibm-aix*}
@item
@uref{#m32r-*-elf,,m32r-*-elf}
@item
@uref{#m68000-hp-bsd,,m68000-hp-bsd}
@item
@uref{#m6811-elf,,m6811-elf}
@item
@uref{#m6812-elf,,m6812-elf}
@item
@uref{#m68k-altos,,m68k-altos}
@item
@uref{#m68k-apple-aux,,m68k-apple-aux}
@item
@uref{#m68k-att-sysv,,m68k-att-sysv}
@item
@uref{#m68k-bull-sysv,,m68k-bull-sysv}
@item
@uref{#m68k-crds-unox,,m68k-crds-unox}
@item
@uref{#m68k-hp-hpux,,m68k-hp-hpux}
@item
@uref{#m68k-*-nextstep*,,m68k-*-nextstep*}
@item
@uref{#m68k-ncr-*,,m68k-ncr-*}
@item
@uref{#m68k-sun,,m68k-sun}
@item
@uref{#m68k-sun-sunos4.1.1,,m68k-sun-sunos4.1.1}
@item
@uref{#m88k-*-svr3,,m88k-*-svr3}
@item
@uref{#m88k-*-dgux,,m88k-*-dgux}
@item
@uref{#m88k-tektronix-sysv3,,m88k-tektronix-sysv3}
@item
@uref{#mips-*-*,,mips-*-*}
@item
@uref{#mips-mips-bsd,,mips-mips-bsd}
@item
@uref{#mips-mips-riscos*,,mips-mips-riscos*}
@item
@uref{#mips*-sgi-irix[45],,mips*-sgi-irix[45]}
@item
@uref{#mips*-sgi-irix6,,mips*-sgi-irix6}
@item
@uref{#mips-sony-sysv,,mips-sony-sysv}
@item
@uref{#ns32k-encore,,ns32k-encore}
@item
@uref{#ns32k-*-genix,,ns32k-*-genix}
@item
@uref{#ns32k-sequent,,ns32k-sequent}
@item
@uref{#ns32k-utek,,ns32k-utek}
@item
@uref{#powerpc-*-elf,,powerpc-*-elf, powerpc-*-sysv4}
@item
@uref{#powerpc-*-linux-gnu*,,powerpc-*-linux-gnu*}
@item
@uref{#powerpc-*-eabiaix,,powerpc-*-eabiaix}
@item
@uref{#powerpc-*-eabisim,,powerpc-*-eabisim}
@item
@uref{#powerpc-*-eabi,,powerpc-*-eabi}
@item
@uref{#powerpcle-*-elf,,powerpcle-*-elf, powerpcle-*-sysv4}
@item
@uref{#powerpcle-*-eabisim,,powerpcle-*-eabisim}
@item
@uref{#powerpcle-*-eabi,,powerpcle-*-eabi}
@item
@uref{#powerpcle-*-winnt,,powerpcle-*-winnt, powerpcle-*-pe}
@item
@uref{#romp-*-aos,,romp-*-aos, romp-*-mach}
@item
@uref{#*-*-solaris*,,*-*-solaris*}
@item
@uref{#sparc-sun-*,,sparc-sun-*}
@item
@uref{#sparc-sun-solaris*,,sparc-sun-solaris*}
@item
@uref{#sparc-sun-solaris2.7,,sparc-sun-solaris2.7}
@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}
@item
@uref{#sparc64-*-*,,sparc64-*-*}
@item
@uref{#*-*-sysv*,,*-*-sysv*}
@item
@uref{#vax-dec-ultrix,,vax-dec-ultrix}
@item
@uref{#we32k-*-*,,we32k-*-*}
@item
@uref{#windows,,Microsoft Windows}
@item
@uref{#os2,,OS/2}
@item
@uref{#older,,Older systems}
@end itemize

@itemize
@item
@uref{#elf_targets,,all ELF targets} (SVR4, Solaris, etc.)
@end itemize
@end ifhtml


@html
<!-- -------- host/target specific issues start here ---------------- -->
<hr>
@end html
@heading @anchor{1750a-*-*}1750a-*-*
MIL-STD-1750A processors.

The MIL-STD-1750A cross configuration produces output for
@code{as1750}, an assembler/linker available under the GNU 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.)

The @code{as1750} assembler requires the file @file{ms1750.inc}, which is
found in the directory @file{config/1750a}.

GNU CC produced the same sections as the Fairchild F9450 C Compiler,
namely:

@table @code
@item Normal
The program code section.

@item Static
The read/write (RAM) data section.

@item Konst
The read-only (ROM) constants section.

@item Init
Initialization section (code to copy KREL to SREL).
@end table

The smallest addressable unit is 16 bits (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
GNU CC.

@html
</p>
<hr>
@end html
@heading @anchor{a29k}a29k
AMD Am29k-family processors.  These are normally used in embedded
applications.  There are no standard Unix configurations.
This configuration
corresponds to AMD's standard calling sequence and binary interface
and is compatible with other 29k tools.

You may need to make a variant of the file @file{a29k.h} for your
particular configuration.

@html
</p>
<hr>
@end html
@heading @anchor{a29k-*-bsd}a29k-*-bsd
AMD Am29050 used in a system running a variant of BSD Unix.

@html
</p>
<hr>
@end html
@heading @anchor{alpha*-*-*}alpha*-*-*

This section contains general configuration information for all
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
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>
@end html
@heading @anchor{alpha*-dec-osf*}alpha*-dec-osf*
Systems using processors that implement the DEC Alpha architecture and
are running the DEC/Compaq Unix (DEC OSF/1, Digital UNIX, or Compaq
Tru64 UNIX) operating system, for example the DEC Alpha AXP systems.

In Tru64 UNIX V5.1, Compaq introduced a new assembler that does not
currently (2001-06-13) work with @command{mips-tfile}.  As a workaround,
we need to use the old assembler, invoked via the barely documented
@option{-oldas} option.  To bootstrap GCC, you either need to use the
Compaq C Compiler:

@example
   % CC=cc @var{srcdir}/configure [@var{target}] [@var{options}]
@end example

or you can use a copy of GCC 2.95.3 or higher built on Tru64 UNIX V4.0:

@example
   % CC=gcc -Wa,-oldas @var{srcdir}/configure [@var{target}] [@var{options}]
@end example

GNU CC writes a @samp{.verstamp} directive to the assembler output file
unless it is built as a cross-compiler.  It gets the version to use from
the system header file @file{/usr/include/stamp.h}.  If you install a
new version of DEC Unix, you should rebuild GCC to pick up the new version
stamp.

Note that since the Alpha is a 64-bit architecture, cross-compilers from
32-bit machines will not generate code as efficient as that generated
when the compiler is running on a 64-bit machine because many
optimizations that depend on being able to represent a word on the
target in an integral value on the host cannot be performed.  Building
cross-compilers on the Alpha for 32-bit machines has only been tested in
a few cases and may not work properly.

@code{make compare} may fail on old versions of DEC Unix unless you add
@option{-save-temps} to @code{CFLAGS}.  On these systems, the name of the
assembler input file is stored in the object file, and that makes
comparison fail if it differs between the @code{stage1} and
@code{stage2} compilations.  The option @option{-save-temps} forces a
fixed name to be used for the assembler input file, instead of a
randomly chosen name in @file{/tmp}.  Do not add @option{-save-temps}
unless the comparisons fail without that option.  If you add
@option{-save-temps}, you will have to manually delete the @samp{.i} and
@samp{.s} files after each series of compilations.

GNU CC now supports both the native (ECOFF) debugging format used by DBX
and GDB and an encapsulated STABS format for use only with GDB.  See the
discussion of the @option{--with-stabs} option of @file{configure} above