Mercurial > hg > CbC > CbC_gcc
annotate INSTALL/prerequisites.html @ 48:9907f3135723
update CbC on GCC from 4.4.2 to 4.4.3.
| author | kent <kent@cr.ie.u-ryukyu.ac.jp> |
|---|---|
| date | Sun, 07 Feb 2010 17:48:31 +0900 |
| parents | 58ad6c70ea60 |
| children |
| rev | line source |
|---|---|
| 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"> | |
|
19
58ad6c70ea60
update gcc from 4.4.0 to 4.4.1.
kent@firefly.cr.ie.u-ryukyu.ac.jp
parents:
0
diff
changeset
|
6 <meta name="generator" content="makeinfo 4.13"> |
| 0 | 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 |