prerequisites.html revision 1.1.1.3
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 5Permission is granted to copy, distribute and/or modify this document 6under the terms of the GNU Free Documentation License, Version 1.3 or 7any later version published by the Free Software Foundation; with no 8Invariant Sections, the Front-Cover texts being (a) (see below), and 9with the Back-Cover Texts being (b) (see below). A copy of the 10license is included in the section entitled "GNU 11Free Documentation License". 12 13(a) The FSF's Front-Cover Text is: 14 15A GNU Manual 16 17(b) The FSF's Back-Cover Text is: 18 19You 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.2, 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<!-- 34a.summary-letter {text-decoration: none} 35blockquote.smallquotation {font-size: smaller} 36div.display {margin-left: 3.2em} 37div.example {margin-left: 3.2em} 38div.indentedblock {margin-left: 3.2em} 39div.lisp {margin-left: 3.2em} 40div.smalldisplay {margin-left: 3.2em} 41div.smallexample {margin-left: 3.2em} 42div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 43div.smalllisp {margin-left: 3.2em} 44kbd {font-style:oblique} 45pre.display {font-family: inherit} 46pre.format {font-family: inherit} 47pre.menu-comment {font-family: serif} 48pre.menu-preformatted {font-family: serif} 49pre.smalldisplay {font-family: inherit; font-size: smaller} 50pre.smallexample {font-size: smaller} 51pre.smallformat {font-family: inherit; font-size: smaller} 52pre.smalllisp {font-size: smaller} 53span.nocodebreak {white-space:nowrap} 54span.nolinebreak {white-space:nowrap} 55span.roman {font-family:serif; font-weight:normal} 56span.sansserif {font-family:sans-serif; font-weight:normal} 57ul.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<a name="index-Prerequisites"></a> 84 85<p>GCC requires that various tools and packages be available for use in the 86build procedure. Modifying GCC sources requires additional tools 87described below. 88</p> 89<a name="Tools_002fpackages-necessary-for-building-GCC"></a> 90<h3 class="heading">Tools/packages necessary for building GCC</h3> 91<dl compact="compact"> 92<dt>ISO C++98 compiler</dt> 93<dd><p>Necessary to bootstrap GCC, although versions of GCC prior 94to 4.8 also allow bootstrapping with a ISO C89 compiler and versions 95of GCC prior to 3.4 also allow bootstrapping with a traditional 96(K&R) C compiler. 97</p> 98<p>To build all languages in a cross-compiler or other configuration where 993-stage bootstrap is not performed, you need to start with an existing 100GCC binary (version 3.4 or later) because source code for language 101frontends other than C might use GCC extensions. 102</p> 103<p>Note that to bootstrap GCC with versions of GCC earlier than 3.4, you 104may need to use <samp>--disable-stage1-checking</samp>, though 105bootstrapping the compiler with such earlier compilers is strongly 106discouraged. 107</p> 108</dd> 109<dt>GNAT</dt> 110<dd> 111<p>In order to build the Ada compiler (GNAT) you must already have GNAT 112installed because portions of the Ada frontend are written in Ada (with 113GNAT extensions.) Refer to the Ada installation instructions for more 114specific information. 115</p> 116</dd> 117<dt>A “working” POSIX compatible shell, or GNU bash</dt> 118<dd> 119<p>Necessary when running <code>configure</code> because some 120<code>/bin/sh</code> shells have bugs and may crash when configuring the 121target libraries. In other cases, <code>/bin/sh</code> or <code>ksh</code> 122have disastrous corner-case performance problems. This 123can cause target <code>configure</code> runs to literally take days to 124complete in some cases. 125</p> 126<p>So on some platforms <code>/bin/ksh</code> is sufficient, on others it 127isn’t. See the host/target specific instructions for your platform, or 128use <code>bash</code> to be sure. Then set <code>CONFIG_SHELL</code> in your 129environment to your “good” shell prior to running 130<code>configure</code>/<code>make</code>. 131</p> 132<p><code>zsh</code> is not a fully compliant POSIX shell and will not 133work when configuring GCC. 134</p> 135</dd> 136<dt>A POSIX or SVR4 awk</dt> 137<dd> 138<p>Necessary for creating some of the generated source files for GCC. 139If in doubt, use a recent GNU awk version, as some of the older ones 140are broken. GNU awk version 3.1.5 is known to work. 141</p> 142</dd> 143<dt>GNU binutils</dt> 144<dd> 145<p>Necessary in some circumstances, optional in others. See the 146host/target specific instructions for your platform for the exact 147requirements. 148</p> 149</dd> 150<dt>gzip version 1.2.4 (or later) or</dt> 151<dt>bzip2 version 1.0.2 (or later)</dt> 152<dd> 153<p>Necessary to uncompress GCC <code>tar</code> files when source code is 154obtained via FTP mirror sites. 155</p> 156</dd> 157<dt>GNU make version 3.80 (or later)</dt> 158<dd> 159<p>You must have GNU make installed to build GCC. 160</p> 161</dd> 162<dt>GNU tar version 1.14 (or later)</dt> 163<dd> 164<p>Necessary (only on some platforms) to untar the source code. Many 165systems’ <code>tar</code> programs will also work, only try GNU 166<code>tar</code> if you have problems. 167</p> 168</dd> 169<dt>Perl version 5.6.1 (or later)</dt> 170<dd> 171<p>Necessary when targeting Darwin, building ‘<samp>libstdc++</samp>’, 172and not using <samp>--disable-symvers</samp>. 173Necessary when targeting Solaris 2 with Sun <code>ld</code> and not using 174<samp>--disable-symvers</samp>. The bundled <code>perl</code> in Solaris 8 175and up works. 176</p> 177<p>Necessary when regenerating <samp>Makefile</samp> dependencies in libiberty. 178Necessary when regenerating <samp>libiberty/functions.texi</samp>. 179Necessary when generating manpages from Texinfo manuals. 180Used by various scripts to generate some files included in SVN (mainly 181Unicode-related and rarely changing) from source tables. 182</p> 183</dd> 184<dt><code>jar</code>, or InfoZIP (<code>zip</code> and <code>unzip</code>)</dt> 185<dd> 186<p>Necessary to build libgcj, the GCJ runtime. 187</p> 188</dd> 189</dl> 190 191<p>Several support libraries are necessary to build GCC, some are required, 192others optional. While any sufficiently new version of required tools 193usually work, library requirements are generally stricter. Newer 194versions may work in some cases, but it’s safer to use the exact 195versions documented. We appreciate bug reports about problems with 196newer versions, though. If your OS vendor provides packages for the 197support libraries then using those packages may be the simplest way to 198install the libraries. 199</p> 200<dl compact="compact"> 201<dt>GNU Multiple Precision Library (GMP) version 4.3.2 (or later)</dt> 202<dd> 203<p>Necessary to build GCC. If a GMP source distribution is found in a 204subdirectory of your GCC sources named <samp>gmp</samp>, it will be built 205together with GCC. Alternatively, if GMP is already installed but it 206is not in your library search path, you will have to configure with the 207<samp>--with-gmp</samp> configure option. See also <samp>--with-gmp-lib</samp> 208and <samp>--with-gmp-include</samp>. 209</p> 210</dd> 211<dt>MPFR Library version 2.4.2 (or later)</dt> 212<dd> 213<p>Necessary to build GCC. It can be downloaded from 214<a href="http://www.mpfr.org/">http://www.mpfr.org/</a>. If an MPFR source distribution is found 215in a subdirectory of your GCC sources named <samp>mpfr</samp>, it will be 216built together with GCC. Alternatively, if MPFR is already installed 217but it is not in your default library search path, the 218<samp>--with-mpfr</samp> configure option should be used. See also 219<samp>--with-mpfr-lib</samp> and <samp>--with-mpfr-include</samp>. 220</p> 221</dd> 222<dt>MPC Library version 0.8.1 (or later)</dt> 223<dd> 224<p>Necessary to build GCC. It can be downloaded from 225<a href="http://www.multiprecision.org/">http://www.multiprecision.org/</a>. If an MPC source distribution 226is found in a subdirectory of your GCC sources named <samp>mpc</samp>, it 227will be built together with GCC. Alternatively, if MPC is already 228installed but it is not in your default library search path, the 229<samp>--with-mpc</samp> configure option should be used. See also 230<samp>--with-mpc-lib</samp> and <samp>--with-mpc-include</samp>. 231</p> 232</dd> 233<dt>ISL Library version 0.11.1</dt> 234<dd> 235<p>Necessary to build GCC with the Graphite loop optimizations. 236It can be downloaded from <a href="ftp://gcc.gnu.org/pub/gcc/infrastructure/">ftp://gcc.gnu.org/pub/gcc/infrastructure/</a> 237as <samp>isl-0.11.1.tar.bz2</samp>. 238</p> 239<p>The <samp>--with-isl</samp> configure option should be used if ISL is not 240installed in your default library search path. 241</p> 242</dd> 243<dt>CLooG 0.18.0</dt> 244<dd> 245<p>Necessary to build GCC with the Graphite loop optimizations. It can be 246downloaded from <a href="ftp://gcc.gnu.org/pub/gcc/infrastructure/">ftp://gcc.gnu.org/pub/gcc/infrastructure/</a> as 247<samp>cloog-0.18.0.tar.gz</samp>. The <samp>--with-cloog</samp> configure option should 248be used if CLooG is not installed in your default library search path. 249CLooG needs to be built against ISL 0.11.1. Use <samp>--with-isl=system</samp> 250to direct CLooG to pick up an already installed ISL, otherwise it will use 251ISL 0.11.1 as bundled with CLooG. CLooG needs to be configured to use GMP 252internally, use <samp>--with-bits=gmp</samp> to direct it to do that. 253</p> 254</dd> 255</dl> 256 257<a name="Tools_002fpackages-necessary-for-modifying-GCC"></a> 258<h3 class="heading">Tools/packages necessary for modifying GCC</h3> 259<dl compact="compact"> 260<dt>autoconf version 2.64</dt> 261<dt>GNU m4 version 1.4.6 (or later)</dt> 262<dd> 263<p>Necessary when modifying <samp>configure.ac</samp>, <samp>aclocal.m4</samp>, etc. 264to regenerate <samp>configure</samp> and <samp>config.in</samp> files. 265</p> 266</dd> 267<dt>automake version 1.11.1</dt> 268<dd> 269<p>Necessary when modifying a <samp>Makefile.am</samp> file to regenerate its 270associated <samp>Makefile.in</samp>. 271</p> 272<p>Much of GCC does not use automake, so directly edit the <samp>Makefile.in</samp> 273file. Specifically this applies to the <samp>gcc</samp>, <samp>intl</samp>, 274<samp>libcpp</samp>, <samp>libiberty</samp>, <samp>libobjc</samp> directories as well 275as any of their subdirectories. 276</p> 277<p>For directories that use automake, GCC requires the latest release in 278the 1.11 series, which is currently 1.11.1. When regenerating a directory 279to a newer version, please update all the directories using an older 1.11 280to the latest released version. 281</p> 282</dd> 283<dt>gettext version 0.14.5 (or later)</dt> 284<dd> 285<p>Needed to regenerate <samp>gcc.pot</samp>. 286</p> 287</dd> 288<dt>gperf version 2.7.2 (or later)</dt> 289<dd> 290<p>Necessary when modifying <code>gperf</code> input files, e.g. 291<samp>gcc/cp/cfns.gperf</samp> to regenerate its associated header file, e.g. 292<samp>gcc/cp/cfns.h</samp>. 293</p> 294</dd> 295<dt>DejaGnu 1.4.4</dt> 296<dt>Expect</dt> 297<dt>Tcl</dt> 298<dd> 299<p>Necessary to run the GCC testsuite; see the section on testing for details. 300</p> 301</dd> 302<dt>autogen version 5.5.4 (or later) and</dt> 303<dt>guile version 1.4.1 (or later)</dt> 304<dd> 305<p>Necessary to regenerate <samp>fixinc/fixincl.x</samp> from 306<samp>fixinc/inclhack.def</samp> and <samp>fixinc/*.tpl</samp>. 307</p> 308<p>Necessary to run ‘<samp>make check</samp>’ for <samp>fixinc</samp>. 309</p> 310<p>Necessary to regenerate the top level <samp>Makefile.in</samp> file from 311<samp>Makefile.tpl</samp> and <samp>Makefile.def</samp>. 312</p> 313</dd> 314<dt>Flex version 2.5.4 (or later)</dt> 315<dd> 316<p>Necessary when modifying <samp>*.l</samp> files. 317</p> 318<p>Necessary to build GCC during development because the generated output 319files are not included in the SVN repository. They are included in 320releases. 321</p> 322</dd> 323<dt>Texinfo version 4.7 (or later)</dt> 324<dd> 325<p>Necessary for running <code>makeinfo</code> when modifying <samp>*.texi</samp> 326files to test your changes. 327</p> 328<p>Necessary for running <code>make dvi</code> or <code>make pdf</code> to 329create printable documentation in DVI or PDF format. Texinfo version 3304.8 or later is required for <code>make pdf</code>. 331</p> 332<p>Necessary to build GCC documentation during development because the 333generated output files are not included in the SVN repository. They are 334included in releases. 335</p> 336</dd> 337<dt>TeX (any working version)</dt> 338<dd> 339<p>Necessary for running <code>texi2dvi</code> and <code>texi2pdf</code>, which 340are used when running <code>make dvi</code> or <code>make pdf</code> to create 341DVI or PDF files, respectively. 342</p> 343</dd> 344<dt>SVN (any version)</dt> 345<dt>SSH (any version)</dt> 346<dd> 347<p>Necessary to access the SVN repository. Public releases and weekly 348snapshots of the development sources are also available via FTP. 349</p> 350</dd> 351<dt>GNU diffutils version 2.7 (or later)</dt> 352<dd> 353<p>Useful when submitting patches for the GCC source code. 354</p> 355</dd> 356<dt>patch version 2.5.4 (or later)</dt> 357<dd> 358<p>Necessary when applying patches, created with <code>diff</code>, to one’s 359own sources. 360</p> 361</dd> 362<dt>ecj1</dt> 363<dt>gjavah</dt> 364<dd> 365<p>If you wish to modify <samp>.java</samp> files in libjava, you will need to 366configure with <samp>--enable-java-maintainer-mode</samp>, and you will need 367to have executables named <code>ecj1</code> and <code>gjavah</code> in your path. 368The <code>ecj1</code> executable should run the Eclipse Java compiler via 369the GCC-specific entry point. You can download a suitable jar from 370<a href="ftp://sourceware.org/pub/java/">ftp://sourceware.org/pub/java/</a>, or by running the script 371<code>contrib/download_ecj</code>. 372</p> 373</dd> 374<dt>antlr.jar version 2.7.1 (or later)</dt> 375<dt>antlr binary</dt> 376<dd> 377<p>If you wish to build the <code>gjdoc</code> binary in libjava, you will 378need to have an <samp>antlr.jar</samp> library available. The library is 379searched for in system locations but can be specified with 380<samp>--with-antlr-jar=</samp> instead. When configuring with 381<samp>--enable-java-maintainer-mode</samp>, you will need to have one of 382the executables named <code>cantlr</code>, <code>runantlr</code> or 383<code>antlr</code> in your path. 384</p> 385</dd> 386</dl> 387 388<hr /> 389<p><p><a href="./index.html">Return to the GCC Installation page</a> 390</p> 391 392 393 394 395 396 397 398 399 400 401 402 403 404</body> 405</html> 406