libstdc++-v3/doc/html/manual/build.html

   1 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Build</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><meta name="keywords" content="&#10;      ISO C++&#10;    , &#10;      build&#10;    " /><meta name="keywords" content="&#10;      ISO C++&#10;    , &#10;      library&#10;    " /><link rel="start" href="../spine.html" title="The GNU C++ Library Documentation" /><link rel="up" href="bk01pt01ch02.html" title="Chapter 2. Setup" /><link rel="prev" href="bk01pt01ch02.html" title="Chapter 2. Setup" /><link rel="next" href="test.html" title="Test" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Build</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk01pt01ch02.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Setup</th><td width="20%" align="right"> <a accesskey="n" href="test.html">Next</a></td></tr></table><hr /></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="manual.intro.setup.build"></a>Build</h2></div></div></div><p>
   4   Because libstdc++ is part of GCC, the primary source for
   5    installation instructions is
   6    <a class="ulink" href="http://gcc.gnu.org/install/" target="_top">the GCC install page</a>.
   7    Additional data is given here only where it applies to libstdc++.
   8 </p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="build.prereq"></a>Prerequisites</h3></div></div></div><p>
   9     The list of software needed to build the library is kept with the
  10     rest of the compiler, at
  11       <a class="ulink" href="http://gcc.gnu.org/install/prerequisites.html" target="_top">
  12       http://gcc.gnu.org/install/prerequisites.html</a>.  The same page
  13       also lists the tools you will need if you wish to modify the source.
  14   </p><p>As of GCC 4.0.1 the minimum version of binutils required to build
  15       libstdc++ is <code class="code">2.15.90.0.1.1</code>. You can get snapshots
  16       (as well as releases) of binutils from
  17       <a class="ulink" href="ftp://sources.redhat.com/pub/binutils" target="_top">
  18       ftp://sources.redhat.com/pub/binutils</a>.
  19       Older releases of libstdc++ do not require such a recent version,
  20       but to take full advantage of useful space-saving features and
  21       bug-fixes you should use a recent binutils if possible.
  22       The configure process will automatically detect and use these
  23       features if the underlying support is present.
  24    </p><p>
  25    Finally, a few system-specific requirements:
  26    </p><div class="variablelist"><dl><dt><span class="term">linux</span></dt><dd><p>
  27           If gcc 3.1.0 or later on is being used on linux, an attempt
  28           will be made to use "C" library functionality necessary for
  29           C++ named locale support.  For gcc 3.2.1 and later, this
  30           means that glibc 2.2.5 or later is required and the "C"
  31           library de_DE locale information must be installed.
  32         </p><p>
  33           Note however that the sanity checks involving the de_DE
  34           locale are skipped when an explicit --enable-clocale=gnu
  35           configure option is used: only the basic checks are carried
  36           out, defending against misconfigurations.
  37         </p><p>
  38           If the 'gnu' locale model is being used, the following
  39           locales are used and tested in the libstdc++ testsuites.
  40           The first column is the name of the locale, the second is
  41           the character set it is expected to use.
  42         </p><pre class="programlisting">
  43 de_DE               ISO-8859-1
  44 de_DE@euro          ISO-8859-15
  45 en_HK               ISO-8859-1
  46 en_PH               ISO-8859-1
  47 en_US               ISO-8859-1
  48 en_US.ISO-8859-1    ISO-8859-1
  49 en_US.ISO-8859-15   ISO-8859-15
  50 en_US.UTF-8         UTF-8
  51 es_ES               ISO-8859-1
  52 es_MX               ISO-8859-1
  53 fr_FR               ISO-8859-1
  54 fr_FR@euro          ISO-8859-15
  55 is_IS               UTF-8
  56 it_IT               ISO-8859-1
  57 ja_JP.eucjp         EUC-JP
  58 se_NO.UTF-8         UTF-8
  59 ta_IN               UTF-8
  60 zh_TW               BIG5
  61 </pre><p>Failure to have the underlying "C" library locale
  62       information installed will mean that C++ named locales for the
  63       above regions will not work: because of this, the libstdc++
  64       testsuite will skip the named locale tests. If this isn't an
  65       issue, don't worry about it. If named locales are needed, the
  66       underlying locale information must be installed. Note that
  67       rebuilding libstdc++ after the "C" locales are installed is not
  68       necessary.
  69       </p><p>
  70         To install support for locales, do only one of the following:
  71       </p><div class="itemizedlist"><ul type="disc"><li><p>install all locales</p><div class="itemizedlist"><ul type="circle"><li><p>with RedHat Linux:
  72               </p><p> <code class="code"> export LC_ALL=C </code>
  73               </p><p> <code class="code"> rpm -e glibc-common --nodeps </code>
  74               </p><p>
  75                 <code class="code"> rpm -i --define "_install_langs all"
  76                  glibc-common-2.2.5-34.i386.rpm
  77                 </code>
  78               </p></li><li><p>
  79                Instructions for other operating systems solicited.
  80              </p></li></ul></div></li><li><p>install just the necessary locales</p><div class="itemizedlist"><ul type="circle"><li><p>with Debian Linux:</p><p> Add the above list, as shown, to the file
  81               <code class="code">/etc/locale.gen</code> </p><p> run <code class="code">/usr/sbin/locale-gen</code> </p></li><li><p>on most Unix-like operating systems:</p><p><code class="code"> localedef -i de_DE -f ISO-8859-1 de_DE </code></p><p>(repeat for each entry in the above list) </p></li><li><p>
  82                Instructions for other operating systems solicited.
  83             </p></li></ul></div></li></ul></div></dd></dl></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="build.configure"></a>Make</h3></div></div></div><p>If you have never done this before, you should read the basic
  84       <a class="ulink" href="http://gcc.gnu.org/install/" target="_top">GCC Installation
  85       Instructions</a> first.  Read <span class="emphasis"><em>all of them</em></span>.
  86       <span class="emphasis"><em>Twice.</em></span>
  87    </p><p>When building libstdc++ you'll have to configure
  88       the entire <span class="emphasis"><em>gccsrcdir</em></span> directory.  The full list of libstdc++
  89       specific configuration options, not dependent on the specific compiler
  90       release being used, can be found <a class="ulink" href="configopts.html" target="_top">here</a>.
  91    </p><p>Consider possibly using --enable-languages=c++ to save time by only
  92       building the C++ language parts.
  93    </p><pre class="programlisting">
  94    cd <span class="emphasis"><em>gccbuilddir</em></span>
  95    <span class="emphasis"><em>gccsrcdir</em></span>/configure --prefix=<span class="emphasis"><em>destdir</em></span> --other-opts...</pre></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk01pt01ch02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="bk01pt01ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="test.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 2. Setup </td><td width="20%" align="center"><a accesskey="h" href="../spine.html">Home</a></td><td width="40%" align="right" valign="top"> Test</td></tr></table></div></body></html>