INSTALL/old.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <!-- Copyright (C) 1988-2013 Free Software Foundation, Inc.
   4
   5 Permission is granted to copy, distribute and/or modify this document
   6 under the terms of the GNU Free Documentation License, Version 1.3 or
   7 any later version published by the Free Software Foundation; with no
   8 Invariant Sections, the Front-Cover texts being (a) (see below), and
   9 with the Back-Cover Texts being (b) (see below).  A copy of the
  10 license is included in the section entitled "GNU
  11 Free Documentation License".
  12
  13 (a) The FSF's Front-Cover Text is:
  14
  15 A GNU Manual
  16
  17 (b) The FSF's Back-Cover Text is:
  18
  19 You have freedom to copy and modify this GNU Manual, like GNU
  20      software.  Copies published by the Free Software Foundation raise
  21      funds for GNU development. -->
  22 <!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
  23 <head>
  24 <title>Installing GCC</title>
  25
  26 <meta name="description" content="Installing GCC">
  27 <meta name="keywords" content="Installing GCC">
  28 <meta name="resource-type" content="document">
  29 <meta name="distribution" content="global">
  30 <meta name="Generator" content="makeinfo">
  31 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  32 <style type="text/css">
  33 <!--
  34 a.summary-letter {text-decoration: none}
  35 blockquote.smallquotation {font-size: smaller}
  36 div.display {margin-left: 3.2em}
  37 div.example {margin-left: 3.2em}
  38 div.indentedblock {margin-left: 3.2em}
  39 div.lisp {margin-left: 3.2em}
  40 div.smalldisplay {margin-left: 3.2em}
  41 div.smallexample {margin-left: 3.2em}
  42 div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  43 div.smalllisp {margin-left: 3.2em}
  44 kbd {font-style:oblique}
  45 pre.display {font-family: inherit}
  46 pre.format {font-family: inherit}
  47 pre.menu-comment {font-family: serif}
  48 pre.menu-preformatted {font-family: serif}
  49 pre.smalldisplay {font-family: inherit; font-size: smaller}
  50 pre.smallexample {font-size: smaller}
  51 pre.smallformat {font-family: inherit; font-size: smaller}
  52 pre.smalllisp {font-size: smaller}
  53 span.nocodebreak {white-space:nowrap}
  54 span.nolinebreak {white-space:nowrap}
  55 span.roman {font-family:serif; font-weight:normal}
  56 span.sansserif {font-family:sans-serif; font-weight:normal}
  57 ul.no-bullet {list-style: none}
  58 -->
  59 </style>
  60
  61
  62 </head>
  63
  64 <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  65 <h1 class="settitle" align="center">Installing GCC</h1>
  66
  67
  68
  69
  70
  71
  72
  73
  74
  75
  76
  77
  78
  79
  80
  81
  82
  83
  84
  85
  86
  87
  88
  89
  90
  91
  92 <h1 align="center">Old installation documentation</h1>
  93 <p>Note most of this information is out of date and superseded by the
  94 previous chapters of this manual.  It is provided for historical
  95 reference only, because of a lack of volunteers to merge it into the
  96 main manual.
  97 </p>
  98
  99 <p>Here is the procedure for installing GCC on a GNU or Unix system.
 100 </p>
 101 <ol>
 102 <li> If you have chosen a configuration for GCC which requires other GNU
 103 tools (such as GAS or the GNU linker) instead of the standard system
 104 tools, install the required tools in the build directory under the names
 105 <samp>as</samp>, <samp>ld</samp> or whatever is appropriate.
 106
 107 <p>Alternatively, you can do subsequent compilation using a value of the
 108 <code>PATH</code> environment variable such that the necessary GNU tools come
 109 before the standard system tools.
 110 </p>
 111 </li><li> Specify the host, build and target machine configurations.  You do this
 112 when you run the <samp>configure</samp> script.
 113
 114 <p>The <em>build</em> machine is the system which you are using, the
 115 <em>host</em> machine is the system where you want to run the resulting
 116 compiler (normally the build machine), and the <em>target</em> machine is
 117 the system for which you want the compiler to generate code.
 118 </p>
 119 <p>If you are building a compiler to produce code for the machine it runs
 120 on (a native compiler), you normally do not need to specify any operands
 121 to <samp>configure</samp>; it will try to guess the type of machine you are on
 122 and use that as the build, host and target machines.  So you don&rsquo;t need
 123 to specify a configuration when building a native compiler unless
 124 <samp>configure</samp> cannot figure out what your configuration is or guesses
 125 wrong.
 126 </p>
 127 <p>In those cases, specify the build machine&rsquo;s <em>configuration name</em>
 128 with the <samp>--host</samp> option; the host and target will default to be
 129 the same as the host machine.
 130 </p>
 131 <p>Here is an example:
 132 </p>
 133 <div class="smallexample">
 134 <pre class="smallexample">./configure --host=sparc-sun-sunos4.1
 135 </pre></div>
 136
 137 <p>A configuration name may be canonical or it may be more or less
 138 abbreviated.
 139 </p>
 140 <p>A canonical configuration name has three parts, separated by dashes.
 141 It looks like this: &lsquo;<samp><var>cpu</var>-<var>company</var>-<var>system</var></samp>&rsquo;.
 142 (The three parts may themselves contain dashes; <samp>configure</samp>
 143 can figure out which dashes serve which purpose.)  For example,
 144 &lsquo;<samp>m68k-sun-sunos4.1</samp>&rsquo; specifies a Sun 3.
 145 </p>
 146 <p>You can also replace parts of the configuration by nicknames or aliases.
 147 For example, &lsquo;<samp>sun3</samp>&rsquo; stands for &lsquo;<samp>m68k-sun</samp>&rsquo;, so
 148 &lsquo;<samp>sun3-sunos4.1</samp>&rsquo; is another way to specify a Sun 3.
 149 </p>
 150 <p>You can specify a version number after any of the system types, and some
 151 of the CPU types.  In most cases, the version is irrelevant, and will be
 152 ignored.  So you might as well specify the version if you know it.
 153 </p>
 154 <p>See <a href="#Configurations">Configurations</a>, for a list of supported configuration names and
 155 notes on many of the configurations.  You should check the notes in that
 156 section before proceeding any further with the installation of GCC.
 157 </p>
 158 </li></ol>
 159
 160 <h2><a name="Configurations"></a>Configurations Supported by GCC</h2><a name="index-configurations-supported-by-GCC"></a>
 161
 162 <p>Here are the possible CPU types:
 163 </p>
 164 <blockquote>
 165 <p>1750a, a29k, alpha, arm, avr, c<var>n</var>, clipper, dsp16xx, elxsi, fr30, h8300,
 166 hppa1.0, hppa1.1, i370, i386, i486, i586, i686, i786, i860, i960, ip2k, m32r,
 167 m68000, m68k, m88k, mcore, mips, mipsel, mips64, mips64el,
 168 mn10200, mn10300, ns32k, pdp11, powerpc, powerpcle, romp, rs6000, sh, sparc,
 169 sparclite, sparc64, v850, vax, we32k.
 170 </p></blockquote>
 171
 172 <p>Here are the recognized company names.  As you can see, customary
 173 abbreviations are used rather than the longer official names.
 174 </p>
 175 <blockquote>
 176 <p>acorn, alliant, altos, apollo, apple, att, bull,
 177 cbm, convergent, convex, crds, dec, dg, dolphin,
 178 elxsi, encore, harris, hitachi, hp, ibm, intergraph, isi,
 179 mips, motorola, ncr, next, ns, omron, plexus,
 180 sequent, sgi, sony, sun, tti, unicom, wrs.
 181 </p></blockquote>
 182
 183 <p>The company name is meaningful only to disambiguate when the rest of
 184 the information supplied is insufficient.  You can omit it, writing
 185 just &lsquo;<samp><var>cpu</var>-<var>system</var></samp>&rsquo;, if it is not needed.  For example,
 186 &lsquo;<samp>vax-ultrix4.2</samp>&rsquo; is equivalent to &lsquo;<samp>vax-dec-ultrix4.2</samp>&rsquo;.
 187 </p>
 188 <p>Here is a list of system types:
 189 </p>
 190 <blockquote>
 191 <p>386bsd, aix, acis, amigaos, aos, aout, aux, bosx, bsd, clix, coff, ctix, cxux,
 192 dgux, dynix, ebmon, ecoff, elf, esix, freebsd, hms, genix, gnu, linux,
 193 linux-gnu, hiux, hpux, iris, irix, isc, luna, lynxos, mach, minix, msdos, mvs,
 194 netbsd, newsos, nindy, ns, osf, osfrose, ptx, riscix, riscos, rtu, sco, sim,
 195 solaris, sunos, sym, sysv, udi, ultrix, unicos, uniplus, unos, vms, vsta,
 196 vxworks, winnt, xenix.
 197 </p></blockquote>
 198
 199 <p>You can omit the system type; then <samp>configure</samp> guesses the
 200 operating system from the CPU and company.
 201 </p>
 202 <p>You can add a version number to the system type; this may or may not
 203 make a difference.  For example, you can write &lsquo;<samp>bsd4.3</samp>&rsquo; or
 204 &lsquo;<samp>bsd4.4</samp>&rsquo; to distinguish versions of BSD.  In practice, the version
 205 number is most needed for &lsquo;<samp>sysv3</samp>&rsquo; and &lsquo;<samp>sysv4</samp>&rsquo;, which are often
 206 treated differently.
 207 </p>
 208 <p>&lsquo;<samp>linux-gnu</samp>&rsquo; is the canonical name for the GNU/Linux target; however
 209 GCC will also accept &lsquo;<samp>linux</samp>&rsquo;.  The version of the kernel in use is
 210 not relevant on these systems.  A suffix such as &lsquo;<samp>libc1</samp>&rsquo; or &lsquo;<samp>aout</samp>&rsquo;
 211 distinguishes major versions of the C library; all of the suffixed versions
 212 are obsolete.
 213 </p>
 214 <p>If you specify an impossible combination such as &lsquo;<samp>i860-dg-vms</samp>&rsquo;,
 215 then you may get an error message from <samp>configure</samp>, or it may
 216 ignore part of the information and do the best it can with the rest.
 217 <samp>configure</samp> always prints the canonical name for the alternative
 218 that it used.  GCC does not support all possible alternatives.
 219 </p>
 220 <p>Often a particular model of machine has a name.  Many machine names are
 221 recognized as aliases for CPU/company combinations.  Thus, the machine
 222 name &lsquo;<samp>sun3</samp>&rsquo;, mentioned above, is an alias for &lsquo;<samp>m68k-sun</samp>&rsquo;.
 223 Sometimes we accept a company name as a machine name, when the name is
 224 popularly used for a particular machine.  Here is a table of the known
 225 machine names:
 226 </p>
 227 <blockquote>
 228 <p>3300, 3b1, 3b<var>n</var>, 7300, altos3068, altos,
 229 apollo68, att-7300, balance,
 230 convex-c<var>n</var>, crds, decstation-3100,
 231 decstation, delta, encore,
 232 fx2800, gmicro, hp7<var>nn</var>, hp8<var>nn</var>,
 233 hp9k2<var>nn</var>, hp9k3<var>nn</var>, hp9k7<var>nn</var>,
 234 hp9k8<var>nn</var>, iris4d, iris, isi68,
 235 m3230, magnum, merlin, miniframe,
 236 mmax, news-3600, news800, news, next,
 237 pbd, pc532, pmax, powerpc, powerpcle, ps2, risc-news,
 238 rtpc, sun2, sun386i, sun386, sun3,
 239 sun4, symmetry, tower-32, tower.
 240 </p></blockquote>
 241
 242 <p>Remember that a machine name specifies both the cpu type and the company
 243 name.
 244 <hr />
 245 <p><a href="./index.html">Return to the GCC Installation page</a>
 246 </p>
 247
 248
 249
 250
 251
 252 </body>
 253 </html>