2017-04-10 11:32:00 +00:00
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
|
|
|
<html>
|
|
|
|
|
<!-- Copyright (C) 1988-2016 Free Software Foundation, Inc.
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
2012-03-27 23:13:14 +00:00
|
|
|
under the terms of the GNU Free Documentation License, Version 1.3 or
|
|
|
|
|
any later version published by the Free Software Foundation; with no
|
|
|
|
|
Invariant Sections, the Front-Cover texts being (a) (see below), and
|
|
|
|
|
with the Back-Cover Texts being (b) (see below). A copy of the
|
2017-04-10 11:32:00 +00:00
|
|
|
license is included in the section entitled "GNU
|
|
|
|
|
Free Documentation License".
|
2012-03-27 23:13:14 +00:00
|
|
|
|
|
|
|
|
(a) The FSF's Front-Cover Text is:
|
|
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
A GNU Manual
|
2012-03-27 23:13:14 +00:00
|
|
|
|
|
|
|
|
(b) The FSF's Back-Cover Text is:
|
|
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
You have freedom to copy and modify this GNU Manual, like GNU
|
2012-03-27 23:13:14 +00:00
|
|
|
software. Copies published by the Free Software Foundation raise
|
2017-04-10 11:32:00 +00:00
|
|
|
funds for GNU development. -->
|
|
|
|
|
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
|
|
|
|
|
<head>
|
|
|
|
|
<title>Installing GCC</title>
|
|
|
|
|
|
|
|
|
|
<meta name="description" content="Installing GCC">
|
|
|
|
|
<meta name="keywords" content="Installing GCC">
|
|
|
|
|
<meta name="resource-type" content="document">
|
|
|
|
|
<meta name="distribution" content="global">
|
|
|
|
|
<meta name="Generator" content="makeinfo">
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
|
|
|
<style type="text/css">
|
|
|
|
|
<!--
|
|
|
|
|
a.summary-letter {text-decoration: none}
|
|
|
|
|
blockquote.indentedblock {margin-right: 0em}
|
|
|
|
|
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
|
|
|
|
|
blockquote.smallquotation {font-size: smaller}
|
|
|
|
|
div.display {margin-left: 3.2em}
|
|
|
|
|
div.example {margin-left: 3.2em}
|
|
|
|
|
div.lisp {margin-left: 3.2em}
|
|
|
|
|
div.smalldisplay {margin-left: 3.2em}
|
|
|
|
|
div.smallexample {margin-left: 3.2em}
|
|
|
|
|
div.smalllisp {margin-left: 3.2em}
|
|
|
|
|
kbd {font-style: oblique}
|
|
|
|
|
pre.display {font-family: inherit}
|
|
|
|
|
pre.format {font-family: inherit}
|
|
|
|
|
pre.menu-comment {font-family: serif}
|
|
|
|
|
pre.menu-preformatted {font-family: serif}
|
|
|
|
|
pre.smalldisplay {font-family: inherit; font-size: smaller}
|
|
|
|
|
pre.smallexample {font-size: smaller}
|
|
|
|
|
pre.smallformat {font-family: inherit; font-size: smaller}
|
|
|
|
|
pre.smalllisp {font-size: smaller}
|
|
|
|
|
span.nolinebreak {white-space: nowrap}
|
|
|
|
|
span.roman {font-family: initial; font-weight: normal}
|
|
|
|
|
span.sansserif {font-family: sans-serif; font-weight: normal}
|
|
|
|
|
ul.no-bullet {list-style: none}
|
|
|
|
|
-->
|
|
|
|
|
</style>
|
|
|
|
|
|
|
|
|
|
|
2012-03-27 23:13:14 +00:00
|
|
|
</head>
|
2017-04-10 11:32:00 +00:00
|
|
|
|
|
|
|
|
<body lang="en">
|
|
|
|
|
<h1 class="settitle" align="center">Installing GCC</h1>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2014-09-21 17:33:12 +00:00
|
|
|
<h1 align="center">Old installation documentation</h1>
|
2015-08-28 15:33:40 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>Note most of this information is out of date and superseded by the
|
2012-03-27 23:13:14 +00:00
|
|
|
previous chapters of this manual. It is provided for historical
|
|
|
|
|
reference only, because of a lack of volunteers to merge it into the
|
|
|
|
|
main manual.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>Here is the procedure for installing GCC on a GNU or Unix system.
|
|
|
|
|
</p>
|
|
|
|
|
<ol>
|
|
|
|
|
<li> If you have chosen a configuration for GCC which requires other GNU
|
2012-03-27 23:13:14 +00:00
|
|
|
tools (such as GAS or the GNU linker) instead of the standard system
|
|
|
|
|
tools, install the required tools in the build directory under the names
|
2017-04-10 11:32:00 +00:00
|
|
|
<samp>as</samp>, <samp>ld</samp> or whatever is appropriate.
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>Alternatively, you can do subsequent compilation using a value of the
|
2012-03-27 23:13:14 +00:00
|
|
|
<code>PATH</code> environment variable such that the necessary GNU tools come
|
|
|
|
|
before the standard system tools.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
</li><li> Specify the host, build and target machine configurations. You do this
|
|
|
|
|
when you run the <samp>configure</samp> script.
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>The <em>build</em> machine is the system which you are using, the
|
|
|
|
|
<em>host</em> machine is the system where you want to run the resulting
|
|
|
|
|
compiler (normally the build machine), and the <em>target</em> machine is
|
2012-03-27 23:13:14 +00:00
|
|
|
the system for which you want the compiler to generate code.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>If you are building a compiler to produce code for the machine it runs
|
2012-03-27 23:13:14 +00:00
|
|
|
on (a native compiler), you normally do not need to specify any operands
|
2017-04-10 11:32:00 +00:00
|
|
|
to <samp>configure</samp>; it will try to guess the type of machine you are on
|
|
|
|
|
and use that as the build, host and target machines. So you don’t need
|
2012-03-27 23:13:14 +00:00
|
|
|
to specify a configuration when building a native compiler unless
|
2017-04-10 11:32:00 +00:00
|
|
|
<samp>configure</samp> cannot figure out what your configuration is or guesses
|
2012-03-27 23:13:14 +00:00
|
|
|
wrong.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>In those cases, specify the build machine’s <em>configuration name</em>
|
|
|
|
|
with the <samp>--host</samp> option; the host and target will default to be
|
2012-03-27 23:13:14 +00:00
|
|
|
the same as the host machine.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>Here is an example:
|
|
|
|
|
</p>
|
|
|
|
|
<div class="smallexample">
|
|
|
|
|
<pre class="smallexample">./configure --host=sparc-sun-sunos4.1
|
|
|
|
|
</pre></div>
|
|
|
|
|
|
|
|
|
|
<p>A configuration name may be canonical or it may be more or less
|
2012-03-27 23:13:14 +00:00
|
|
|
abbreviated.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>A canonical configuration name has three parts, separated by dashes.
|
|
|
|
|
It looks like this: ‘<samp><var>cpu</var>-<var>company</var>-<var>system</var></samp>’.
|
|
|
|
|
(The three parts may themselves contain dashes; <samp>configure</samp>
|
2012-03-27 23:13:14 +00:00
|
|
|
can figure out which dashes serve which purpose.) For example,
|
2017-04-10 11:32:00 +00:00
|
|
|
‘<samp>m68k-sun-sunos4.1</samp>’ specifies a Sun 3.
|
|
|
|
|
</p>
|
|
|
|
|
<p>You can also replace parts of the configuration by nicknames or aliases.
|
|
|
|
|
For example, ‘<samp>sun3</samp>’ stands for ‘<samp>m68k-sun</samp>’, so
|
|
|
|
|
‘<samp>sun3-sunos4.1</samp>’ is another way to specify a Sun 3.
|
|
|
|
|
</p>
|
|
|
|
|
<p>You can specify a version number after any of the system types, and some
|
2012-03-27 23:13:14 +00:00
|
|
|
of the CPU types. In most cases, the version is irrelevant, and will be
|
|
|
|
|
ignored. So you might as well specify the version if you know it.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>See <a href="#Configurations">Configurations</a>, for a list of supported configuration names and
|
2012-03-27 23:13:14 +00:00
|
|
|
notes on many of the configurations. You should check the notes in that
|
|
|
|
|
section before proceeding any further with the installation of GCC.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
</li></ol>
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<h2><a name="Configurations"></a>Configurations Supported by GCC</h2>
|
|
|
|
|
<a name="index-configurations-supported-by-GCC"></a>
|
2015-08-28 15:33:40 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>Here are the possible CPU types:
|
|
|
|
|
</p>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>1750a, a29k, alpha, arm, avr, c<var>n</var>, clipper, dsp16xx, elxsi, fr30, h8300,
|
2012-03-27 23:13:14 +00:00
|
|
|
hppa1.0, hppa1.1, i370, i386, i486, i586, i686, i786, i860, i960, ip2k, m32r,
|
|
|
|
|
m68000, m68k, m88k, mcore, mips, mipsel, mips64, mips64el,
|
|
|
|
|
mn10200, mn10300, ns32k, pdp11, powerpc, powerpcle, romp, rs6000, sh, sparc,
|
2017-04-10 11:32:00 +00:00
|
|
|
sparclite, sparc64, v850, vax, we32k.
|
|
|
|
|
</p></blockquote>
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>Here are the recognized company names. As you can see, customary
|
2012-03-27 23:13:14 +00:00
|
|
|
abbreviations are used rather than the longer official names.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>acorn, alliant, altos, apollo, apple, att, bull,
|
2012-03-27 23:13:14 +00:00
|
|
|
cbm, convergent, convex, crds, dec, dg, dolphin,
|
|
|
|
|
elxsi, encore, harris, hitachi, hp, ibm, intergraph, isi,
|
|
|
|
|
mips, motorola, ncr, next, ns, omron, plexus,
|
2017-04-10 11:32:00 +00:00
|
|
|
sequent, sgi, sony, sun, tti, unicom, wrs.
|
|
|
|
|
</p></blockquote>
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>The company name is meaningful only to disambiguate when the rest of
|
2012-03-27 23:13:14 +00:00
|
|
|
the information supplied is insufficient. You can omit it, writing
|
2017-04-10 11:32:00 +00:00
|
|
|
just ‘<samp><var>cpu</var>-<var>system</var></samp>’, if it is not needed. For example,
|
|
|
|
|
‘<samp>vax-ultrix4.2</samp>’ is equivalent to ‘<samp>vax-dec-ultrix4.2</samp>’.
|
|
|
|
|
</p>
|
|
|
|
|
<p>Here is a list of system types:
|
|
|
|
|
</p>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>386bsd, aix, acis, amigaos, aos, aout, aux, bosx, bsd, clix, coff, ctix, cxux,
|
2012-03-27 23:13:14 +00:00
|
|
|
dgux, dynix, ebmon, ecoff, elf, esix, freebsd, hms, genix, gnu, linux,
|
|
|
|
|
linux-gnu, hiux, hpux, iris, irix, isc, luna, lynxos, mach, minix, msdos, mvs,
|
|
|
|
|
netbsd, newsos, nindy, ns, osf, osfrose, ptx, riscix, riscos, rtu, sco, sim,
|
|
|
|
|
solaris, sunos, sym, sysv, udi, ultrix, unicos, uniplus, unos, vms, vsta,
|
2017-04-10 11:32:00 +00:00
|
|
|
vxworks, winnt, xenix.
|
|
|
|
|
</p></blockquote>
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>You can omit the system type; then <samp>configure</samp> guesses the
|
2012-03-27 23:13:14 +00:00
|
|
|
operating system from the CPU and company.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>You can add a version number to the system type; this may or may not
|
|
|
|
|
make a difference. For example, you can write ‘<samp>bsd4.3</samp>’ or
|
|
|
|
|
‘<samp>bsd4.4</samp>’ to distinguish versions of BSD. In practice, the version
|
|
|
|
|
number is most needed for ‘<samp>sysv3</samp>’ and ‘<samp>sysv4</samp>’, which are often
|
2012-03-27 23:13:14 +00:00
|
|
|
treated differently.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>‘<samp>linux-gnu</samp>’ is the canonical name for the GNU/Linux target; however
|
|
|
|
|
GCC will also accept ‘<samp>linux</samp>’. The version of the kernel in use is
|
|
|
|
|
not relevant on these systems. A suffix such as ‘<samp>libc1</samp>’ or ‘<samp>aout</samp>’
|
2012-03-27 23:13:14 +00:00
|
|
|
distinguishes major versions of the C library; all of the suffixed versions
|
|
|
|
|
are obsolete.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>If you specify an impossible combination such as ‘<samp>i860-dg-vms</samp>’,
|
|
|
|
|
then you may get an error message from <samp>configure</samp>, or it may
|
|
|
|
|
ignore part of the information and do the best it can with the rest.
|
|
|
|
|
<samp>configure</samp> always prints the canonical name for the alternative
|
2012-03-27 23:13:14 +00:00
|
|
|
that it used. GCC does not support all possible alternatives.
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<p>Often a particular model of machine has a name. Many machine names are
|
2012-03-27 23:13:14 +00:00
|
|
|
recognized as aliases for CPU/company combinations. Thus, the machine
|
2017-04-10 11:32:00 +00:00
|
|
|
name ‘<samp>sun3</samp>’, mentioned above, is an alias for ‘<samp>m68k-sun</samp>’.
|
2012-03-27 23:13:14 +00:00
|
|
|
Sometimes we accept a company name as a machine name, when the name is
|
|
|
|
|
popularly used for a particular machine. Here is a table of the known
|
|
|
|
|
machine names:
|
2017-04-10 11:32:00 +00:00
|
|
|
</p>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>3300, 3b1, 3b<var>n</var>, 7300, altos3068, altos,
|
2012-03-27 23:13:14 +00:00
|
|
|
apollo68, att-7300, balance,
|
|
|
|
|
convex-c<var>n</var>, crds, decstation-3100,
|
|
|
|
|
decstation, delta, encore,
|
|
|
|
|
fx2800, gmicro, hp7<var>nn</var>, hp8<var>nn</var>,
|
|
|
|
|
hp9k2<var>nn</var>, hp9k3<var>nn</var>, hp9k7<var>nn</var>,
|
|
|
|
|
hp9k8<var>nn</var>, iris4d, iris, isi68,
|
|
|
|
|
m3230, magnum, merlin, miniframe,
|
|
|
|
|
mmax, news-3600, news800, news, next,
|
|
|
|
|
pbd, pc532, pmax, powerpc, powerpcle, ps2, risc-news,
|
|
|
|
|
rtpc, sun2, sun386i, sun386, sun3,
|
2017-04-10 11:32:00 +00:00
|
|
|
sun4, symmetry, tower-32, tower.
|
|
|
|
|
</p></blockquote>
|
2012-03-27 23:13:14 +00:00
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>Remember that a machine name specifies both the cpu type and the company
|
|
|
|
|
name.
|
2012-03-27 23:13:14 +00:00
|
|
|
<hr />
|
2017-04-10 11:32:00 +00:00
|
|
|
<p>
|
|
|
|
|
<a href="./index.html">Return to the GCC Installation page</a>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2012-03-27 23:13:14 +00:00
|
|
|
|
|
|
|
|
|
2017-04-10 11:32:00 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
