source: final-system/multilib/glibc-64bit.xml @ 4a0dbd7

Last change on this file since 4a0dbd7 was 4a0dbd7, checked in by Jim Gifford <clfs@…>, 18 years ago

r3968@server (orig r1784): jciccone | 2006-06-19 09:32:11 -0700
Added an iconv_fix patch to glibc which fixes an issue that has shown up primarily in samba.

  • Property mode set to 100644
File size: 6.8 KB
RevLine 
[bf8c11f]1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-glibc" role="wrap">
9  <?dbhtml filename="glibc-64bit.html"?>
10
11  <title>Glibc-&glibc-version; 64-Bit</title>
12
13  <indexterm zone="ch-system-glibc">
14    <primary sortas="a-Glibc">Glibc</primary>
15  </indexterm>
16
[a67c762]17  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
18  href="glibc.xml"
19  xpointer="xpointer(//*[@role='package'])"/>
[bf8c11f]20
21  <sect2 role="installation">
22    <title>Installation of Glibc</title>
23
24    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
25    href="glibc.xml"
26    xpointer="xpointer(//*[@os='b'])"/>
27
28    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
29    href="../common/glibc.xml"
30    xpointer="xpointer(//*[@os='c'])"/>
31
32    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
33    href="../common/glibc.xml"
34    xpointer="xpointer(//*[@os='d'])"/>
35
[4a0dbd7]36    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
37    href="../common/glibc.xml"
38    xpointer="xpointer(//*[@os='p1'])"/>
39
40    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
41    href="../common/glibc.xml"
42    xpointer="xpointer(//*[@os='p2'])"/>
43
[ea522c5]44    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
45    href="glibc.xml"
46    xpointer="xpointer(//*[@os='s1'])"/>
47
48    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
49    href="glibc.xml"
50    xpointer="xpointer(//*[@os='s2'])"/>
51
[bf8c11f]52    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
53    href="glibc.xml"
54    xpointer="xpointer(//*[@os='e'])"/>
55
56    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
57    href="glibc.xml"
58    xpointer="xpointer(//*[@os='f'])"/>
59
[8b86a2f]60    <para os="m1">Tell Glibc to install its 64-bit libraries into
[bf8c11f]61    <filename class="directory">/lib64</filename>:</para>
62
[c48c555]63<screen os="m2"><userinput>echo "slibdir=/lib64" &gt;&gt; configparms</userinput></screen>
[bf8c11f]64
65    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
66    href="glibc.xml"
67    xpointer="xpointer(//*[@os='g'])"/>
68
[c48c555]69<screen os="h"><userinput>CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}" \
[bf8c11f]70    ../glibc-&glibc-version;/configure --prefix=/usr \
71    --disable-profile --enable-add-ons --enable-kernel=2.6.0 \
72    --libexecdir=/usr/lib64/glibc --libdir=/usr/lib64</userinput></screen>
73
[c48c555]74    <variablelist os="i">
[bf8c11f]75      <title>The meaning of the new configure option:</title>
76
77      <varlistentry>
78        <term><parameter>--libexecdir=/usr/lib64/glibc</parameter></term>
79        <listitem>
80          <para>This changes the location of the <command>pt_chown</command>
81          program from its default of <filename
82          class="directory">/usr/libexec</filename> to <filename
83          class="directory">/usr/lib64/glibc</filename>.</para>
84        </listitem>
85      </varlistentry>
86    </variablelist>
87
88    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
89    href="glibc.xml"
90    xpointer="xpointer(//*[@os='j'])"/>
91
92    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
93    href="glibc.xml"
94    xpointer="xpointer(//*[@os='k'])"/>
95
96    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
97    href="glibc.xml"
98    xpointer="xpointer(//*[@os='l'])"/>
99
100    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
101    href="glibc.xml"
102    xpointer="xpointer(//*[@os='m'])"/>
103
104<!-- items n,o,p here are now the master, not multilib, because
105 the tests are known to all pass on multilib_64 -->
106
107<screen os="n"><userinput>make check</userinput></screen>
108
109    <para os="o">The Glibc test suite is highly dependent on certain functions of
110    the host system, in particular the kernel. In general, the Glibc test
111    suite is always expected to pass. However, in certain circumstances,
112    some failures are unavoidable. This is a list of the most common
113    issues:</para>
114
115    <itemizedlist os="p">
116      <listitem>
117        <para>The <emphasis>math</emphasis> tests sometimes fail.
118        Certain optimization settings are known to be a
119        factor here.</para>
120      </listitem>
121      <listitem>
122        <para>The <emphasis>gettext</emphasis> test sometimes fails due to
123        host system issues. The exact reasons are not yet clear.</para>
124      </listitem>
125      <listitem>
126        <para>If you have mounted the LFS partition with the
127        <parameter>noatime</parameter> option, the <emphasis>atime</emphasis> test
128        will fail. As mentioned in <xref linkend="ch-partitioning-mounting"/>,
129        do not use the <parameter>noatime</parameter> option while building
130        LFS.</para>
131      </listitem>
132      <listitem>
133        <para>When running on older and slower hardware, some tests
134        can fail because of test timeouts being exceeded.</para>
135      </listitem>
136    </itemizedlist>
137
138    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
139    href="glibc.xml"
140    xpointer="xpointer(//*[@os='s'])"/>
141
142    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
143    href="glibc.xml"
144    xpointer="xpointer(//*[@os='t'])"/>
145
146  </sect2>
147
148  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
149  href="../common/glibc.xml"
150  xpointer="xpointer(id('i18n-glibc'))"/>
151
152  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
153  href="../common/glibc.xml"
154  xpointer="xpointer(id('conf-glibc'))"/>
155
156  <sect2 id="conf-ld" role="configuration">
[dd9906e]157    <title>Configuring The Dynamic Loader</title>
[bf8c11f]158
159    <indexterm zone="conf-ld">
160      <primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary>
161    </indexterm>
162
163    <para>By default, the dynamic loader (<filename
164    class="libraryfile">/lib/ld-linux.so.2</filename>) searches through
[6de5a22]165    <filename class="directory">/lib</filename>,
[f32f537]166    <filename class="directory">/lib64</filename>,
[6de5a22]167    <filename class="directory">/usr/lib</filename>,
168    and <filename class="directory">/usr/lib64</filename> for dynamic
169    libraries that are needed by programs as they are run. However, if
170    there are libraries in directories other than these, they need to be
[bf8c11f]171    added to the <filename>/etc/ld.so.conf</filename> file in order
[a0418f7]172    for the dynamic loader to find them. Some directories that are commonly
[bf8c11f]173    known to contain additional libraries are
174    <filename class="directory">/usr/local/lib</filename>,
175    <filename class="directory">/usr/local/lib64</filename>,
176    <filename class="directory">/opt/lib</filename>,
177    and <filename class="directory">/opt/lib64</filename>,
178    so add those directories to the dynamic loader's search path.</para>
179
180    <para>Create a new file <filename>/etc/ld.so.conf</filename> by running the
181    following:</para>
182
183<screen><userinput>cat &gt; /etc/ld.so.conf &lt;&lt; "EOF"
184<literal># Begin /etc/ld.so.conf
185
186/usr/local/lib
187/usr/local/lib64
188/opt/lib
189/opt/lib64
190
191# End /etc/ld.so.conf</literal>
192EOF</userinput></screen>
193
194  </sect2>
195
196  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
197  href="../common/glibc.xml"
198  xpointer="xpointer(id('contents-glibc'))"/>
199
200</sect1>
Note: See TracBrowser for help on using the repository browser.