<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta name="AUTHOR" content="pme@gcc.gnu.org (Phil Edwards)" /> <meta name="KEYWORDS" content="libstdc++, libstdc++-v3, GCC, g++" /> <meta name="DESCRIPTION" content="README for the GNU libstdc++ effort." /> <meta name="GENERATOR" content="vi and eight fingers" /> <title>libstdc++-v3 Installation Instructions</title> <link rel="StyleSheet" href="lib3styles.css" type="text/css" /> <link rel="Copyright" href="17_intro/license.html" type="text/html" /> </head> <body> <h1 class="centered"><a name="top">Getting started: configure, build, install</a></h1> <p class="fineprint"><em> The latest version of this document is always available at <a href="http://gcc.gnu.org/onlinedocs/libstdc++/install.html"> http://gcc.gnu.org/onlinedocs/libstdc++/install.html</a>. </em></p> <p><em> To the <a href="http://gcc.gnu.org/libstdc++/">libstdc++-v3 homepage</a>. </em></p> <!-- ####################################################### --> <hr /> <h2>Contents</h2> <p>Because libstdc++-v3 is part of GCC, the primary source for installation instructions is <a href="http://gcc.gnu.org/install/">the GCC install page</a>. Additional data is given here only where it applies to libstdc++-v3. </p> <ul> <li><a href="#prereqs">Tools you will need beforehand</a></li> <li><a href="#config">Configuring</a></li> <li><a href="#usage">Using the library</a></li> </ul> <hr /> <!-- ####################################################### --> <h2><a name="prereqs">Tools you will need beforehand</a></h2> <p>The list of software needed to build the library is kept with the rest of the compiler, at <a href="http://gcc.gnu.org/install/prerequisites.html"> http://gcc.gnu.org/install/prerequisites.html</a>. The same page also lists the tools you will need if you wish to modify the source. </p> <p>As of June 19, 2000, libstdc++ attempts to use tricky and space-saving features of the GNU toolchain, enabled with <code>-ffunction-sections -fdata-sections -Wl,--gc-sections</code>. To obtain maximum benefit from this, binutils after this date should also be used (bugs were fixed with C++ exception handling related to this change in libstdc++-v3). The version of these tools should be <code>2.10.90</code>, or later, and you can get snapshots (as well as releases) of binutils <a href="ftp://sources.redhat.com/pub/binutils">here</a>. The configure process will automatically detect and use these features if the underlying support is present. </p> <p>Finally, a few system-specific requirements: </p> <dl> <dt> linux </dt> <dd>If gcc 3.1.0 or later on is being used on linux, an attempt will be made to use "C" library functionality necessary for C++ named locale support. For gcc 3.2.1 and later, this means that glibc 2.2.5 or later is required. <p> The configure option --enable-clocale can be used force a particular behavior. </p> <p> If the 'gnu' locale model is being used, the following locales are used and tested in the libstdc++ testsuites. The first column is the name of the locale, the second is the character set it is expected to use. </p> <pre> de_DE ISO-8859-1 de_DE@euro ISO-8859-15 en_HK ISO-8859-1 en_PH ISO-8859-1 en_US ISO-8859-1 en_US.ISO-8859-1 ISO-8859-1 en_US.ISO-8859-15 ISO-8859-15 en_US.UTF-8 UTF-8 es_ES ISO-8859-1 es_MX ISO-8859-1 fr_FR ISO-8859-1 fr_FR@euro ISO-8859-15 is_IS UTF-8 it_IT ISO-8859-1 ja_JP.eucjp EUC-JP se_NO.UTF-8 UTF-8 ta_IN UTF-8 zh_TW BIG5 </pre> <p>Failure to have the underlying "C" library locale information installed will mean that C++ named locales for the above regions will not work: because of this, the libstdc++ testsuite will not pass the named locale tests. If this isn't an issue, don't worry about it. If named locales are needed, the underlying locale information must be installed. Note that rebuilding libstdc++ after the "C" locales are installed is not necessary. </p> <p>To install support for locales, do only one of the following: </p> <ul> <li> install all locales <ul> <li>with RedHat Linux: <p> <code> export LC_ALL=C </code> </p> <p> <code> rpm -e glibc-common --nodeps </code> </p> <p> <code> rpm -i --define "_install_langs all" glibc-common-2.2.5-34.i386.rpm </code> </p> </li> <li> (instructions for other operating systems solicited) </li> </ul> </li> <li> install just the necessary locales <ul> <li>with Debian Linux: <p> Add the above list, as shown, to the file <code>/etc/locale.gen</code> </p> <p> run <code>/usr/sbin/locale-gen</code> </p> </li> <li> on most Unix-like operating systems: <p> <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> (instructions for other operating systems solicited) </li> </ul> </li> </ul> </dd> </dl> <hr /> <h2><a name="config">Configuring</a></h2> <p>If you have never done this before, you should read the basic <a href="http://gcc.gnu.org/install/">GCC Installation Instructions</a> first. Read <em>all of them</em>. <strong>Twice.</strong> </p> <p>When building libstdc++-v3 you'll have to configure the entire <em>gccsrcdir</em> directory. The full list of libstdc++-v3 specific configuration options, not dependent on the specific compiler release being used, can be found <a href="configopts.html">here</a>. </p> <p>Consider possibly using --enable-languages=c++ to save time by only building the C++ language parts. </p> <pre> cd <em>gccbuilddir</em> <em>gccsrcdir</em>/configure --prefix=<em>destdir</em> --other-opts...</pre> <hr /> <h2><a name="usage">Using the library</a></h2> <h3>Find the new library at runtime (shared linking only)</h3> <p>If you only built a static library (libstdc++.a), or if you specified static linking, you don't have to worry about this. But if you built a shared library (libstdc++.so) and linked against it, then you will need to find that library when you run the executable. </p> <p>Methods vary for different platforms and different styles, but the usual ones are printed to the screen during installation. They include: </p> <ul> <li>At runtime set LD_LIBRARY_PATH in your environment correctly, so that the shared library for libstdc++ can be found and loaded. Be certain that you understand all of the other implications and behavior of LD_LIBRARY_PATH first (few people do, and they get into trouble). </li> <li>Compile the path to find the library at runtime into the program. This can be done by passing certain options to g++, which will in turn pass them on to the linker. The exact format of the options is dependent on which linker you use: <ul> <li>GNU ld (default on Linux):<code> -Wl,--rpath,<em>destdir</em>/lib</code></li> <li>IRIX ld:<code> -Wl,-rpath,<em>destdir</em>/lib</code></li> <li>Solaris ld:<code> -Wl,-R<em>destdir</em>/lib</code></li> <li>More...? Let us know!</li> </ul> </li> </ul> <p>Use the <code>ldd(1)</code> utility to show which library the system thinks it will get at runtime. </p> <p>A libstdc++.la file is also installed, for use with Libtool. If you use Libtool to create your executables, these details are taken care of for you. </p> <!-- <hr /> <h2><a name=""></a></h2> <p> </p> --> <!-- ####################################################### --> <hr /> <p class="fineprint"><em> See <a href="17_intro/license.html">license.html</a> for copying conditions. Comments and suggestions are welcome, and may be sent to <a href="mailto:libstdc++@gcc.gnu.org">the libstdc++ mailing list</a>. </em></p> </body> </html>