Changeset 73c180db for chapter06/glibc.xml
- Timestamp:
- 02/04/2006 01:37:25 PM (19 years ago)
- Children:
- 3a0a57c
- Parents:
- fa994c9
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/glibc.xml
rfa994c9 r73c180db 1 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" 3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 3 4 <!ENTITY % general-entities SYSTEM "../general.ent"> 4 5 %general-entities; 5 6 ]> 7 6 8 <sect1 id="ch-system-glibc" role="wrap"> 7 <title>Glibc-&glibc-version;</title> 8 <?dbhtml filename="glibc.html"?> 9 10 <indexterm zone="ch-system-glibc"><primary sortas="a-Glibc">Glibc</primary></indexterm> 11 12 <sect2 role="package"><title/> 13 <para>The Glibc package contains the main C library. This library provides 14 the basic routines for allocating memory, searching directories, opening and 15 closing files, reading and writing files, string handling, pattern matching, 16 arithmetic, and so on.</para> 17 18 <segmentedlist> 19 <segtitle>&buildtime;</segtitle> 20 <segtitle>&diskspace;</segtitle> 21 <seglistitem><seg>16.7 SBU</seg><seg>500 MB</seg></seglistitem> 22 </segmentedlist> 23 24 <segmentedlist> 25 <segtitle>&dependencies;</segtitle> 26 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, 27 Gawk, GCC, Gettext, Grep, Make, Perl, Sed, and Texinfo</seg></seglistitem> 28 </segmentedlist> 29 </sect2> 30 31 <sect2 role="installation"> 32 <title>Installation of Glibc</title> 33 34 <note><para>Some packages outside of LFS suggest installing GNU libiconv in 35 order to translate data from one encoding to another. The project's home page 36 (<ulink url="http://www.gnu.org/software/libiconv/"/>) says <quote>This library 37 provides an <function>iconv()</function> implementation, for use on systems 38 which don't have one, or whose implementation cannot convert from/to Unicode. 39 </quote> Glibc provides an <function>iconv()</function> implementation and can 40 convert from/to Unicode, therefore libiconv is not required on an LFS 41 system.</para></note> 42 43 <para>The Glibc build system is self-contained and will install 44 perfectly, even though the compiler specs file and linker are still 45 pointing at <filename class="directory">/tools</filename>. The specs 46 and linker cannot be adjusted before the Glibc install because the 47 Glibc autoconf tests would give false results and defeat the goal 48 of achieving a clean build.</para> 49 50 <para>The glibc-libidn tarball adds support for internationalized 51 domain names (IDN) to Glibc. Many programs that 52 support IDN require the full libidn library (see 53 <ulink url="&blfs-root;view/svn/general/libidn.html"/>), 54 not this add-on. 55 Unpack the tarball from within the Glibc source 56 directory:</para> 9 <?dbhtml filename="glibc.html"?> 10 11 <title>Glibc-&glibc-version;</title> 12 13 <indexterm zone="ch-system-glibc"> 14 <primary sortas="a-Glibc">Glibc</primary> 15 </indexterm> 16 17 <sect2 role="package"> 18 <title/> 19 20 <para>The Glibc 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 <segmentedlist> 26 <segtitle>&buildtime;</segtitle> 27 <segtitle>&diskspace;</segtitle> 28 29 <seglistitem> 30 <seg>16.7 SBU</seg> 31 <seg>500 MB</seg> 32 </seglistitem> 33 </segmentedlist> 34 35 <segmentedlist> 36 <segtitle>&dependencies;</segtitle> 37 38 <seglistitem> 39 <seg>Bash, Binutils, Coreutils, Diffutils, Gawk, GCC, Gettext, Grep, 40 Make, Perl, Sed, and Texinfo</seg> 41 </seglistitem> 42 </segmentedlist> 43 44 </sect2> 45 46 <sect2 role="installation"> 47 <title>Installation of Glibc</title> 48 49 <note> 50 <para>Some packages outside of LFS suggest installing GNU libiconv in 51 order to translate data from one encoding to another. The project's 52 home page (<ulink url="http://www.gnu.org/software/libiconv/"/>) says 53 <quote>This library provides an <function>iconv()</function> 54 implementation, for use on systems which don't have one, or whose 55 implementation cannot convert from/to Unicode.</quote> Glibc provides 56 an <function>iconv()</function> implementation and can convert from/to 57 Unicode, therefore libiconv is not required on an LFS system.</para> 58 </note> 59 60 <para>The Glibc build system is self-contained and will install 61 perfectly, even though the compiler specs file and linker are still 62 pointing at <filename class="directory">/tools</filename>. The specs 63 and linker cannot be adjusted before the Glibc install because the 64 Glibc autoconf tests would give false results and defeat the goal 65 of achieving a clean build.</para> 66 67 <para>The glibc-libidn tarball adds support for internationalized domain 68 names (IDN) to Glibc. Many programs that support IDN require the full 69 <filename class="libraryfile">libidn</filename> library (see 70 <ulink url="&blfs-root;view/svn/general/libidn.html"/>), not this add-on. 71 Unpack the tarball from within the Glibc source directory:</para> 57 72 58 73 <screen><userinput>tar -xf ../glibc-libidn-&glibc-version;.tar.bz2</userinput></screen> 59 74 60 <para>In the vi_VN.TCVN locale, <command>bash</command> enters an infinite loop61 at startup. It is unknown whether this is a <command>bash</command> bug or a62 Glibc problem. Disable installation of this locale in order to avoid the63 problem:</para>75 <para>In the vi_VN.TCVN locale, <command>bash</command> enters an infinite loop 76 at startup. It is unknown whether this is a <command>bash</command> bug or a 77 Glibc problem. Disable installation of this locale in order to avoid the 78 problem:</para> 64 79 65 80 <screen><userinput>sed -i '/vi_VN.TCVN/d' localedata/SUPPORTED</userinput></screen> 66 81 67 <para>When running <command>make install</command>, a script called68 <filename>test-installation.pl</filename> performs a small sanity test 69 on our newly installed Glibc. However, because our toolchain still points to the 70 <filename class="directory">/tools</filename> directory, the sanity test would 71 be carried out against the wrong Glibc. We can force the script to check the 72 Glibc we have just installed with the following:</para>82 <para>When running <command>make install</command>, a script called 83 <filename>test-installation.pl</filename> performs a small sanity test on 84 our newly installed Glibc. However, because our toolchain still points to 85 the <filename class="directory">/tools</filename> directory, the sanity 86 test would be carried out against the wrong Glibc. We can force the script 87 to check the Glibc we have just installed with the following:</para> 73 88 74 89 <screen><userinput>sed -i \ … … 76 91 scripts/test-installation.pl</userinput></screen> 77 92 78 <para>The Glibc documentation recommends building Glibc outside of the source79 directory in a dedicated build directory:</para>93 <para>The Glibc documentation recommends building Glibc outside of the source 94 directory in a dedicated build directory:</para> 80 95 81 96 <screen><userinput>mkdir -v ../glibc-build 82 97 cd ../glibc-build</userinput></screen> 83 98 84 <para>Prepare Glibc for compilation:</para>99 <para>Prepare Glibc for compilation:</para> 85 100 86 101 <screen><userinput>../glibc-&glibc-version;/configure --prefix=/usr \ … … 88 103 --enable-kernel=2.6.0 --libexecdir=/usr/lib/glibc</userinput></screen> 89 104 90 <para>The meaning of the new configure options:</para> 91 92 <variablelist> 93 <varlistentry> 94 <term><parameter>--libexecdir=/usr/lib/glibc</parameter></term> 95 <listitem><para>This changes the location of the 96 <command>pt_chown</command> program from its default of <filename 97 class="directory">/usr/libexec</filename> to <filename 98 class="directory">/usr/lib/glibc</filename>.</para></listitem> 99 </varlistentry> 100 </variablelist> 101 102 <para>Compile the package:</para> 105 <variablelist> 106 <title>The meaning of the new configure options:</title> 107 108 <varlistentry> 109 <term><parameter>--libexecdir=/usr/lib/glibc</parameter></term> 110 <listitem> 111 <para>This changes the location of the <command>pt_chown</command> 112 program from its default of <filename 113 class="directory">/usr/libexec</filename> to <filename 114 class="directory">/usr/lib/glibc</filename>.</para> 115 </listitem> 116 </varlistentry> 117 118 </variablelist> 119 120 <para>Compile the package:</para> 103 121 104 122 <screen><userinput>make</userinput></screen> 105 123 106 <important><para>In this section, the test suite for Glibc is 107 considered critical. Do not skip it under any 108 circumstance.</para></important> 109 110 <para>Test the results:</para> 124 <important> 125 <para>In this section, the test suite for Glibc is considered critical. 126 Do not skip it under any circumstance.</para> 127 </important> 128 129 <para>Test the results:</para> 111 130 112 131 <screen><userinput>make -k check >glibc-check-log 2>&1 113 132 grep Error glibc-check-log</userinput></screen> 114 133 115 <para>On at least i686 you can expect to see failures in the <emphasis>test-double 116 </emphasis> and <emphasis>test-idouble</emphasis> math tests with 117 gcc-&gcc-version;, as well as an expected (ignored) failure in <emphasis> 118 posix/annexc</emphasis>. These two failures in the math tests appear to be 119 harmless.</para> 120 121 <para>The Glibc test suite is highly dependent on certain functions of 122 the host system, in particular the kernel. In certain circumstances, 123 some failures are unavoidable. This is a list of the most common 124 issues:</para> 125 126 <itemizedlist> 127 <listitem><para>The <emphasis>math</emphasis> tests sometimes fail in other tests 128 when running 129 on systems where the CPU is not a relatively new genuine Intel or authentic AMD. 130 Certain optimization settings are also known to be a factor here.</para></listitem> 131 132 <listitem><para>The <emphasis>gettext</emphasis> test sometimes fails due to 133 host system issues. The exact reasons are not yet clear.</para></listitem> 134 135 <listitem><para>If you have mounted the LFS partition with the 136 <parameter>noatime</parameter> option, the <emphasis>atime</emphasis> test will 137 fail. As mentioned in <xref linkend="space-mounting"/>, do not use the 138 <parameter>noatime</parameter> option while building LFS.</para></listitem> 139 140 <listitem><para>When running on older and slower hardware, some tests 141 can fail because of test timeouts being exceeded.</para></listitem> 142 </itemizedlist> 143 144 <para>Though it is a harmless message, the install stage of Glibc will 145 complain about the absence of <filename>/etc/ld.so.conf</filename>. 146 Prevent this warning with:</para> 134 <para>On at least i686 you can expect to see failures in the 135 <emphasis>test-double </emphasis> and <emphasis>test-idouble</emphasis> 136 math tests with gcc-&gcc-version;, as well as an expected (ignored) 137 failure in <emphasis> posix/annexc</emphasis>. These two failures in 138 the math tests appear to be harmless.</para> 139 140 <para>The Glibc test suite is highly dependent on certain functions of 141 the host system, in particular the kernel. In certain circumstances, 142 some failures are unavoidable. This is a list of the most common 143 issues:</para> 144 145 <itemizedlist> 146 <listitem> 147 <para>The <emphasis>math</emphasis> tests sometimes fail in other 148 tests when running on systems where the CPU is not a relatively 149 new genuine Intel or authentic AMD. Certain optimization settings 150 are also known to be a factor here.</para> 151 </listitem> 152 <listitem> 153 <para>The <emphasis>gettext</emphasis> test sometimes fails due to 154 host system issues. The exact reasons are not yet clear.</para> 155 </listitem> 156 <listitem> 157 <para>If you have mounted the LFS partition with the 158 <parameter>noatime</parameter> option, the <emphasis>atime</emphasis> 159 test will fail. As mentioned in <xref linkend="space-mounting"/>, do not 160 use the <parameter>noatime</parameter> option while building LFS.</para> 161 </listitem> 162 <listitem> 163 <para>When running on older and slower hardware, some tests 164 can fail because of test timeouts being exceeded.</para> 165 </listitem> 166 </itemizedlist> 167 168 <para>Though it is a harmless message, the install stage of Glibc will 169 complain about the absence of <filename>/etc/ld.so.conf</filename>. 170 Prevent this warning with:</para> 147 171 148 172 <screen><userinput>touch /etc/ld.so.conf</userinput></screen> 149 173 150 <para>Install the package:</para>174 <para>Install the package:</para> 151 175 152 176 <screen><userinput>make install</userinput></screen> 153 177 154 <para>The locales that can make the system respond in a different 155 language were not installed by the above command. None of the 156 locales are required, but, if some of them are misssing, testuites of the 157 future packages would skip important testcases.</para> 158 159 <para>Individual locales can be installed using the <command>localedef</command> 160 program. E.g., the first <command>localedef</command> command below combines 161 the <filename>/usr/share/i18n/locales/de_DE</filename> charset-independent 162 locale definition with the 163 <filename>/usr/share/i18n/charmaps/ISO-8859-1.gz</filename> charmap definition 164 and appends the result to the 165 <filename>/usr/lib/locale/locale-archive</filename> file. The following 166 instructions will install the minimum set of locales necessary 167 for the optimal coverage of tests:</para> 178 <para>The locales that can make the system respond in a different language 179 were not installed by the above command. None of the locales are required, 180 but, if some of them are misssing, testuites of the future packages would 181 skip important testcases.</para> 182 183 <para>Individual locales can be installed using the 184 <command>localedef</command> program. E.g., the first 185 <command>localedef</command> command below combines the 186 <filename>/usr/share/i18n/locales/de_DE</filename> 187 charset-independent locale definition with the 188 <filename>/usr/share/i18n/charmaps/ISO-8859-1.gz</filename> 189 charmap definition and appends the result to the 190 <filename>/usr/lib/locale/locale-archive</filename> file. 191 The following instructions will install the minimum set of 192 locales necessary for the optimal coverage of tests:</para> 168 193 169 194 <screen role="nodump"><userinput>mkdir -pv /usr/lib/locale … … 182 207 localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen> 183 208 184 <para>In addition, install the locale for your own country, language and185 character set.</para>186 187 <para>Alternatively, install all locales 188 listed in the <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> 189 file (it includes every locale listed above and many more) 190 at once with thefollowing time-consuming command:</para>209 <para>In addition, install the locale for your own country, language and 210 character set.</para> 211 212 <para>Alternatively, install all locales listed in the 213 <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> file 214 (it includes every locale listed above and many more) at once with the 215 following time-consuming command:</para> 191 216 192 217 <screen><userinput>make localedata/install-locales</userinput></screen> 193 218 194 <para>Then use the <command>localedef</command> command to create and 195 install locales not listed in the 196 <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> file 197 in the unlikely case if you need them.</para> 198 <!-- The Live CD patches the localedata/SUPPORTED file instead of 199 running localedef, the results are equivalent --> 200 201 </sect2> 202 203 <sect2 id="conf-glibc" role="configuration"><title>Configuring Glibc</title> 204 <indexterm zone="conf-glibc"><primary sortas="e-/etc/nsswitch.conf">/etc/nsswitch.conf</primary></indexterm> 205 <indexterm zone="conf-glibc"><primary sortas="e-/etc/localtime">/etc/localtime</primary></indexterm> 206 207 <para>The <filename>/etc/nsswitch.conf</filename> file needs to be created 208 because, although Glibc provides defaults when this file is missing or corrupt, 209 the Glibc defaults do not work well in a networked environment. The time zone 210 also needs to be configured.</para> 211 212 <para>Create a new file <filename>/etc/nsswitch.conf</filename> by running the 213 following:</para> 219 <para>Then use the <command>localedef</command> command to create and 220 install locales not listed in the 221 <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> file 222 in the unlikely case if you need them.</para> 223 <!-- The Live CD patches the localedata/SUPPORTED file instead of 224 running localedef, the results are equivalent --> 225 226 </sect2> 227 228 <sect2 id="conf-glibc" role="configuration"> 229 <title>Configuring Glibc</title> 230 231 <indexterm zone="conf-glibc"> 232 <primary sortas="e-/etc/nsswitch.conf">/etc/nsswitch.conf</primary> 233 </indexterm> 234 235 <indexterm zone="conf-glibc"> 236 <primary sortas="e-/etc/localtime">/etc/localtime</primary> 237 </indexterm> 238 239 <para>The <filename>/etc/nsswitch.conf</filename> file needs to be created 240 because, although Glibc provides defaults when this file is missing or corrupt, 241 the Glibc defaults do not work well in a networked environment. The time zone 242 also needs to be configured.</para> 243 244 <para>Create a new file <filename>/etc/nsswitch.conf</filename> by running the 245 following:</para> 214 246 215 247 <screen><userinput>cat > /etc/nsswitch.conf << "EOF" … … 231 263 EOF</userinput></screen> 232 264 233 <para>To determine the local time zone, run the following script:</para>265 <para>To determine the local time zone, run the following script:</para> 234 266 235 267 <screen role="nodump"><userinput>tzselect</userinput></screen> 236 268 237 <para>After answering a few questions about the location, the script 238 will output the name of the time zone (e.g., 239 <emphasis>EST5EDT</emphasis> or <emphasis>Canada/Eastern</emphasis>). 240 Then create the <filename>/etc/localtime</filename> file by 241 running:</para> 269 <para>After answering a few questions about the location, the script will 270 output the name of the time zone (e.g., <emphasis>EST5EDT</emphasis> or 271 <emphasis>Canada/Eastern</emphasis>). Then create the 272 <filename>/etc/localtime</filename> file by running:</para> 242 273 243 274 <screen><userinput>cp -v --remove-destination /usr/share/zoneinfo/<replaceable>[xxx]</replaceable> \ 244 275 /etc/localtime</userinput></screen> 245 276 246 <para>Replace <replaceable>[xxx]</replaceable> with the name of the time zone 247 that <command>tzselect</command> provided (e.g., Canada/Eastern).</para> 248 249 <para>The meaning of the cp option:</para> 250 251 <variablelist> 252 <varlistentry> 253 <term><parameter>--remove-destination</parameter></term> 254 <listitem><para>This is needed to force removal of the already 255 existing symbolic link. The reason for copying the file instead of 256 using a symlink is to cover the situation where <filename 257 class="directory">/usr</filename> is on a separate partition. This 258 could be important when booted into single user 259 mode.</para></listitem> 260 </varlistentry> 261 </variablelist> 262 263 </sect2> 264 265 266 <sect2 id="conf-ld" role="configuration"> 267 <title>Configuring the Dynamic Loader</title> 268 <indexterm zone="conf-ld"><primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary></indexterm> 269 270 <para>By default, the dynamic loader (<filename 271 class="libraryfile">/lib/ld-linux.so.2</filename>) searches through 272 <filename class="directory">/lib</filename> and <filename 273 class="directory">/usr/lib</filename> for dynamic libraries that are 274 needed by programs as they are run. However, if there are libraries in 275 directories other than <filename class="directory">/lib</filename> and 276 <filename class="directory">/usr/lib</filename>, these need to be 277 added to the <filename>/etc/ld.so.conf</filename> file in order 278 for the dynamic loader to find them. Two directories that are commonly 279 known to contain additional libraries are <filename 280 class="directory">/usr/local/lib</filename> and <filename 281 class="directory">/opt/lib</filename>, so add those directories to the 282 dynamic loader's search path.</para> 283 284 <para>Create a new file <filename>/etc/ld.so.conf</filename> by running the 285 following:</para> 277 <para>Replace <replaceable>[xxx]</replaceable> with the name of the time zone 278 that <command>tzselect</command> provided (e.g., Canada/Eastern).</para> 279 280 <variablelist> 281 <title>The meaning of the cp option:</title> 282 283 <varlistentry> 284 <term><parameter>--remove-destination</parameter></term> 285 <listitem> 286 <para>This is needed to force removal of the already existing symbolic 287 link. The reason for copying the file instead of using a symlink is to 288 cover the situation where <filename class="directory">/usr</filename> 289 is on a separate partition. This could be important when booted into 290 single user mode.</para> 291 </listitem> 292 </varlistentry> 293 294 </variablelist> 295 296 </sect2> 297 298 <sect2 id="conf-ld" role="configuration"> 299 <title>Configuring the Dynamic Loader</title> 300 301 <indexterm zone="conf-ld"> 302 <primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary> 303 </indexterm> 304 305 <para>By default, the dynamic loader (<filename 306 class="libraryfile">/lib/ld-linux.so.2</filename>) searches through 307 <filename class="directory">/lib</filename> and <filename 308 class="directory">/usr/lib</filename> for dynamic libraries that are 309 needed by programs as they are run. However, if there are libraries in 310 directories other than <filename class="directory">/lib</filename> and 311 <filename class="directory">/usr/lib</filename>, these need to be added 312 to the <filename>/etc/ld.so.conf</filename> file in order for the 313 dynamic loader to find them. Two directories that are commonly known 314 to contain additional libraries are <filename 315 class="directory">/usr/local/lib</filename> and <filename 316 class="directory">/opt/lib</filename>, so add those directories to the 317 dynamic loader's search path.</para> 318 319 <para>Create a new file <filename>/etc/ld.so.conf</filename> by running the 320 following:</para> 286 321 287 322 <screen><userinput>cat > /etc/ld.so.conf << "EOF" … … 294 329 EOF</userinput></screen> 295 330 296 </sect2> 297 298 <sect2 id="contents-glibc" role="content"><title>Contents of Glibc</title> 299 300 <segmentedlist> 301 <segtitle>Installed programs</segtitle> 302 <segtitle>Installed libraries</segtitle> 303 <seglistitem><seg>catchsegv, gencat, getconf, 304 getent, iconv, iconvconfig, ldconfig, ldd, lddlibc4, locale, 305 localedef, mtrace, nscd, nscd_nischeck, pcprofiledump, pt_chown, rpcgen, 306 rpcinfo, sln, sprof, tzselect, xtrace, zdump, and zic</seg> 307 <seg>ld.so, libBrokenLocale.[a,so], 308 libSegFault.so, libanl.[a,so], libbsd-compat.a, libc.[a,so], libcidn.so, 309 libcrypt.[a,so], libdl.[a,so], libg.a, libieee.a, libm.[a,so], libmcheck.a, 310 libmemusage.so, libnsl.a, libnss_compat.so, libnss_dns.so, libnss_files.so, 311 libnss_hesiod.so, libnss_nis.so, libnss_nisplus.so, libpcprofile.so, 312 libpthread.[a,so], libresolv.[a,so], librpcsvc.a, librt.[a,so], 313 libthread_db.so, and libutil.[a,so]</seg></seglistitem> 314 </segmentedlist> 315 316 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> 317 <?dbfo list-presentation="list"?> 318 <?dbhtml list-presentation="table"?> 319 320 <varlistentry id="catchsegv"> 321 <term><command>catchsegv</command></term> 322 <listitem> 323 <para>Can be used to create a stack trace when a program 324 terminates with a segmentation fault</para> 325 <indexterm zone="ch-system-glibc catchsegv"><primary sortas="b-catchsegv">catchsegv</primary></indexterm> 326 </listitem> 327 </varlistentry> 328 329 <varlistentry id="gencat"> 330 <term><command>gencat</command></term> 331 <listitem> 332 <para>Generates message catalogues</para> 333 <indexterm zone="ch-system-glibc gencat"><primary sortas="b-gencat">gencat</primary></indexterm> 334 </listitem> 335 </varlistentry> 336 337 <varlistentry id="getconf"> 338 <term><command>getconf</command></term> 339 <listitem> 340 <para>Displays the system configuration values for file system specific variables</para> 341 <indexterm zone="ch-system-glibc getconf"><primary sortas="b-getconf">getconf</primary></indexterm> 342 </listitem> 343 </varlistentry> 344 345 <varlistentry id="getent"> 346 <term><command>getent</command></term> 347 <listitem> 348 <para>Gets entries from an administrative database</para> 349 <indexterm zone="ch-system-glibc getent"><primary sortas="b-getent">getent</primary></indexterm> 350 </listitem> 351 </varlistentry> 352 353 <varlistentry id="iconv"> 354 <term><command>iconv</command></term> 355 <listitem> 356 <para>Performs character set conversion</para> 357 <indexterm zone="ch-system-glibc iconv"><primary sortas="b-iconv">iconv</primary></indexterm> 358 </listitem> 359 </varlistentry> 360 361 <varlistentry id="iconvconfig"> 362 <term><command>iconvconfig</command></term> 363 <listitem> 364 <para>Creates fastloading <command>iconv</command> module configuration files</para> 365 <indexterm zone="ch-system-glibc iconvconfig"><primary sortas="b-iconvconfig">iconvconfig</primary></indexterm> 366 </listitem> 367 </varlistentry> 368 369 <varlistentry id="ldconfig"> 370 <term><command>ldconfig</command></term> 371 <listitem> 372 <para>Configures the dynamic linker runtime bindings</para> 373 <indexterm zone="ch-system-glibc ldconfig"><primary sortas="b-ldconfig">ldconfig</primary></indexterm> 374 </listitem> 375 </varlistentry> 376 377 <varlistentry id="ldd"> 378 <term><command>ldd</command></term> 379 <listitem> 380 <para>Reports which shared libraries are required 381 by each given program or shared library</para> 382 <indexterm zone="ch-system-glibc ldd"><primary sortas="b-ldd">ldd</primary></indexterm> 383 </listitem> 384 </varlistentry> 385 386 <varlistentry id="lddlibc4"> 387 <term><command>lddlibc4</command></term> 388 <listitem> 389 <para>Assists <command>ldd</command> with object files</para> 390 <indexterm zone="ch-system-glibc lddlibc4"><primary sortas="b-lddlibc4">lddlibc4</primary></indexterm> 391 </listitem> 392 </varlistentry> 393 394 <varlistentry id="locale"> 395 <term><command>locale</command></term> 396 <listitem> 397 <para>Prints various information about the current locale</para> 398 <indexterm zone="ch-system-glibc locale"><primary sortas="b-locale">locale</primary></indexterm> 399 </listitem> 400 </varlistentry> 401 402 <varlistentry id="localedef"> 403 <term><command>localedef</command></term> 404 <listitem> 405 <para>Compiles locale specifications</para> 406 <indexterm zone="ch-system-glibc localedef"><primary sortas="b-localedef">localedef</primary></indexterm> 407 </listitem> 408 </varlistentry> 409 410 <varlistentry id="mtrace"> 411 <term><command>mtrace</command></term> 412 <listitem> 413 <para>Reads and interprets a memory trace file and displays a summary in human-readable format</para> 414 <indexterm zone="ch-system-glibc mtrace"><primary sortas="b-mtrace">mtrace</primary></indexterm> 415 </listitem> 416 </varlistentry> 417 418 <varlistentry id="nscd"> 419 <term><command>nscd</command></term> 420 <listitem> 421 <para>A daemon that provides a cache for the most common name 422 service requests</para> 423 <indexterm zone="ch-system-glibc nscd"><primary sortas="b-nscd">nscd</primary></indexterm> 424 </listitem> 425 </varlistentry> 426 427 <varlistentry id="nscd_nischeck"> 428 <term><command>nscd_nischeck</command></term> 429 <listitem> 430 <para>Checks whether or not secure mode is necessary for NIS+ lookup</para> 431 <indexterm zone="ch-system-glibc nscd_nischeck"><primary sortas="b-nscd_nischeck">nscd_nischeck</primary></indexterm> 432 </listitem> 433 </varlistentry> 434 435 <varlistentry id="pcprofiledump"> 436 <term><command>pcprofiledump</command></term> 437 <listitem> 438 <para>Dumps information generated by PC profiling</para> 439 <indexterm zone="ch-system-glibc pcprofiledump"><primary sortas="b-pcprofiledump">pcprofiledump</primary></indexterm> 440 </listitem> 441 </varlistentry> 442 443 <varlistentry id="pt_chown"> 444 <term><command>pt_chown</command></term> 445 <listitem> 446 <para>A helper program for <command>grantpt</command> to set 447 the owner, group and access permissions of a slave pseudo terminal</para> 448 <indexterm zone="ch-system-glibc pt_chown"><primary sortas="b-pt_chown">pt_chown</primary></indexterm> 449 </listitem> 450 </varlistentry> 451 452 <varlistentry id="rpcgen"> 453 <term><command>rpcgen</command></term> 454 <listitem> 455 <para>Generates C code to implement the Remote Procecure Call (RPC) protocol</para> 456 <indexterm zone="ch-system-glibc rpcgen"><primary sortas="b-rpcgen">rpcgen</primary></indexterm> 457 </listitem> 458 </varlistentry> 459 460 <varlistentry id="rpcinfo"> 461 <term><command>rpcinfo</command></term> 462 <listitem> 463 <para>Makes an RPC call to an RPC server</para> 464 <indexterm zone="ch-system-glibc rpcinfo"><primary sortas="b-rpcinfo">rpcinfo</primary></indexterm> 465 </listitem> 466 </varlistentry> 467 468 <varlistentry id="sln"> 469 <term><command>sln</command></term> 470 <listitem> 471 <para>A statically linked <command>ln</command> program</para> 472 <indexterm zone="ch-system-glibc sln"><primary sortas="b-sln">sln</primary></indexterm> 473 </listitem> 474 </varlistentry> 475 476 <varlistentry id="sprof"> 477 <term><command>sprof</command></term> 478 <listitem> 479 <para>Reads and displays shared object profiling data</para> 480 <indexterm zone="ch-system-glibc sprof"><primary sortas="b-sprof">sprof</primary></indexterm> 481 </listitem> 482 </varlistentry> 483 484 <varlistentry id="tzselect"> 485 <term><command>tzselect</command></term> 486 <listitem> 487 <para>Asks the user about the location of the 488 system and reports the corresponding time zone description</para> 489 <indexterm zone="ch-system-glibc tzselect"><primary sortas="b-tzselect">tzselect</primary></indexterm> 490 </listitem> 491 </varlistentry> 492 493 <varlistentry id="xtrace"> 494 <term><command>xtrace</command></term> 495 <listitem> 496 <para>Traces the execution of a program by 497 printing the currently executed function</para> 498 <indexterm zone="ch-system-glibc xtrace"><primary sortas="b-xtrace">xtrace</primary></indexterm> 499 </listitem> 500 </varlistentry> 501 502 <varlistentry id="zdump"> 503 <term><command>zdump</command></term> 504 <listitem> 505 <para>The time zone dumper</para> 506 <indexterm zone="ch-system-glibc zdump"><primary sortas="b-zdump">zdump</primary></indexterm> 507 </listitem> 508 </varlistentry> 509 510 <varlistentry id="zic"> 511 <term><command>zic</command></term> 512 <listitem> 513 <para>The time zone compiler</para> 514 <indexterm zone="ch-system-glibc zic"><primary sortas="b-zic">zic</primary></indexterm> 515 </listitem> 516 </varlistentry> 517 518 <varlistentry id="ld.so"> 519 <term><filename class="libraryfile">ld.so</filename></term> 520 <listitem> 521 <para>The helper program for shared library executables</para> 522 <indexterm zone="ch-system-glibc ld.so"><primary sortas="c-ld.so">ld.so</primary></indexterm> 523 </listitem> 524 </varlistentry> 525 526 <varlistentry id="libBrokenLocale"> 527 <term><filename class="libraryfile">libBrokenLocale</filename></term> 528 <listitem> 529 <para>Used internally by Glibc as a gross hack to get broken programs 530 (e.g., some Motif applications) running. See comments in 531 <filename>glibc-&glibc-version;/locale/broken_cur_max.c</filename> for more 532 information</para> 533 <indexterm zone="ch-system-glibc libBrokenLocale"><primary sortas="c-libBrokenLocale">libBrokenLocale</primary></indexterm> 534 </listitem> 535 </varlistentry> 536 537 <varlistentry id="libSegFault"> 538 <term><filename class="libraryfile">libSegFault</filename></term> 539 <listitem> 540 <para>The segmentation fault signal handler, used by 541 <command>catchsegv</command></para> 542 <indexterm zone="ch-system-glibc libSegFault"><primary sortas="c-libSegFault">libSegFault</primary></indexterm> 543 </listitem> 544 </varlistentry> 545 546 <varlistentry id="libanl"> 547 <term><filename class="libraryfile">libanl</filename></term> 548 <listitem> 549 <para>An asynchronous name lookup library</para> 550 <indexterm zone="ch-system-glibc libanl"><primary sortas="c-libanl">libanl</primary></indexterm> 551 </listitem> 552 </varlistentry> 553 554 <varlistentry id="libbsd-compat"> 555 <term><filename class="libraryfile">libbsd-compat</filename></term> 556 <listitem> 557 <para>Provides the portability needed 558 in order to run certain Berkey Software Distribution (BSD) programs under Linux</para> 559 <indexterm zone="ch-system-glibc libbsd-compat"><primary sortas="c-libbsd-compat">libbsd-compat</primary></indexterm> 560 </listitem> 561 </varlistentry> 562 563 <varlistentry id="libc"> 564 <term><filename class="libraryfile">libc</filename></term> 565 <listitem> 566 <para>The main C library</para> 567 <indexterm zone="ch-system-glibc libc"><primary sortas="c-libc">libc</primary></indexterm> 568 </listitem> 569 </varlistentry> 570 571 <varlistentry id="libcidn"> 572 <term><filename class="libraryfile">libcidn</filename></term> 573 <listitem> 574 <para>Used internally by Glibc for handling internationalized domain names in 575 the <function>getaddrinfo()</function> function</para> 576 <indexterm zone="ch-system-glibc libcrypt"><primary sortas="c-libcrypt">libcrypt</primary></indexterm> 577 </listitem> 578 </varlistentry> 579 580 <varlistentry id="libcrypt"> 581 <term><filename class="libraryfile">libcrypt</filename></term> 582 <listitem> 583 <para>The cryptography library</para> 584 <indexterm zone="ch-system-glibc libcrypt"><primary sortas="c-libcrypt">libcrypt</primary></indexterm> 585 </listitem> 586 </varlistentry> 587 588 <varlistentry id="libdl"> 589 <term><filename class="libraryfile">libdl</filename></term> 590 <listitem> 591 <para>The dynamic linking interface library</para> 592 <indexterm zone="ch-system-glibc libdl"><primary sortas="c-libdl">libdl</primary></indexterm> 593 </listitem> 594 </varlistentry> 595 596 <varlistentry id="libg"> 597 <term><filename class="libraryfile">libg</filename></term> 598 <listitem> 599 <para>Dummy library containing no functions. Previously was a runtime library 600 for <command>g++</command></para> 601 <indexterm zone="ch-system-glibc libg"><primary sortas="c-libg">libg</primary></indexterm> 602 </listitem> 603 </varlistentry> 604 605 <varlistentry id="libieee"> 606 <term><filename class="libraryfile">libieee</filename></term> 607 <listitem> 608 <para>Linking in this module forces error handling rules for math functions as 609 defined by the Institute of Electrical and Electronic Engineers (IEEE). 610 The default is POSIX.1 error handling</para> 611 <indexterm zone="ch-system-glibc libieee"><primary sortas="c-libieee">libieee</primary></indexterm> 612 </listitem> 613 </varlistentry> 614 615 <varlistentry id="libm"> 616 <term><filename class="libraryfile">libm</filename></term> 617 <listitem> 618 <para>The mathematical library</para> 619 <indexterm zone="ch-system-glibc libm"><primary sortas="c-libm">libm</primary></indexterm> 620 </listitem> 621 </varlistentry> 622 623 <varlistentry id="libmcheck"> 624 <term><filename class="libraryfile">libmcheck</filename></term> 625 <listitem> 626 <para>Turns on memory allocation checking when linked to</para> 627 <indexterm zone="ch-system-glibc libmcheck"><primary sortas="c-libmcheck">libmcheck</primary></indexterm> 628 </listitem> 629 </varlistentry> 630 631 <varlistentry id="libmemusage"> 632 <term><filename class="libraryfile">libmemusage</filename></term> 633 <listitem> 634 <para>Used by <command>memusage</command> to help collect 635 information about the memory usage of a program</para> 636 <indexterm zone="ch-system-glibc libmemusage"><primary sortas="c-libmemusage">libmemusage</primary></indexterm> 637 </listitem> 638 </varlistentry> 639 640 <varlistentry id="libnsl"> 641 <term><filename class="libraryfile">libnsl</filename></term> 642 <listitem> 643 <para>The network services library</para> 644 <indexterm zone="ch-system-glibc libnsl"><primary sortas="c-libnsl">libnsl</primary></indexterm> 645 </listitem> 646 </varlistentry> 647 648 <varlistentry id="libnss"> 649 <term><filename class="libraryfile">libnss</filename></term> 650 <listitem> 651 <para>The Name Service Switch libraries, 652 containing functions for resolving host names, user names, group names, 653 aliases, services, protocols, etc.</para> 654 <indexterm zone="ch-system-glibc libnss"><primary sortas="c-libnss">libnss</primary></indexterm> 655 </listitem> 656 </varlistentry> 657 658 <varlistentry id="libpcprofile"> 659 <term><filename class="libraryfile">libpcprofile</filename></term> 660 <listitem> 661 <para>Contains profiling functions used 662 to track the amount of CPU time spent in specific source code lines</para> 663 <indexterm zone="ch-system-glibc libpcprofile"><primary sortas="c-libpcprofile">libpcprofile</primary></indexterm> 664 </listitem> 665 </varlistentry> 666 667 <varlistentry id="libpthread"> 668 <term><filename class="libraryfile">libpthread</filename></term> 669 <listitem> 670 <para>The POSIX threads library</para> 671 <indexterm zone="ch-system-glibc libpthread"><primary sortas="c-libpthread">libpthread</primary></indexterm> 672 </listitem> 673 </varlistentry> 674 675 <varlistentry id="libresolv"> 676 <term><filename class="libraryfile">libresolv</filename></term> 677 <listitem> 678 <para>Contains functions for creating, 679 sending, and interpreting packets to the Internet domain name servers</para> 680 <indexterm zone="ch-system-glibc libresolv"><primary sortas="c-libresolv">libresolv</primary></indexterm> 681 </listitem> 682 </varlistentry> 683 684 <varlistentry id="librpcsvc"> 685 <term><filename class="libraryfile">librpcsvc</filename></term> 686 <listitem> 687 <para>Contains functions providing miscellaneous RPC services</para> 688 <indexterm zone="ch-system-glibc librpcsvc"><primary sortas="c-librpcsvc">librpcsvc</primary></indexterm> 689 </listitem> 690 </varlistentry> 691 692 <varlistentry id="librt"> 693 <term><filename class="libraryfile">librt</filename></term> 694 <listitem> 695 <para>Contains functions providing most of the 696 interfaces specified by the POSIX.1b Realtime Extension</para> 697 <indexterm zone="ch-system-glibc librt"><primary sortas="c-librt">librt</primary></indexterm> 698 </listitem> 699 </varlistentry> 700 701 <varlistentry id="libthread_db"> 702 <term><filename class="libraryfile">libthread_db</filename></term> 703 <listitem> 704 <para>Contains functions useful for 705 building debuggers for multi-threaded programs</para> 706 <indexterm zone="ch-system-glibc libthread_db"><primary sortas="c-libthread_db">libthread_db</primary></indexterm> 707 </listitem> 708 </varlistentry> 709 710 <varlistentry id="libutil"> 711 <term><filename class="libraryfile">libutil</filename></term> 712 <listitem> 713 <para>Contains code for <quote>standard</quote> functions used in many different Unix utilities</para> 714 <indexterm zone="ch-system-glibc libutil"><primary sortas="c-libutil">libutil</primary></indexterm> 715 </listitem> 716 </varlistentry> 717 </variablelist> 718 719 </sect2> 331 </sect2> 332 333 <sect2 id="contents-glibc" role="content"> 334 <title>Contents of Glibc</title> 335 336 <segmentedlist> 337 <segtitle>Installed programs</segtitle> 338 <segtitle>Installed libraries</segtitle> 339 340 <seglistitem> 341 <seg>catchsegv, gencat, getconf, getent, iconv, iconvconfig, ldconfig, 342 ldd, lddlibc4, locale, localedef, mtrace, nscd, nscd_nischeck, 343 pcprofiledump, pt_chown, rpcgen, rpcinfo, sln, sprof, tzselect, xtrace, 344 zdump, and zic</seg> 345 <seg>ld.so, libBrokenLocale.[a,so], libSegFault.so, libanl.[a,so], 346 libbsd-compat.a, libc.[a,so], libcidn.so, libcrypt.[a,so], libdl.[a,so], 347 libg.a, libieee.a, libm.[a,so], libmcheck.a, libmemusage.so, libnsl.a, 348 libnss_compat.so, libnss_dns.so, libnss_files.so, libnss_hesiod.so, 349 libnss_nis.so, libnss_nisplus.so, libpcprofile.so, libpthread.[a,so], 350 libresolv.[a,so], librpcsvc.a, librt.[a,so], libthread_db.so, and 351 libutil.[a,so]</seg> 352 </seglistitem> 353 </segmentedlist> 354 355 <variablelist> 356 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 357 <?dbfo list-presentation="list"?> 358 <?dbhtml list-presentation="table"?> 359 360 <varlistentry id="catchsegv"> 361 <term><command>catchsegv</command></term> 362 <listitem> 363 <para>Can be used to create a stack trace when a program 364 terminates with a segmentation fault</para> 365 <indexterm zone="ch-system-glibc catchsegv"> 366 <primary sortas="b-catchsegv">catchsegv</primary> 367 </indexterm> 368 </listitem> 369 </varlistentry> 370 371 <varlistentry id="gencat"> 372 <term><command>gencat</command></term> 373 <listitem> 374 <para>Generates message catalogues</para> 375 <indexterm zone="ch-system-glibc gencat"> 376 <primary sortas="b-gencat">gencat</primary> 377 </indexterm> 378 </listitem> 379 </varlistentry> 380 381 <varlistentry id="getconf"> 382 <term><command>getconf</command></term> 383 <listitem> 384 <para>Displays the system configuration values for file system 385 specific variables</para> 386 <indexterm zone="ch-system-glibc getconf"> 387 <primary sortas="b-getconf">getconf</primary> 388 </indexterm> 389 </listitem> 390 </varlistentry> 391 392 <varlistentry id="getent"> 393 <term><command>getent</command></term> 394 <listitem> 395 <para>Gets entries from an administrative database</para> 396 <indexterm zone="ch-system-glibc getent"> 397 <primary sortas="b-getent">getent</primary> 398 </indexterm> 399 </listitem> 400 </varlistentry> 401 402 <varlistentry id="iconv"> 403 <term><command>iconv</command></term> 404 <listitem> 405 <para>Performs character set conversion</para> 406 <indexterm zone="ch-system-glibc iconv"> 407 <primary sortas="b-iconv">iconv</primary> 408 </indexterm> 409 </listitem> 410 </varlistentry> 411 412 <varlistentry id="iconvconfig"> 413 <term><command>iconvconfig</command></term> 414 <listitem> 415 <para>Creates fastloading <command>iconv</command> module configuration 416 files</para> 417 <indexterm zone="ch-system-glibc iconvconfig"> 418 <primary sortas="b-iconvconfig">iconvconfig</primary> 419 </indexterm> 420 </listitem> 421 </varlistentry> 422 423 <varlistentry id="ldconfig"> 424 <term><command>ldconfig</command></term> 425 <listitem> 426 <para>Configures the dynamic linker runtime bindings</para> 427 <indexterm zone="ch-system-glibc ldconfig"> 428 <primary sortas="b-ldconfig">ldconfig</primary> 429 </indexterm> 430 </listitem> 431 </varlistentry> 432 433 <varlistentry id="ldd"> 434 <term><command>ldd</command></term> 435 <listitem> 436 <para>Reports which shared libraries are required 437 by each given program or shared library</para> 438 <indexterm zone="ch-system-glibc ldd"> 439 <primary sortas="b-ldd">ldd</primary> 440 </indexterm> 441 </listitem> 442 </varlistentry> 443 444 <varlistentry id="lddlibc4"> 445 <term><command>lddlibc4</command></term> 446 <listitem> 447 <para>Assists <command>ldd</command> with object files</para> 448 <indexterm zone="ch-system-glibc lddlibc4"> 449 <primary sortas="b-lddlibc4">lddlibc4</primary> 450 </indexterm> 451 </listitem> 452 </varlistentry> 453 454 <varlistentry id="locale"> 455 <term><command>locale</command></term> 456 <listitem> 457 <para>Prints various information about the current locale</para> 458 <indexterm zone="ch-system-glibc locale"> 459 <primary sortas="b-locale">locale</primary> 460 </indexterm> 461 </listitem> 462 </varlistentry> 463 464 <varlistentry id="localedef"> 465 <term><command>localedef</command></term> 466 <listitem> 467 <para>Compiles locale specifications</para> 468 <indexterm zone="ch-system-glibc localedef"> 469 <primary sortas="b-localedef">localedef</primary> 470 </indexterm> 471 </listitem> 472 </varlistentry> 473 474 <varlistentry id="mtrace"> 475 <term><command>mtrace</command></term> 476 <listitem> 477 <para>Reads and interprets a memory trace file and displays a summary 478 in human-readable format</para> 479 <indexterm zone="ch-system-glibc mtrace"> 480 <primary sortas="b-mtrace">mtrace</primary> 481 </indexterm> 482 </listitem> 483 </varlistentry> 484 485 <varlistentry id="nscd"> 486 <term><command>nscd</command></term> 487 <listitem> 488 <para>A daemon that provides a cache for the most common name 489 service requests</para> 490 <indexterm zone="ch-system-glibc nscd"> 491 <primary sortas="b-nscd">nscd</primary> 492 </indexterm> 493 </listitem> 494 </varlistentry> 495 496 <varlistentry id="nscd_nischeck"> 497 <term><command>nscd_nischeck</command></term> 498 <listitem> 499 <para>Checks whether or not secure mode is necessary for NIS+ 500 lookup</para> 501 <indexterm zone="ch-system-glibc nscd_nischeck"> 502 <primary sortas="b-nscd_nischeck">nscd_nischeck</primary> 503 </indexterm> 504 </listitem> 505 </varlistentry> 506 507 <varlistentry id="pcprofiledump"> 508 <term><command>pcprofiledump</command></term> 509 <listitem> 510 <para>Dumps information generated by PC profiling</para> 511 <indexterm zone="ch-system-glibc pcprofiledump"> 512 <primary sortas="b-pcprofiledump">pcprofiledump</primary> 513 </indexterm> 514 </listitem> 515 </varlistentry> 516 517 <varlistentry id="pt_chown"> 518 <term><command>pt_chown</command></term> 519 <listitem> 520 <para>A helper program for <command>grantpt</command> to set the owner, 521 group and access permissions of a slave pseudo terminal</para> 522 <indexterm zone="ch-system-glibc pt_chown"> 523 <primary sortas="b-pt_chown">pt_chown</primary> 524 </indexterm> 525 </listitem> 526 </varlistentry> 527 528 <varlistentry id="rpcgen"> 529 <term><command>rpcgen</command></term> 530 <listitem> 531 <para>Generates C code to implement the Remote Procecure Call (RPC) 532 protocol</para> 533 <indexterm zone="ch-system-glibc rpcgen"> 534 <primary sortas="b-rpcgen">rpcgen</primary> 535 </indexterm> 536 </listitem> 537 </varlistentry> 538 539 <varlistentry id="rpcinfo"> 540 <term><command>rpcinfo</command></term> 541 <listitem> 542 <para>Makes an RPC call to an RPC server</para> 543 <indexterm zone="ch-system-glibc rpcinfo"> 544 <primary sortas="b-rpcinfo">rpcinfo</primary> 545 </indexterm> 546 </listitem> 547 </varlistentry> 548 549 <varlistentry id="sln"> 550 <term><command>sln</command></term> 551 <listitem> 552 <para>A statically linked <command>ln</command> program</para> 553 <indexterm zone="ch-system-glibc sln"> 554 <primary sortas="b-sln">sln</primary> 555 </indexterm> 556 </listitem> 557 </varlistentry> 558 559 <varlistentry id="sprof"> 560 <term><command>sprof</command></term> 561 <listitem> 562 <para>Reads and displays shared object profiling data</para> 563 <indexterm zone="ch-system-glibc sprof"> 564 <primary sortas="b-sprof">sprof</primary> 565 </indexterm> 566 </listitem> 567 </varlistentry> 568 569 <varlistentry id="tzselect"> 570 <term><command>tzselect</command></term> 571 <listitem> 572 <para>Asks the user about the location of the system and reports 573 the corresponding time zone description</para> 574 <indexterm zone="ch-system-glibc tzselect"> 575 <primary sortas="b-tzselect">tzselect</primary> 576 </indexterm> 577 </listitem> 578 </varlistentry> 579 580 <varlistentry id="xtrace"> 581 <term><command>xtrace</command></term> 582 <listitem> 583 <para>Traces the execution of a program by printing the currently 584 executed function</para> 585 <indexterm zone="ch-system-glibc xtrace"> 586 <primary sortas="b-xtrace">xtrace</primary> 587 </indexterm> 588 </listitem> 589 </varlistentry> 590 591 <varlistentry id="zdump"> 592 <term><command>zdump</command></term> 593 <listitem> 594 <para>The time zone dumper</para> 595 <indexterm zone="ch-system-glibc zdump"> 596 <primary sortas="b-zdump">zdump</primary> 597 </indexterm> 598 </listitem> 599 </varlistentry> 600 601 <varlistentry id="zic"> 602 <term><command>zic</command></term> 603 <listitem> 604 <para>The time zone compiler</para> 605 <indexterm zone="ch-system-glibc zic"> 606 <primary sortas="b-zic">zic</primary> 607 </indexterm> 608 </listitem> 609 </varlistentry> 610 611 <varlistentry id="ld.so"> 612 <term><filename class="libraryfile">ld.so</filename></term> 613 <listitem> 614 <para>The helper program for shared library executables</para> 615 <indexterm zone="ch-system-glibc ld.so"> 616 <primary sortas="c-ld.so">ld.so</primary> 617 </indexterm> 618 </listitem> 619 </varlistentry> 620 621 <varlistentry id="libBrokenLocale"> 622 <term><filename class="libraryfile">libBrokenLocale</filename></term> 623 <listitem> 624 <para>Used internally by Glibc as a gross hack to get broken programs 625 (e.g., some Motif applications) running. See comments in 626 <filename>glibc-&glibc-version;/locale/broken_cur_max.c</filename> 627 for more information</para> 628 <indexterm zone="ch-system-glibc libBrokenLocale"> 629 <primary sortas="c-libBrokenLocale">libBrokenLocale</primary> 630 </indexterm> 631 </listitem> 632 </varlistentry> 633 634 <varlistentry id="libSegFault"> 635 <term><filename class="libraryfile">libSegFault</filename></term> 636 <listitem> 637 <para>The segmentation fault signal handler, used by 638 <command>catchsegv</command></para> 639 <indexterm zone="ch-system-glibc libSegFault"> 640 <primary sortas="c-libSegFault">libSegFault</primary> 641 </indexterm> 642 </listitem> 643 </varlistentry> 644 645 <varlistentry id="libanl"> 646 <term><filename class="libraryfile">libanl</filename></term> 647 <listitem> 648 <para>An asynchronous name lookup library</para> 649 <indexterm zone="ch-system-glibc libanl"> 650 <primary sortas="c-libanl">libanl</primary> 651 </indexterm> 652 </listitem> 653 </varlistentry> 654 655 <varlistentry id="libbsd-compat"> 656 <term><filename class="libraryfile">libbsd-compat</filename></term> 657 <listitem> 658 <para>Provides the portability needed in order to run certain Berkey 659 Software Distribution (BSD) programs under Linux</para> 660 <indexterm zone="ch-system-glibc libbsd-compat"> 661 <primary sortas="c-libbsd-compat">libbsd-compat</primary> 662 </indexterm> 663 </listitem> 664 </varlistentry> 665 666 <varlistentry id="libc"> 667 <term><filename class="libraryfile">libc</filename></term> 668 <listitem> 669 <para>The main C library</para> 670 <indexterm zone="ch-system-glibc libc"> 671 <primary sortas="c-libc">libc</primary> 672 </indexterm> 673 </listitem> 674 </varlistentry> 675 676 <varlistentry id="libcidn"> 677 <term><filename class="libraryfile">libcidn</filename></term> 678 <listitem> 679 <para>Used internally by Glibc for handling internationalized domain 680 names in the <function>getaddrinfo()</function> function</para> 681 <indexterm zone="ch-system-glibc libcrypt"> 682 <primary sortas="c-libcrypt">libcrypt</primary> 683 </indexterm> 684 </listitem> 685 </varlistentry> 686 687 <varlistentry id="libcrypt"> 688 <term><filename class="libraryfile">libcrypt</filename></term> 689 <listitem> 690 <para>The cryptography library</para> 691 <indexterm zone="ch-system-glibc libcrypt"> 692 <primary sortas="c-libcrypt">libcrypt</primary> 693 </indexterm> 694 </listitem> 695 </varlistentry> 696 697 <varlistentry id="libdl"> 698 <term><filename class="libraryfile">libdl</filename></term> 699 <listitem> 700 <para>The dynamic linking interface library</para> 701 <indexterm zone="ch-system-glibc libdl"> 702 <primary sortas="c-libdl">libdl</primary> 703 </indexterm> 704 </listitem> 705 </varlistentry> 706 707 <varlistentry id="libg"> 708 <term><filename class="libraryfile">libg</filename></term> 709 <listitem> 710 <para>Dummy library containing no functions. Previously was a runtime 711 library for <command>g++</command></para> 712 <indexterm zone="ch-system-glibc libg"> 713 <primary sortas="c-libg">libg</primary> 714 </indexterm> 715 </listitem> 716 </varlistentry> 717 718 <varlistentry id="libieee"> 719 <term><filename class="libraryfile">libieee</filename></term> 720 <listitem> 721 <para>Linking in this module forces error handling rules for math 722 functions as defined by the Institute of Electrical and Electronic 723 Engineers (IEEE). The default is POSIX.1 error handling</para> 724 <indexterm zone="ch-system-glibc libieee"> 725 <primary sortas="c-libieee">libieee</primary> 726 </indexterm> 727 </listitem> 728 </varlistentry> 729 730 <varlistentry id="libm"> 731 <term><filename class="libraryfile">libm</filename></term> 732 <listitem> 733 <para>The mathematical library</para> 734 <indexterm zone="ch-system-glibc libm"> 735 <primary sortas="c-libm">libm</primary> 736 </indexterm> 737 </listitem> 738 </varlistentry> 739 740 <varlistentry id="libmcheck"> 741 <term><filename class="libraryfile">libmcheck</filename></term> 742 <listitem> 743 <para>Turns on memory allocation checking when linked to</para> 744 <indexterm zone="ch-system-glibc libmcheck"> 745 <primary sortas="c-libmcheck">libmcheck</primary> 746 </indexterm> 747 </listitem> 748 </varlistentry> 749 750 <varlistentry id="libmemusage"> 751 <term><filename class="libraryfile">libmemusage</filename></term> 752 <listitem> 753 <para>Used by <command>memusage</command> to help collect 754 information about the memory usage of a program</para> 755 <indexterm zone="ch-system-glibc libmemusage"> 756 <primary sortas="c-libmemusage">libmemusage</primary> 757 </indexterm> 758 </listitem> 759 </varlistentry> 760 761 <varlistentry id="libnsl"> 762 <term><filename class="libraryfile">libnsl</filename></term> 763 <listitem> 764 <para>The network services library</para> 765 <indexterm zone="ch-system-glibc libnsl"> 766 <primary sortas="c-libnsl">libnsl</primary> 767 </indexterm> 768 </listitem> 769 </varlistentry> 770 771 <varlistentry id="libnss"> 772 <term><filename class="libraryfile">libnss</filename></term> 773 <listitem> 774 <para>The Name Service Switch libraries, containing functions for 775 resolving host names, user names, group names, aliases, services, 776 protocols, etc.</para> 777 <indexterm zone="ch-system-glibc libnss"> 778 <primary sortas="c-libnss">libnss</primary> 779 </indexterm> 780 </listitem> 781 </varlistentry> 782 783 <varlistentry id="libpcprofile"> 784 <term><filename class="libraryfile">libpcprofile</filename></term> 785 <listitem> 786 <para>Contains profiling functions used to track the amount of CPU 787 time spent in specific source code lines</para> 788 <indexterm zone="ch-system-glibc libpcprofile"> 789 <primary sortas="c-libpcprofile">libpcprofile</primary> 790 </indexterm> 791 </listitem> 792 </varlistentry> 793 794 <varlistentry id="libpthread"> 795 <term><filename class="libraryfile">libpthread</filename></term> 796 <listitem> 797 <para>The POSIX threads library</para> 798 <indexterm zone="ch-system-glibc libpthread"> 799 <primary sortas="c-libpthread">libpthread</primary> 800 </indexterm> 801 </listitem> 802 </varlistentry> 803 804 <varlistentry id="libresolv"> 805 <term><filename class="libraryfile">libresolv</filename></term> 806 <listitem> 807 <para>Contains functions for creating, sending, and interpreting 808 packets to the Internet domain name servers</para> 809 <indexterm zone="ch-system-glibc libresolv"> 810 <primary sortas="c-libresolv">libresolv</primary> 811 </indexterm> 812 </listitem> 813 </varlistentry> 814 815 <varlistentry id="librpcsvc"> 816 <term><filename class="libraryfile">librpcsvc</filename></term> 817 <listitem> 818 <para>Contains functions providing miscellaneous RPC services</para> 819 <indexterm zone="ch-system-glibc librpcsvc"> 820 <primary sortas="c-librpcsvc">librpcsvc</primary> 821 </indexterm> 822 </listitem> 823 </varlistentry> 824 825 <varlistentry id="librt"> 826 <term><filename class="libraryfile">librt</filename></term> 827 <listitem> 828 <para>Contains functions providing most of the interfaces specified 829 by the POSIX.1b Realtime Extension</para> 830 <indexterm zone="ch-system-glibc librt"> 831 <primary sortas="c-librt">librt</primary> 832 </indexterm> 833 </listitem> 834 </varlistentry> 835 836 <varlistentry id="libthread_db"> 837 <term><filename class="libraryfile">libthread_db</filename></term> 838 <listitem> 839 <para>Contains functions useful for building debuggers for 840 multi-threaded programs</para> 841 <indexterm zone="ch-system-glibc libthread_db"> 842 <primary sortas="c-libthread_db">libthread_db</primary> 843 </indexterm> 844 </listitem> 845 </varlistentry> 846 847 <varlistentry id="libutil"> 848 <term><filename class="libraryfile">libutil</filename></term> 849 <listitem> 850 <para>Contains code for <quote>standard</quote> functions used in 851 many different Unix utilities</para> 852 <indexterm zone="ch-system-glibc libutil"> 853 <primary sortas="c-libutil">libutil</primary> 854 </indexterm> 855 </listitem> 856 </varlistentry> 857 858 </variablelist> 859 860 </sect2> 720 861 721 862 </sect1> 722
Note:
See TracChangeset
for help on using the changeset viewer.