Mercurial > hg > CbC > CbC_gcc

comparison INSTALL/prerequisites.html @ 0:a06113de4d67

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
first commit
author kent <kent@cr.ie.u-ryukyu.ac.jp>
date Fri, 17 Jul 2009 14:47:48 +0900
parents
children 58ad6c70ea60
comparison
equal deleted inserted replaced
-1:000000000000 0:a06113de4d67
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&amp;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 &ldquo;working&rdquo; 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 &ldquo;good&rdquo; 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 &lsquo;<samp><span class="samp">make check</span></samp>&rsquo; 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