source: chapter05/glibc.xml@ d4b5218

ml-11.0 multilib
Last change on this file since d4b5218 was d4b5218, checked in by Thomas Trepl (Moody) <thomas@…>, 3 years ago

Merge

  • 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 <para>Some of the Glibc programs use the non-FHS compliant
62 <filename class="directory">/var/db</filename> directory to store their
63 runtime data. Apply the following patch to make such programs store their
64 runtime data in the FHS-compliant locations:</para>
65
66<screen><userinput remap="pre">patch -Np1 -i ../glibc-&glibc-version;-fhs-1.patch</userinput></screen>
67
68 <para>Fix a build issue with gcc-11.1:</para>
69
70<screen><userinput remap="pre">sed 's/amx_/amx-/' -i sysdeps/x86/tst-cpu-features-supports.c</userinput></screen>
71
72 <para>The Glibc documentation recommends building Glibc
73 in a dedicated build directory:</para>
74
75<screen><userinput remap="pre">mkdir -v build
76cd build</userinput></screen>
77
78 <para>Next, prepare Glibc for compilation:</para>
79
80<screen arch="default"><userinput remap="configure">../configure \
81 --prefix=/usr \
82 --host=$LFS_TGT \
83 --build=$(../scripts/config.guess) \
84 --enable-kernel=&min-kernel; \
85 --with-headers=$LFS/usr/include \
86 libc_cv_slibdir=/usr/lib</userinput></screen>
87<screen arch="ml_32,ml_x32,ml_all"><userinput remap="configure">../configure \
88 --prefix=/usr \
89 --host=$LFS_TGT \
90 --build=$(../scripts/config.guess) \
91 --enable-kernel=&min-kernel; \
92 --with-headers=$LFS/usr/include \
93 --enable-multi-arch \
94 libc_cv_slibdir=/usr/lib</userinput></screen>
95
96 <variablelist>
97 <title>The meaning of the configure options:</title>
98
99 <varlistentry>
100 <term><parameter>--host=$LFS_TGT, --build=$(../scripts/config.guess)</parameter></term>
101 <listitem>
102 <para>The combined effect of these switches is that Glibc's build system
103 configures itself to be cross-compiled, using the cross-linker and
104 cross-compiler in <filename class="directory">$LFS/tools</filename>.</para>
105 </listitem>
106 </varlistentry>
107
108 <varlistentry>
109 <term><parameter>--enable-kernel=&min-kernel;</parameter></term>
110 <listitem>
111 <para>This tells Glibc to compile the library with support
112 for &min-kernel; and later Linux kernels. Workarounds for older
113 kernels are not enabled.</para>
114 </listitem>
115 </varlistentry>
116
117 <varlistentry>
118 <term><parameter>--with-headers=$LFS/usr/include</parameter></term>
119 <listitem>
120 <para>This tells Glibc to compile itself against the headers
121 recently installed to the $LFS/usr/include directory, so that
122 it knows exactly what features the kernel has and can optimize
123 itself accordingly.</para>
124 </listitem>
125 </varlistentry>
126
127 <varlistentry>
128 <term><parameter>libc_cv_slibdir=/usr/lib</parameter></term>
129 <listitem>
130 <para>This ensures that the library is installed in /usr/lib instead
131 of the default /lib64 on 64 bit machines.</para>
132 </listitem>
133 </varlistentry>
134
135 <varlistentry>
136 <term><parameter>libc_cv_rtlddir=/usr/lib</parameter></term>
137 <listitem>
138 <para>Fix hardcoded path to the executable loader in the
139 <command>ldd</command> script.</para>
140 </listitem>
141 </varlistentry>
142
143 <varlistentry>
144 <term><option>libc_cv_include_x86_isa_level=no</option></term>
145 <listitem>
146 <para>This disables <quote>x86 ISA needed</quote> property in
147 Glibc libraries. Use it <emphasis role="bold">if</emphasis>
148 you are building Glibc with <option>-march</option> option in
149 <envar>CFLAGS</envar>, to workaround an issue in Glibc-2.33
150 breaking it.</para>
151 </listitem>
152 </varlistentry>
153
154 </variablelist>
155
156 <para>During this stage the following warning might appear:</para>
157
158 <blockquote>
159<screen><computeroutput>configure: WARNING:
160*** These auxiliary programs are missing or
161*** incompatible versions: msgfmt
162*** some features will be disabled.
163*** Check the INSTALL file for required versions.</computeroutput></screen>
164 </blockquote>
165
166 <para>The missing or incompatible <command>msgfmt</command> program is
167 generally harmless. This <command>msgfmt</command> program is part of the
168 Gettext package which the host distribution should provide.</para>
169
170 <note><para>There have been reports that this package may fail when
171 building as a "parallel make". If this occurs, rerun the make command
172 with a "-j1" option.</para></note>
173
174 <para>Compile the package:</para>
175
176<screen><userinput remap="make">make</userinput></screen>
177
178 <para>Install the package:</para>
179
180 <warning><para>If <envar>LFS</envar> is not properly set, and despite the
181 recommendations, you are building as
182 <systemitem class="username">root</systemitem>, the next command will
183 install the newly built glibc to your host system, which most likely
184 will render it unusable. So double check that the environment is
185 correctly set, before running the following command.</para></warning>
186
187<screen><userinput remap="install">make DESTDIR=$LFS install</userinput></screen>
188
189 <variablelist>
190 <title>The meaning of the <command>make install</command> option:</title>
191
192 <varlistentry>
193 <term><parameter>DESTDIR=$LFS</parameter></term>
194 <listitem>
195 <para>The <envar>DESTDIR</envar> make variable is used by almost all
196 packages to define the location where the package should be
197 installed. If it is not set, it defaults to the root (<filename
198 class="directory">/</filename>) directory. Here we specify that
199 the package be installed in <filename class="directory">$LFS
200 </filename>, which will become the root after <xref linkend=
201 "ch-tools-chroot"/>.</para>
202 </listitem>
203 </varlistentry>
204
205 </variablelist>
206
207 <para>Fix hardcoded path to the executable loader in
208 <command>ldd</command> script:</para>
209
210<screen><userinput remap="install">sed '/RTLDLIST=/s@/usr@@g' -i $LFS/usr/bin/ldd</userinput></screen>
211
212 <caution>
213 <para>At this point, it is imperative to stop and ensure that the basic
214 functions (compiling and linking) of the new toolchain are working as
215 expected. To perform a sanity check, run the following commands:</para>
216
217<screen><userinput>echo 'int main(){}' &gt; dummy.c
218$LFS_TGT-gcc dummy.c
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 shown as above or there was 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 on.</para>
233
234 <para>Once all is well, clean up the test files:</para>
235
236<screen><userinput>rm -v dummy.c a.out</userinput></screen>
237
238 </caution>
239
240 <note><para>Building 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 previous 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. For doing so, 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.