source: BOOK/final-system/common/eglibc.xml @ c0bc7c4

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since c0bc7c4 was c0bc7c4, checked in by Jim Gifford <clfs@…>, 15 years ago

Changed internal variable to one that's not used in eglibc

  • Property mode set to 100644
File size: 30.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-eglibc" role="wrap">
9  <?dbhtml filename="eglibc.html"?>
10
11  <title>EGLIBC-&eglibc-version;</title>
12
13  <indexterm zone="ch-system-eglibc">
14    <primary sortas="a-EGLIBC">EGLIBC</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The EGLIBC package contains the main C library. This library provides
21    the basic routines for allocating memory, searching directories, opening and
22    closing files, reading and writing files, string handling, pattern matching,
23    arithmetic, and so on.</para>
24
25  </sect2>
26
27  <sect2 role="installation">
28    <title>Installation of EGLIBC</title>
29
30    <note os="z">
31      <para>Some packages outside of CLFS suggest installing GNU libiconv in
32      order to translate data from one encoding to another. The project's
33      home page (<ulink url="http://www.gnu.org/software/libiconv/"/>) says
34      <quote>This library provides an <function>iconv()</function>
35      implementation, for use on systems which don't have one, or whose
36      implementation cannot convert from/to Unicode.</quote> EGLIBC provides
37      an <function>iconv()</function> implementation and can convert from/to
38      Unicode, therefore libiconv is not required on a CLFS system.</para>
39    </note>
40
41    <para os="p1">EGLIBC has various issues addressed by the following patch:</para>
42
43<screen os="p2"><userinput>patch -Np1 -i ../&eglibc-fixes-patch;</userinput></screen>
44
45    <para os="l3">The following sed makes sure that newly built EGLIBC is tested,
46    during make install, instead of the one we previously build:</para>
47
48<screen os="l4"><userinput>LINKER=$(readelf -l $(file /tools/lib/libc-* | cut -f1 -d:) | sed -n 's@.*interpret.*/tools\(.*\)]$@\1@p')
49sed -i "s|libs -o|libs -L/usr/lib -Wl,-dynamic-linker=${LINKER} -o|" \
50  scripts/test-installation.pl
51unset LINKER</userinput></screen>
52
53    <para os="b">The EGLIBC build system is self-contained and will install
54    perfectly, even though the compiler specs file and linker are still
55    pointing at <filename class="directory">/tools</filename>. The specs
56    and linker cannot be adjusted before the EGLIBC install because the
57    EGLIBC Autoconf tests would give false results and defeat the goal
58    of achieving a clean build.</para>
59
60    <para os="e">The EGLIBC documentation recommends building EGLIBC outside of the
61    source directory in a dedicated build directory:</para>
62
63<screen os="f"><userinput>mkdir -v ../eglibc-build
64cd ../eglibc-build</userinput></screen>
65
66    <para os="g">Prepare EGLIBC for compilation:</para>
67
68<screen os="h"><userinput>../eglibc-&eglibc-version;/configure --prefix=/usr \
69    --disable-profile --enable-add-ons --enable-kernel=2.6.0 \
70    --libexecdir=/usr/lib/eglibc</userinput></screen>
71
72    <variablelist os="i">
73      <title>The meaning of the new configure option:</title>
74
75      <varlistentry>
76        <term><parameter>--libexecdir=/usr/lib/eglibc</parameter></term>
77        <listitem>
78          <para>This changes the location of the <command>pt_chown</command>
79          program from its default of <filename
80          class="directory">/usr/libexec</filename> to <filename
81          class="directory">/usr/lib/eglibc</filename>.</para>
82        </listitem>
83      </varlistentry>
84    </variablelist>
85
86    <para os="j">Compile the package:</para>
87
88<screen os="k"><userinput>make</userinput></screen>
89
90    <important os="l">
91      <para>The test suite for EGLIBC is considered critical.
92      Do not skip it under any circumstance.</para>
93    </important>
94
95    <para os="m">Before running the tests, copy a file from the source tree into our
96    build tree to prevent a couple of test failures, then run the tests:</para>
97
98<!-- items n,o,p no longer the master, use x86_64 which has no failures -->
99
100<screen os="n"><userinput>cp -v ../eglibc-&eglibc-version;/iconvdata/gconv-modules iconvdata
101make -k check &gt;eglibc-check-log 2&gt;&amp;1 ; grep Error eglibc-check-log</userinput></screen>
102
103    <para os="o">The EGLIBC test suite is highly dependent on certain functions of
104    the host system, in particular the kernel. The posix/annexc test normally fails
105    and you should see <literal>Error 1 (ignored)</literal> in the output. Apart
106    from this, the EGLIBC test suite is always expected to pass. However, in certain
107    circumstances, some failures are unavoidable. If a test fails because of a missing
108    program (or missing symbolic link), or a segfault, you will see an error code
109    greater than 127 and the details will be in the log. More commonly, tests will
110    fail with <literal>Error 2</literal> - for these, the contents of the corresponding
111    <filename>.out</filename> file, e.g. <filename>posix/annexc.out</filename> may be
112    informative. Here is a list of the most common issues:</para>
113
114    <itemizedlist os="p">
115      <listitem>
116        <para>The <emphasis>math</emphasis> tests sometimes fail.
117        Certain optimization settings are known to be a
118        factor here.</para>
119      </listitem>
120      <listitem>
121        <para>If you have mounted the CLFS partition with the
122        <parameter>noatime</parameter> option, the <emphasis>atime</emphasis> test
123        will fail. As mentioned in <xref linkend="ch-partitioning-mounting"/>,
124        do not use the <parameter>noatime</parameter> option while building
125        CLFS.</para>
126      </listitem>
127      <listitem>
128        <para>When running on older and slower hardware, some tests
129        can fail because of test timeouts being exceeded.</para>
130      </listitem>
131    </itemizedlist>
132
133    <para os="q">Though it is a harmless message, the install stage of EGLIBC will
134    complain about the absence of <filename>/etc/ld.so.conf</filename>.
135    Prevent this warning with:</para>
136
137<screen os="r"><userinput>touch /etc/ld.so.conf</userinput></screen>
138
139    <para os="s">Install the package:</para>
140
141<screen os="t"><userinput>make install</userinput></screen>
142
143  </sect2>
144
145  <sect2 id="i18n-eglibc" role="configuration">
146    <title>Internationalization</title>
147
148    <para>The locales that can make the system respond in a different
149    language were not installed by the above command. Install them
150    with:</para>
151
152<screen><userinput>make localedata/install-locales</userinput></screen>
153
154    <para>To save time, an alternative to running the previous command (which
155    generates and installs every locale listed in the
156    eglibc-&eglibc-version;/localedata/SUPPORTED file) is to install only
157    those locales that are wanted and needed. This can be achieved by using
158    the <command>localedef</command> command. Information on this command is
159    located in the <filename>INSTALL</filename> file in the EGLIBC source.
160    However, there are a number of locales that are essential in order for the
161    tests of future packages to pass, in particular, the
162    <emphasis>libstdc++</emphasis> tests from GCC. The following instructions,
163    instead of the <parameter>install-locales</parameter> target used above,
164    will install the minimum set of locales necessary for the tests to run
165    successfully:</para>
166
167<screen role="nodump"><userinput>mkdir -pv /usr/lib/locale
168localedef -i cs_CZ -f UTF-8 cs_CZ.UTF-8
169localedef -i de_DE -f ISO-8859-1 de_DE
170localedef -i de_DE@euro -f ISO-8859-15 de_DE@euro
171localedef -i en_HK -f ISO-8859-1 en_HK
172localedef -i en_PH -f ISO-8859-1 en_PH
173localedef -i en_US -f ISO-8859-1 en_US
174localedef -i es_MX -f ISO-8859-1 es_MX
175localedef -i fa_IR -f UTF-8 fa_IR
176localedef -i fr_FR -f ISO-8859-1 fr_FR
177localedef -i fr_FR@euro -f ISO-8859-15 fr_FR@euro
178localedef -i it_IT -f ISO-8859-1 it_IT
179localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen>
180
181    <para>Some locales installed by the <command>make
182    localedata/install-locales</command> command above are not properly
183    supported by some applications that are in CLFS and CBLFS. Because
184    of the various problems that arise due to application programmers making
185    assumptions that break in such locales, CLFS should not be used in locales
186    that utilize multibyte character sets (including UTF-8) or right-to-left
187    writing order.  Numerous unofficial and unstable patches are required to
188    fix these problems, and it has been decided by the CLFS developers not to
189    support such complex locales at this time. This applies to the ja_JP and
190    fa_IR locales as well&mdash;they have been installed only for GCC and
191    Gettext tests to pass, and the <command>watch</command> program (part of
192    the Procps package) does not work properly in them. Various attempts to
193    circumvent these restrictions are documented in internationalization-related
194    hints.</para>
195
196  </sect2>
197
198  <sect2 id="conf-eglibc" role="configuration">
199    <title>Configuring EGLIBC</title>
200
201    <indexterm zone="conf-eglibc">
202      <primary sortas="e-/etc/nsswitch.conf">/etc/nsswitch.conf</primary>
203    </indexterm>
204
205    <indexterm zone="conf-eglibc">
206      <primary sortas="e-/etc/localtime">/etc/localtime</primary>
207    </indexterm>
208
209    <para>The <filename>/etc/nsswitch.conf</filename> file needs to be created
210    because, although EGLIBC provides defaults when this file is missing or
211    corrupt, the EGLIBC defaults do not work well in a networked environment.
212    The time zone also needs to be configured.</para>
213
214    <para>Create a new file <filename>/etc/nsswitch.conf</filename> by running
215    the following:</para>
216
217<screen><userinput>cat &gt; /etc/nsswitch.conf &lt;&lt; "EOF"
218<literal># Begin /etc/nsswitch.conf
219
220passwd: files
221group: files
222shadow: files
223
224hosts: files dns
225networks: files
226
227protocols: files
228services: files
229ethers: files
230rpc: files
231
232# End /etc/nsswitch.conf</literal>
233EOF</userinput></screen>
234
235    <para>To determine the local time zone, run the following script:</para>
236
237<screen role="nodump"><userinput>tzselect</userinput></screen>
238
239    <para>After answering a few questions about the location, the script will
240    output the name of the time zone (e.g., <emphasis>EST5EDT</emphasis> or
241    <emphasis>Canada/Eastern</emphasis>). Then create the
242    <filename>/etc/localtime</filename> file by running:</para>
243
244<screen><userinput>cp -v --remove-destination /usr/share/zoneinfo/<replaceable>[xxx]</replaceable> \
245    /etc/localtime</userinput></screen>
246
247    <para>Replace <replaceable>[xxx]</replaceable> with the name of the time zone
248    that <command>tzselect</command> provided (e.g., Canada/Eastern).</para>
249
250    <variablelist>
251      <title>The meaning of the cp option:</title>
252
253      <varlistentry>
254        <term><parameter>--remove-destination</parameter></term>
255        <listitem>
256          <para>This is needed to force removal of the already existing symbolic
257          link. The reason for copying the file instead of using a symlink is to
258          cover the situation where <filename class="directory">/usr</filename>
259          is on a separate partition. This could be important when booted into
260          single user mode.</para>
261        </listitem>
262      </varlistentry>
263    </variablelist>
264
265  </sect2>
266
267  <sect2 id="conf-ld" role="configuration">
268    <title>Configuring The Dynamic Loader</title>
269
270    <indexterm zone="conf-ld">
271      <primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary>
272    </indexterm>
273
274    <para os="ld-a">By default, the dynamic loader (<filename
275    class="libraryfile">/lib/ld-linux.so.2</filename>) searches through
276    <filename class="directory">/lib</filename> and <filename
277    class="directory">/usr/lib</filename> for dynamic libraries that are
278    needed by programs as they are run. However, if there are libraries in
279    directories other than <filename class="directory">/lib</filename> and
280    <filename class="directory">/usr/lib</filename>, these need to be
281    added to the <filename>/etc/ld.so.conf</filename> file in order
282    for the dynamic loader to find them. Two directories that are commonly
283    known to contain additional libraries are <filename
284    class="directory">/usr/local/lib</filename> and <filename
285    class="directory">/opt/lib</filename>, so add those directories to the
286    dynamic loader's search path.</para>
287
288    <para os="ld-b">Create a new file <filename>/etc/ld.so.conf</filename> by running the
289    following:</para>
290
291<screen os="ld-c"><userinput>cat &gt; /etc/ld.so.conf &lt;&lt; "EOF"
292<literal># Begin /etc/ld.so.conf
293
294/usr/local/lib
295/opt/lib
296
297# End /etc/ld.so.conf</literal>
298EOF</userinput></screen>
299
300  </sect2>
301
302  <sect2 id="contents-eglibc" role="content">
303    <title>Contents of EGLIBC</title>
304
305    <segmentedlist>
306      <segtitle>Installed programs</segtitle>
307      <segtitle>Installed libraries</segtitle>
308
309      <seglistitem>
310        <seg>catchsegv, gencat, getconf, getent, iconv, iconvconfig, ldconfig,
311        ldd, lddlibc4, locale, localedef, mtrace, nscd,
312        pcprofiledump, pt_chown, rpcgen, rpcinfo, sln, sprof, tzselect, xtrace,
313        zdump, and zic</seg>
314        <seg>ld.so, libBrokenLocale.[a,so], libSegFault.so, libanl.[a,so],
315        libbsd-compat.a, libc.[a,so], libcrypt.[a,so], libdl.[a,so], libg.a,
316        libieee.a, libm.[a,so], libmcheck.a, libmemusage.so, libnsl.a,
317        libnss_compat.so, libnss_dns.so, libnss_files.so, libnss_hesiod.so,
318        libnss_nis.so, libnss_nisplus.so, libpcprofile.so, libpthread.[a,so],
319        libresolv.[a,so], librpcsvc.a, librt.[a,so], libthread_db.so, and
320        libutil.[a,so]</seg>
321      </seglistitem>
322    </segmentedlist>
323
324    <variablelist>
325      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
326      <?dbfo list-presentation="list"?>
327      <?dbhtml list-presentation="table"?>
328
329      <varlistentry id="catchsegv">
330        <term><command>catchsegv</command></term>
331        <listitem>
332          <para>Can be used to create a stack trace when a program
333          terminates with a segmentation fault</para>
334          <indexterm zone="ch-system-eglibc catchsegv">
335            <primary sortas="b-catchsegv">catchsegv</primary>
336          </indexterm>
337        </listitem>
338      </varlistentry>
339
340      <varlistentry id="gencat">
341        <term><command>gencat</command></term>
342        <listitem>
343          <para>Generates message catalogues</para>
344          <indexterm zone="ch-system-eglibc gencat">
345            <primary sortas="b-gencat">gencat</primary>
346          </indexterm>
347        </listitem>
348      </varlistentry>
349
350      <varlistentry id="getconf">
351        <term><command>getconf</command></term>
352        <listitem>
353          <para>Displays the system configuration values for file system specific
354          variables</para>
355          <indexterm zone="ch-system-eglibc getconf">
356            <primary sortas="b-getconf">getconf</primary>
357          </indexterm>
358        </listitem>
359      </varlistentry>
360
361      <varlistentry id="getent">
362        <term><command>getent</command></term>
363        <listitem>
364          <para>Gets entries from an administrative database</para>
365          <indexterm zone="ch-system-eglibc getent">
366            <primary sortas="b-getent">getent</primary>
367          </indexterm>
368        </listitem>
369      </varlistentry>
370
371      <varlistentry id="iconv">
372        <term><command>iconv</command></term>
373        <listitem>
374          <para>Performs character set conversion</para>
375          <indexterm zone="ch-system-eglibc iconv">
376            <primary sortas="b-iconv">iconv</primary>
377          </indexterm>
378        </listitem>
379      </varlistentry>
380
381      <varlistentry id="iconvconfig">
382        <term><command>iconvconfig</command></term>
383        <listitem>
384          <para>Creates fastloading <command>iconv</command> module configuration
385          files</para>
386          <indexterm zone="ch-system-eglibc iconvconfig">
387            <primary sortas="b-iconvconfig">iconvconfig</primary>
388          </indexterm>
389        </listitem>
390      </varlistentry>
391
392      <varlistentry id="ldconfig">
393        <term><command>ldconfig</command></term>
394        <listitem>
395          <para>Configures the dynamic linker runtime bindings</para>
396          <indexterm zone="ch-system-eglibc ldconfig">
397            <primary sortas="b-ldconfig">ldconfig</primary>
398          </indexterm>
399        </listitem>
400      </varlistentry>
401
402      <varlistentry id="ldd">
403        <term><command>ldd</command></term>
404        <listitem>
405          <para>Reports which shared libraries are required
406          by each given program or shared library</para>
407          <indexterm zone="ch-system-eglibc ldd">
408            <primary sortas="b-ldd">ldd</primary>
409          </indexterm>
410        </listitem>
411      </varlistentry>
412
413      <varlistentry id="lddlibc4">
414        <term><command>lddlibc4</command></term>
415        <listitem>
416          <para>Assists <command>ldd</command> with object files</para>
417          <indexterm zone="ch-system-eglibc lddlibc4">
418            <primary sortas="b-lddlibc4">lddlibc4</primary>
419          </indexterm>
420        </listitem>
421      </varlistentry>
422
423      <varlistentry id="locale">
424        <term><command>locale</command></term>
425        <listitem>
426          <para>Tells the compiler to enable or disable the use of POSIX locales
427          for built-in operations</para>
428          <indexterm zone="ch-system-eglibc locale">
429            <primary sortas="b-locale">locale</primary>
430          </indexterm>
431        </listitem>
432      </varlistentry>
433
434      <varlistentry id="localedef">
435        <term><command>localedef</command></term>
436        <listitem>
437          <para>Compiles locale specifications</para>
438          <indexterm zone="ch-system-eglibc localedef">
439            <primary sortas="b-localedef">localedef</primary>
440          </indexterm>
441        </listitem>
442      </varlistentry>
443
444      <varlistentry id="mtrace">
445        <term><command>mtrace</command></term>
446        <listitem>
447          <para>Reads and interprets a memory trace file and
448          displays a summary in human-readable format</para>
449          <indexterm zone="ch-system-eglibc mtrace">
450            <primary sortas="b-mtrace">mtrace</primary>
451          </indexterm>
452        </listitem>
453      </varlistentry>
454
455      <varlistentry id="nscd">
456        <term><command>nscd</command></term>
457        <listitem>
458          <para>A daemon that provides a cache for the most common name
459          service requests</para>
460          <indexterm zone="ch-system-eglibc nscd">
461            <primary sortas="b-nscd">nscd</primary>
462          </indexterm>
463        </listitem>
464      </varlistentry>
465
466      <varlistentry id="pcprofiledump">
467        <term><command>pcprofiledump</command></term>
468        <listitem>
469          <para>Dumps information generated by PC profiling</para>
470          <indexterm zone="ch-system-eglibc pcprofiledump">
471            <primary sortas="b-pcprofiledump">pcprofiledump</primary>
472          </indexterm>
473        </listitem>
474      </varlistentry>
475
476      <varlistentry id="pt_chown">
477        <term><command>pt_chown</command></term>
478        <listitem>
479          <para>A helper program for <command>grantpt</command> to set the owner,
480          group and access permissions of a slave pseudo terminal</para>
481          <indexterm zone="ch-system-eglibc pt_chown">
482            <primary sortas="b-pt_chown">pt_chown</primary>
483          </indexterm>
484        </listitem>
485      </varlistentry>
486
487      <varlistentry id="rpcgen">
488        <term><command>rpcgen</command></term>
489        <listitem>
490          <para>Generates C code to implement the Remote Procecure Call (RPC)
491          protocol</para>
492          <indexterm zone="ch-system-eglibc rpcgen">
493            <primary sortas="b-rpcgen">rpcgen</primary>
494          </indexterm>
495        </listitem>
496      </varlistentry>
497
498      <varlistentry id="rpcinfo">
499        <term><command>rpcinfo</command></term>
500        <listitem>
501          <para>Makes an RPC call to an RPC server</para>
502          <indexterm zone="ch-system-eglibc rpcinfo">
503            <primary sortas="b-rpcinfo">rpcinfo</primary>
504          </indexterm>
505        </listitem>
506      </varlistentry>
507
508      <varlistentry id="sln">
509        <term><command>sln</command></term>
510        <listitem>
511          <para>A statically linked program that creates symbolic links</para>
512          <indexterm zone="ch-system-eglibc sln">
513            <primary sortas="b-sln">sln</primary>
514          </indexterm>
515        </listitem>
516      </varlistentry>
517
518      <varlistentry id="sprof">
519        <term><command>sprof</command></term>
520        <listitem>
521          <para>Reads and displays shared object profiling data</para>
522          <indexterm zone="ch-system-eglibc sprof">
523            <primary sortas="b-sprof">sprof</primary>
524          </indexterm>
525        </listitem>
526      </varlistentry>
527
528      <varlistentry id="tzselect">
529        <term><command>tzselect</command></term>
530        <listitem>
531          <para>Asks the user about the location of the
532          system and reports the corresponding time zone description</para>
533          <indexterm zone="ch-system-eglibc tzselect">
534            <primary sortas="b-tzselect">tzselect</primary>
535          </indexterm>
536        </listitem>
537      </varlistentry>
538
539      <varlistentry id="xtrace">
540        <term><command>xtrace</command></term>
541        <listitem>
542          <para>Traces the execution of a program by
543          printing the currently executed function</para>
544          <indexterm zone="ch-system-eglibc xtrace">
545            <primary sortas="b-xtrace">xtrace</primary>
546          </indexterm>
547        </listitem>
548      </varlistentry>
549
550      <varlistentry id="zdump">
551        <term><command>zdump</command></term>
552        <listitem>
553          <para>The time zone dumper</para>
554          <indexterm zone="ch-system-eglibc zdump">
555            <primary sortas="b-zdump">zdump</primary>
556          </indexterm>
557        </listitem>
558      </varlistentry>
559
560      <varlistentry id="zic">
561        <term><command>zic</command></term>
562        <listitem>
563          <para>The time zone compiler</para>
564          <indexterm zone="ch-system-eglibc zic">
565            <primary sortas="b-zic">zic</primary>
566          </indexterm>
567        </listitem>
568      </varlistentry>
569
570      <varlistentry id="ld.so">
571        <term><filename class="libraryfile">ld.so</filename></term>
572        <listitem>
573          <para>The helper program for shared library executables</para>
574          <indexterm zone="ch-system-eglibc ld.so">
575            <primary sortas="c-ld.so">ld.so</primary>
576          </indexterm>
577        </listitem>
578      </varlistentry>
579
580      <varlistentry id="libBrokenLocale">
581        <term><filename class="libraryfile">libBrokenLocale</filename></term>
582        <listitem>
583          <para>Used by programs, such as Mozilla, to solve broken locales</para>
584          <indexterm zone="ch-system-eglibc libBrokenLocale">
585            <primary sortas="c-libBrokenLocale">libBrokenLocale</primary>
586          </indexterm>
587        </listitem>
588      </varlistentry>
589
590      <varlistentry id="libSegFault">
591        <term><filename class="libraryfile">libSegFault</filename></term>
592        <listitem>
593          <para>The segmentation fault signal handler</para>
594          <indexterm zone="ch-system-eglibc libSegFault">
595            <primary sortas="c-libSegFault">libSegFault</primary>
596          </indexterm>
597        </listitem>
598      </varlistentry>
599
600      <varlistentry id="libanl">
601        <term><filename class="libraryfile">libanl</filename></term>
602        <listitem>
603          <para>An asynchronous name lookup library</para>
604          <indexterm zone="ch-system-eglibc libanl">
605            <primary sortas="c-libanl">libanl</primary>
606          </indexterm>
607        </listitem>
608      </varlistentry>
609
610      <varlistentry id="libbsd-compat">
611        <term><filename class="libraryfile">libbsd-compat</filename></term>
612        <listitem>
613          <para>Provides the portability needed
614          in order to run certain Berkey Software Distribution (BSD) programs
615          under Linux</para>
616          <indexterm zone="ch-system-eglibc libbsd-compat">
617            <primary sortas="c-libbsd-compat">libbsd-compat</primary>
618          </indexterm>
619        </listitem>
620      </varlistentry>
621
622      <varlistentry id="libc">
623        <term><filename class="libraryfile">libc</filename></term>
624        <listitem>
625          <para>The main C library</para>
626          <indexterm zone="ch-system-eglibc libc">
627            <primary sortas="c-libc">libc</primary>
628          </indexterm>
629        </listitem>
630      </varlistentry>
631
632      <varlistentry id="libcrypt">
633        <term><filename class="libraryfile">libcrypt</filename></term>
634        <listitem>
635          <para>The cryptography library</para>
636          <indexterm zone="ch-system-eglibc libcrypt">
637            <primary sortas="c-libcrypt">libcrypt</primary>
638          </indexterm>
639        </listitem>
640      </varlistentry>
641
642      <varlistentry id="libdl">
643        <term><filename class="libraryfile">libdl</filename></term>
644        <listitem>
645          <para>The dynamic linking interface library</para>
646          <indexterm zone="ch-system-eglibc libdl">
647            <primary sortas="c-libdl">libdl</primary>
648          </indexterm>
649        </listitem>
650      </varlistentry>
651
652      <varlistentry id="libg">
653        <term><filename class="libraryfile">libg</filename></term>
654        <listitem>
655          <para>A runtime library for <command>g++</command></para>
656          <indexterm zone="ch-system-eglibc libg">
657            <primary sortas="c-libg">libg</primary>
658          </indexterm>
659        </listitem>
660      </varlistentry>
661
662      <varlistentry id="libieee">
663        <term><filename class="libraryfile">libieee</filename></term>
664        <listitem>
665          <para>The Institute of Electrical and Electronic Engineers (IEEE)
666          floating point library</para>
667          <indexterm zone="ch-system-eglibc libieee">
668            <primary sortas="c-libieee">libieee</primary>
669          </indexterm>
670        </listitem>
671      </varlistentry>
672
673      <varlistentry id="libm">
674        <term><filename class="libraryfile">libm</filename></term>
675        <listitem>
676          <para>The mathematical library</para>
677          <indexterm zone="ch-system-eglibc libm">
678            <primary sortas="c-libm">libm</primary>
679          </indexterm>
680        </listitem>
681      </varlistentry>
682
683      <varlistentry id="libmcheck">
684        <term><filename class="libraryfile">libmcheck</filename></term>
685        <listitem>
686          <para>Contains code run at boot</para>
687          <indexterm zone="ch-system-eglibc libmcheck">
688            <primary sortas="c-libmcheck">libmcheck</primary>
689          </indexterm>
690        </listitem>
691      </varlistentry>
692
693      <varlistentry id="libmemusage">
694        <term><filename class="libraryfile">libmemusage</filename></term>
695        <listitem>
696          <para>Used by <command>memusage</command> (included in EGLIBC, but
697          not built in a base CLFS system as it has additional dependencies)
698          to help collect information about the memory usage of a program</para>
699          <indexterm zone="ch-system-eglibc libmemusage">
700            <primary sortas="c-libmemusage">libmemusage</primary>
701          </indexterm>
702        </listitem>
703      </varlistentry>
704
705      <varlistentry id="libnsl">
706        <term><filename class="libraryfile">libnsl</filename></term>
707        <listitem>
708          <para>The network services library</para>
709          <indexterm zone="ch-system-eglibc libnsl">
710            <primary sortas="c-libnsl">libnsl</primary>
711          </indexterm>
712        </listitem>
713      </varlistentry>
714
715      <varlistentry id="libnss">
716        <term><filename class="libraryfile">libnss</filename></term>
717        <listitem>
718          <para>The Name Service Switch libraries, containing functions for
719          resolving host names, user names, group names, aliases, services,
720          protocols, etc.</para>
721          <indexterm zone="ch-system-eglibc libnss">
722            <primary sortas="c-libnss">libnss</primary>
723          </indexterm>
724        </listitem>
725      </varlistentry>
726
727      <varlistentry id="libpcprofile">
728        <term><filename class="libraryfile">libpcprofile</filename></term>
729        <listitem>
730          <para>Contains profiling functions used to track the amount of CPU
731          time spent in specific source code lines</para>
732          <indexterm zone="ch-system-eglibc libpcprofile">
733            <primary sortas="c-libpcprofile">libpcprofile</primary>
734          </indexterm>
735        </listitem>
736      </varlistentry>
737
738      <varlistentry id="libpthread">
739        <term><filename class="libraryfile">libpthread</filename></term>
740        <listitem>
741          <para>The POSIX threads library</para>
742          <indexterm zone="ch-system-eglibc libpthread">
743            <primary sortas="c-libpthread">libpthread</primary>
744          </indexterm>
745        </listitem>
746      </varlistentry>
747
748      <varlistentry id="libresolv">
749        <term><filename class="libraryfile">libresolv</filename></term>
750        <listitem>
751          <para>Contains functions for creating, sending, and interpreting
752          packets to the Internet domain name servers</para>
753          <indexterm zone="ch-system-eglibc libresolv">
754            <primary sortas="c-libresolv">libresolv</primary>
755          </indexterm>
756        </listitem>
757      </varlistentry>
758
759      <varlistentry id="librpcsvc">
760        <term><filename class="libraryfile">librpcsvc</filename></term>
761        <listitem>
762          <para>Contains functions providing miscellaneous RPC services</para>
763          <indexterm zone="ch-system-eglibc librpcsvc">
764            <primary sortas="c-librpcsvc">librpcsvc</primary>
765          </indexterm>
766        </listitem>
767      </varlistentry>
768
769      <varlistentry id="librt">
770        <term><filename class="libraryfile">librt</filename></term>
771        <listitem>
772          <para>Contains functions providing most of the interfaces specified by
773          the POSIX.1b Realtime Extension</para>
774          <indexterm zone="ch-system-eglibc librt">
775            <primary sortas="c-librt">librt</primary>
776          </indexterm>
777        </listitem>
778      </varlistentry>
779
780      <varlistentry id="libthread_db">
781        <term><filename class="libraryfile">libthread_db</filename></term>
782        <listitem>
783          <para>Contains functions useful for
784          building debuggers for multi-threaded programs</para>
785          <indexterm zone="ch-system-eglibc libthread_db">
786            <primary sortas="c-libthread_db">libthread_db</primary>
787          </indexterm>
788        </listitem>
789      </varlistentry>
790
791      <varlistentry id="libutil">
792        <term><filename class="libraryfile">libutil</filename></term>
793        <listitem>
794          <para>Contains code for <quote>standard</quote> functions used in
795          many different Unix utilities</para>
796          <indexterm zone="ch-system-eglibc libutil">
797            <primary sortas="c-libutil">libutil</primary>
798          </indexterm>
799        </listitem>
800      </varlistentry>
801
802    </variablelist>
803
804  </sect2>
805
806</sect1>
Note: See TracBrowser for help on using the repository browser.