source: chapter06/glibc.xml@ 1118b17

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 1118b17 was 1118b17, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Create branches/merge in svn repo fo rtesting of merged LFS books

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