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<!-- 10Copyright (C) 1988-2015 Free Software Foundation, Inc. 11 12 Permission is granted to copy, distribute and/or modify this document 13under the terms of the GNU Free Documentation License, Version 1.3 or 14any later version published by the Free Software Foundation; with no 15Invariant Sections, the Front-Cover texts being (a) (see below), and 16with the Back-Cover Texts being (b) (see below). A copy of the 17license is included in the section entitled "GNU Free Documentation License". 18 19(a) The FSF's Front-Cover Text is: 20 21 A GNU Manual 22 23(b) The FSF's Back-Cover Text is: 24 25 You have freedom to copy and modify this GNU Manual, like GNU 26 software. Copies published by the Free Software Foundation raise 27 funds for GNU development.--> 28<meta http-equiv="Content-Style-Type" content="text/css"> 29<style type="text/css"><!-- 30 pre.display { font-family:inherit } 31 pre.format { font-family:inherit } 32 pre.smalldisplay { font-family:inherit; font-size:smaller } 33 pre.smallformat { font-family:inherit; font-size:smaller } 34 pre.smallexample { font-size:smaller } 35 pre.smalllisp { font-size:smaller } 36 span.sc { font-variant:small-caps } 37 span.roman { font-family:serif; font-weight:normal; } 38 span.sansserif { font-family:sans-serif; font-weight:normal; } 39--></style> 40</head> 41<body> 42<h1 class="settitle">Prerequisites for GCC</h1> 43<a name="index-Prerequisites-1"></a> 44GCC requires that various tools and packages be available for use in the 45build procedure. Modifying GCC sources requires additional tools 46described below. 47 48<h3 class="heading"><a name="TOC0"></a>Tools/packages necessary for building GCC</h3> 49 50 <dl> 51<dt>ISO C++98 compiler<dd>Necessary to bootstrap GCC, although versions of GCC prior 52to 4.8 also allow bootstrapping with a ISO C89 compiler and versions 53of GCC prior to 3.4 also allow bootstrapping with a traditional 54(K&R) C compiler. 55 56 <p>To build all languages in a cross-compiler or other configuration where 573-stage bootstrap is not performed, you need to start with an existing 58GCC binary (version 3.4 or later) because source code for language 59frontends other than C might use GCC extensions. 60 61 <p>Note that to bootstrap GCC with versions of GCC earlier than 3.4, you 62may need to use <samp><span class="option">--disable-stage1-checking</span></samp>, though 63bootstrapping the compiler with such earlier compilers is strongly 64discouraged. 65 66 <br><dt>C standard library and headers<dd> 67In order to build GCC, the C standard library and headers must be present 68for all target variants for which target libraries will be built (and not 69only the variant of the host C++ compiler). 70 71 <p>This affects the popular ‘<samp><span class="samp">x86_64-unknown-linux-gnu</span></samp>’ platform (among 72other multilib targets), for which 64-bit (‘<samp><span class="samp">x86_64</span></samp>’) and 32-bit 73(‘<samp><span class="samp">i386</span></samp>’) libc headers are usually packaged separately. If you do a 74build of a native compiler on ‘<samp><span class="samp">x86_64-unknown-linux-gnu</span></samp>’, make sure you 75either have the 32-bit libc developer package properly installed (the exact 76name of the package depends on your distro) or you must build GCC as a 7764-bit only compiler by configuring with the option 78<samp><span class="option">--disable-multilib</span></samp>. Otherwise, you may encounter an error such as 79‘<samp><span class="samp">fatal error: gnu/stubs-32.h: No such file</span></samp>’ 80 81 <br><dt>GNAT<dd> 82In order to build the Ada compiler (GNAT) you must already have GNAT 83installed because portions of the Ada frontend are written in Ada (with 84GNAT extensions.) Refer to the Ada installation instructions for more 85specific information. 86 87 <br><dt>A “working” POSIX compatible shell, or GNU bash<dd> 88Necessary when running <samp><span class="command">configure</span></samp> because some 89<samp><span class="command">/bin/sh</span></samp> shells have bugs and may crash when configuring the 90target libraries. In other cases, <samp><span class="command">/bin/sh</span></samp> or <samp><span class="command">ksh</span></samp> 91have disastrous corner-case performance problems. This 92can cause target <samp><span class="command">configure</span></samp> runs to literally take days to 93complete in some cases. 94 95 <p>So on some platforms <samp><span class="command">/bin/ksh</span></samp> is sufficient, on others it 96isn't. See the host/target specific instructions for your platform, or 97use <samp><span class="command">bash</span></samp> to be sure. Then set <samp><span class="env">CONFIG_SHELL</span></samp> in your 98environment to your “good” shell prior to running 99<samp><span class="command">configure</span></samp>/<samp><span class="command">make</span></samp>. 100 101 <p><samp><span class="command">zsh</span></samp> is not a fully compliant POSIX shell and will not 102work when configuring GCC. 103 104 <br><dt>A POSIX or SVR4 awk<dd> 105Necessary for creating some of the generated source files for GCC. 106If in doubt, use a recent GNU awk version, as some of the older ones 107are broken. GNU awk version 3.1.5 is known to work. 108 109 <br><dt>GNU binutils<dd> 110Necessary in some circumstances, optional in others. See the 111host/target specific instructions for your platform for the exact 112requirements. 113 114 <br><dt>gzip version 1.2.4 (or later) or<dt>bzip2 version 1.0.2 (or later)<dd> 115Necessary to uncompress GCC <samp><span class="command">tar</span></samp> files when source code is 116obtained via FTP mirror sites. 117 118 <br><dt>GNU make version 3.80 (or later)<dd> 119You must have GNU make installed to build GCC. 120 121 <br><dt>GNU tar version 1.14 (or later)<dd> 122Necessary (only on some platforms) to untar the source code. Many 123systems' <samp><span class="command">tar</span></samp> programs will also work, only try GNU 124<samp><span class="command">tar</span></samp> if you have problems. 125 126 <br><dt>Perl version 5.6.1 (or later)<dd> 127Necessary when targeting Darwin, building ‘<samp><span class="samp">libstdc++</span></samp>’, 128and not using <samp><span class="option">--disable-symvers</span></samp>. 129Necessary when targeting Solaris 2 with Sun <samp><span class="command">ld</span></samp> and not using 130<samp><span class="option">--disable-symvers</span></samp>. The bundled <samp><span class="command">perl</span></samp> in Solaris 8 131and up works. 132 133 <p>Necessary when regenerating <samp><span class="file">Makefile</span></samp> dependencies in libiberty. 134Necessary when regenerating <samp><span class="file">libiberty/functions.texi</span></samp>. 135Necessary when generating manpages from Texinfo manuals. 136Used by various scripts to generate some files included in SVN (mainly 137Unicode-related and rarely changing) from source tables. 138 139 <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> 140Necessary to build libgcj, the GCJ runtime. 141 142</dl> 143 144 <p>Several support libraries are necessary to build GCC, some are required, 145others optional. While any sufficiently new version of required tools 146usually work, library requirements are generally stricter. Newer 147versions may work in some cases, but it's safer to use the exact 148versions documented. We appreciate bug reports about problems with 149newer versions, though. If your OS vendor provides packages for the 150support libraries then using those packages may be the simplest way to 151install the libraries. 152 153 <dl> 154<dt>GNU Multiple Precision Library (GMP) version 4.3.2 (or later)<dd> 155Necessary to build GCC. If a GMP source distribution is found in a 156subdirectory of your GCC sources named <samp><span class="file">gmp</span></samp>, it will be built 157together with GCC. Alternatively, if GMP is already installed but it 158is not in your library search path, you will have to configure with the 159<samp><span class="option">--with-gmp</span></samp> configure option. See also <samp><span class="option">--with-gmp-lib</span></samp> 160and <samp><span class="option">--with-gmp-include</span></samp>. 161 162 <br><dt>MPFR Library version 2.4.2 (or later)<dd> 163Necessary to build GCC. It can be downloaded from 164<a href="http://www.mpfr.org/">http://www.mpfr.org/</a>. If an MPFR source distribution is found 165in a subdirectory of your GCC sources named <samp><span class="file">mpfr</span></samp>, it will be 166built together with GCC. Alternatively, if MPFR is already installed 167but it is not in your default library search path, the 168<samp><span class="option">--with-mpfr</span></samp> configure option should be used. See also 169<samp><span class="option">--with-mpfr-lib</span></samp> and <samp><span class="option">--with-mpfr-include</span></samp>. 170 171 <br><dt>MPC Library version 0.8.1 (or later)<dd> 172Necessary to build GCC. It can be downloaded from 173<a href="http://www.multiprecision.org/">http://www.multiprecision.org/</a>. If an MPC source distribution 174is found in a subdirectory of your GCC sources named <samp><span class="file">mpc</span></samp>, it 175will be built together with GCC. Alternatively, if MPC is already 176installed but it is not in your default library search path, the 177<samp><span class="option">--with-mpc</span></samp> configure option should be used. See also 178<samp><span class="option">--with-mpc-lib</span></samp> and <samp><span class="option">--with-mpc-include</span></samp>. 179 180 <br><dt>ISL Library version 0.14 (or 0.12.2)<dd> 181Necessary to build GCC with the Graphite loop optimizations. 182It can be downloaded from <a href="ftp://gcc.gnu.org/pub/gcc/infrastructure/">ftp://gcc.gnu.org/pub/gcc/infrastructure/</a> 183as <samp><span class="file">isl-0.12.2.tar.bz2</span></samp>. If an ISL source distribution is found 184in a subdirectory of your GCC sources named <samp><span class="file">isl</span></samp>, it will be 185built together with GCC. Alternatively, the <samp><span class="option">--with-isl</span></samp> configure 186option should be used if ISL is not installed in your default library 187search path. 188 189 </dl> 190 191<h3 class="heading"><a name="TOC1"></a>Tools/packages necessary for modifying GCC</h3> 192 193 <dl> 194<dt>autoconf version 2.64<dt>GNU m4 version 1.4.6 (or later)<dd> 195Necessary when modifying <samp><span class="file">configure.ac</span></samp>, <samp><span class="file">aclocal.m4</span></samp>, etc. 196to regenerate <samp><span class="file">configure</span></samp> and <samp><span class="file">config.in</span></samp> files. 197 198 <br><dt>automake version 1.11.1<dd> 199Necessary when modifying a <samp><span class="file">Makefile.am</span></samp> file to regenerate its 200associated <samp><span class="file">Makefile.in</span></samp>. 201 202 <p>Much of GCC does not use automake, so directly edit the <samp><span class="file">Makefile.in</span></samp> 203file. Specifically this applies to the <samp><span class="file">gcc</span></samp>, <samp><span class="file">intl</span></samp>, 204<samp><span class="file">libcpp</span></samp>, <samp><span class="file">libiberty</span></samp>, <samp><span class="file">libobjc</span></samp> directories as well 205as any of their subdirectories. 206 207 <p>For directories that use automake, GCC requires the latest release in 208the 1.11 series, which is currently 1.11.1. When regenerating a directory 209to a newer version, please update all the directories using an older 1.11 210to the latest released version. 211 212 <br><dt>gettext version 0.14.5 (or later)<dd> 213Needed to regenerate <samp><span class="file">gcc.pot</span></samp>. 214 215 <br><dt>gperf version 2.7.2 (or later)<dd> 216Necessary when modifying <samp><span class="command">gperf</span></samp> input files, e.g. 217<samp><span class="file">gcc/cp/cfns.gperf</span></samp> to regenerate its associated header file, e.g. 218<samp><span class="file">gcc/cp/cfns.h</span></samp>. 219 220 <br><dt>DejaGnu 1.4.4<dt>Expect<dt>Tcl<dd> 221Necessary to run the GCC testsuite; see the section on testing for 222details. Tcl 8.6 has a known regression in RE pattern handling that 223make parts of the testsuite fail. See 224<a href="http://core.tcl.tk/tcl/tktview/267b7e2334ee2e9de34c4b00d6e72e2f1997085f">http://core.tcl.tk/tcl/tktview/267b7e2334ee2e9de34c4b00d6e72e2f1997085f</a> 225for more information. This bug has been fixed in 8.6.1. 226 227 <br><dt>autogen version 5.5.4 (or later) and<dt>guile version 1.4.1 (or later)<dd> 228Necessary to regenerate <samp><span class="file">fixinc/fixincl.x</span></samp> from 229<samp><span class="file">fixinc/inclhack.def</span></samp> and <samp><span class="file">fixinc/*.tpl</span></samp>. 230 231 <p>Necessary to run ‘<samp><span class="samp">make check</span></samp>’ for <samp><span class="file">fixinc</span></samp>. 232 233 <p>Necessary to regenerate the top level <samp><span class="file">Makefile.in</span></samp> file from 234<samp><span class="file">Makefile.tpl</span></samp> and <samp><span class="file">Makefile.def</span></samp>. 235 236 <br><dt>Flex version 2.5.4 (or later)<dd> 237Necessary when modifying <samp><span class="file">*.l</span></samp> files. 238 239 <p>Necessary to build GCC during development because the generated output 240files are not included in the SVN repository. They are included in 241releases. 242 243 <br><dt>Texinfo version 4.7 (or later)<dd> 244Necessary for running <samp><span class="command">makeinfo</span></samp> when modifying <samp><span class="file">*.texi</span></samp> 245files to test your changes. 246 247 <p>Necessary for running <samp><span class="command">make dvi</span></samp> or <samp><span class="command">make pdf</span></samp> to 248create printable documentation in DVI or PDF format. Texinfo version 2494.8 or later is required for <samp><span class="command">make pdf</span></samp>. 250 251 <p>Necessary to build GCC documentation during development because the 252generated output files are not included in the SVN repository. They are 253included in releases. 254 255 <br><dt>TeX (any working version)<dd> 256Necessary for running <samp><span class="command">texi2dvi</span></samp> and <samp><span class="command">texi2pdf</span></samp>, which 257are used when running <samp><span class="command">make dvi</span></samp> or <samp><span class="command">make pdf</span></samp> to create 258DVI or PDF files, respectively. 259 260 <br><dt>Sphinx version 1.0 (or later)<dd> 261Necessary to regenerate <samp><span class="file">jit/docs/_build/texinfo</span></samp> from the <samp><span class="file">.rst</span></samp> 262files in the directories below <samp><span class="file">jit/docs</span></samp>. 263 264 <br><dt>SVN (any version)<dt>SSH (any version)<dd> 265Necessary to access the SVN repository. Public releases and weekly 266snapshots of the development sources are also available via FTP. 267 268 <br><dt>GNU diffutils version 2.7 (or later)<dd> 269Useful when submitting patches for the GCC source code. 270 271 <br><dt>patch version 2.5.4 (or later)<dd> 272Necessary when applying patches, created with <samp><span class="command">diff</span></samp>, to one's 273own sources. 274 275 <br><dt>ecj1<dt>gjavah<dd> 276If you wish to modify <samp><span class="file">.java</span></samp> files in libjava, you will need to 277configure with <samp><span class="option">--enable-java-maintainer-mode</span></samp>, and you will need 278to have executables named <samp><span class="command">ecj1</span></samp> and <samp><span class="command">gjavah</span></samp> in your path. 279The <samp><span class="command">ecj1</span></samp> executable should run the Eclipse Java compiler via 280the GCC-specific entry point. You can download a suitable jar from 281<a href="ftp://sourceware.org/pub/java/">ftp://sourceware.org/pub/java/</a>, or by running the script 282<samp><span class="command">contrib/download_ecj</span></samp>. 283 284 <br><dt>antlr.jar version 2.7.1 (or later)<dt>antlr binary<dd> 285If you wish to build the <samp><span class="command">gjdoc</span></samp> binary in libjava, you will 286need to have an <samp><span class="file">antlr.jar</span></samp> library available. The library is 287searched for in system locations but can be specified with 288<samp><span class="option">--with-antlr-jar=</span></samp> instead. When configuring with 289<samp><span class="option">--enable-java-maintainer-mode</span></samp>, you will need to have one of 290the executables named <samp><span class="command">cantlr</span></samp>, <samp><span class="command">runantlr</span></samp> or 291<samp><span class="command">antlr</span></samp> in your path. 292 293</dl> 294 295 <p><hr /> 296<p><a href="./index.html">Return to the GCC Installation page</a> 297 298<!-- ***Downloading the source************************************************** --> 299<!-- ***Configuration*********************************************************** --> 300<!-- ***Building**************************************************************** --> 301<!-- ***Testing***************************************************************** --> 302<!-- ***Final install*********************************************************** --> 303<!-- ***Binaries**************************************************************** --> 304<!-- ***Specific**************************************************************** --> 305<!-- ***Old documentation****************************************************** --> 306<!-- ***GFDL******************************************************************** --> 307<!-- *************************************************************************** --> 308<!-- Part 6 The End of the Document --> 309</body></html> 310 311