source: chapter05/glibc.xml@ 4a9c50a

multilib
Last change on this file since 4a9c50a was f8a76cb, checked in by Thomas Trepl <thomas@…>, 10 months ago

Automatic merge of trunk into multilib

  • Property mode set to 100644
File size: 15.0 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-tools-glibc" role="wrap">
9 <?dbhtml filename="glibc.html"?>
10
11 <sect1info condition="script">
12 <productname>glibc</productname>
13 <productnumber>&glibc-version;</productnumber>
14 <address>&glibc-url;</address>
15 </sect1info>
16
17 <title>Glibc-&glibc-version;</title>
18
19 <indexterm zone="ch-tools-glibc">
20 <primary sortas="a-Glibc">Glibc</primary>
21 <secondary>tools</secondary>
22 </indexterm>
23
24 <sect2 role="package">
25 <title/>
26
27 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
28 href="../chapter08/glibc.xml"
29 xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
30
31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
34
35 <seglistitem>
36 <seg>&glibc-tmp-sbu;</seg>
37 <seg>&glibc-tmp-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Glibc</title>
45
46 <para>First, create a symbolic link for LSB compliance. Additionally,
47 for x86_64, create a compatibility symbolic link required for proper
48 operation of the dynamic library loader:</para>
49
50<screen arch="default"><userinput remap="pre">case $(uname -m) in
51 i?86) ln -sfv ld-linux.so.2 $LFS/lib/ld-lsb.so.3
52 ;;
53 x86_64) ln -sfv ../lib/ld-linux-x86-64.so.2 $LFS/lib64
54 ln -sfv ../lib/ld-linux-x86-64.so.2 $LFS/lib64/ld-lsb-x86-64.so.3
55 ;;
56esac</userinput></screen>
57<!-- no ld-linux.so.2 here as multilib is based on x86_64, not on i686 -->
58<screen arch="ml_32,ml_x32,ml_all"><userinput remap="pre">ln -sfv ../lib/ld-linux-x86-64.so.2 $LFS/lib64
59ln -sfv ../lib/ld-linux-x86-64.so.2 $LFS/lib64/ld-lsb-x86-64.so.3</userinput></screen>
60
61 <note>
62 <para>
63 The above command is correct. The <command>ln</command> command has
64 several syntactic versions, so be sure to check
65 <command>info coreutils ln</command> and <filename>ln(1)</filename>
66 before reporting what may appear to be an error.
67 </para>
68 </note>
69
70 <para>Some of the Glibc programs use the non-FHS-compliant
71 <filename class="directory">/var/db</filename> directory to store their
72 runtime data. Apply the following patch to make such programs store their
73 runtime data in the FHS-compliant locations:</para>
74
75<screen><userinput remap="pre">patch -Np1 -i ../glibc-&glibc-version;-fhs-1.patch</userinput></screen>
76
77 <para>The Glibc documentation recommends building Glibc
78 in a dedicated build directory:</para>
79
80<screen><userinput remap="pre">mkdir -v build
81cd build</userinput></screen>
82
83 <para>Ensure that the <command>ldconfig</command> and <command>sln</command>
84 utilities are installed into
85 <filename class="directory">/usr/sbin</filename>:</para>
86
87<screen><userinput remap="pre">echo "rootsbindir=/usr/sbin" &gt; configparms</userinput></screen>
88
89 <para>Next, prepare Glibc for compilation:</para>
90
91<screen arch="default"><userinput remap="configure">../configure \
92 --prefix=/usr \
93 --host=$LFS_TGT \
94 --build=$(../scripts/config.guess) \
95 --enable-kernel=&min-kernel; \
96 --with-headers=$LFS/usr/include \
97 --disable-nscd \
98 libc_cv_slibdir=/usr/lib</userinput></screen>
99<screen arch="ml_32,ml_x32,ml_all"><userinput remap="configure">../configure \
100 --prefix=/usr \
101 --host=$LFS_TGT \
102 --build=$(../scripts/config.guess) \
103 --enable-kernel=&min-kernel; \
104 --with-headers=$LFS/usr/include \
105 --enable-multi-arch \
106 libc_cv_slibdir=/usr/lib</userinput></screen>
107
108 <variablelist>
109 <title>The meaning of the configure options:</title>
110
111 <varlistentry>
112 <term><parameter>--host=$LFS_TGT, --build=$(../scripts/config.guess)</parameter></term>
113 <listitem>
114 <para>The combined effect of these switches is that Glibc's build system
115 configures itself to be cross-compiled, using the cross-linker and
116 cross-compiler in <filename class="directory">$LFS/tools</filename>.</para>
117 </listitem>
118 </varlistentry>
119
120 <varlistentry>
121 <term><parameter>--enable-kernel=&min-kernel;</parameter></term>
122 <listitem>
123 <para>This tells Glibc to compile the library with support
124 for &min-kernel; and later Linux kernels. Workarounds for older
125 kernels are not enabled.</para>
126 </listitem>
127 </varlistentry>
128
129 <varlistentry>
130 <term><parameter>--with-headers=$LFS/usr/include</parameter></term>
131 <listitem>
132 <para>This tells Glibc to compile itself against the headers
133 recently installed to the $LFS/usr/include directory, so that
134 it knows exactly what features the kernel has and can optimize
135 itself accordingly.</para>
136 </listitem>
137 </varlistentry>
138
139 <varlistentry>
140 <term><parameter>libc_cv_slibdir=/usr/lib</parameter></term>
141 <listitem>
142 <para>This ensures that the library is installed in /usr/lib instead
143 of the default /lib64 on 64-bit machines.</para>
144 </listitem>
145 </varlistentry>
146
147 <varlistentry>
148 <term><parameter>--disable-nscd</parameter></term>
149 <listitem>
150 <para>Do not build the name service cache daemon which is no
151 longer used.</para>
152 </listitem>
153 </varlistentry>
154
155 </variablelist>
156
157 <para>During this stage the following warning might appear:</para>
158
159 <blockquote>
160<screen><computeroutput>configure: WARNING:
161*** These auxiliary programs are missing or
162*** incompatible versions: msgfmt
163*** some features will be disabled.
164*** Check the INSTALL file for required versions.</computeroutput></screen>
165 </blockquote>
166
167 <para>The missing or incompatible <command>msgfmt</command> program is
168 generally harmless. This <command>msgfmt</command> program is part of the
169 Gettext package, which the host distribution should provide.</para>
170
171 <note><para>There have been reports that this package may fail when
172 building as a "parallel make". If that occurs, rerun the make command
173 with the "-j1" option.</para></note>
174
175 <para>Compile the package:</para>
176
177<screen><userinput remap="make">make</userinput></screen>
178
179 <para>Install the package:</para>
180
181 <warning><para>If <envar>LFS</envar> is not properly set, and despite the
182 recommendations, you are building as
183 <systemitem class="username">root</systemitem>, the next command will
184 install the newly built Glibc to your host system, which will almost
185 certainly render it unusable. So double-check that the environment is
186 correctly set, and that you are not &root;, before running the following command.</para></warning>
187
188<screen><userinput remap="install">make DESTDIR=$LFS install</userinput></screen>
189
190 <variablelist>
191 <title>The meaning of the <command>make install</command> option:</title>
192
193 <varlistentry>
194 <term><parameter>DESTDIR=$LFS</parameter></term>
195 <listitem>
196 <para>The <envar>DESTDIR</envar> make variable is used by almost all
197 packages to define the location where the package should be
198 installed. If it is not set, it defaults to the root (<filename
199 class="directory">/</filename>) directory. Here we specify that
200 the package is installed in <filename class="directory">$LFS
201 </filename>, which will become the root directory in <xref linkend=
202 "ch-tools-chroot"/>.</para>
203 </listitem>
204 </varlistentry>
205
206 </variablelist>
207
208 <para>Fix a hard coded path to the executable loader in the
209 <command>ldd</command> script:</para>
210
211<screen><userinput remap="install">sed '/RTLDLIST=/s@/usr@@g' -i $LFS/usr/bin/ldd</userinput></screen>
212
213 <caution>
214 <para>At this point, it is imperative to stop and ensure that the basic
215 functions (compiling and linking) of the new toolchain are working as
216 expected. To perform a sanity check, run the following commands:</para>
217
218<screen><userinput>echo 'int main(){}' | $LFS_TGT-gcc -xc -
219readelf -l a.out | grep ld-linux</userinput></screen>
220
221 <para>If everything is working correctly, there should be no errors,
222 and the output of the last command will be of the form:</para>
223
224<screen><computeroutput>[Requesting program interpreter: /lib64/ld-linux-x86-64.so.2]</computeroutput></screen>
225
226 <para arch="default">Note that for 32-bit machines, the interpreter name will be
227 <filename>/lib/ld-linux.so.2</filename>.</para>
228
229 <para>If the output is not as shown above, or there is no output at all,
230 then something is wrong. Investigate and retrace the steps to find out
231 where the problem is and correct it. This issue must be resolved before
232 continuing.</para>
233
234 <para>Once all is well, clean up the test file:</para>
235
236<screen><userinput>rm -v a.out</userinput></screen>
237
238 </caution>
239
240 <note><para>Building the packages in the next chapter will serve as an
241 additional check that the toolchain has been built properly. If some
242 package, especially Binutils-pass2 or GCC-pass2, fails to build, it is
243 an indication that something has gone wrong with the
244 preceding Binutils, GCC, or Glibc installations.</para></note>
245<!--
246 <para>Now that our cross-toolchain is complete, finalize the installation
247 of the limits.h header. To do this, run a utility provided by the GCC
248 developers:</para>
249
250<screen><userinput>$LFS/tools/libexec/gcc/$LFS_TGT/&gcc-version;/install-tools/mkheaders</userinput></screen>
251-->
252 </sect2>
253
254 <!-- - - - - - - - - - -->
255 <!-- Multilib - 32bit -->
256 <!-- - - - - - - - - - -->
257 <sect2 arch="ml_32,ml_all">
258 <title>Building Glibc - 32bit</title>
259
260 <para>Now recompile for m32. The extracted source can be
261 reused but needs to be cleaned before installing the m32
262 version of Glibc.</para>
263
264 <para>Clear the build directory and remove artefacts from
265 previous build:</para>
266
267<screen><userinput remap="pre">make clean
268find .. -name "*.a" -delete</userinput></screen>
269
270 <para>Configure Glibc for m32 with the following commands:</para>
271
272<screen><userinput remap="configure">CC="$LFS_TGT-gcc -m32" \
273CXX="$LFS_TGT-g++ -m32" \
274../configure \
275 --prefix=/usr \
276 --host=$LFS_TGT32 \
277 --build=$(../scripts/config.guess) \
278 --enable-kernel=&min-kernel; \
279 --with-headers=$LFS/usr/include \
280 --enable-multi-arch \
281 --libdir=/usr/lib32 \
282 --libexecdir=/usr/lib32 \
283 libc_cv_slibdir=/usr/lib32</userinput></screen>
284
285 <para>Compile the package:</para>
286
287<screen><userinput remap="make">make</userinput></screen>
288
289 <para>Install the package:</para>
290
291<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
292cp -a DESTDIR/usr/lib32 $LFS/usr/
293install -vm644 DESTDIR/usr/include/gnu/{lib-names,stubs}-32.h \
294 $LFS/usr/include/gnu/
295ln -svf ../lib32/ld-linux.so.2 $LFS/lib/ld-linux.so.2</userinput></screen>
296
297
298 <caution>
299 <para>At this point, it is imperative to stop and ensure that the basic
300 functions (compiling and linking) of the new toolchain are working as
301 expected. To perform a sanity check, run the following commands:</para>
302
303<screen><userinput>echo 'int main(){}' &gt; dummy.c
304$LFS_TGT-gcc -m32 dummy.c
305readelf -l a.out | grep '/ld-linux'</userinput></screen>
306
307 <para>If everything is working correctly, there should be no errors,
308 and the output of the last command will be of the form:</para>
309
310<screen><computeroutput>[Requesting program interpreter: /lib/ld-linux.so.2]</computeroutput></screen>
311
312 <para>If the output is not shown as above or there was no output at all,
313 then something is wrong. Investigate and retrace the steps to find out
314 where the problem is and correct it. This issue must be resolved before
315 continuing on.</para>
316
317 <para>Once all is well, clean up the test files:</para>
318
319<screen><userinput>rm -v dummy.c a.out</userinput></screen>
320
321 </caution>
322
323 </sect2><!-- m32 -->
324
325 <!-- - - - - - - - - - -->
326 <!-- Multilib - x32bit -->
327 <!-- - - - - - - - - - -->
328
329 <sect2 arch="ml_x32,ml_all">
330 <title>Building Glibc - x32bit</title>
331
332 <para>Now recompile for mx32. The extracted source can be
333 reused but needs to be cleaned before installing the mx32
334 version of Glibc.</para>
335
336 <para>Clear the build directory and remove artefacts from
337 previous build:</para>
338
339<screen><userinput remap="pre">make clean
340find .. -name "*.a" -delete</userinput></screen>
341
342 <para>Configure Glibc for mx32 with the following commands:</para>
343
344<screen><userinput remap="configure">CC="$LFS_TGT-gcc -mx32" \
345CXX="$LFS_TGT-g++ -mx32" \
346../configure \
347 --prefix=/usr \
348 --host=$LFS_TGTX32 \
349 --build=$(../scripts/config.guess) \
350 --enable-kernel=&min-kernel; \
351 --with-headers=$LFS/usr/include \
352 --enable-multi-arch \
353 --libdir=/usr/libx32 \
354 --libexecdir=/usr/libx32 \
355 libc_cv_slibdir=/usr/libx32</userinput></screen>
356
357 <para>Compile the package:</para>
358
359<screen><userinput remap="make">make</userinput></screen>
360
361 <para>Install the package:</para>
362
363<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
364cp -a DESTDIR/usr/libx32 $LFS/usr/
365install -vm644 DESTDIR/usr/include/gnu/{lib-names,stubs}-x32.h \
366 $LFS/usr/include/gnu/
367ln -svf ../libx32/ld-linux-x32.so.2 $LFS/lib/ld-linux-x32.so.2</userinput></screen>
368
369 <caution>
370 <para>At this point, it is imperative to stop and ensure that the basic
371 functions (compiling and linking) of the new toolchain are working as
372 expected. To perform a sanity check, run the following commands:</para>
373
374<screen><userinput>echo 'int main(){}' &gt; dummy.c
375$LFS_TGT-gcc -mx32 dummy.c
376readelf -l a.out | grep '/ld-linux-x32'</userinput></screen>
377
378 <para>If everything is working correctly, there should be no errors,
379 and the output of the last command will be of the form:</para>
380
381<screen><computeroutput>[Requesting program interpreter: /libx32/ld-linux-x32.so.2]</computeroutput></screen>
382
383 <para>If the output is not shown as above or there was no output at all,
384 then something is wrong. Investigate and retrace the steps to find out
385 where the problem is and correct it. This issue must be resolved before
386 continuing on.</para>
387
388 <para>Once all is well, clean up the test files:</para>
389
390<screen><userinput>rm -v dummy.c a.out</userinput></screen>
391
392 </caution>
393
394 </sect2><!-- mx32 -->
395
396 <sect2 role="content">
397 <title/>
398
399 <para>Details on this package are located in
400 <xref linkend="contents-glibc" role="."/></para>
401
402 </sect2>
403
404</sect1>
Note: See TracBrowser for help on using the repository browser.