source: chapter06/glibc.xml@ 0cba512d

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 0cba512d was be3d9f3, checked in by DJ Lucas <dj@…>, 7 years ago

Merge nosym branch.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11154 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 32.7 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 <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-system-glibc">
20 <primary sortas="a-Glibc">Glibc</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Glibc package contains the main C library. This library provides
27 the basic routines for allocating memory, searching directories, opening and
28 closing files, reading and writing files, string handling, pattern matching,
29 arithmetic, and so on.</para>
30
31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
34
35 <seglistitem>
36 <seg>&glibc-ch6-sbu;</seg>
37 <seg>&glibc-ch6-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Glibc</title>
45
46 <note><para>The Glibc build system is self-contained and will install
47 perfectly, even though the compiler specs file and linker are still
48 pointing to <filename class="directory">/tools</filename>. The specs
49 and linker cannot be adjusted before the Glibc install because the
50 Glibc autoconf tests would give false results and defeat the goal
51 of achieving a clean build.</para></note>
52
53 <para>Some of the Glibc programs use non-FHS compilant
54 <filename class="directory">/var/db</filename> directory to store
55 their runtime data. Apply the following patch to make such programs
56 store their runtime data in the FHS-compliant locations:</para>
57
58<screen><userinput remap="pre">patch -Np1 -i ../&glibc-fhs-patch;</userinput></screen>
59
60 <para>Create a symlink for LSB compliance and, for x86_64, a
61 compatibility symlink required for the dynamic loader to function
62 correctly:</para>
63
64<screen><userinput remap="pre">case $(uname -m) in
65 x86) ln -s ld-linux.so.2 /lib/ld-lsb.so.3
66 ;;
67 x86_64) ln -s ../lib/ld-linux-x86-64.so.2 /lib64
68 ln -s ../lib/ld-linux-x86-64.so.2 /lib64/ld-lsb-x86-64.so.3
69 ;;
70esac</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>Prepare Glibc for compilation:</para>
79
80<screen><userinput remap="configure">../configure --prefix=/usr \
81 --enable-kernel=&min-kernel; \
82 --enable-obsolete-rpc \
83 libc_cv_slibdir=/lib</userinput></screen>
84
85 <para>Compile the package:</para>
86
87<screen><userinput remap="make">make</userinput></screen>
88
89 <important>
90 <para>In this section, the test suite for Glibc is considered critical.
91 Do not skip it under any circumstance.</para>
92 </important>
93
94 <para>Generally a few tests do not pass, but you can generally ignore
95 any of the test failures listed below. Now test the build results:</para>
96
97<screen><userinput remap="test">make check</userinput></screen>
98
99 <para>You will probably see some test failures. The Glibc test suite is
100 somewhat dependent on the host system. This is a list of the most common
101 issues seen for this version of LFS:</para>
102
103 <itemizedlist>
104
105 <listitem>
106 <para><emphasis>posix/tst-getaddrinfo4</emphasis> will always fail due
107 to not having the necessary networking applications when the tests are
108 run. <emphasis>posix/tst-getaddrinfo5</emphasis> is also known
109 to fail on some architectures.</para>
110 </listitem>
111
112 <listitem>
113 <para>The <emphasis>rt/tst-cputimer1</emphasis> and
114 <emphasis>rt/tst-cpuclock2</emphasis> tests have been known to
115 fail. The reason is not completely understood, but indications are
116 that minor timing issues can trigger these failures.</para>
117 </listitem>
118
119 <listitem>
120 <para>The math tests sometimes fail when running on
121 systems where the CPU is not a relatively new Intel or
122 AMD processor.</para>
123 </listitem>
124
125 <listitem>
126 <para>The
127 <emphasis>nptl/tst-thread-affinity-{pthread,pthread2,sched}</emphasis>
128 tests may fail for reasons that have not been determined. </para>
129 </listitem>
130
131 <listitem>
132 <para>Other tests known to fail on some architectures are
133 malloc/tst-malloc-usable and nptl/tst-cleanupx4. </para>
134 </listitem>
135
136 </itemizedlist>
137
138 <para>Though it is a harmless message, the install stage of Glibc will
139 complain about the absence of <filename>/etc/ld.so.conf</filename>.
140 Prevent this warning with:</para>
141
142<screen><userinput remap="install">touch /etc/ld.so.conf</userinput></screen>
143
144 <para>Install the package:</para>
145
146<screen><userinput remap="install">make install</userinput></screen>
147
148 <para>Install the configuration file and runtime directory for
149 <command>nscd</command>:</para>
150
151<screen><userinput remap="install">cp -v ../nscd/nscd.conf /etc/nscd.conf
152mkdir -pv /var/cache/nscd</userinput></screen>
153
154 <para revision="systemd">Install the systemd support files for
155 <command>nscd</command>:</para>
156
157 <screen revision="systemd"><userinput remap="install">install -v -Dm644 ../nscd/nscd.tmpfiles /usr/lib/tmpfiles.d/nscd.conf
158install -v -Dm644 ../nscd/nscd.service /lib/systemd/system/nscd.service</userinput></screen>
159
160 <para>Next, install the locales that can make the system respond in a
161 different language. None of the locales are required, but if some of them
162 are missing, the test suites of future packages would skip important
163 testcases.</para>
164
165 <para>Individual locales can be installed using the
166 <command>localedef</command> program. E.g., the first
167 <command>localedef</command> command below combines the
168 <filename>/usr/share/i18n/locales/cs_CZ</filename>
169 charset-independent locale definition with the
170 <filename>/usr/share/i18n/charmaps/UTF-8.gz</filename>
171 charmap definition and appends the result to the
172 <filename>/usr/lib/locale/locale-archive</filename> file.
173 The following instructions will install the minimum set of
174 locales necessary for the optimal coverage of tests:</para>
175
176<screen role="nodump"><userinput remap="locale-test">mkdir -pv /usr/lib/locale
177localedef -i cs_CZ -f UTF-8 cs_CZ.UTF-8
178localedef -i de_DE -f ISO-8859-1 de_DE
179localedef -i de_DE@euro -f ISO-8859-15 de_DE@euro
180localedef -i de_DE -f UTF-8 de_DE.UTF-8
181localedef -i en_GB -f UTF-8 en_GB.UTF-8
182localedef -i en_HK -f ISO-8859-1 en_HK
183localedef -i en_PH -f ISO-8859-1 en_PH
184localedef -i en_US -f ISO-8859-1 en_US
185localedef -i en_US -f UTF-8 en_US.UTF-8
186localedef -i es_MX -f ISO-8859-1 es_MX
187localedef -i fa_IR -f UTF-8 fa_IR
188localedef -i fr_FR -f ISO-8859-1 fr_FR
189localedef -i fr_FR@euro -f ISO-8859-15 fr_FR@euro
190localedef -i fr_FR -f UTF-8 fr_FR.UTF-8
191localedef -i it_IT -f ISO-8859-1 it_IT
192localedef -i it_IT -f UTF-8 it_IT.UTF-8
193localedef -i ja_JP -f EUC-JP ja_JP
194localedef -i ru_RU -f KOI8-R ru_RU.KOI8-R
195localedef -i ru_RU -f UTF-8 ru_RU.UTF-8
196localedef -i tr_TR -f UTF-8 tr_TR.UTF-8
197localedef -i zh_CN -f GB18030 zh_CN.GB18030</userinput></screen>
198
199 <para>In addition, install the locale for your own country, language and
200 character set.</para>
201
202 <para>Alternatively, install all locales listed in the
203 <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> file
204 (it includes every locale listed above and many more) at once with the
205 following time-consuming command:</para>
206
207<screen><userinput remap="locale-full">make localedata/install-locales</userinput></screen>
208
209 <para>Then use the <command>localedef</command> command to create and
210 install locales not listed in the
211 <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> file
212 in the unlikely case you need them.</para>
213
214 </sect2>
215
216 <sect2 id="conf-glibc" role="configuration">
217 <title>Configuring Glibc</title>
218
219 <indexterm zone="conf-glibc">
220 <primary sortas="e-/etc/nsswitch.conf">/etc/nsswitch.conf</primary>
221 </indexterm>
222
223 <indexterm zone="conf-glibc">
224 <primary sortas="e-/etc/localtime">/etc/localtime</primary>
225 </indexterm>
226
227 <sect3>
228 <title>Adding nsswitch.conf</title>
229
230 <para>The <filename>/etc/nsswitch.conf</filename> file needs to be created
231 because the Glibc defaults do not work well in a networked environment.
232 </para>
233
234 <para>Create a new file <filename>/etc/nsswitch.conf</filename> by running the
235 following:</para>
236
237<screen><userinput>cat &gt; /etc/nsswitch.conf &lt;&lt; "EOF"
238<literal># Begin /etc/nsswitch.conf
239
240passwd: files
241group: files
242shadow: files
243
244hosts: files dns
245networks: files
246
247protocols: files
248services: files
249ethers: files
250rpc: files
251
252# End /etc/nsswitch.conf</literal>
253EOF</userinput></screen>
254
255 </sect3>
256
257 <sect3>
258 <title>Adding time zone data</title>
259
260 <para>Install and set up the time zone data with the following:</para>
261<screen><userinput>tar -xf ../../tzdata&tzdata-version;.tar.gz
262
263ZONEINFO=/usr/share/zoneinfo
264mkdir -pv $ZONEINFO/{posix,right}
265
266for tz in etcetera southamerica northamerica europe africa antarctica \
267 asia australasia backward pacificnew systemv; do
268 zic -L /dev/null -d $ZONEINFO -y "sh yearistype.sh" ${tz}
269 zic -L /dev/null -d $ZONEINFO/posix -y "sh yearistype.sh" ${tz}
270 zic -L leapseconds -d $ZONEINFO/right -y "sh yearistype.sh" ${tz}
271done
272
273cp -v zone.tab zone1970.tab iso3166.tab $ZONEINFO
274zic -d $ZONEINFO -p America/New_York
275unset ZONEINFO</userinput></screen>
276
277 <variablelist>
278 <title>The meaning of the zic commands:</title>
279
280 <varlistentry>
281 <term><parameter>zic -L /dev/null ...</parameter></term>
282 <listitem>
283 <para>This creates posix time zones, without any leap seconds. It is
284 conventional to put these in both
285 <filename class="directory">zoneinfo</filename> and
286 <filename class="directory">zoneinfo/posix</filename>. It is
287 necessary to put the POSIX time zones in
288 <filename class="directory">zoneinfo</filename>, otherwise various
289 test-suites will report errors. On an embedded system, where space is
290 tight and you do not intend to ever update the time zones, you could save
291 1.9MB by not using the <filename class="directory">posix</filename>
292 directory, but some applications or test-suites might produce some
293 failures.</para>
294 </listitem>
295 </varlistentry>
296 <varlistentry>
297 <term><parameter>zic -L leapseconds ...</parameter></term>
298 <listitem>
299 <para>This creates right time zones, including leap seconds. On an
300 embedded system, where space is tight and you do not intend to
301 ever update the time zones, or care about the correct time, you could
302 save 1.9MB by omitting the <filename class="directory">right</filename>
303 directory.</para>
304 </listitem>
305 </varlistentry>
306 <varlistentry>
307 <term><parameter>zic ... -p ...</parameter></term>
308 <listitem>
309 <para>This creates the <filename>posixrules</filename> file. We use
310 New York because POSIX requires the daylight savings time rules
311 to be in accordance with US rules.</para>
312 </listitem>
313 </varlistentry>
314 </variablelist>
315
316
317 <para>One way to determine the local time zone is to run the following
318 script:</para>
319
320<screen role="nodump"><userinput>tzselect</userinput></screen>
321
322 <para>After answering a few questions about the location, the script will
323 output the name of the time zone (e.g.,
324 <emphasis>America/Edmonton</emphasis>). There are also some other possible
325 time zones listed in <filename
326 class='directory'>/usr/share/zoneinfo</filename> such as
327 <emphasis>Canada/Eastern</emphasis> or <emphasis>EST5EDT</emphasis> that
328 are not identified by the script but can be used.</para>
329
330 <para>Then create the <filename>/etc/localtime</filename> file by
331 running:</para>
332
333<screen revision="sysv"><userinput>cp -v /usr/share/zoneinfo/<replaceable>&lt;xxx&gt;</replaceable> /etc/localtime</userinput></screen>
334
335<screen revision="systemd"><userinput>ln -sfv /usr/share/zoneinfo/<replaceable>&lt;xxx&gt;</replaceable> /etc/localtime</userinput></screen>
336
337 <para>Replace <replaceable>&lt;xxx&gt;</replaceable> with the name of the
338 time zone selected (e.g., Canada/Eastern).</para>
339
340 </sect3>
341
342 <sect3 id="conf-ld" role="configuration">
343 <title>Configuring the Dynamic Loader</title>
344
345 <indexterm zone="conf-ld">
346 <primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary>
347 </indexterm>
348
349 <para>By default, the dynamic loader (<filename
350 class="libraryfile">/lib/ld-linux.so.2</filename>) searches through
351 <filename class="directory">/lib</filename> and <filename
352 class="directory">/usr/lib</filename> for dynamic libraries that are
353 needed by programs as they are run. However, if there are libraries in
354 directories other than <filename class="directory">/lib</filename> and
355 <filename class="directory">/usr/lib</filename>, these need to be added
356 to the <filename>/etc/ld.so.conf</filename> file in order for the
357 dynamic loader to find them. Two directories that are commonly known
358 to contain additional libraries are <filename
359 class="directory">/usr/local/lib</filename> and <filename
360 class="directory">/opt/lib</filename>, so add those directories to the
361 dynamic loader's search path.</para>
362
363 <para>Create a new file <filename>/etc/ld.so.conf</filename> by running the
364 following:</para>
365
366<screen><userinput>cat &gt; /etc/ld.so.conf &lt;&lt; "EOF"
367<literal># Begin /etc/ld.so.conf
368/usr/local/lib
369/opt/lib
370</literal>
371EOF</userinput></screen>
372
373 <para>If desired, the dynamic loader can also search a directory and
374 include the contents of files found there. Generally the files in
375 this include directory are one line specifying the desired library path.
376 To add this capability run the following commands:</para>
377
378<screen role="nodump"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
379<literal># Add an include directory
380include /etc/ld.so.conf.d/*.conf
381</literal>
382EOF
383mkdir -pv /etc/ld.so.conf.d</userinput></screen>
384
385 </sect3>
386 </sect2>
387
388 <sect2 id="contents-glibc" role="content">
389 <title>Contents of Glibc</title>
390
391 <segmentedlist>
392 <segtitle>Installed programs</segtitle>
393 <segtitle>Installed libraries</segtitle>
394 <segtitle>Installed directories</segtitle>
395
396 <seglistitem>
397 <seg>catchsegv, gencat, getconf, getent, iconv, iconvconfig, ldconfig,
398 ldd, lddlibc4, locale, localedef, makedb, mtrace, nscd,
399 pldd, rpcgen, sln, sotruss, sprof, tzselect, xtrace,
400 zdump, and zic</seg>
401 <seg>ld-&glibc-version;.so, libBrokenLocale.{a,so}, libSegFault.so, libanl.{a,so},
402 libc.{a,so}, libc_nonshared.a, libcidn.so,
403 libcrypt.{a,so}, libdl.{a,so}, libg.a, libieee.a, libm.{a,so},
404 libmcheck.a, libmemusage.so, libnsl.{a,so}, libnss_compat.so,
405 libnss_dns.so, libnss_files.so, libnss_hesiod.so, libnss_nis.so,
406 libnss_nisplus.so, libpthread.{a,so},
407 libpthread_nonshared.a, libresolv.{a,so}, librpcsvc.a, librt.{a,so},
408 libthread_db.so, and libutil.{a,so}</seg>
409 <seg>/usr/include/arpa, /usr/include/bits, /usr/include/gnu,
410 /usr/include/net, /usr/include/netash, /usr/include/netatalk,
411 /usr/include/netax25, /usr/include/neteconet, /usr/include/netinet,
412 /usr/include/netipx, /usr/include/netiucv, /usr/include/netpacket,
413 /usr/include/netrom, /usr/include/netrose, /usr/include/nfs,
414 /usr/include/protocols, /usr/include/rpc, /usr/include/rpcsvc,
415 /usr/include/sys, /usr/lib/audit, /usr/lib/gconv, /usr/lib/locale,
416 /usr/libexec/getconf, /usr/share/i18n, /usr/share/zoneinfo,
417 /var/cache/nscd, and /var/lib/nss_db</seg>
418 </seglistitem>
419 </segmentedlist>
420
421 <variablelist>
422 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
423 <?dbfo list-presentation="list"?>
424 <?dbhtml list-presentation="table"?>
425
426 <varlistentry id="catchsegv">
427 <term><command>catchsegv</command></term>
428 <listitem>
429 <para>Can be used to create a stack trace when a program
430 terminates with a segmentation fault</para>
431 <indexterm zone="ch-system-glibc catchsegv">
432 <primary sortas="b-catchsegv">catchsegv</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 <varlistentry id="gencat">
438 <term><command>gencat</command></term>
439 <listitem>
440 <para>Generates message catalogues</para>
441 <indexterm zone="ch-system-glibc gencat">
442 <primary sortas="b-gencat">gencat</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="getconf">
448 <term><command>getconf</command></term>
449 <listitem>
450 <para>Displays the system configuration values for file system
451 specific variables</para>
452 <indexterm zone="ch-system-glibc getconf">
453 <primary sortas="b-getconf">getconf</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 <varlistentry id="getent">
459 <term><command>getent</command></term>
460 <listitem>
461 <para>Gets entries from an administrative database</para>
462 <indexterm zone="ch-system-glibc getent">
463 <primary sortas="b-getent">getent</primary>
464 </indexterm>
465 </listitem>
466 </varlistentry>
467
468 <varlistentry id="iconv">
469 <term><command>iconv</command></term>
470 <listitem>
471 <para>Performs character set conversion</para>
472 <indexterm zone="ch-system-glibc iconv">
473 <primary sortas="b-iconv">iconv</primary>
474 </indexterm>
475 </listitem>
476 </varlistentry>
477
478 <varlistentry id="iconvconfig">
479 <term><command>iconvconfig</command></term>
480 <listitem>
481 <para>Creates fastloading <command>iconv</command> module configuration
482 files</para>
483 <indexterm zone="ch-system-glibc iconvconfig">
484 <primary sortas="b-iconvconfig">iconvconfig</primary>
485 </indexterm>
486 </listitem>
487 </varlistentry>
488
489 <varlistentry id="ldconfig">
490 <term><command>ldconfig</command></term>
491 <listitem>
492 <para>Configures the dynamic linker runtime bindings</para>
493 <indexterm zone="ch-system-glibc ldconfig">
494 <primary sortas="b-ldconfig">ldconfig</primary>
495 </indexterm>
496 </listitem>
497 </varlistentry>
498
499 <varlistentry id="ldd">
500 <term><command>ldd</command></term>
501 <listitem>
502 <para>Reports which shared libraries are required
503 by each given program or shared library</para>
504 <indexterm zone="ch-system-glibc ldd">
505 <primary sortas="b-ldd">ldd</primary>
506 </indexterm>
507 </listitem>
508 </varlistentry>
509
510 <varlistentry id="lddlibc4">
511 <term><command>lddlibc4</command></term>
512 <listitem>
513 <para>Assists <command>ldd</command> with object files</para>
514 <indexterm zone="ch-system-glibc lddlibc4">
515 <primary sortas="b-lddlibc4">lddlibc4</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519
520 <varlistentry id="locale">
521 <term><command>locale</command></term>
522 <listitem>
523 <para>Prints various information about the current locale</para>
524 <indexterm zone="ch-system-glibc locale">
525 <primary sortas="b-locale">locale</primary>
526 </indexterm>
527 </listitem>
528 </varlistentry>
529
530 <varlistentry id="localedef">
531 <term><command>localedef</command></term>
532 <listitem>
533 <para>Compiles locale specifications</para>
534 <indexterm zone="ch-system-glibc localedef">
535 <primary sortas="b-localedef">localedef</primary>
536 </indexterm>
537 </listitem>
538 </varlistentry>
539
540 <varlistentry id="makedb">
541 <term><command>makedb</command></term>
542 <listitem>
543 <para>Creates a simple database from textual input</para>
544 <indexterm zone="ch-system-glibc makedb">
545 <primary sortas="b-makedb">makedb</primary>
546 </indexterm>
547 </listitem>
548 </varlistentry>
549
550 <varlistentry id="mtrace">
551 <term><command>mtrace</command></term>
552 <listitem>
553 <para>Reads and interprets a memory trace file and displays a summary
554 in human-readable format</para>
555 <indexterm zone="ch-system-glibc mtrace">
556 <primary sortas="b-mtrace">mtrace</primary>
557 </indexterm>
558 </listitem>
559 </varlistentry>
560
561 <varlistentry id="nscd">
562 <term><command>nscd</command></term>
563 <listitem>
564 <para>A daemon that provides a cache for the most common name
565 service requests</para>
566 <indexterm zone="ch-system-glibc nscd">
567 <primary sortas="b-nscd">nscd</primary>
568 </indexterm>
569 </listitem>
570 </varlistentry>
571
572 <varlistentry id="pldd">
573 <term><command>pldd</command></term>
574 <listitem>
575 <para>Lists dynamic shared objects used by running processes</para>
576 <indexterm zone="ch-system-glibc pldd">
577 <primary sortas="b-pldd">pldd</primary>
578 </indexterm>
579 </listitem>
580 </varlistentry>
581
582 <varlistentry id="rpcgen">
583 <term><command>rpcgen</command></term>
584 <listitem>
585 <para>Generates C code to implement the Remote Procedure Call (RPC)
586 protocol</para>
587 <indexterm zone="ch-system-glibc rpcgen">
588 <primary sortas="b-rpcgen">rpcgen</primary>
589 </indexterm>
590 </listitem>
591 </varlistentry>
592
593 <varlistentry id="sln">
594 <term><command>sln</command></term>
595 <listitem>
596 <para>A statically linked <command>ln</command> program</para>
597 <indexterm zone="ch-system-glibc sln">
598 <primary sortas="b-sln">sln</primary>
599 </indexterm>
600 </listitem>
601 </varlistentry>
602
603 <varlistentry id="sotruss">
604 <term><command>sotruss</command></term>
605 <listitem>
606 <para>Traces shared library procedure calls of a specified command</para>
607 <indexterm zone="ch-system-glibc sotruss">
608 <primary sortas="b-sotruss">sotruss</primary>
609 </indexterm>
610 </listitem>
611 </varlistentry>
612
613 <varlistentry id="sprof">
614 <term><command>sprof</command></term>
615 <listitem>
616 <para>Reads and displays shared object profiling data</para>
617 <indexterm zone="ch-system-glibc sprof">
618 <primary sortas="b-sprof">sprof</primary>
619 </indexterm>
620 </listitem>
621 </varlistentry>
622
623 <varlistentry id="tzselect">
624 <term><command>tzselect</command></term>
625 <listitem>
626 <para>Asks the user about the location of the system and reports
627 the corresponding time zone description</para>
628 <indexterm zone="ch-system-glibc tzselect">
629 <primary sortas="b-tzselect">tzselect</primary>
630 </indexterm>
631 </listitem>
632 </varlistentry>
633
634 <varlistentry id="xtrace">
635 <term><command>xtrace</command></term>
636 <listitem>
637 <para>Traces the execution of a program by printing the currently
638 executed function</para>
639 <indexterm zone="ch-system-glibc xtrace">
640 <primary sortas="b-xtrace">xtrace</primary>
641 </indexterm>
642 </listitem>
643 </varlistentry>
644
645 <varlistentry id="zdump">
646 <term><command>zdump</command></term>
647 <listitem>
648 <para>The time zone dumper</para>
649 <indexterm zone="ch-system-glibc zdump">
650 <primary sortas="b-zdump">zdump</primary>
651 </indexterm>
652 </listitem>
653 </varlistentry>
654
655 <varlistentry id="zic">
656 <term><command>zic</command></term>
657 <listitem>
658 <para>The time zone compiler</para>
659 <indexterm zone="ch-system-glibc zic">
660 <primary sortas="b-zic">zic</primary>
661 </indexterm>
662 </listitem>
663 </varlistentry>
664
665 <varlistentry id="ld.so">
666 <term><filename class="libraryfile">ld-&glibc-version;.so</filename></term>
667 <listitem>
668 <para>The helper program for shared library executables</para>
669 <indexterm zone="ch-system-glibc ld.so">
670 <primary sortas="c-ld.so">ld-&glibc-version;.so</primary>
671 </indexterm>
672 </listitem>
673 </varlistentry>
674
675 <varlistentry id="libBrokenLocale">
676 <term><filename class="libraryfile">libBrokenLocale</filename></term>
677 <listitem>
678 <para>Used internally by Glibc as a gross hack to get broken programs
679 (e.g., some Motif applications) running. See comments in
680 <filename>glibc-&glibc-version;/locale/broken_cur_max.c</filename>
681 for more information</para>
682 <indexterm zone="ch-system-glibc libBrokenLocale">
683 <primary sortas="c-libBrokenLocale">libBrokenLocale</primary>
684 </indexterm>
685 </listitem>
686 </varlistentry>
687
688 <varlistentry id="libSegFault">
689 <term><filename class="libraryfile">libSegFault</filename></term>
690 <listitem>
691 <para>The segmentation fault signal handler, used by
692 <command>catchsegv</command></para>
693 <indexterm zone="ch-system-glibc libSegFault">
694 <primary sortas="c-libSegFault">libSegFault</primary>
695 </indexterm>
696 </listitem>
697 </varlistentry>
698
699 <varlistentry id="libanl">
700 <term><filename class="libraryfile">libanl</filename></term>
701 <listitem>
702 <para>An asynchronous name lookup library</para>
703 <indexterm zone="ch-system-glibc libanl">
704 <primary sortas="c-libanl">libanl</primary>
705 </indexterm>
706 </listitem>
707 </varlistentry>
708
709 <varlistentry id="libc">
710 <term><filename class="libraryfile">libc</filename></term>
711 <listitem>
712 <para>The main C library</para>
713 <indexterm zone="ch-system-glibc libc">
714 <primary sortas="c-libc">libc</primary>
715 </indexterm>
716 </listitem>
717 </varlistentry>
718
719 <varlistentry id="libcidn">
720 <term><filename class="libraryfile">libcidn</filename></term>
721 <listitem>
722 <para>Used internally by Glibc for handling internationalized domain
723 names in the <function>getaddrinfo()</function> function</para>
724 <indexterm zone="ch-system-glibc libcidn">
725 <primary sortas="c-libcidn">libcidn</primary>
726 </indexterm>
727 </listitem>
728 </varlistentry>
729
730 <varlistentry id="libcrypt">
731 <term><filename class="libraryfile">libcrypt</filename></term>
732 <listitem>
733 <para>The cryptography library</para>
734 <indexterm zone="ch-system-glibc libcrypt">
735 <primary sortas="c-libcrypt">libcrypt</primary>
736 </indexterm>
737 </listitem>
738 </varlistentry>
739
740 <varlistentry id="libdl">
741 <term><filename class="libraryfile">libdl</filename></term>
742 <listitem>
743 <para>The dynamic linking interface library</para>
744 <indexterm zone="ch-system-glibc libdl">
745 <primary sortas="c-libdl">libdl</primary>
746 </indexterm>
747 </listitem>
748 </varlistentry>
749
750 <varlistentry id="libg">
751 <term><filename class="libraryfile">libg</filename></term>
752 <listitem>
753 <para>Dummy library containing no functions. Previously was a runtime
754 library for <command>g++</command></para>
755 <indexterm zone="ch-system-glibc libg">
756 <primary sortas="c-libg">libg</primary>
757 </indexterm>
758 </listitem>
759 </varlistentry>
760
761 <varlistentry id="libieee">
762 <term><filename class="libraryfile">libieee</filename></term>
763 <listitem>
764 <para>Linking in this module forces error handling rules for math
765 functions as defined by the Institute of Electrical and Electronic
766 Engineers (IEEE). The default is POSIX.1 error handling</para>
767 <indexterm zone="ch-system-glibc libieee">
768 <primary sortas="c-libieee">libieee</primary>
769 </indexterm>
770 </listitem>
771 </varlistentry>
772
773 <varlistentry id="libm">
774 <term><filename class="libraryfile">libm</filename></term>
775 <listitem>
776 <para>The mathematical library</para>
777 <indexterm zone="ch-system-glibc libm">
778 <primary sortas="c-libm">libm</primary>
779 </indexterm>
780 </listitem>
781 </varlistentry>
782
783 <varlistentry id="libmcheck">
784 <term><filename class="libraryfile">libmcheck</filename></term>
785 <listitem>
786 <para>Turns on memory allocation checking when linked to</para>
787 <indexterm zone="ch-system-glibc libmcheck">
788 <primary sortas="c-libmcheck">libmcheck</primary>
789 </indexterm>
790 </listitem>
791 </varlistentry>
792
793 <varlistentry id="libmemusage">
794 <term><filename class="libraryfile">libmemusage</filename></term>
795 <listitem>
796 <para>Used by <command>memusage</command> to help collect
797 information about the memory usage of a program</para>
798 <indexterm zone="ch-system-glibc libmemusage">
799 <primary sortas="c-libmemusage">libmemusage</primary>
800 </indexterm>
801 </listitem>
802 </varlistentry>
803
804 <varlistentry id="libnsl">
805 <term><filename class="libraryfile">libnsl</filename></term>
806 <listitem>
807 <para>The network services library</para>
808 <indexterm zone="ch-system-glibc libnsl">
809 <primary sortas="c-libnsl">libnsl</primary>
810 </indexterm>
811 </listitem>
812 </varlistentry>
813
814 <varlistentry id="libnss">
815 <term><filename class="libraryfile">libnss</filename></term>
816 <listitem>
817 <para>The Name Service Switch libraries, containing functions for
818 resolving host names, user names, group names, aliases, services,
819 protocols, etc.</para>
820 <indexterm zone="ch-system-glibc libnss">
821 <primary sortas="c-libnss">libnss</primary>
822 </indexterm>
823 </listitem>
824 </varlistentry>
825
826 <varlistentry id="libpthread">
827 <term><filename class="libraryfile">libpthread</filename></term>
828 <listitem>
829 <para>The POSIX threads library</para>
830 <indexterm zone="ch-system-glibc libpthread">
831 <primary sortas="c-libpthread">libpthread</primary>
832 </indexterm>
833 </listitem>
834 </varlistentry>
835
836 <varlistentry id="libresolv">
837 <term><filename class="libraryfile">libresolv</filename></term>
838 <listitem>
839 <para>Contains functions for creating, sending, and interpreting
840 packets to the Internet domain name servers</para>
841 <indexterm zone="ch-system-glibc libresolv">
842 <primary sortas="c-libresolv">libresolv</primary>
843 </indexterm>
844 </listitem>
845 </varlistentry>
846
847 <varlistentry id="librpcsvc">
848 <term><filename class="libraryfile">librpcsvc</filename></term>
849 <listitem>
850 <para>Contains functions providing miscellaneous RPC services</para>
851 <indexterm zone="ch-system-glibc librpcsvc">
852 <primary sortas="c-librpcsvc">librpcsvc</primary>
853 </indexterm>
854 </listitem>
855 </varlistentry>
856
857 <varlistentry id="librt">
858 <term><filename class="libraryfile">librt</filename></term>
859 <listitem>
860 <para>Contains functions providing most of the interfaces specified
861 by the POSIX.1b Realtime Extension</para>
862 <indexterm zone="ch-system-glibc librt">
863 <primary sortas="c-librt">librt</primary>
864 </indexterm>
865 </listitem>
866 </varlistentry>
867
868 <varlistentry id="libthread_db">
869 <term><filename class="libraryfile">libthread_db</filename></term>
870 <listitem>
871 <para>Contains functions useful for building debuggers for
872 multi-threaded programs</para>
873 <indexterm zone="ch-system-glibc libthread_db">
874 <primary sortas="c-libthread_db">libthread_db</primary>
875 </indexterm>
876 </listitem>
877 </varlistentry>
878
879 <varlistentry id="libutil">
880 <term><filename class="libraryfile">libutil</filename></term>
881 <listitem>
882 <para>Contains code for <quote>standard</quote> functions used in
883 many different Unix utilities</para>
884 <indexterm zone="ch-system-glibc libutil">
885 <primary sortas="c-libutil">libutil</primary>
886 </indexterm>
887 </listitem>
888 </varlistentry>
889
890 </variablelist>
891
892 </sect2>
893
894</sect1>
Note: See TracBrowser for help on using the repository browser.