source: BOOK/final-system/x86_64-64/glibc.xml @ 005d85d

Revision 005d85d, 7.6 KB checked in by William Harrington <kb0iic@…>, 3 years ago (diff)

We don't tell what glibc should do. We configure glibc to do what we want it to do.

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