[8fcc2c0] | 1 | <sect2><title>Contents of Glibc</title>
|
---|
| 2 |
|
---|
| 3 | <para>Last checked against version &glibc-contversion;.</para>
|
---|
[6370fa6] | 4 |
|
---|
[bdc08c1] | 5 | <sect3><title>Program Files</title>
|
---|
[6370fa6] | 6 |
|
---|
[bdc08c1] | 7 | <para>catchsegv, gencat, getconf, getent, glibcbug, iconv, iconvconfig,
|
---|
| 8 | ldconfig, ldd, lddlibc4, locale, localedef, mtrace, nscd, nscd_nischeck,
|
---|
| 9 | pcprofiledump, pt_chown, rpcgen, rpcinfo, sln, sprof, tzselect, xtrace,
|
---|
| 10 | zdump and zic</para></sect3>
|
---|
| 11 |
|
---|
| 12 | <sect3><title>Descriptions</title>
|
---|
| 13 |
|
---|
| 14 | <sect4><title>catchsegv</title>
|
---|
[227d26b] | 15 | <para>catchsegv can be used to create a stack trace when a program
|
---|
| 16 | terminates with a segmentation fault.</para></sect4>
|
---|
[bdc08c1] | 17 |
|
---|
| 18 | <sect4><title>gencat</title>
|
---|
| 19 | <para>gencat generates message catalogues.</para></sect4>
|
---|
| 20 |
|
---|
| 21 | <sect4><title>getconf</title>
|
---|
[227d26b] | 22 | <para>getconf displays the system configuration values for filesystem
|
---|
| 23 | specific variables.</para></sect4>
|
---|
[bdc08c1] | 24 |
|
---|
| 25 | <sect4><title>getent</title>
|
---|
| 26 | <para>getent gets entries from an administrative database.</para></sect4>
|
---|
| 27 |
|
---|
| 28 | <sect4><title>glibcbug</title>
|
---|
| 29 | <para>glibcbug creates a bug report about glibc and and mails it to the
|
---|
| 30 | bug email address.</para></sect4>
|
---|
| 31 |
|
---|
| 32 | <sect4><title>iconv</title>
|
---|
| 33 | <para>iconv performs character set conversion.</para></sect4>
|
---|
| 34 |
|
---|
| 35 | <sect4><title>iconvconfig</title>
|
---|
| 36 | <para>iconvconfig creates fastloading iconv module
|
---|
| 37 | configuration file.</para></sect4>
|
---|
| 38 |
|
---|
| 39 | <sect4><title>ldconfig</title>
|
---|
| 40 | <para>ldconfig configures the dynamic linker run time bindings.</para></sect4>
|
---|
| 41 |
|
---|
| 42 | <sect4><title>ldd</title>
|
---|
| 43 | <para>ldd prints the shared libraries required by each program or shared
|
---|
| 44 | library specified on the command line.</para></sect4>
|
---|
| 45 |
|
---|
| 46 | <sect4><title>lddlibc4</title>
|
---|
[02ef5b58] | 47 | <para>lddlibc4 assists ldd with object files.</para></sect4>
|
---|
[bdc08c1] | 48 |
|
---|
| 49 | <sect4><title>locale</title>
|
---|
[227d26b] | 50 | <para>locale is a Perl program which tells the compiler to enable
|
---|
| 51 | (or disable) the use of POSIX locales for built-in operations.</para></sect4>
|
---|
[bdc08c1] | 52 |
|
---|
| 53 | <sect4><title>localedef</title>
|
---|
| 54 | <para>localedef compiles locale specifications.</para></sect4>
|
---|
| 55 |
|
---|
| 56 | <sect4><title>mtrace</title>
|
---|
[227d26b] | 57 | <para>mtrace prints the multicast path from a source to a receiver (an IP
|
---|
| 58 | trace query).</para></sect4>
|
---|
[bdc08c1] | 59 |
|
---|
| 60 | <sect4><title>nscd</title>
|
---|
| 61 | <para>nscd is a daemon that provides a cache for the most common name
|
---|
| 62 | service requests.</para></sect4>
|
---|
| 63 |
|
---|
| 64 | <sect4><title>nscd_nischeck</title>
|
---|
[227d26b] | 65 | <para>nscd_nischeck checks whether or not secure mode is necessary for
|
---|
| 66 | NIS+ lookup.</para></sect4>
|
---|
[bdc08c1] | 67 |
|
---|
| 68 | <sect4><title>pcprofiledump</title>
|
---|
| 69 | <para>pcprofiledump dumps information generated by
|
---|
| 70 | PC profiling.</para></sect4>
|
---|
| 71 |
|
---|
| 72 | <sect4><title>pt_chown</title>
|
---|
| 73 | <para>pt_chown sets the owner, group and access permission of the
|
---|
| 74 | slave pseudo terminal corresponding to the master pseudo terminal passed
|
---|
| 75 | on file descriptor `3'. This is the helper program for the `grantpt'
|
---|
[227d26b] | 76 | function. It is not intended to be run directly from the command
|
---|
| 77 | line.</para></sect4>
|
---|
[bdc08c1] | 78 |
|
---|
| 79 | <sect4><title>rpcgen</title>
|
---|
[227d26b] | 80 | <para>rpcgen generates C code to implement the RPC protocol.</para></sect4>
|
---|
[bdc08c1] | 81 |
|
---|
| 82 | <sect4><title>rpcinfo</title>
|
---|
[227d26b] | 83 | <para>rpcinfo makes an RPC call to an RPC server.</para></sect4>
|
---|
[bdc08c1] | 84 |
|
---|
| 85 | <sect4><title>sln</title>
|
---|
| 86 | <para>sln symbolically links dest to source. It is statically linked,
|
---|
| 87 | needing no dynamic linking at all. Thus sln is useful to make symbolic
|
---|
| 88 | links to dynamic libraries if the dynamic linking system for some reason
|
---|
| 89 | is nonfunctional.</para></sect4>
|
---|
| 90 |
|
---|
| 91 | <sect4><title>sprof</title>
|
---|
| 92 | <para>sprof reads and displays shared object profiling data.</para></sect4>
|
---|
| 93 |
|
---|
| 94 | <sect4><title>tzselect</title>
|
---|
| 95 | <para>tzselect asks the user for information about the current location and
|
---|
| 96 | outputs the resulting time zone description to standard output.</para></sect4>
|
---|
| 97 |
|
---|
| 98 | <sect4><title>xtrace</title>
|
---|
| 99 | <para>xtrace traces execution of program by printing the currently executed
|
---|
| 100 | function.</para></sect4>
|
---|
| 101 |
|
---|
| 102 | <sect4><title>zdump</title>
|
---|
| 103 | <para>zdump is the time zone dumper.</para></sect4>
|
---|
[6370fa6] | 104 |
|
---|
[bdc08c1] | 105 | <sect4><title>zic</title>
|
---|
| 106 | <para>zic is the time zone compiler.</para></sect4>
|
---|
[6370fa6] | 107 |
|
---|
[bdc08c1] | 108 | </sect3>
|
---|
| 109 |
|
---|
| 110 | <sect3><title>Library Files</title>
|
---|
| 111 | <para>ld.so, libBrokenLocale.[a,so], libBrokenLocale_p.a,
|
---|
| 112 | libSegFault.so, libanl.[a,so], libanl_p.a, libbsd-compat.a, libc.[a,so],
|
---|
| 113 | libc_nonshared.a, libc_p.a, libcrypt.[a,so], libcrypt_p.a, libdl.[a,so],
|
---|
| 114 | libdl_p.a, libg.a, libieee.a, libm.[a,so], libm_p.a, libmcheck.a,
|
---|
| 115 | libmemusage.so, libnsl.a, libnsl_p.a, libnss_compat.so, libnss_dns.so,
|
---|
| 116 | libnss_files.so, libnss_hesiod.so, libnss_nis.so, libnss_nisplus.so,
|
---|
| 117 | libpcprofile.so, libpthread.[a,so], libpthread_p.a, libresolv.[a,so],
|
---|
| 118 | libresolv_p.a, librpcsvc.a, librpcsvc_p.a, librt.[a,so], librt_p.a,
|
---|
| 119 | libthread_db.so, libutil.[a,so] and libutil_p.a</para></sect3>
|
---|
| 120 |
|
---|
| 121 | <sect3><title>Descriptions</title>
|
---|
| 122 |
|
---|
| 123 | <sect4><title>ld.so</title>
|
---|
| 124 | <para>ld.so is the helper program for shared library
|
---|
| 125 | executables.</para></sect4>
|
---|
| 126 |
|
---|
[c5ba0d6] | 127 | <sect4><title>libBrokenLocale, libBrokenLocale_p</title>
|
---|
[227d26b] | 128 | <para>Used by software, such as Mozilla, to solve broken locales.</para></sect4>
|
---|
[bdc08c1] | 129 |
|
---|
[c5ba0d6] | 130 | <sect4><title>libSegFault</title>
|
---|
[227d26b] | 131 | <para>libSegFault is a segmentation fault signal handler. It tries to catch
|
---|
| 132 | segfaults.</para></sect4>
|
---|
[bdc08c1] | 133 |
|
---|
[c5ba0d6] | 134 | <sect4><title>libanl, libanl_p</title>
|
---|
[227d26b] | 135 | <para>libanl is an asynchronous name lookup library.</para></sect4>
|
---|
[bdc08c1] | 136 |
|
---|
[c5ba0d6] | 137 | <sect4><title>libbsd-compat</title>
|
---|
[02ef5b58] | 138 | <para>libbsd-compat provides the portability needed in order to run certain
|
---|
| 139 | programs in Linux.</para></sect4>
|
---|
[bdc08c1] | 140 |
|
---|
[c5ba0d6] | 141 | <sect4><title>libc, libc_nonshared, libc_p</title>
|
---|
[cf24ff1] | 142 | <para>These files constitute the main C library. The C library is a
|
---|
[bdc08c1] | 143 | collection of commonly used functions in programs.
|
---|
[58484755] | 144 | This way a programmer doesn't need to create his own functions for every
|
---|
[7d90bd3] | 145 | single task. The most common things like writing a string to the screen
|
---|
[b822811] | 146 | are already present and at the disposal of the programmer.</para>
|
---|
[6370fa6] | 147 |
|
---|
[cf24ff1] | 148 | <para>The C library (actually almost every library) comes in two flavors:
|
---|
| 149 | a dynamic and a static one. In short, when a program uses a static C
|
---|
| 150 | library, the code from the C library is copied into the executable file.
|
---|
| 151 | When a program uses a dynamic library, the executable will not
|
---|
[6370fa6] | 152 | contain the code from the C library, but instead a routine that loads
|
---|
| 153 | the functions from the library at the time the program is run. This
|
---|
[bdc08c1] | 154 | means a significant decrease in the file size of a program. The
|
---|
[cf24ff1] | 155 | documentation that comes with the C library describes this in more
|
---|
[bdc08c1] | 156 | detail, as it is too complicated to explain here in one or two
|
---|
| 157 | lines.</para></sect4>
|
---|
| 158 |
|
---|
[c5ba0d6] | 159 | <sect4><title>libcrypt, libcrypt_p</title>
|
---|
[bdc08c1] | 160 | <para>libcrypt is the cryptography library.</para></sect4>
|
---|
| 161 |
|
---|
[c5ba0d6] | 162 | <sect4><title>libdl, libdl_p</title>
|
---|
[02ef5b58] | 163 | <para>libdl is the dynamic linking interface library.</para></sect4>
|
---|
[bdc08c1] | 164 |
|
---|
[c5ba0d6] | 165 | <sect4><title>libg</title>
|
---|
[02ef5b58] | 166 | <para>libg is a runtime library for g++.</para></sect4>
|
---|
[bdc08c1] | 167 |
|
---|
[c5ba0d6] | 168 | <sect4><title>libieee</title>
|
---|
[02ef5b58] | 169 | <para>libieee is the IEEE floating point library.</para></sect4>
|
---|
[bdc08c1] | 170 |
|
---|
[c5ba0d6] | 171 | <sect4><title>libm, libm_p</title>
|
---|
[bdc08c1] | 172 | <para>libm is the mathematical library.</para></sect4>
|
---|
| 173 |
|
---|
[c5ba0d6] | 174 | <sect4><title>libmcheck</title>
|
---|
[65396f5] | 175 | <para>libmcheck contains code run at boot.</para></sect4>
|
---|
[bdc08c1] | 176 |
|
---|
[c5ba0d6] | 177 | <sect4><title>libmemusage</title>
|
---|
[65396f5] | 178 | <para>libmemusage is used by memusage to help collect information about the
|
---|
| 179 | memory usage of a program.</para></sect4>
|
---|
[bdc08c1] | 180 |
|
---|
[c5ba0d6] | 181 | <sect4><title>libnsl, libnsl_p</title>
|
---|
[f49cf1a] | 182 | <para>libnsl is the network services library.</para></sect4>
|
---|
[bdc08c1] | 183 |
|
---|
[c5ba0d6] | 184 | <sect4><title>libnss_compat, libnss_dns, libnss_files,
|
---|
| 185 | libnss_hesiod, libnss_nis, libnss_nisplus</title>
|
---|
[f49cf1a] | 186 | <para>The basic idea is to put the implementation of the different services
|
---|
| 187 | offered to access the databases in separate modules. This has some
|
---|
| 188 | advantages:</para>
|
---|
| 189 | <itemizedlist>
|
---|
[4ceb3a1] | 190 | <listitem><para>contributors can add new services without adding them to
|
---|
| 191 | GNU C library,</para></listitem>
|
---|
| 192 | <listitem><para>the modules can be updated separately,</para></listitem>
|
---|
| 193 | <listitem><para>the C library image is smaller.</para></listitem>
|
---|
[f49cf1a] | 194 | </itemizedlist></sect4>
|
---|
[bdc08c1] | 195 |
|
---|
[c5ba0d6] | 196 | <sect4><title>libpcprofile</title>
|
---|
[46105cf] | 197 | <para>Code used by the kernel to track CPU time spent in functions, source
|
---|
| 198 | code lines, and instructions.</para></sect4>
|
---|
[bdc08c1] | 199 |
|
---|
[c5ba0d6] | 200 | <sect4><title>libpthread, libpthread_p</title>
|
---|
[f49cf1a] | 201 | <para>The POSIX threads library.</para></sect4>
|
---|
[bdc08c1] | 202 |
|
---|
[c5ba0d6] | 203 | <sect4><title>libresolv, libresolv_p</title>
|
---|
[f49cf1a] | 204 | <para>Functions in this library provide for creating, sending, and
|
---|
| 205 | interpreting packets to the Internet domain name servers.</para></sect4>
|
---|
[bdc08c1] | 206 |
|
---|
[c5ba0d6] | 207 | <sect4><title>librpcsvc, librpcsvc_p</title>
|
---|
[f49cf1a] | 208 | <para>Functions in this library provide miscellaneous RPC services.</para></sect4>
|
---|
[bdc08c1] | 209 |
|
---|
[c5ba0d6] | 210 | <sect4><title>librt, librt_p</title>
|
---|
[f49cf1a] | 211 | <para>Functions in this library provide most of the interfaces specified by
|
---|
| 212 | the POSIX.1b Realtime Extension.</para></sect4>
|
---|
[bdc08c1] | 213 |
|
---|
[c5ba0d6] | 214 | <sect4><title>libthread_db</title>
|
---|
[f49cf1a] | 215 | <para>Functions is this library are useful for building debuggers for
|
---|
| 216 | multi-threaded programs.</para></sect4>
|
---|
[bdc08c1] | 217 |
|
---|
[f49cf1a] | 218 | <sect4><title>libutil, libutil_p</title>
|
---|
[32cee45c] | 219 | <para>Contains code for "standard" functions used in many different Unix
|
---|
[f49cf1a] | 220 | utilities.</para></sect4>
|
---|
[bdc08c1] | 221 |
|
---|
| 222 | </sect3>
|
---|
[6370fa6] | 223 |
|
---|
| 224 | </sect2>
|
---|
| 225 |
|
---|