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