1<sect1 id="manual.intro.setup.prereq" xreflabel="Prerequisites"> 2<?dbhtml filename="prerequisites.html"?> 3 4<sect1info> 5 <keywordset> 6 <keyword> 7 ISO C++ 8 </keyword> 9 <keyword> 10 Prerequisites 11 </keyword> 12 </keywordset> 13</sect1info> 14 15<title>Prerequisites</title> 16 17<para> 18 Because libstdc++ is part of GCC, the primary source for 19 installation instructions is 20 <ulink url="http://gcc.gnu.org/install/">the GCC install page</ulink>. 21 In particular, list of prerequisite software needed to build the library 22 <ulink url="http://gcc.gnu.org/install/prerequisites.html"> 23 starts with those requirements.</ulink> The same pages also list 24 the tools you will need if you wish to modify the source. 25</para> 26 27 <para> 28 Additional data is given here only where it applies to libstdc++. 29 </para> 30 31 <para>As of GCC 4.0.1 the minimum version of binutils required to build 32 libstdc++ is <code>2.15.90.0.1.1</code>. You can get snapshots 33 (as well as releases) of binutils from 34 <ulink url="ftp://sources.redhat.com/pub/binutils/"> 35 ftp://sources.redhat.com/pub/binutils</ulink>. 36 Older releases of libstdc++ do not require such a recent version, 37 but to take full advantage of useful space-saving features and 38 bug-fixes you should use a recent binutils whenever possible. 39 The configure process will automatically detect and use these 40 features if the underlying support is present. 41 </para> 42 43 <para> 44 Finally, a few system-specific requirements: 45 </para> 46 47 <variablelist> 48 <varlistentry> 49 <term>linux</term> 50 51 <listitem> 52 <para> 53 If gcc 3.1.0 or later on is being used on linux, an attempt 54 will be made to use "C" library functionality necessary for 55 C++ named locale support. For gcc 3.2.1 and later, this 56 means that glibc 2.2.5 or later is required and the "C" 57 library de_DE locale information must be installed. 58 </para> 59 60 <para> 61 Note however that the sanity checks involving the de_DE 62 locale are skipped when an explicit --enable-clocale=gnu 63 configure option is used: only the basic checks are carried 64 out, defending against misconfigurations. 65 </para> 66 67 <para> 68 If the 'gnu' locale model is being used, the following 69 locales are used and tested in the libstdc++ testsuites. 70 The first column is the name of the locale, the second is 71 the character set it is expected to use. 72 </para> 73<programlisting> 74de_DE ISO-8859-1 75de_DE@euro ISO-8859-15 76en_GB ISO-8859-1 77en_HK ISO-8859-1 78en_PH ISO-8859-1 79en_US ISO-8859-1 80en_US.ISO-8859-1 ISO-8859-1 81en_US.ISO-8859-15 ISO-8859-15 82en_US.UTF-8 UTF-8 83es_ES ISO-8859-1 84es_MX ISO-8859-1 85fr_FR ISO-8859-1 86fr_FR@euro ISO-8859-15 87is_IS UTF-8 88it_IT ISO-8859-1 89ja_JP.eucjp EUC-JP 90ru_RU.ISO-8859-5 ISO-8859-5 91ru_RU.UTF-8 UTF-8 92se_NO.UTF-8 UTF-8 93ta_IN UTF-8 94zh_TW BIG5 95</programlisting> 96 97 <para>Failure to have the underlying "C" library locale 98 information installed will mean that C++ named locales for the 99 above regions will not work: because of this, the libstdc++ 100 testsuite will skip the named locale tests. If this isn't an 101 issue, don't worry about it. If named locales are needed, the 102 underlying locale information must be installed. Note that 103 rebuilding libstdc++ after the "C" locales are installed is not 104 necessary. 105 </para> 106 107 <para> 108 To install support for locales, do only one of the following: 109 </para> 110 111 <itemizedlist> 112 <listitem> 113 <para>install all locales</para> 114 <itemizedlist> 115 <listitem> 116 <para>with RedHat Linux: 117 </para> 118 <para> <code> export LC_ALL=C </code> 119 </para> 120 <para> <code> rpm -e glibc-common --nodeps </code> 121 </para> 122 <para> 123 <code> rpm -i --define "_install_langs all" 124 glibc-common-2.2.5-34.i386.rpm 125 </code> 126 </para> 127 </listitem> 128 <listitem> 129 <para> 130 Instructions for other operating systems solicited. 131 </para> 132 </listitem> 133 </itemizedlist> 134 </listitem> 135 <listitem> 136 <para>install just the necessary locales</para> 137 <itemizedlist> 138 <listitem> 139 <para>with Debian Linux:</para> 140 <para> Add the above list, as shown, to the file 141 <code>/etc/locale.gen</code> </para> 142 <para> run <code>/usr/sbin/locale-gen</code> </para> 143 </listitem> 144 <listitem> 145 <para>on most Unix-like operating systems:</para> 146 <para><code> localedef -i de_DE -f ISO-8859-1 de_DE </code></para> 147 <para>(repeat for each entry in the above list) </para> 148 </listitem> 149 <listitem> 150 <para> 151 Instructions for other operating systems solicited. 152 </para> 153 </listitem> 154 </itemizedlist> 155 </listitem> 156 </itemizedlist> 157 </listitem> 158 </varlistentry> 159 </variablelist> 160 161</sect1> 162