| 1 |
13 |
jlechner |
<html lang="en">
|
| 2 |
|
|
<head>
|
| 3 |
|
|
<title>Prerequisites for GCC</title>
|
| 4 |
|
|
<meta http-equiv="Content-Type" content="text/html">
|
| 5 |
|
|
<meta name="description" content="Prerequisites for GCC">
|
| 6 |
|
|
<meta name="generator" content="makeinfo 4.8">
|
| 7 |
|
|
<link title="Top" rel="top" href="#Top">
|
| 8 |
|
|
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
| 9 |
|
|
<!--
|
| 10 |
|
|
Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
|
| 11 |
|
|
1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
|
| 12 |
|
|
|
| 13 |
|
|
Permission is granted to copy, distribute and/or modify this document
|
| 14 |
|
|
under the terms of the GNU Free Documentation License, Version 1.2 or
|
| 15 |
|
|
any later version published by the Free Software Foundation; with no
|
| 16 |
|
|
Invariant Sections, the Front-Cover texts being (a) (see below), and
|
| 17 |
|
|
with the Back-Cover Texts being (b) (see below). A copy of the
|
| 18 |
|
|
license is included in the section entitled "GNU Free Documentation License".
|
| 19 |
|
|
|
| 20 |
|
|
(a) The FSF's Front-Cover Text is:
|
| 21 |
|
|
|
| 22 |
|
|
A GNU Manual
|
| 23 |
|
|
|
| 24 |
|
|
(b) The FSF's Back-Cover Text is:
|
| 25 |
|
|
|
| 26 |
|
|
You have freedom to copy and modify this GNU Manual, like GNU
|
| 27 |
|
|
software. Copies published by the Free Software Foundation raise
|
| 28 |
|
|
funds for GNU development.-->
|
| 29 |
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
| 30 |
|
|
<style type="text/css"><!--
|
| 31 |
|
|
pre.display { font-family:inherit }
|
| 32 |
|
|
pre.format { font-family:inherit }
|
| 33 |
|
|
pre.smalldisplay { font-family:inherit; font-size:smaller }
|
| 34 |
|
|
pre.smallformat { font-family:inherit; font-size:smaller }
|
| 35 |
|
|
pre.smallexample { font-size:smaller }
|
| 36 |
|
|
pre.smalllisp { font-size:smaller }
|
| 37 |
|
|
span.sc { font-variant:small-caps }
|
| 38 |
|
|
span.roman { font-family:serif; font-weight:normal; }
|
| 39 |
|
|
span.sansserif { font-family:sans-serif; font-weight:normal; }
|
| 40 |
|
|
--></style>
|
| 41 |
|
|
</head>
|
| 42 |
|
|
<body>
|
| 43 |
|
|
<h1 class="settitle">Prerequisites for GCC</h1>
|
| 44 |
|
|
<a name="index-Prerequisites-1"></a>
|
| 45 |
|
|
GCC requires that various tools and packages be available for use in the
|
| 46 |
|
|
build procedure. Modifying GCC sources requires additional tools
|
| 47 |
|
|
described below.
|
| 48 |
|
|
|
| 49 |
|
|
<h3 class="heading"><a name="TOC0"></a>Tools/packages necessary for building GCC</h3>
|
| 50 |
|
|
|
| 51 |
|
|
<dl>
|
| 52 |
|
|
<dt>ISO C90 compiler<dd>Necessary to bootstrap GCC, although versions of GCC prior
|
| 53 |
|
|
to 3.4 also allow bootstrapping with a traditional (K&R) C compiler.
|
| 54 |
|
|
|
| 55 |
|
|
<p>To build all languages in a cross-compiler or other configuration where
|
| 56 |
|
|
3-stage bootstrap is not performed, you need to start with an existing
|
| 57 |
|
|
GCC binary (version 2.95 or later) because source code for language
|
| 58 |
|
|
frontends other than C might use GCC extensions.
|
| 59 |
|
|
|
| 60 |
|
|
<br><dt>GNAT<dd>
|
| 61 |
|
|
In order to build the Ada compiler (GNAT) you must already have GNAT
|
| 62 |
|
|
installed because portions of the Ada frontend are written in Ada (with
|
| 63 |
|
|
GNAT extensions.) Refer to the Ada installation instructions for more
|
| 64 |
|
|
specific information.
|
| 65 |
|
|
|
| 66 |
|
|
<br><dt>A “working” POSIX compatible shell, or GNU bash<dd>
|
| 67 |
|
|
Necessary when running <samp><span class="command">configure</span></samp> because some
|
| 68 |
|
|
<samp><span class="command">/bin/sh</span></samp> shells have bugs and may crash when configuring the
|
| 69 |
|
|
target libraries. In other cases, <samp><span class="command">/bin/sh</span></samp> or <samp><span class="command">ksh</span></samp>
|
| 70 |
|
|
have disastrous corner-case performance problems. This
|
| 71 |
|
|
can cause target <samp><span class="command">configure</span></samp> runs to literally take days to
|
| 72 |
|
|
complete in some cases.
|
| 73 |
|
|
|
| 74 |
|
|
<p>So on some platforms <samp><span class="command">/bin/ksh</span></samp> is sufficient, on others it
|
| 75 |
|
|
isn't. See the host/target specific instructions for your platform, or
|
| 76 |
|
|
use <samp><span class="command">bash</span></samp> to be sure. Then set <samp><span class="env">CONFIG_SHELL</span></samp> in your
|
| 77 |
|
|
environment to your “good” shell prior to running
|
| 78 |
|
|
<samp><span class="command">configure</span></samp>/<samp><span class="command">make</span></samp>.
|
| 79 |
|
|
|
| 80 |
|
|
<p><samp><span class="command">zsh</span></samp> is not a fully compliant POSIX shell and will not
|
| 81 |
|
|
work when configuring GCC.
|
| 82 |
|
|
|
| 83 |
|
|
<br><dt>GNU binutils<dd>
|
| 84 |
|
|
Necessary in some circumstances, optional in others. See the
|
| 85 |
|
|
host/target specific instructions for your platform for the exact
|
| 86 |
|
|
requirements.
|
| 87 |
|
|
|
| 88 |
|
|
<br><dt>gzip version 1.2.4 (or later) or<dt>bzip2 version 1.0.2 (or later)<dd>
|
| 89 |
|
|
Necessary to uncompress GCC <samp><span class="command">tar</span></samp> files when source code is
|
| 90 |
|
|
obtained via FTP mirror sites.
|
| 91 |
|
|
|
| 92 |
|
|
<br><dt>GNU make version 3.79.1 (or later)<dd>
|
| 93 |
|
|
You must have GNU make installed to build GCC.
|
| 94 |
|
|
|
| 95 |
|
|
<br><dt>GNU tar version 1.14 (or later)<dd>
|
| 96 |
|
|
Necessary (only on some platforms) to untar the source code. Many
|
| 97 |
|
|
systems' <samp><span class="command">tar</span></samp> programs will also work, only try GNU
|
| 98 |
|
|
<samp><span class="command">tar</span></samp> if you have problems.
|
| 99 |
|
|
|
| 100 |
|
|
<br><dt>GNU Multiple Precision Library (GMP) version 4.0 (or later)<dd>
|
| 101 |
|
|
Necessary to build the Fortran frontend. If you don't have it
|
| 102 |
|
|
installed in your library search path, you will have to configure with
|
| 103 |
|
|
the <samp><span class="option">--with-gmp</span></samp> or <samp><span class="option">--with-gmp-dir</span></samp> configure option.
|
| 104 |
|
|
|
| 105 |
|
|
<br><dt>MPFR Library<dd>
|
| 106 |
|
|
Necessary to build the Fortran frontend. It can be downloaded from
|
| 107 |
|
|
<a href="http://www.mpfr.org/">http://www.mpfr.org/</a>. It is also included in the current GMP
|
| 108 |
|
|
release (4.1.3) when configured with <samp><span class="option">--enable-mpfr</span></samp>.
|
| 109 |
|
|
|
| 110 |
|
|
<p>The <samp><span class="option">--with-mpfr</span></samp> or <samp><span class="option">--with-mpfr-dir</span></samp> configure option should
|
| 111 |
|
|
be used if your MPFR Library is not installed in your library search path.
|
| 112 |
|
|
|
| 113 |
|
|
</dl>
|
| 114 |
|
|
|
| 115 |
|
|
<h3 class="heading"><a name="TOC1"></a>Tools/packages necessary for modifying GCC</h3>
|
| 116 |
|
|
|
| 117 |
|
|
<dl>
|
| 118 |
|
|
<dt>autoconf versions 2.13 and 2.59<dt>GNU m4 version 1.4 (or later)<dd>
|
| 119 |
|
|
Necessary when modifying <samp><span class="file">configure.ac</span></samp>, <samp><span class="file">aclocal.m4</span></samp>, etc.
|
| 120 |
|
|
to regenerate <samp><span class="file">configure</span></samp> and <samp><span class="file">config.in</span></samp> files. Most
|
| 121 |
|
|
directories require autoconf 2.59 (exactly), but the toplevel
|
| 122 |
|
|
still requires autoconf 2.13 (exactly).
|
| 123 |
|
|
|
| 124 |
|
|
<br><dt>automake versions 1.9.3<dd>
|
| 125 |
|
|
Necessary when modifying a <samp><span class="file">Makefile.am</span></samp> file to regenerate its
|
| 126 |
|
|
associated <samp><span class="file">Makefile.in</span></samp>.
|
| 127 |
|
|
|
| 128 |
|
|
<p>Much of GCC does not use automake, so directly edit the <samp><span class="file">Makefile.in</span></samp>
|
| 129 |
|
|
file. Specifically this applies to the <samp><span class="file">gcc</span></samp>, <samp><span class="file">intl</span></samp>,
|
| 130 |
|
|
<samp><span class="file">libcpp</span></samp>, <samp><span class="file">libiberty</span></samp>, <samp><span class="file">libobjc</span></samp> directories as well
|
| 131 |
|
|
as any of their subdirectories.
|
| 132 |
|
|
|
| 133 |
|
|
<p>For directories that use automake, GCC requires the latest release in
|
| 134 |
|
|
the 1.9.x series, which is currently 1.9.3. When regenerating a directory
|
| 135 |
|
|
to a newer version, please update all the directories using an older 1.9.x
|
| 136 |
|
|
to the latest released version.
|
| 137 |
|
|
|
| 138 |
|
|
<br><dt>gettext version 0.14.5 (or later)<dd>
|
| 139 |
|
|
Needed to regenerate <samp><span class="file">gcc.pot</span></samp>.
|
| 140 |
|
|
|
| 141 |
|
|
<br><dt>gperf version 2.7.2 (or later)<dd>
|
| 142 |
|
|
Necessary when modifying <samp><span class="command">gperf</span></samp> input files, e.g.
|
| 143 |
|
|
<samp><span class="file">gcc/cp/cfns.gperf</span></samp> to regenerate its associated header file, e.g.
|
| 144 |
|
|
<samp><span class="file">gcc/cp/cfns.h</span></samp>.
|
| 145 |
|
|
|
| 146 |
|
|
<br><dt>DejaGnu 1.4.4<dt>Expect<dt>Tcl<dd>
|
| 147 |
|
|
Necessary to run the GCC testsuite; see the section on testing for details.
|
| 148 |
|
|
|
| 149 |
|
|
<br><dt>autogen version 5.5.4 (or later) and<dt>guile version 1.4.1 (or later)<dd>
|
| 150 |
|
|
Necessary to regenerate <samp><span class="file">fixinc/fixincl.x</span></samp> from
|
| 151 |
|
|
<samp><span class="file">fixinc/inclhack.def</span></samp> and <samp><span class="file">fixinc/*.tpl</span></samp>.
|
| 152 |
|
|
|
| 153 |
|
|
<p>Necessary to run `<samp><span class="samp">make check</span></samp>' for <samp><span class="file">fixinc</span></samp>.
|
| 154 |
|
|
|
| 155 |
|
|
<p>Necessary to regenerate the top level <samp><span class="file">Makefile.in</span></samp> file from
|
| 156 |
|
|
<samp><span class="file">Makefile.tpl</span></samp> and <samp><span class="file">Makefile.def</span></samp>.
|
| 157 |
|
|
|
| 158 |
|
|
<br><dt>GNU Bison version 1.28 (or later)<dd>Berkeley <samp><span class="command">yacc</span></samp> (<samp><span class="command">byacc</span></samp>) is also reported to work other
|
| 159 |
|
|
than for GCJ.
|
| 160 |
|
|
|
| 161 |
|
|
<p>Necessary when modifying <samp><span class="file">*.y</span></samp> files.
|
| 162 |
|
|
|
| 163 |
|
|
<p>Necessary to build GCC during development because the generated output
|
| 164 |
|
|
files are not included in the SVN repository. They are included in
|
| 165 |
|
|
releases.
|
| 166 |
|
|
|
| 167 |
|
|
<br><dt>Flex version 2.5.4 (or later)<dd>
|
| 168 |
|
|
Necessary when modifying <samp><span class="file">*.l</span></samp> files.
|
| 169 |
|
|
|
| 170 |
|
|
<p>Necessary to build GCC during development because the generated output
|
| 171 |
|
|
files are not included in the SVN repository. They are included in
|
| 172 |
|
|
releases.
|
| 173 |
|
|
|
| 174 |
|
|
<br><dt>Texinfo version 4.2 (or later)<dd>
|
| 175 |
|
|
Necessary for running <samp><span class="command">makeinfo</span></samp> when modifying <samp><span class="file">*.texi</span></samp>
|
| 176 |
|
|
files to test your changes.
|
| 177 |
|
|
|
| 178 |
|
|
<p>Necessary to build GCC documentation during development because the
|
| 179 |
|
|
generated output files are not included in the SVN repository. They are
|
| 180 |
|
|
included in releases.
|
| 181 |
|
|
|
| 182 |
|
|
<br><dt>TeX (any working version)<dd>
|
| 183 |
|
|
Necessary for running <samp><span class="command">texi2dvi</span></samp>, used when running
|
| 184 |
|
|
<samp><span class="command">make dvi</span></samp> to create DVI files.
|
| 185 |
|
|
|
| 186 |
|
|
<br><dt>SVN (any version)<dt>SSH (any version)<dd>
|
| 187 |
|
|
Necessary to access the SVN repository. Public releases and weekly
|
| 188 |
|
|
snapshots of the development sources are also available via FTP.
|
| 189 |
|
|
|
| 190 |
|
|
<br><dt>Perl version 5.6.1 (or later)<dd>
|
| 191 |
|
|
Necessary when regenerating <samp><span class="file">Makefile</span></samp> dependencies in libiberty.
|
| 192 |
|
|
Necessary when regenerating <samp><span class="file">libiberty/functions.texi</span></samp>.
|
| 193 |
|
|
Necessary when generating manpages from Texinfo manuals.
|
| 194 |
|
|
Necessary when targetting Darwin, building libstdc++,
|
| 195 |
|
|
and not using <samp><span class="option">--disable-symvers</span></samp>.
|
| 196 |
|
|
Used by various scripts to generate some files included in SVN (mainly
|
| 197 |
|
|
Unicode-related and rarely changing) from source tables.
|
| 198 |
|
|
|
| 199 |
|
|
<br><dt>GNU diffutils version 2.7 (or later)<dd>
|
| 200 |
|
|
Useful when submitting patches for the GCC source code.
|
| 201 |
|
|
|
| 202 |
|
|
<br><dt>patch version 2.5.4 (or later)<dd>
|
| 203 |
|
|
Necessary when applying patches, created with <samp><span class="command">diff</span></samp>, to one's
|
| 204 |
|
|
own sources.
|
| 205 |
|
|
|
| 206 |
|
|
</dl>
|
| 207 |
|
|
|
| 208 |
|
|
<p><hr />
|
| 209 |
|
|
<p><a href="./index.html">Return to the GCC Installation page</a>
|
| 210 |
|
|
|
| 211 |
|
|
<!-- ***Downloading the source************************************************** -->
|
| 212 |
|
|
<!-- ***Configuration*********************************************************** -->
|
| 213 |
|
|
<!-- ***Building**************************************************************** -->
|
| 214 |
|
|
<!-- ***Testing***************************************************************** -->
|
| 215 |
|
|
<!-- ***Final install*********************************************************** -->
|
| 216 |
|
|
<!-- ***Binaries**************************************************************** -->
|
| 217 |
|
|
<!-- ***Specific**************************************************************** -->
|
| 218 |
|
|
<!-- ***Old documentation****************************************************** -->
|
| 219 |
|
|
<!-- ***GFDL******************************************************************** -->
|
| 220 |
|
|
<!-- *************************************************************************** -->
|
| 221 |
|
|
<!-- Part 6 The End of the Document -->
|
| 222 |
|
|
</body></html>
|
| 223 |
|
|
|
