0
|
1 <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.12">
|
|
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,
|
|
11 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
|
|
12 2008 Free Software Foundation, Inc.
|
|
13
|
|
14 Permission is granted to copy, distribute and/or modify this document
|
|
15 under the terms of the GNU Free Documentation License, Version 1.2 or
|
|
16 any later version published by the Free Software Foundation; with no
|
|
17 Invariant Sections, the Front-Cover texts being (a) (see below), and
|
|
18 with the Back-Cover Texts being (b) (see below). A copy of the
|
|
19 license is included in the section entitled "GNU Free Documentation License".
|
|
20
|
|
21 (a) The FSF's Front-Cover Text is:
|
|
22
|
|
23 A GNU Manual
|
|
24
|
|
25 (b) The FSF's Back-Cover Text is:
|
|
26
|
|
27 You have freedom to copy and modify this GNU Manual, like GNU
|
|
28 software. Copies published by the Free Software Foundation raise
|
|
29 funds for GNU development.-->
|
|
30 <meta http-equiv="Content-Style-Type" content="text/css">
|
|
31 <style type="text/css"><!--
|
|
32 pre.display { font-family:inherit }
|
|
33 pre.format { font-family:inherit }
|
|
34 pre.smalldisplay { font-family:inherit; font-size:smaller }
|
|
35 pre.smallformat { font-family:inherit; font-size:smaller }
|
|
36 pre.smallexample { font-size:smaller }
|
|
37 pre.smalllisp { font-size:smaller }
|
|
38 span.sc { font-variant:small-caps }
|
|
39 span.roman { font-family:serif; font-weight:normal; }
|
|
40 span.sansserif { font-family:sans-serif; font-weight:normal; }
|
|
41 --></style>
|
|
42 </head>
|
|
43 <body>
|
|
44 <h1 class="settitle">Prerequisites for GCC</h1>
|
|
45 <a name="index-Prerequisites-1"></a>
|
|
46 GCC requires that various tools and packages be available for use in the
|
|
47 build procedure. Modifying GCC sources requires additional tools
|
|
48 described below.
|
|
49
|
|
50 <h3 class="heading"><a name="TOC0"></a>Tools/packages necessary for building GCC</h3>
|
|
51
|
|
52 <dl>
|
|
53 <dt>ISO C90 compiler<dd>Necessary to bootstrap GCC, although versions of GCC prior
|
|
54 to 3.4 also allow bootstrapping with a traditional (K&R) C compiler.
|
|
55
|
|
56 <p>To build all languages in a cross-compiler or other configuration where
|
|
57 3-stage bootstrap is not performed, you need to start with an existing
|
|
58 GCC binary (version 2.95 or later) because source code for language
|
|
59 frontends other than C might use GCC extensions.
|
|
60
|
|
61 <br><dt>GNAT<dd>
|
|
62 In order to build the Ada compiler (GNAT) you must already have GNAT
|
|
63 installed because portions of the Ada frontend are written in Ada (with
|
|
64 GNAT extensions.) Refer to the Ada installation instructions for more
|
|
65 specific information.
|
|
66
|
|
67 <br><dt>A “working” POSIX compatible shell, or GNU bash<dd>
|
|
68 Necessary when running <samp><span class="command">configure</span></samp> because some
|
|
69 <samp><span class="command">/bin/sh</span></samp> shells have bugs and may crash when configuring the
|
|
70 target libraries. In other cases, <samp><span class="command">/bin/sh</span></samp> or <samp><span class="command">ksh</span></samp>
|
|
71 have disastrous corner-case performance problems. This
|
|
72 can cause target <samp><span class="command">configure</span></samp> runs to literally take days to
|
|
73 complete in some cases.
|
|
74
|
|
75 <p>So on some platforms <samp><span class="command">/bin/ksh</span></samp> is sufficient, on others it
|
|
76 isn't. See the host/target specific instructions for your platform, or
|
|
77 use <samp><span class="command">bash</span></samp> to be sure. Then set <samp><span class="env">CONFIG_SHELL</span></samp> in your
|
|
78 environment to your “good” shell prior to running
|
|
79 <samp><span class="command">configure</span></samp>/<samp><span class="command">make</span></samp>.
|
|
80
|
|
81 <p><samp><span class="command">zsh</span></samp> is not a fully compliant POSIX shell and will not
|
|
82 work when configuring GCC.
|
|
83
|
|
84 <br><dt>A POSIX or SVR4 awk<dd>
|
|
85 Necessary for creating some of the generated source files for GCC.
|
|
86 If in doubt, use a recent GNU awk version, as some of the older ones
|
|
87 are broken. GNU awk version 3.1.5 is known to work.
|
|
88
|
|
89 <br><dt>GNU binutils<dd>
|
|
90 Necessary in some circumstances, optional in others. See the
|
|
91 host/target specific instructions for your platform for the exact
|
|
92 requirements.
|
|
93
|
|
94 <br><dt>gzip version 1.2.4 (or later) or<dt>bzip2 version 1.0.2 (or later)<dd>
|
|
95 Necessary to uncompress GCC <samp><span class="command">tar</span></samp> files when source code is
|
|
96 obtained via FTP mirror sites.
|
|
97
|
|
98 <br><dt>GNU make version 3.80 (or later)<dd>
|
|
99 You must have GNU make installed to build GCC.
|
|
100
|
|
101 <br><dt>GNU tar version 1.14 (or later)<dd>
|
|
102 Necessary (only on some platforms) to untar the source code. Many
|
|
103 systems' <samp><span class="command">tar</span></samp> programs will also work, only try GNU
|
|
104 <samp><span class="command">tar</span></samp> if you have problems.
|
|
105
|
|
106 <br><dt>GNU Multiple Precision Library (GMP) version 4.1 (or later)<dd>
|
|
107 Necessary to build GCC. If you do not have it installed in your
|
|
108 library search path, you will have to configure with the
|
|
109 <samp><span class="option">--with-gmp</span></samp> configure option. See also <samp><span class="option">--with-gmp-lib</span></samp>
|
|
110 and <samp><span class="option">--with-gmp-include</span></samp>. Alternatively, if a GMP source
|
|
111 distribution is found in a subdirectory of your GCC sources named
|
|
112 <samp><span class="file">gmp</span></samp>, it will be built together with GCC.
|
|
113
|
|
114 <br><dt>MPFR Library version 2.3.2 (or later)<dd>
|
|
115 Necessary to build GCC. It can be downloaded from
|
|
116 <a href="http://www.mpfr.org/">http://www.mpfr.org/</a>. The version of MPFR that is bundled with
|
|
117 GMP 4.1.x contains numerous bugs. Although GCC may appear to function
|
|
118 with the buggy versions of MPFR, there are a few bugs that will not be
|
|
119 fixed when using this version. It is strongly recommended to upgrade
|
|
120 to the recommended version of MPFR.
|
|
121
|
|
122 <p>The <samp><span class="option">--with-mpfr</span></samp> configure option should be used if your MPFR
|
|
123 Library is not installed in your default library search path. See also
|
|
124 <samp><span class="option">--with-mpfr-lib</span></samp> and <samp><span class="option">--with-mpfr-include</span></samp>.
|
|
125 Alternatively, if a MPFR source distribution is found in a subdirectory
|
|
126 of your GCC sources named <samp><span class="file">mpfr</span></samp>, it will be built together with
|
|
127 GCC.
|
|
128
|
|
129 <br><dt>Parma Polyhedra Library (PPL) version 0.10<dd>
|
|
130 Necessary to build GCC with the Graphite loop optimizations.
|
|
131 It can be downloaded from <a href="http://www.cs.unipr.it/ppl/Download/">http://www.cs.unipr.it/ppl/Download/</a>.
|
|
132
|
|
133 <p>The <samp><span class="option">--with-ppl</span></samp> configure option should be used if PPL is not
|
|
134 installed in your default library search path.
|
|
135
|
|
136 <br><dt>CLooG-PPL version 0.15<dd>
|
|
137 Necessary to build GCC with the Graphite loop optimizations. It can
|
|
138 be downloaded from <a href="ftp://gcc.gnu.org/pub/gcc/infrastructure/">ftp://gcc.gnu.org/pub/gcc/infrastructure/</a>.
|
|
139 The code in <samp><span class="file">cloog-ppl-0.15.tar.gz</span></samp> comes from a branch of CLooG
|
|
140 available from <a href="http://repo.or.cz/w/cloog-ppl.git">http://repo.or.cz/w/cloog-ppl.git</a>. CLooG-PPL
|
|
141 should be configured with <samp><span class="option">--with-ppl</span></samp>.
|
|
142
|
|
143 <p>The <samp><span class="option">--with-cloog</span></samp> configure option should be used if CLooG is
|
|
144 not installed in your default library search path.
|
|
145
|
|
146 <br><dt><samp><span class="command">jar</span></samp>, or InfoZIP (<samp><span class="command">zip</span></samp> and <samp><span class="command">unzip</span></samp>)<dd>
|
|
147 Necessary to build libgcj, the GCJ runtime.
|
|
148
|
|
149 </dl>
|
|
150
|
|
151 <h3 class="heading"><a name="TOC1"></a>Tools/packages necessary for modifying GCC</h3>
|
|
152
|
|
153 <dl>
|
|
154 <dt>autoconf version 2.59<dt>GNU m4 version 1.4 (or later)<dd>
|
|
155 Necessary when modifying <samp><span class="file">configure.ac</span></samp>, <samp><span class="file">aclocal.m4</span></samp>, etc.
|
|
156 to regenerate <samp><span class="file">configure</span></samp> and <samp><span class="file">config.in</span></samp> files.
|
|
157
|
|
158 <br><dt>automake version 1.9.6<dd>
|
|
159 Necessary when modifying a <samp><span class="file">Makefile.am</span></samp> file to regenerate its
|
|
160 associated <samp><span class="file">Makefile.in</span></samp>.
|
|
161
|
|
162 <p>Much of GCC does not use automake, so directly edit the <samp><span class="file">Makefile.in</span></samp>
|
|
163 file. Specifically this applies to the <samp><span class="file">gcc</span></samp>, <samp><span class="file">intl</span></samp>,
|
|
164 <samp><span class="file">libcpp</span></samp>, <samp><span class="file">libiberty</span></samp>, <samp><span class="file">libobjc</span></samp> directories as well
|
|
165 as any of their subdirectories.
|
|
166
|
|
167 <p>For directories that use automake, GCC requires the latest release in
|
|
168 the 1.9.x series, which is currently 1.9.6. When regenerating a directory
|
|
169 to a newer version, please update all the directories using an older 1.9.x
|
|
170 to the latest released version.
|
|
171
|
|
172 <br><dt>gettext version 0.14.5 (or later)<dd>
|
|
173 Needed to regenerate <samp><span class="file">gcc.pot</span></samp>.
|
|
174
|
|
175 <br><dt>gperf version 2.7.2 (or later)<dd>
|
|
176 Necessary when modifying <samp><span class="command">gperf</span></samp> input files, e.g.
|
|
177 <samp><span class="file">gcc/cp/cfns.gperf</span></samp> to regenerate its associated header file, e.g.
|
|
178 <samp><span class="file">gcc/cp/cfns.h</span></samp>.
|
|
179
|
|
180 <br><dt>DejaGnu 1.4.4<dt>Expect<dt>Tcl<dd>
|
|
181 Necessary to run the GCC testsuite; see the section on testing for details.
|
|
182
|
|
183 <br><dt>autogen version 5.5.4 (or later) and<dt>guile version 1.4.1 (or later)<dd>
|
|
184 Necessary to regenerate <samp><span class="file">fixinc/fixincl.x</span></samp> from
|
|
185 <samp><span class="file">fixinc/inclhack.def</span></samp> and <samp><span class="file">fixinc/*.tpl</span></samp>.
|
|
186
|
|
187 <p>Necessary to run ‘<samp><span class="samp">make check</span></samp>’ for <samp><span class="file">fixinc</span></samp>.
|
|
188
|
|
189 <p>Necessary to regenerate the top level <samp><span class="file">Makefile.in</span></samp> file from
|
|
190 <samp><span class="file">Makefile.tpl</span></samp> and <samp><span class="file">Makefile.def</span></samp>.
|
|
191
|
|
192 <br><dt>Flex version 2.5.4 (or later)<dd>
|
|
193 Necessary when modifying <samp><span class="file">*.l</span></samp> files.
|
|
194
|
|
195 <p>Necessary to build GCC during development because the generated output
|
|
196 files are not included in the SVN repository. They are included in
|
|
197 releases.
|
|
198
|
|
199 <br><dt>Texinfo version 4.7 (or later)<dd>
|
|
200 Necessary for running <samp><span class="command">makeinfo</span></samp> when modifying <samp><span class="file">*.texi</span></samp>
|
|
201 files to test your changes.
|
|
202
|
|
203 <p>Necessary for running <samp><span class="command">make dvi</span></samp> or <samp><span class="command">make pdf</span></samp> to
|
|
204 create printable documentation in DVI or PDF format. Texinfo version
|
|
205 4.8 or later is required for <samp><span class="command">make pdf</span></samp>.
|
|
206
|
|
207 <p>Necessary to build GCC documentation during development because the
|
|
208 generated output files are not included in the SVN repository. They are
|
|
209 included in releases.
|
|
210
|
|
211 <br><dt>TeX (any working version)<dd>
|
|
212 Necessary for running <samp><span class="command">texi2dvi</span></samp> and <samp><span class="command">texi2pdf</span></samp>, which
|
|
213 are used when running <samp><span class="command">make dvi</span></samp> or <samp><span class="command">make pdf</span></samp> to create
|
|
214 DVI or PDF files, respectively.
|
|
215
|
|
216 <br><dt>SVN (any version)<dt>SSH (any version)<dd>
|
|
217 Necessary to access the SVN repository. Public releases and weekly
|
|
218 snapshots of the development sources are also available via FTP.
|
|
219
|
|
220 <br><dt>Perl version 5.6.1 (or later)<dd>
|
|
221 Necessary when regenerating <samp><span class="file">Makefile</span></samp> dependencies in libiberty.
|
|
222 Necessary when regenerating <samp><span class="file">libiberty/functions.texi</span></samp>.
|
|
223 Necessary when generating manpages from Texinfo manuals.
|
|
224 Necessary when targetting Darwin, building libstdc++,
|
|
225 and not using <samp><span class="option">--disable-symvers</span></samp>.
|
|
226 Used by various scripts to generate some files included in SVN (mainly
|
|
227 Unicode-related and rarely changing) from source tables.
|
|
228
|
|
229 <br><dt>GNU diffutils version 2.7 (or later)<dd>
|
|
230 Useful when submitting patches for the GCC source code.
|
|
231
|
|
232 <br><dt>patch version 2.5.4 (or later)<dd>
|
|
233 Necessary when applying patches, created with <samp><span class="command">diff</span></samp>, to one's
|
|
234 own sources.
|
|
235
|
|
236 <br><dt>ecj1<dt>gjavah<dd>
|
|
237 If you wish to modify <samp><span class="file">.java</span></samp> files in libjava, you will need to
|
|
238 configure with <samp><span class="option">--enable-java-maintainer-mode</span></samp>, and you will need
|
|
239 to have executables named <samp><span class="command">ecj1</span></samp> and <samp><span class="command">gjavah</span></samp> in your path.
|
|
240 The <samp><span class="command">ecj1</span></samp> executable should run the Eclipse Java compiler via
|
|
241 the GCC-specific entry point. You can download a suitable jar from
|
|
242 <a href="ftp://sourceware.org/pub/java/">ftp://sourceware.org/pub/java/</a>, or by running the script
|
|
243 <samp><span class="command">contrib/download_ecj</span></samp>.
|
|
244
|
|
245 <br><dt>antlr.jar version 2.7.1 (or later)<dt>antlr binary<dd>
|
|
246 If you wish to build the <samp><span class="command">gjdoc</span></samp> binary in libjava, you will
|
|
247 need to have a <samp><span class="file">antlr.jar</span></samp> library available. The library is
|
|
248 searched in system locations but can be configured with
|
|
249 <samp><span class="option">--with-antlr-jar=</span></samp> instead. When configuring with
|
|
250 <samp><span class="option">--enable-java-maintainer-mode</span></samp>, you will need to have one of
|
|
251 the executables named <samp><span class="command">cantlr</span></samp>, <samp><span class="command">runantlr</span></samp> or
|
|
252 <samp><span class="command">antlr</span></samp> in your path.
|
|
253
|
|
254 </dl>
|
|
255
|
|
256 <p><hr />
|
|
257 <p><a href="./index.html">Return to the GCC Installation page</a>
|
|
258
|
|
259 <!-- ***Downloading the source************************************************** -->
|
|
260 <!-- ***Configuration*********************************************************** -->
|
|
261 <!-- ***Building**************************************************************** -->
|
|
262 <!-- ***Testing***************************************************************** -->
|
|
263 <!-- ***Final install*********************************************************** -->
|
|
264 <!-- ***Binaries**************************************************************** -->
|
|
265 <!-- ***Specific**************************************************************** -->
|
|
266 <!-- ***Old documentation****************************************************** -->
|
|
267 <!-- ***GFDL******************************************************************** -->
|
|
268 <!-- *************************************************************************** -->
|
|
269 <!-- Part 6 The End of the Document -->
|
|
270 </body></html>
|
|
271
|