source: BOOK/final-system/x86_64-64/eglibc.xml @ 22cd957

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since 22cd957 was 22cd957, checked in by Joe Ciccone <jciccone@…>, 13 years ago

Add a sed to EGLIBC in the final system that will fix an issue with
the installation test script.

  • Property mode set to 100644
File size: 7.1 KB
Line 
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-system-eglibc" role="wrap">
9  <?dbhtml filename="eglibc.html"?>
10
11  <title>EGLIBC-&eglibc-version;</title>
12
13  <indexterm zone="ch-system-eglibc">
14    <primary sortas="a-EGLIBC">EGLIBC</primary>
15  </indexterm>
16
17  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
18  href="../common/eglibc.xml"
19  xpointer="xpointer(//*[@role='package'])"/>
20
21  <sect2 role="installation">
22    <title>Installation of EGLIBC</title>
23
24    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
25    href="../common/eglibc.xml"
26    xpointer="xpointer(//*[@os='z'])"/>
27
28    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
29    href="../common/eglibc.xml"
30    xpointer="xpointer(//*[@os='l1'])"/>
31
32    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
33    href="../common/eglibc.xml"
34    xpointer="xpointer(//*[@os='l2'])"/>
35
36    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
37    href="../common/eglibc.xml"
38    xpointer="xpointer(//*[@os='l3'])"/>
39
40    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
41    href="../common/eglibc.xml"
42    xpointer="xpointer(//*[@os='l4'])"/>
43
44    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
45    href="../common/eglibc.xml"
46    xpointer="xpointer(//*[@os='b'])"/>
47
48    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
49    href="../common/eglibc.xml"
50    xpointer="xpointer(//*[@os='e'])"/>
51
52    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
53    href="../common/eglibc.xml"
54    xpointer="xpointer(//*[@os='f'])"/>
55
56    <para os="l1">Tell EGLIBC to install its libraries into
57    <filename class="directory">/lib</filename>:</para>
58
59<screen os="l2"><userinput>echo "slibdir=/lib" &gt;&gt; configparms</userinput></screen>
60
61    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
62    href="../common/eglibc.xml"
63    xpointer="xpointer(//*[@os='g'])"/>
64
65<screen os="h"><userinput>CFLAGS="-mtune=generic -g -O2" \
66    ../eglibc-&eglibc-version;/configure --prefix=/usr \
67    --disable-profile --enable-add-ons --enable-kernel=2.6.0 \
68    --libexecdir=/usr/lib/eglibc --libdir=/usr/lib</userinput></screen>
69
70    <variablelist os="i">
71      <title>The meaning of the new configure option:</title>
72
73      <varlistentry>
74        <term><parameter>--libexecdir=/usr/lib/eglibc</parameter></term>
75        <listitem>
76          <para>This changes the location of the <command>pt_chown</command>
77          program from its default of <filename
78          class="directory">/usr/libexec</filename> to <filename
79          class="directory">/usr/lib/eglibc</filename>.</para>
80        </listitem>
81      </varlistentry>
82    </variablelist>
83
84    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
85    href="../common/eglibc.xml"
86    xpointer="xpointer(//*[@os='j'])"/>
87
88    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
89    href="../common/eglibc.xml"
90    xpointer="xpointer(//*[@os='k'])"/>
91
92    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
93    href="../common/eglibc.xml"
94    xpointer="xpointer(//*[@os='l'])"/>
95
96    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
97    href="../common/eglibc.xml"
98    xpointer="xpointer(//*[@os='m'])"/>
99
100    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
101    href="../multilib/eglibc-64bit.xml"
102    xpointer="xpointer(//*[@os='n'])"/>
103
104    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
105    href="../multilib/eglibc-64bit.xml"
106    xpointer="xpointer(//*[@os='o'])"/>
107
108    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
109    href="../multilib/eglibc-64bit.xml"
110    xpointer="xpointer(//*[@os='p'])"/>
111
112    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
113    href="../common/eglibc.xml"
114    xpointer="xpointer(//*[@os='q'])"/>
115
116    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
117    href="../common/eglibc.xml"
118    xpointer="xpointer(//*[@os='r'])"/>
119
120    <para>The install will finish by checking that everything is correctly installed.
121    Unfortunately, it will test for a multilib installation. On x86_64 Pure64 this means
122    it will try to test the non-existent 32-bit loader which has a different name
123    from the 64-bit loader (unlike on other 64-bit architectures).  We fool it by
124    creating a symlink to the real loader.</para>
125
126    <screen><userinput>ln -sv &eglibc-ld-name; /lib/ld-linux.so.2</userinput></screen>
127
128    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
129    href="../common/eglibc.xml"
130    xpointer="xpointer(//*[@os='s'])"/>
131
132    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
133    href="../common/eglibc.xml"
134    xpointer="xpointer(//*[@os='t'])"/>
135
136    <para>Now we can remove this symlink.  We also need to correct the <command>
137    /usr/bin/ldd</command> script - if you look at this, you will see it references
138    not only the 32-bit linker, but also /lib64 where it thinks the 64-bit linker
139    is. The following <command>sed</command> will correct this:</para>
140
141    <screen><userinput>rm -v /lib/ld-linux.so.2
142cp -v /usr/bin/ldd{,.bak}
143sed '/RTLDLIST/s%/ld-linux.so.2 /lib64%%' /usr/bin/ldd.bak >/usr/bin/ldd</userinput></screen>
144
145    <para>Check the script to make sure the sed worked correctly, then delete
146    the backup.</para>
147
148    <screen><userinput>rm -v /usr/bin/ldd.bak</userinput></screen>
149
150  </sect2>
151
152  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
153  href="../common/eglibc.xml"
154  xpointer="xpointer(id('i18n-eglibc'))"/>
155
156  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
157  href="../common/eglibc.xml"
158  xpointer="xpointer(id('conf-eglibc'))"/>
159
160  <sect2 id="conf-ld" role="configuration">
161    <title>Configuring The Dynamic Loader</title>
162
163    <indexterm zone="conf-ld">
164      <primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary>
165    </indexterm>
166
167    <para>By default, the dynamic loader (<filename
168    class="libraryfile">/lib/ld-linux-x86-64.so.2</filename>) searches through
169    <filename class="directory">/lib</filename> and <filename
170    class="directory">/usr/lib</filename> for dynamic libraries that are
171    needed by programs as they are run. However, if there are libraries in
172    directories other than <filename class="directory">/lib</filename> and
173    <filename class="directory">/usr/lib</filename>, these need to be
174    added to the <filename>/etc/ld.so.conf</filename> file in order
175    for the dynamic loader to find them. Two directories that are commonly
176    known to contain additional libraries are <filename
177    class="directory">/usr/local/lib</filename> and <filename
178    class="directory">/opt/lib</filename>, so add those directories to the
179    dynamic loader's search path.</para>
180
181    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
182    href="../common/eglibc.xml"
183    xpointer="xpointer(//*[@os='ld-b'])"/>
184
185    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
186    href="../common/eglibc.xml"
187    xpointer="xpointer(//*[@os='ld-c'])"/>
188
189  </sect2>
190
191  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
192  href="../common/eglibc.xml"
193  xpointer="xpointer(id('contents-eglibc'))"/>
194
195</sect1>
Note: See TracBrowser for help on using the repository browser.