chapter05/glibc.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-tools-glibc" role="wrap">
   9   <?dbhtml filename="glibc.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>glibc</productname>
  13     <productnumber>&glibc-version;</productnumber>
  14     <address>&glibc-url;</address>
  15   </sect1info>
  16
  17   <title>Glibc-&glibc-version;</title>
  18
  19   <indexterm zone="ch-tools-glibc">
  20     <primary sortas="a-Glibc">Glibc</primary>
  21     <secondary>tools</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  28     href="../chapter06/glibc.xml"
  29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&glibc-ch5-sbu;</seg>
  37         <seg>&glibc-ch5-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Glibc</title>
  45
  46     <para>Fix a bug that prevents Glibc from building with GCC-&gcc-version;:</para>
  47
  48 <screen><userinput remap="pre">patch -Np1 -i ../&glibc-gcc_fix-patch;</userinput></screen>
  49
  50     <para>The Glibc documentation recommends building Glibc outside of the source
  51     directory in a dedicated build directory:</para>
  52
  53 <screen><userinput remap="pre">mkdir -v ../glibc-build
  54 cd ../glibc-build</userinput></screen>
  55
  56     <para>Because Glibc no longer supports i386, its developers say to use the
  57     compiler flag <parameter>-march=i486</parameter> when building it for x86
  58     machines. There are several ways to accomplish that, but testing shows that
  59     the flag is best placed inside the build variable <quote>CFLAGS</quote>.
  60     Instead of overriding completely what Glibc's internal build system uses
  61     for CFLAGS, append the new flag to the existing contents of CFLAGS by
  62     making use of the special file <filename>configparms</filename>. The
  63     -mtune=native flag is also necessary to reset a reasonable value for -mtune
  64     that is changed when setting -march.</para>
  65
  66 <screen><userinput remap="configure">case `uname -m` in
  67   i?86) echo "CFLAGS += -march=i486 -mtune=native" &gt; configparms ;;
  68 esac</userinput></screen>
  69
  70     <para>Next, prepare Glibc for compilation:</para>
  71
  72 <screen><userinput remap="configure">../glibc-&glibc-version;/configure --prefix=/tools \
  73     --host=$LFS_TGT --build=$(../glibc-&glibc-version;/scripts/config.guess) \
  74     --disable-profile --enable-add-ons \
  75     --enable-kernel=2.6.22.5 --with-headers=/tools/include \
  76     libc_cv_forced_unwind=yes libc_cv_c_cleanup=yes</userinput></screen>
  77
  78     <variablelist>
  79       <title>The meaning of the configure options:</title>
  80
  81       <varlistentry>
  82         <term><parameter>--host=$LFS_TGT, --build=$(../glibc-&glibc-version;/scripts/config.guess)</parameter></term>
  83         <listitem>
  84           <para>The combined effect of these switches is that Glibc's build system
  85           configures itself to cross-compile, using the cross-linker and
  86           cross-compiler in <filename class="directory">/tools</filename>.</para>
  87         </listitem>
  88       </varlistentry>
  89
  90       <varlistentry>
  91         <term><parameter>--disable-profile</parameter></term>
  92         <listitem>
  93           <para>This builds the libraries without profiling information. Omit
  94           this option if profiling on the temporary tools is necessary.</para>
  95         </listitem>
  96       </varlistentry>
  97
  98       <varlistentry>
  99         <term><parameter>--enable-add-ons</parameter></term>
 100         <listitem>
 101           <para>This tells Glibc to use the NPTL add-on as its threading
 102           library.</para>
 103         </listitem>
 104       </varlistentry>
 105
 106       <varlistentry>
 107         <term><parameter>--enable-kernel=2.6.18</parameter></term>
 108         <listitem>
 109           <para>This tells Glibc to compile the library with support
 110           for 2.6.18 and later Linux kernels.  Workarounds for older
 111           kernels are not enabled.</para>
 112         </listitem>
 113       </varlistentry>
 114
 115       <varlistentry>
 116         <term><parameter>--with-headers=/tools/include</parameter></term>
 117         <listitem>
 118           <para>This tells Glibc to compile itself against the headers recently
 119           installed to the tools directory, so that it knows exactly what
 120           features the kernel has and can optimize itself accordingly.</para>
 121         </listitem>
 122       </varlistentry>
 123
 124       <varlistentry>
 125         <term><parameter>libc_cv_forced_unwind=yes</parameter></term>
 126         <listitem>
 127           <para>The linker installed during
 128           <xref linkend="ch-tools-binutils-pass1"/> was cross-compiled and as
 129           such cannot be used until Glibc has been installed.  This means that
 130           the configure test for force-unwind support will fail, as it relies on
 131           a working linker.  The libc_cv_forced_unwind=yes variable is passed in
 132           order to inform <command>configure</command> that force-unwind
 133           support is available without it having to run the test.</para>
 134         </listitem>
 135       </varlistentry>
 136       <varlistentry>
 137         <term><parameter>libc_cv_c_cleanup=yes</parameter></term>
 138         <listitem>
 139           <para>Simlarly, we pass libc_cv_c_cleanup=yes through to the
 140           <command>configure</command> script so that the test is skipped and C
 141           cleanup handling support is configured.</para>
 142         </listitem>
 143       </varlistentry>
 144
 145     </variablelist>
 146
 147     <para>During this stage the following warning might appear:</para>
 148
 149     <blockquote>
 150 <screen><computeroutput>configure: WARNING:
 151 *** These auxiliary programs are missing or
 152 *** incompatible versions: msgfmt
 153 *** some features will be disabled.
 154 *** Check the INSTALL file for required versions.</computeroutput></screen>
 155     </blockquote>
 156
 157     <para>The missing or incompatible <command>msgfmt</command> program is
 158     generally harmless. This <command>msgfmt</command> program is part of the
 159     Gettext package which the host distribution should provide.</para>
 160
 161     <para>Compile the package:</para>
 162
 163 <screen><userinput remap="make">make</userinput></screen>
 164
 165     <para>This package does come with a test suite, however, it cannot be
 166     run at this time because we do not have a C++ compiler yet.</para>
 167
 168     <note>
 169       <para>The test suite also requires locale data to be installed in order to run
 170       successfully. Locale data provides information to the system regarding
 171       such things as the date, time, and currency formats accepted and output by
 172       system utilities. If the test suites are not being run in this chapter
 173       (as per the recommendation), there is no need to install the locales now.
 174       The appropriate locales will be installed in the next chapter. To install
 175       the Glibc locales anyway, use instructions from <xref
 176       linkend="ch-system-glibc" role="."/></para>
 177     </note>
 178
 179     <para>Install the package:</para>
 180
 181 <screen><userinput remap="install">make install</userinput></screen>
 182
 183   </sect2>
 184
 185   <sect2 role="content">
 186     <title/>
 187
 188     <para>Details on this package are located in
 189     <xref linkend="contents-glibc" role="."/></para>
 190
 191   </sect2>
 192
 193 </sect1>