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

sysvinit
Last change on this file since e52599b was e52599b, checked in by William Harrington <kb0iic@…>, 9 years ago

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

  • Property mode set to 100644
File size: 7.3 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-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  </sect2>
159
160  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
161  href="../common/glibc.xml"
162  xpointer="xpointer(id('i18n-glibc'))"/>
163
164  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
165  href="../common/glibc.xml"
166  xpointer="xpointer(id('conf-glibc'))"/>
167
168  <sect2 id="conf-ld" role="configuration">
169    <title>Configuring The Dynamic Loader</title>
170
171    <indexterm zone="conf-ld">
172      <primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary>
173    </indexterm>
174
175    <para>By default, the dynamic loader (<filename
176    class="libraryfile">/lib/ld-linux-x86-64.so.2</filename>) searches through
177    <filename class="directory">/lib</filename> and <filename
178    class="directory">/usr/lib</filename> for dynamic libraries that are
179    needed by programs as they are run. However, if there are libraries in
180    directories other than <filename class="directory">/lib</filename> and
181    <filename class="directory">/usr/lib</filename>, these need to be
182    added to the <filename>/etc/ld.so.conf</filename> file in order
183    for the dynamic loader to find them. Two directories that are commonly
184    known to contain additional libraries are <filename
185    class="directory">/usr/local/lib</filename> and <filename
186    class="directory">/opt/lib</filename>, so add those directories to the
187    dynamic loader's search path.</para>
188
189    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
190    href="../common/glibc.xml"
191    xpointer="xpointer(//*[@os='ld-b'])"/>
192
193    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
194    href="../common/glibc.xml"
195    xpointer="xpointer(//*[@os='ld-c'])"/>
196
197  </sect2>
198
199  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
200  href="../common/glibc.xml"
201  xpointer="xpointer(id('contents-glibc'))"/>
202
203</sect1>
Note: See TracBrowser for help on using the repository browser.