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

Last change on this file since d6d5866 was d6d5866, checked in by Ken Moffat <zarniwhoop@…>, 18 years ago

Log remaining glibc test results on multilibs, and look for errors.

  • Property mode set to 100644
File size: 6.8 KB
Line 
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
17  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
18  href="glibc.xml"
19  xpointer="xpointer(//*[@role='package'])"/>
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
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
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
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
60    <para os="m1">Tell Glibc to install its 64-bit libraries into
61    <filename class="directory">/lib64</filename>:</para>
62
63<screen os="m2"><userinput>echo "slibdir=/lib64" &gt;&gt; configparms</userinput></screen>
64
65    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
66    href="glibc.xml"
67    xpointer="xpointer(//*[@os='g'])"/>
68
69<screen os="h"><userinput>CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}" \
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
74    <variablelist os="i">
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    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
105    href="glibc.xml"
106    xpointer="xpointer(//*[@os='n'])"/>
107
108    <para os="o">The Glibc test suite is highly dependent on certain functions of
109    the host system, in particular the kernel. In general, the Glibc test
110    suite is always expected to pass. However, in certain circumstances,
111    some failures are unavoidable. This is a list of the most common
112    issues:</para>
113
114    <itemizedlist os="p">
115      <listitem>
116        <para>The <emphasis>math</emphasis> tests sometimes fail.
117        Certain optimization settings are known to be a
118        factor here.</para>
119      </listitem>
120      <listitem>
121        <para>The <emphasis>gettext</emphasis> test sometimes fails due to
122        host system issues. The exact reasons are not yet clear.</para>
123      </listitem>
124      <listitem>
125        <para>If you have mounted the CLFS partition with the
126        <parameter>noatime</parameter> option, the <emphasis>atime</emphasis> test
127        will fail. As mentioned in <xref linkend="ch-partitioning-mounting"/>,
128        do not use the <parameter>noatime</parameter> option while building
129        CLFS.</para>
130      </listitem>
131      <listitem>
132        <para>When running on older and slower hardware, some tests
133        can fail because of test timeouts being exceeded.</para>
134      </listitem>
135    </itemizedlist>
136
137    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
138    href="glibc.xml"
139    xpointer="xpointer(//*[@os='s'])"/>
140
141    <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
142    href="glibc.xml"
143    xpointer="xpointer(//*[@os='t'])"/>
144
145  </sect2>
146
147  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
148  href="../common/glibc.xml"
149  xpointer="xpointer(id('i18n-glibc'))"/>
150
151  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
152  href="../common/glibc.xml"
153  xpointer="xpointer(id('conf-glibc'))"/>
154
155  <sect2 id="conf-ld" role="configuration">
156    <title>Configuring The Dynamic Loader</title>
157
158    <indexterm zone="conf-ld">
159      <primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary>
160    </indexterm>
161
162    <para>By default, the dynamic loader (<filename
163    class="libraryfile">/lib/ld-linux.so.2</filename>) searches through
164    <filename class="directory">/lib</filename>,
165    <filename class="directory">/lib64</filename>,
166    <filename class="directory">/usr/lib</filename>,
167    and <filename class="directory">/usr/lib64</filename> for dynamic
168    libraries that are needed by programs as they are run. However, if
169    there are libraries in directories other than these, they need to be
170    added to the <filename>/etc/ld.so.conf</filename> file in order
171    for the dynamic loader to find them. Some directories that are commonly
172    known to contain additional libraries are
173    <filename class="directory">/usr/local/lib</filename>,
174    <filename class="directory">/usr/local/lib64</filename>,
175    <filename class="directory">/opt/lib</filename>,
176    and <filename class="directory">/opt/lib64</filename>,
177    so add those directories to the dynamic loader's search path.</para>
178
179    <para>Create a new file <filename>/etc/ld.so.conf</filename> by running the
180    following:</para>
181
182<screen><userinput>cat &gt; /etc/ld.so.conf &lt;&lt; "EOF"
183<literal># Begin /etc/ld.so.conf
184
185/usr/local/lib
186/usr/local/lib64
187/opt/lib
188/opt/lib64
189
190# End /etc/ld.so.conf</literal>
191EOF</userinput></screen>
192
193  </sect2>
194
195  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
196  href="../common/glibc.xml"
197  xpointer="xpointer(id('contents-glibc'))"/>
198
199</sect1>
Note: See TracBrowser for help on using the repository browser.