Change bug-glibc@prep.ai.mit.edu to bug-glibc@gnu.org.
[kopensolaris-gnu/glibc.git] / manual / maint.texi
1 @c \input /gd/gnu/doc/texinfo
2 @c This is for making the `INSTALL' file for the distribution.
3 @c Makeinfo ignores it when processing the file from the include.
4 @setfilename INSTALL
5
6 @node Maintenance, Copying, Library Summary, Top
7 @appendix Library Maintenance
8
9 @menu
10 * Installation::          How to configure, compile and
11                              install the GNU C library.
12 * Reporting Bugs::        How to report bugs (if you want to
13                              get them fixed) and other troubles
14                              you may have with the GNU C library.
15 * Source Layout::         How to add new functions or header files
16                              to the GNU C library.
17 * Porting::               How to port the GNU C library to
18                              a new machine or operating system.
19 * Contributors::          Contributors to the GNU C Library.
20 @end menu
21
22 @node Installation
23 @appendixsec How to Install the GNU C Library
24 @cindex installing the library
25
26 Installation of the GNU C library is relatively simple, but usually
27 requires several GNU tools to be installed already.
28 @iftex
29 (@pxref{Tools for Installation}, below.)
30 @end iftex
31
32 @menu
33 * Tools for Installation::      We recommend using these tools to build.
34 * Supported Configurations::    What systems the GNU C library runs on.
35 @end menu
36
37 To configure the GNU C library for your system, run the shell script
38 @file{configure} with @code{sh}.  Use an argument which is the
39 conventional GNU name for your system configuration---for example,
40 @samp{sparc-sun-sunos4.1}, for a Sun 4 running SunOS 4.1.
41 @xref{Installation, Installation, Installing GNU CC, gcc.info, Using and
42 Porting GNU CC}, for a full description of standard GNU configuration
43 names.  If you omit the configuration name, @file{configure} will try to
44 guess one for you by inspecting the system it is running on.  It may or
45 may not be able to come up with a guess, and the its guess might be
46 wrong.  @file{configure} will tell you the canonical name of the chosen
47 configuration before proceeding.
48
49 Here are some options that you should specify (if appropriate) when
50 you run @code{configure}:
51
52 @table @samp
53 @item --with-binutils=@var{directory}
54 Use the binutils (assembler and linker) in @file{@var{directory}}, not
55 the ones the C compiler would default to.  You could use this option if
56 the default binutils on your system cannot deal with all the constructs
57 in the GNU C library.  (@code{configure} will detect the problem and
58 suppress these constructs, so the library will still be usable, but
59 functionality may be lost---for example, you can not build a shared libc
60 with old binutils.)
61
62 @c extra blank line makes it look better
63 @item --without-fp
64 @itemx --nfp
65
66 Use this option if your computer lacks hardware floating-point support
67 and your operating system does not emulate an FPU.
68
69 @item --prefix=@var{directory}
70 Install machine-independent data files in subdirectories of
71 @file{@var{directory}}.  (You can also set this in @file{configparms};
72 see below.)  The default is to install in `/usr/local'.
73
74 @item --exec-prefix=@var{directory}
75 Install the library and other machine-dependent files in subdirectories
76 of @file{@var{directory}}.  (You can also set this in
77 @file{configparms}; see below.)  The default is to use <prefix>/bin
78 and <prefix>/sbin.
79
80 @item --enable-shared
81 @itemx --disable-shared
82 Enable or disable building of an ELF shared library on systems that
83 support it.  The default is to build the shared library on systems using
84 ELF when the GNU @code{binutils} are available.
85
86 @item --enable-profile
87 @itemx --disable-profile
88 Enable or disable building of the profiled C library, @samp{-lc_p}.  The
89 default is to build the profiled library.  You may wish to disable it if
90 you don't plan to do profiling, because it doubles the build time of
91 compiling just the unprofiled static library.
92
93 @item --enable-omitfp
94 Enable building a highly-optimized but possibly undebuggable static C
95 library.  This causes the normal static and shared (if enabled) C
96 libraries to be compiled with maximal optimization, including the
97 @samp{-fomit-frame-pointer} switch that makes debugging impossible on
98 many machines, and without debugging information (which makes the
99 binaries substantially smaller).  An additional static library is
100 compiled with no optimization and full debugging information, and
101 installed as @samp{-lc_g}.
102 @end table
103
104 The simplest way to run @code{configure} is to do it in the directory
105 that contains the library sources.  This prepares to build the library
106 in that very directory.
107
108 You can prepare to build the library in some other directory by going
109 to that other directory to run @code{configure}.  In order to run
110 configure, you will have to specify a directory for it, like this:
111
112 @smallexample
113 mkdir sun4
114 cd sun4
115 ../configure sparc-sun-sunos4.1
116 @end smallexample
117
118 @noindent
119 @code{configure} looks for the sources in whatever directory you
120 specified for finding @code{configure} itself.  It does not matter where
121 in the file system the source and build directories are---as long as you
122 specify the source directory when you run @code{configure}, you will get
123 the proper results.
124
125 This feature lets you keep sources and binaries in different
126 directories, and that makes it easy to build the library for several
127 different machines from the same set of sources.  Simply create a
128 build directory for each target machine, and run @code{configure} in
129 that directory specifying the target machine's configuration name.
130
131 The library has a number of special-purpose configuration parameters.
132 These are defined in the file @file{Makeconfig}; see the comments in
133 that file for the details.
134
135 But don't edit the file @file{Makeconfig} yourself---instead, create a
136 file @file{configparms} in the directory where you are building the
137 library, and define in that file the parameters you want to specify.
138 @file{configparms} should @strong{not} be an edited copy of
139 @file{Makeconfig}; specify only the parameters that you want to
140 override.  To see how to set these parameters, find the section of
141 @file{Makeconfig} that says ``These are the configuration variables.''
142 Then for each parameter that you want to change, copy the definition
143 from @file{Makeconfig} to your new @file{configparms} file, and change
144 the value as appropriate for your system.
145
146 It is easy to configure the GNU C library for cross-compilation by
147 setting a few variables in @file{configparms}.  Set @code{CC} to the
148 cross-compiler for the target you configured the library for; it is
149 important to use this same @code{CC} value when running
150 @code{configure}, like this: @samp{CC=@var{target}-gcc configure
151 @var{target}}.  Set @code{BUILD_CC} to the compiler to use for for
152 programs run on the build system as part of compiling the library.  You
153 may need to set @code{AR} and @code{RANLIB} to cross-compiling versions
154 of @code{ar} and @code{ranlib} if the native tools are not configured to
155 work with object files for the target you configured for.
156
157 Some of the machine-dependent code for some machines uses extensions in
158 the GNU C compiler, so you may need to compile the library with GCC.
159 (In fact, all of the existing complete ports require GCC.)
160
161
162 To build the library and related programs, type @code{make}.  This will
163 produce a lot of output, some of which may look like errors from
164 @code{make} (but isn't).  Look for error messages from @code{make}
165 containing @samp{***}.  Those indicate that something is really wrong.
166
167 To build and run some test programs which exercise some of the library
168 facilities, type @code{make check}.  This will produce several files
169 with names like @file{@var{program}.out}.
170
171 To format the @cite{GNU C Library Reference Manual} for printing, type
172 @w{@code{make dvi}}.  You need a working @TeX{} installation to do this.
173
174 To install the library and its header files, and the Info files of the
175 manual, type @code{make install}.  This will build things if necessary,
176 before installing them.  If you want to install the files in a different
177 place than the one specified at configuration time you can specify a
178 value for the Makefile variable @code{install_root} on the command line.
179 This is useful to create chroot'ed environment or to prepare binary
180 releases.@refill
181
182 @node Tools for Installation
183 @appendixsubsec Recommended Tools to Install the GNU C Library
184 @cindex installation tools
185 @cindex tools, for installing library
186
187 We recommend installing the following GNU tools before attempting to
188 build the GNU C library:
189
190 @itemize @bullet
191 @item
192 GNU @code{make} 3.75
193
194 You need the latest version of GNU @code{make}.  Modifying the GNU C
195 Library to work with other @code{make} programs would be so hard that we
196 recommend you port GNU @code{make} instead.  @strong{Really.}  We
197 recommend version GNU @code{make} version 3.75.  Versions 3.76 and
198 3.76.1 are known to have bugs which only show up in big projects like
199 GNU @code{libc}.
200
201 @item
202 GCC 2.7.2.3
203
204 On most platforms, the GNU C library can only be compiled with the GNU C
205 compiler.  We recommend GCC version 2.7.2 or later; earlier versions may
206 have problems.
207
208 On PowerPC, GCC versions dated earlier than 970904 are known not to work
209 (they crash), including 2.7.2.
210
211 @item
212 GNU @code{binutils} 2.8.1.0.17
213
214 Using the GNU @code{binutils} (assembler, linker, and related tools) is
215 preferable when possible, and they are required to build an ELF shared C
216 library.  We recommend @code{binutils} version 2.8.1 or later; earlier
217 versions are known to have problems or to not support all architectures.
218
219 @item
220 GNU @code{texinfo} 3.11
221
222 To correctly translate and install the Texinfo documentation you need
223 this version of the @code{texinfo} package.  Former versions did not
224 understand all the tags used in the document and also the installation
225 mechanisms for the info files was not present or worked differently.
226
227 On some Debian Linux based systems the used @code{install-info} program
228 works differently.  Here you have to run make like this:
229
230 @smallexample
231 make INSTALL_INFO=/path/to/GNU/install-info install
232 @end smallexample
233 @end itemize
234
235 If you change any configuration file you will need also
236
237 @itemize @bullet
238 @item
239 GNU @code{autoconf} 2.12
240 @end itemize
241
242 @noindent
243 and if you change any of the message translation files you will also need
244
245 @itemize @bullet
246 @item
247 @code{GNU gettext} 0.10 or later
248 @end itemize
249
250 If any of the manual files changed you will need this
251
252 @itemize @bullet
253 @item
254 GNU @code{awk} 3.0
255 @end itemize
256
257 @noindent
258 If you upgrade your source tree using the patches made available you probably
259 will need those package above in any case.
260
261
262 @node Supported Configurations
263 @appendixsubsec Supported Configurations
264 @cindex configurations, all supported
265
266 The GNU C Library currently supports configurations that match the
267 following patterns:
268
269 @smallexample
270 alpha-@var{anything}-linux
271 i@var{x}86-@var{anything}-gnu
272 i@var{x}86-@var{anything}-linux
273 m68k-@var{anything}-linux
274 powerpc-@var{anything}-linux
275 sparc64-@var{anything}-linux
276 @end smallexample
277
278 Former releases of this library (version 1.09.1 and perhaps earlier
279 versions) used to run on the following configurations:
280
281 @smallexample
282 alpha-dec-osf1
283 alpha-@var{anything}-linuxecoff
284 i@var{x}86-@var{anything}-bsd4.3
285 i@var{x}86-@var{anything}-isc2.2
286 i@var{x}86-@var{anything}-isc3.@var{n}
287 i@var{x}86-@var{anything}-sco3.2
288 i@var{x}86-@var{anything}-sco3.2v4
289 i@var{x}86-@var{anything}-sysv
290 i@var{x}86-@var{anything}-sysv4
291 i@var{x}86-force_cpu386-none
292 i@var{x}86-sequent-bsd
293 i960-nindy960-none
294 m68k-hp-bsd4.3
295 m68k-mvme135-none
296 m68k-mvme136-none
297 m68k-sony-newsos3
298 m68k-sony-newsos4
299 m68k-sun-sunos4.@var{n}
300 mips-dec-ultrix4.@var{n}
301 mips-sgi-irix4.@var{n}
302 sparc-sun-solaris2.@var{n}
303 sparc-sun-sunos4.@var{n}
304 @end smallexample
305
306 Since no one has volunteered to test and fix the above configurations,
307 these are not supported at the moment.  It's expected that these don't
308 work anymore.  Porting the library is not hard.  If you are interested
309 in doing a port, please contact the glibc maintainers by sending
310 electronic mail to @email{bug-glibc@@gnu.org}.
311
312 Each case of @samp{i@var{x}86} can be @samp{i386}, @samp{i486},
313 @samp{i586}, or @samp{i686}.  All of those configurations produce a
314 library that can run on any of these processors.  The library will be
315 optimized for the specified processor, but will not use instructions not
316 available on all of them.
317
318 While no other configurations are supported, there are handy aliases for
319 these few.  (These aliases work in other GNU software as well.)
320
321 @smallexample
322 decstation
323 hp320-bsd4.3 hp300bsd
324 i486-gnu
325 i586-linux
326 i386-sco
327 i386-sco3.2v4
328 i386-sequent-dynix
329 i386-svr4
330 news
331 sun3-sunos4.@var{n} sun3
332 sun4-solaris2.@var{n} sun4-sunos5.@var{n}
333 sun4-sunos4.@var{n} sun4
334 @end smallexample
335
336 @node Reporting Bugs
337 @appendixsec Reporting Bugs
338 @cindex reporting bugs
339 @cindex bugs, reporting
340
341 There are probably bugs in the GNU C library.  There are certainly
342 errors and omissions in this manual.  If you report them, they will get
343 fixed.  If you don't, no one will ever know about them and they will
344 remain unfixed for all eternity, if not longer.
345
346 To report a bug, first you must find it.  Hopefully, this will be the
347 hard part.  Once you've found a bug, make sure it's really a bug.  A
348 good way to do this is to see if the GNU C library behaves the same way
349 some other C library does.  If so, probably you are wrong and the
350 libraries are right (but not necessarily).  If not, one of the libraries
351 is probably wrong.
352
353 Once you're sure you've found a bug, try to narrow it down to the
354 smallest test case that reproduces the problem.  In the case of a C
355 library, you really only need to narrow it down to one library
356 function call, if possible.  This should not be too difficult.
357
358 The final step when you have a simple test case is to report the bug.
359 When reporting a bug, send your test case, the results you got, the
360 results you expected, what you think the problem might be (if you've
361 thought of anything), your system type, and the version of the GNU C
362 library which you are using.  Also include the files
363 @file{config.status} and @file{config.make} which are created by running
364 @file{configure}; they will be in whatever directory was current when
365 you ran @file{configure}.
366
367 If you think you have found some way in which the GNU C library does not
368 conform to the ISO and POSIX standards (@pxref{Standards and
369 Portability}), that is definitely a bug.  Report it!@refill
370
371 Send bug reports to the Internet address
372 @email{bug-glibc@@gnu.org}.  If you have other problems
373 with installation or use, please report those as well.@refill
374
375 If you are not sure how a function should behave, and this manual
376 doesn't tell you, that's a bug in the manual.  Report that too!  If the
377 function's behavior disagrees with the manual, then either the library
378 or the manual has a bug, so report the disagreement.  If you find any
379 errors or omissions in this manual, please report them to the Internet
380 address @email{bug-glibc-manual@@prep.ai.mit.edu}.
381
382 @node Source Layout
383 @appendixsec Adding New Functions
384
385 The process of building the library is driven by the makefiles, which
386 make heavy use of special features of GNU @code{make}.  The makefiles
387 are very complex, and you probably don't want to try to understand them.
388 But what they do is fairly straightforward, and only requires that you
389 define a few variables in the right places.
390
391 The library sources are divided into subdirectories, grouped by topic.
392
393 The @file{string} subdirectory has all the string-manipulation
394 functions, @file{math} has all the mathematical functions, etc.
395
396 Each subdirectory contains a simple makefile, called @file{Makefile},
397 which defines a few @code{make} variables and then includes the global
398 makefile @file{Rules} with a line like:
399
400 @smallexample
401 include ../Rules
402 @end smallexample
403
404 @noindent
405 The basic variables that a subdirectory makefile defines are:
406
407 @table @code
408 @item subdir
409 The name of the subdirectory, for example @file{stdio}.
410 This variable @strong{must} be defined.
411
412 @item headers
413 The names of the header files in this section of the library,
414 such as @file{stdio.h}.
415
416 @item routines
417 @itemx aux
418 The names of the modules (source files) in this section of the library.
419 These should be simple names, such as @samp{strlen} (rather than
420 complete file names, such as @file{strlen.c}).  Use @code{routines} for
421 modules that define functions in the library, and @code{aux} for
422 auxiliary modules containing things like data definitions.  But the
423 values of @code{routines} and @code{aux} are just concatenated, so there
424 really is no practical difference.@refill
425
426 @item tests
427 The names of test programs for this section of the library.  These
428 should be simple names, such as @samp{tester} (rather than complete file
429 names, such as @file{tester.c}).  @w{@samp{make tests}} will build and
430 run all the test programs.  If a test program needs input, put the test
431 data in a file called @file{@var{test-program}.input}; it will be given to
432 the test program on its standard input.  If a test program wants to be
433 run with arguments, put the arguments (all on a single line) in a file
434 called @file{@var{test-program}.args}.  Test programs should exit with
435 zero status when the test passes, and nonzero status when the test
436 indicates a bug in the library or error in building.
437
438 @item others
439 The names of ``other'' programs associated with this section of the
440 library.  These are programs which are not tests per se, but are other
441 small programs included with the library.  They are built by
442 @w{@samp{make others}}.@refill
443
444 @item install-lib
445 @itemx install-data
446 @itemx install
447 Files to be installed by @w{@samp{make install}}.  Files listed in
448 @samp{install-lib} are installed in the directory specified by
449 @samp{libdir} in @file{configparms} or @file{Makeconfig}
450 (@pxref{Installation}).  Files listed in @code{install-data} are
451 installed in the directory specified by @samp{datadir} in
452 @file{configparms} or @file{Makeconfig}.  Files listed in @code{install}
453 are installed in the directory specified by @samp{bindir} in
454 @file{configparms} or @file{Makeconfig}.@refill
455
456 @item distribute
457 Other files from this subdirectory which should be put into a
458 distribution tar file.  You need not list here the makefile itself or
459 the source and header files listed in the other standard variables.
460 Only define @code{distribute} if there are files used in an unusual way
461 that should go into the distribution.
462
463 @item generated
464 Files which are generated by @file{Makefile} in this subdirectory.
465 These files will be removed by @w{@samp{make clean}}, and they will
466 never go into a distribution.
467
468 @item extra-objs
469 Extra object files which are built by @file{Makefile} in this
470 subdirectory.  This should be a list of file names like @file{foo.o};
471 the files will actually be found in whatever directory object files are
472 being built in.  These files will be removed by @w{@samp{make clean}}.
473 This variable is used for secondary object files needed to build
474 @code{others} or @code{tests}.
475 @end table
476
477 @node Porting
478 @appendixsec Porting the GNU C Library
479
480 The GNU C library is written to be easily portable to a variety of
481 machines and operating systems.  Machine- and operating system-dependent
482 functions are well separated to make it easy to add implementations for
483 new machines or operating systems.  This section describes the layout of
484 the library source tree and explains the mechanisms used to select
485 machine-dependent code to use.
486
487 All the machine-dependent and operating system-dependent files in the
488 library are in the subdirectory @file{sysdeps} under the top-level
489 library source directory.  This directory contains a hierarchy of
490 subdirectories (@pxref{Hierarchy Conventions}).
491
492 Each subdirectory of @file{sysdeps} contains source files for a
493 particular machine or operating system, or for a class of machine or
494 operating system (for example, systems by a particular vendor, or all
495 machines that use IEEE 754 floating-point format).  A configuration
496 specifies an ordered list of these subdirectories.  Each subdirectory
497 implicitly appends its parent directory to the list.  For example,
498 specifying the list @file{unix/bsd/vax} is equivalent to specifying the
499 list @file{unix/bsd/vax unix/bsd unix}.  A subdirectory can also specify
500 that it implies other subdirectories which are not directly above it in
501 the directory hierarchy.  If the file @file{Implies} exists in a
502 subdirectory, it lists other subdirectories of @file{sysdeps} which are
503 appended to the list, appearing after the subdirectory containing the
504 @file{Implies} file.  Lines in an @file{Implies} file that begin with a
505 @samp{#} character are ignored as comments.  For example,
506 @file{unix/bsd/Implies} contains:@refill
507 @smallexample
508 # BSD has Internet-related things.
509 unix/inet
510 @end smallexample
511 @noindent
512 and @file{unix/Implies} contains:
513 @need 300
514 @smallexample
515 posix
516 @end smallexample
517
518 @noindent
519 So the final list is @file{unix/bsd/vax unix/bsd unix/inet unix posix}.
520
521 @file{sysdeps} has a ``special'' subdirectory called @file{generic}.  It
522 is always implicitly appended to the list of subdirectories, so you
523 needn't put it in an @file{Implies} file, and you should not create any
524 subdirectories under it intended to be new specific categories.
525 @file{generic} serves two purposes.  First, the makefiles do not bother
526 to look for a system-dependent version of a file that's not in
527 @file{generic}.  This means that any system-dependent source file must
528 have an analogue in @file{generic}, even if the routines defined by that
529 file are not implemented on other platforms.  Second. the @file{generic}
530 version of a system-dependent file is used if the makefiles do not find
531 a version specific to the system you're compiling for.
532
533 If it is possible to implement the routines in a @file{generic} file in
534 machine-independent C, using only other machine-independent functions in
535 the C library, then you should do so.  Otherwise, make them stubs.  A
536 @dfn{stub} function is a function which cannot be implemented on a
537 particular machine or operating system.  Stub functions always return an
538 error, and set @code{errno} to @code{ENOSYS} (Function not implemented).
539 @xref{Error Reporting}.  If you define a stub function, you must place
540 the statement @code{stub_warning(@var{function})}, where @var{function}
541 is the name of your function, after its definition; also, you must
542 include the file @code{<stub-tag.h>} into your file.  This causes the
543 function to be listed in the installed @code{<gnu/stubs.h>}, and
544 makes GNU ld warn when the function is used.
545
546 Some rare functions are only useful on specific systems and aren't
547 defined at all on others; these do not appear anywhere in the
548 system-independent source code or makefiles (including the
549 @file{generic} directory), only in the system-dependent @file{Makefile}
550 in the specific system's subdirectory.
551
552 If you come across a file that is in one of the main source directories
553 (@file{string}, @file{stdio}, etc.), and you want to write a machine- or
554 operating system-dependent version of it, move the file into
555 @file{sysdeps/generic} and write your new implementation in the
556 appropriate system-specific subdirectory.  Note that if a file is to be
557 system-dependent, it @strong{must not} appear in one of the main source
558 directories.@refill
559
560 There are a few special files that may exist in each subdirectory of
561 @file{sysdeps}:
562
563 @comment Blank lines after items make the table look better.
564 @table @file
565 @item Makefile
566
567 A makefile for this machine or operating system, or class of machine or
568 operating system.  This file is included by the library makefile
569 @file{Makerules}, which is used by the top-level makefile and the
570 subdirectory makefiles.  It can change the variables set in the
571 including makefile or add new rules.  It can use GNU @code{make}
572 conditional directives based on the variable @samp{subdir} (see above) to
573 select different sets of variables and rules for different sections of
574 the library.  It can also set the @code{make} variable
575 @samp{sysdep-routines}, to specify extra modules to be included in the
576 library.  You should use @samp{sysdep-routines} rather than adding
577 modules to @samp{routines} because the latter is used in determining
578 what to distribute for each subdirectory of the main source tree.@refill
579
580 Each makefile in a subdirectory in the ordered list of subdirectories to
581 be searched is included in order.  Since several system-dependent
582 makefiles may be included, each should append to @samp{sysdep-routines}
583 rather than simply setting it:
584
585 @smallexample
586 sysdep-routines := $(sysdep-routines) foo bar
587 @end smallexample
588
589 @need 1000
590 @item Subdirs
591
592 This file contains the names of new whole subdirectories under the
593 top-level library source tree that should be included for this system.
594 These subdirectories are treated just like the system-independent
595 subdirectories in the library source tree, such as @file{stdio} and
596 @file{math}.
597
598 Use this when there are completely new sets of functions and header
599 files that should go into the library for the system this subdirectory
600 of @file{sysdeps} implements.  For example,
601 @file{sysdeps/unix/inet/Subdirs} contains @file{inet}; the @file{inet}
602 directory contains various network-oriented operations which only make
603 sense to put in the library on systems that support the Internet.@refill
604
605 @item Dist
606
607 This file contains the names of files (relative to the subdirectory of
608 @file{sysdeps} in which it appears) which should be included in the
609 distribution.  List any new files used by rules in the @file{Makefile}
610 in the same directory, or header files used by the source files in that
611 directory.  You don't need to list files that are implementations
612 (either C or assembly source) of routines whose names are given in the
613 machine-independent makefiles in the main source tree.
614
615 @item configure
616
617 This file is a shell script fragment to be run at configuration time.
618 The top-level @file{configure} script uses the shell @code{.} command to
619 read the @file{configure} file in each system-dependent directory
620 chosen, in order.  The @file{configure} files are often generated from
621 @file{configure.in} files using Autoconf.
622
623 A system-dependent @file{configure} script will usually add things to
624 the shell variables @samp{DEFS} and @samp{config_vars}; see the
625 top-level @file{configure} script for details.  The script can check for
626 @w{@samp{--with-@var{package}}} options that were passed to the
627 top-level @file{configure}.  For an option
628 @w{@samp{--with-@var{package}=@var{value}}} @file{configure} sets the
629 shell variable @w{@samp{with_@var{package}}} (with any dashes in
630 @var{package} converted to underscores) to @var{value}; if the option is
631 just @w{@samp{--with-@var{package}}} (no argument), then it sets
632 @w{@samp{with_@var{package}}} to @samp{yes}.
633
634 @item configure.in
635
636 This file is an Autoconf input fragment to be processed into the file
637 @file{configure} in this subdirectory.  @xref{Introduction,,,
638 autoconf.info, Autoconf: Generating Automatic Configuration Scripts},
639 for a description of Autoconf.  You should write either @file{configure}
640 or @file{configure.in}, but not both.  The first line of
641 @file{configure.in} should invoke the @code{m4} macro
642 @samp{GLIBC_PROVIDES}.  This macro does several @code{AC_PROVIDE} calls
643 for Autoconf macros which are used by the top-level @file{configure}
644 script; without this, those macros might be invoked again unnecessarily
645 by Autoconf.
646 @end table
647
648 That is the general system for how system-dependencies are isolated.
649 @iftex
650 The next section explains how to decide what directories in
651 @file{sysdeps} to use.  @ref{Porting to Unix}, has some tips on porting
652 the library to Unix variants.
653 @end iftex
654
655 @menu
656 * Hierarchy Conventions::       The layout of the @file{sysdeps} hierarchy.
657 * Porting to Unix::             Porting the library to an average
658                                    Unix-like system.
659 @end menu
660
661 @node Hierarchy Conventions
662 @appendixsubsec Layout of the @file{sysdeps} Directory Hierarchy
663
664 A GNU configuration name has three parts: the CPU type, the
665 manufacturer's name, and the operating system.  @file{configure} uses
666 these to pick the list of system-dependent directories to look for.  If
667 the @samp{--nfp} option is @emph{not} passed to @file{configure}, the
668 directory @file{@var{machine}/fpu} is also used.  The operating system
669 often has a @dfn{base operating system}; for example, if the operating
670 system is @samp{sunos4.1}, the base operating system is @samp{unix/bsd}.
671 The algorithm used to pick the list of directories is simple:
672 @file{configure} makes a list of the base operating system,
673 manufacturer, CPU type, and operating system, in that order.  It then
674 concatenates all these together with slashes in between, to produce a
675 directory name; for example, the configuration @w{@samp{sparc-sun-sunos4.1}}
676 results in @file{unix/bsd/sun/sparc/sunos4.1}.  @file{configure} then
677 tries removing each element of the list in turn, so
678 @file{unix/bsd/sparc} and @file{sun/sparc} are also tried, among others.
679 Since the precise version number of the operating system is often not
680 important, and it would be very inconvenient, for example, to have
681 identical @file{sunos4.1.1} and @file{sunos4.1.2} directories,
682 @file{configure} tries successively less specific operating system names
683 by removing trailing suffixes starting with a period.
684
685 As an example, here is the complete list of directories that would be
686 tried for the configuration @w{@samp{sparc-sun-sunos4.1}} (without the
687 @w{@samp{--nfp}} option):
688
689 @smallexample
690 sparc/fpu
691 unix/bsd/sun/sunos4.1/sparc
692 unix/bsd/sun/sunos4.1
693 unix/bsd/sun/sunos4/sparc
694 unix/bsd/sun/sunos4
695 unix/bsd/sun/sunos/sparc
696 unix/bsd/sun/sunos
697 unix/bsd/sun/sparc
698 unix/bsd/sun
699 unix/bsd/sunos4.1/sparc
700 unix/bsd/sunos4.1
701 unix/bsd/sunos4/sparc
702 unix/bsd/sunos4
703 unix/bsd/sunos/sparc
704 unix/bsd/sunos
705 unix/bsd/sparc
706 unix/bsd
707 unix/sun/sunos4.1/sparc
708 unix/sun/sunos4.1
709 unix/sun/sunos4/sparc
710 unix/sun/sunos4
711 unix/sun/sunos/sparc
712 unix/sun/sunos
713 unix/sun/sparc
714 unix/sun
715 unix/sunos4.1/sparc
716 unix/sunos4.1
717 unix/sunos4/sparc
718 unix/sunos4
719 unix/sunos/sparc
720 unix/sunos
721 unix/sparc
722 unix
723 sun/sunos4.1/sparc
724 sun/sunos4.1
725 sun/sunos4/sparc
726 sun/sunos4
727 sun/sunos/sparc
728 sun/sunos
729 sun/sparc
730 sun
731 sunos4.1/sparc
732 sunos4.1
733 sunos4/sparc
734 sunos4
735 sunos/sparc
736 sunos
737 sparc
738 @end smallexample
739
740 Different machine architectures are conventionally subdirectories at the
741 top level of the @file{sysdeps} directory tree.  For example,
742 @w{@file{sysdeps/sparc}} and @w{@file{sysdeps/m68k}}.  These contain
743 files specific to those machine architectures, but not specific to any
744 particular operating system.  There might be subdirectories for
745 specializations of those architectures, such as
746 @w{@file{sysdeps/m68k/68020}}. Code which is specific to the
747 floating-point coprocessor used with a particular machine should go in
748 @w{@file{sysdeps/@var{machine}/fpu}}.
749
750 There are a few directories at the top level of the @file{sysdeps}
751 hierarchy that are not for particular machine architectures.
752
753 @table @file
754 @item generic
755 As described above (@pxref{Porting}), this is the subdirectory
756 that every configuration implicitly uses after all others.
757
758 @item ieee754
759 This directory is for code using the IEEE 754 floating-point format,
760 where the C type @code{float} is IEEE 754 single-precision format, and
761 @code{double} is IEEE 754 double-precision format.  Usually this
762 directory is referred to in the @file{Implies} file in a machine
763 architecture-specific directory, such as @file{m68k/Implies}.
764
765 @item posix
766 This directory contains implementations of things in the library in
767 terms of @sc{POSIX.1} functions.  This includes some of the @sc{POSIX.1}
768 functions themselves.  Of course, @sc{POSIX.1} cannot be completely
769 implemented in terms of itself, so a configuration using just
770 @file{posix} cannot be complete.
771
772 @item unix
773 This is the directory for Unix-like things.  @xref{Porting to Unix}.
774 @file{unix} implies @file{posix}.  There are some special-purpose
775 subdirectories of @file{unix}:
776
777 @table @file
778 @item unix/common
779 This directory is for things common to both BSD and System V release 4.
780 Both @file{unix/bsd} and @file{unix/sysv/sysv4} imply @file{unix/common}.
781
782 @item unix/inet
783 This directory is for @code{socket} and related functions on Unix systems.
784 The @file{inet} top-level subdirectory is enabled by @file{unix/inet/Subdirs}.
785 @file{unix/common} implies @file{unix/inet}.
786 @end table
787
788 @item mach
789 This is the directory for things based on the Mach microkernel from CMU
790 (including the GNU operating system).  Other basic operating systems
791 (VMS, for example) would have their own directories at the top level of
792 the @file{sysdeps} hierarchy, parallel to @file{unix} and @file{mach}.
793 @end table
794
795 @node Porting to Unix
796 @appendixsubsec Porting the GNU C Library to Unix Systems
797
798 Most Unix systems are fundamentally very similar.  There are variations
799 between different machines, and variations in what facilities are
800 provided by the kernel.  But the interface to the operating system
801 facilities is, for the most part, pretty uniform and simple.
802
803 The code for Unix systems is in the directory @file{unix}, at the top
804 level of the @file{sysdeps} hierarchy.  This directory contains
805 subdirectories (and subdirectory trees) for various Unix variants.
806
807 The functions which are system calls in most Unix systems are
808 implemented in assembly code, which is generated automatically from
809 specifications in the file @file{sysdeps/unix/syscalls.list}.  Some
810 special system calls are implemented in files that are named with a
811 suffix of @samp{.S}; for example, @file{_exit.S}.  Files ending in
812 @samp{.S} are run through the C preprocessor before being fed to the
813 assembler.
814
815 These files all use a set of macros that should be defined in
816 @file{sysdep.h}.  The @file{sysdep.h} file in @file{sysdeps/unix}
817 partially defines them; a @file{sysdep.h} file in another directory must
818 finish defining them for the particular machine and operating system
819 variant.  See @file{sysdeps/unix/sysdep.h} and the machine-specific
820 @file{sysdep.h} implementations to see what these macros are and what
821 they should do.@refill
822
823 The system-specific makefile for the @file{unix} directory (that is, the
824 file @file{sysdeps/unix/Makefile}) gives rules to generate several files
825 from the Unix system you are building the library on (which is assumed
826 to be the target system you are building the library @emph{for}).  All
827 the generated files are put in the directory where the object files are
828 kept; they should not affect the source tree itself.  The files
829 generated are @file{ioctls.h}, @file{errnos.h}, @file{sys/param.h}, and
830 @file{errlist.c} (for the @file{stdio} section of the library).
831
832 @ignore
833 @c This section might be a good idea if it is finished,
834 @c but there's no point including it as it stands. --rms
835 @c @appendixsec Compatibility with Traditional C
836
837 @c ??? This section is really short now.  Want to keep it? --roland
838
839 Although the GNU C library implements the @w{ISO C} library facilities, you
840 @emph{can} use the GNU C library with traditional, ``pre-ISO'' C
841 compilers.  However, you need to be careful because the content and
842 organization of the GNU C library header files differs from that of
843 traditional C implementations.  This means you may need to make changes
844 to your program in order to get it to compile.
845 @end ignore
846
847 @node Contributors
848 @appendixsec Contributors to the GNU C Library
849
850 The GNU C library was written originally by Roland McGrath.  Some parts
851 of the library were contributed or worked on by other people.
852
853 @itemize @bullet
854 @item
855 The @code{getopt} function and related code were written by
856 Richard Stallman, @w{David J. MacKenzie}, and @w{Roland McGrath}.
857
858 @item
859 The merge sort function @code{qsort} was written by Michael J. Haertel.
860
861 @item
862 The quick sort function used as a fallback by @code{qsort} was written
863 by Douglas C. Schmidt.
864
865 @item
866 The memory allocation functions @code{malloc}, @code{realloc} and
867 @code{free} and related code were written by Michael J. Haertel.
868
869 @item
870 Fast implementations of many of the string functions (@code{memcpy},
871 @code{strlen}, etc.) were written by Torbj@"orn Granlund.
872
873 @item
874 The @file{tar.h} header file was written by David J. MacKenzie.
875
876 @item
877 The port to the MIPS DECStation running Ultrix 4
878 (@code{mips-dec-ultrix4})
879 was contributed by Brendan Kehoe and Ian Lance Taylor.
880
881 @item
882 The DES encryption function @code{crypt} and related functions were
883 contributed by Michael Glad.
884
885 @item
886 The @code{ftw} and @code{nftw} function was contributed by Ulrich Drepper.
887
888 @item
889 The startup code to support SunOS shared libraries was contributed by
890 Tom Quinn.
891
892 @item
893 The @code{mktime} function was contributed by Paul Eggert.
894
895 @item
896 The port to the Sequent Symmetry running Dynix version 3
897 (@code{i386-sequent-bsd}) was contributed by Jason Merrill.
898
899 @item
900 The timezone support code is derived from the public-domain timezone
901 package by Arthur David Olson and his many contributors.
902
903 @item
904 The port to the DEC Alpha running OSF/1 (@code{alpha-dec-osf1}) was
905 contributed by Brendan Kehoe, using some code written by Roland McGrath.
906
907 @item
908 The port to SGI machines running Irix 4 (@code{mips-sgi-irix4}) was
909 contributed by Tom Quinn.
910
911 @item
912 The port of the Mach and Hurd code to the MIPS architecture
913 (@code{mips-@var{anything}-gnu}) was contributed by Kazumoto Kojima.
914
915 @item
916 The floating-point printing function used by @code{printf} and friends
917 and the floating-point reading function used by @code{scanf},
918 @code{strtod} and friends were written by Ulrich Drepper.  The
919 multi-precision integer functions used in those functions are taken from
920 GNU MP, which was contributed by Torbj@"orn Granlund.
921
922 @item
923 The internationalization support in the library, and the support
924 programs @code{locale} and @code{localedef}, were written by Ulrich
925 Drepper.  Ulrich Drepper adapted the support code for message catalogs
926 (@file{libintl.h}, etc.) from the GNU @code{gettext} package, which he
927 also wrote.  He also contributed the @code{catgets} support and the
928 entire suite of multi-byte and wide-character support functions
929 (@file{wctype.h}, @file{wchar.h}, etc.).
930
931 @item
932 The implementations of the @file{nsswitch.conf} mechanism and the files
933 and DNS backends for it were designed and written by Ulrich Drepper and
934 Roland McGrath, based on a backend interface defined by Peter Eriksson.
935
936 @item
937 The port to Linux i386/ELF (@code{i386-@var{anything}-linux}) was
938 contributed by Ulrich Drepper, based in large part on work done in
939 Hongjiu Lu's Linux version of the GNU C Library.
940
941 @item
942 The port to Linux/m68k (@code{m68k-@var{anything}-linux}) was
943 contributed by Andreas Schwab.
944
945 @item
946 The ports to Linux/ARM (@code{arm-@var{ANYTHING}-linuxaout}) and ARM
947 standalone (@code{arm-@var{ANYTHING}-none}), as well as parts of the
948 IPv6 support code, were contributed by Philip Blundell.
949
950 @item
951 Richard Henderson contributed the ELF dynamic linking code and other
952 support for the Alpha processor.
953
954 @item
955 David Mosberger-Tang contributed the port to Linux/Alpha
956 (@code{alpha-@var{anything}-linux}).
957
958 @item
959 The port to Linux on PowerPC (@code{powerpc-@var{anything}-linux})
960 was contributed by Geoffrey Keating.
961
962 @item
963 Miles Bader wrote the argp argument-parsing package, and the argz/envz
964 interfaces.
965
966 @item
967 Stephen R. van den Berg contributed a highly-optimized @code{strstr} function.
968
969 @item
970 Ulrich Drepper contributed the @code{hsearch} and @code{drand48}
971 families of functions; reentrant @samp{@dots{}@code{_r}} versions of the
972 @code{random} family; System V shared memory and IPC support code; and
973 several highly-optimized string functions for i@var{x}86 processors.
974
975 @item
976 The math functions are taken from @code{fdlibm-5.1} by Sun
977 Microsystems, as modified by J.T. Conklin, Ian Lance Taylor,
978 Ulrich Drepper, Andreas Schwab, and Roland McGrath.
979
980 @item
981 The @code{libio} library used to implement @code{stdio} functions on
982 some platforms was written by Per Bothner and modified by Ulrich Drepper.
983
984 @item
985 The Internet-related code (most of the @file{inet} subdirectory) and
986 several other miscellaneous functions and header files have been
987 included from 4.4 BSD with little or no modification.
988
989 All code incorporated from 4.4 BSD is under the following copyright:
990
991 @quotation
992 @display
993 Copyright @copyright{} 1991 Regents of the University of California.
994 All rights reserved.
995 @end display
996
997 Redistribution and use in source and binary forms, with or without
998 modification, are permitted provided that the following conditions
999 are met:
1000
1001 @enumerate
1002 @item
1003 Redistributions of source code must retain the above copyright
1004 notice, this list of conditions and the following disclaimer.
1005 @item
1006 Redistributions in binary form must reproduce the above copyright
1007 notice, this list of conditions and the following disclaimer in the
1008 documentation and/or other materials provided with the distribution.
1009 @item
1010 All advertising materials mentioning features or use of this software
1011 must display the following acknowledgement:
1012 @quotation
1013 This product includes software developed by the University of
1014 California, Berkeley and its contributors.
1015 @end quotation
1016 @item
1017 Neither the name of the University nor the names of its contributors
1018 may be used to endorse or promote products derived from this software
1019 without specific prior written permission.
1020 @end enumerate
1021
1022 @sc{this software is provided by the regents and contributors ``as is'' and
1023 any express or implied warranties, including, but not limited to, the
1024 implied warranties of merchantability and fitness for a particular purpose
1025 are disclaimed.  in no event shall the regents or contributors be liable
1026 for any direct, indirect, incidental, special, exemplary, or consequential
1027 damages (including, but not limited to, procurement of substitute goods
1028 or services; loss of use, data, or profits; or business interruption)
1029 however caused and on any theory of liability, whether in contract, strict
1030 liability, or tort (including negligence or otherwise) arising in any way
1031 out of the use of this software, even if advised of the possibility of
1032 such damage.}
1033 @end quotation
1034
1035 @item
1036 The random number generation functions @code{random}, @code{srandom},
1037 @code{setstate} and @code{initstate}, which are also the basis for the
1038 @code{rand} and @code{srand} functions, were written by Earl T. Cohen
1039 for the University of California at Berkeley and are copyrighted by the
1040 Regents of the University of California.  They have undergone minor
1041 changes to fit into the GNU C library and to fit the @w{ISO C} standard,
1042 but the functional code is Berkeley's.@refill
1043
1044 @item
1045 The Internet resolver code is taken directly from BIND 4.9.5, which is
1046 under both the Berkeley copyright above and also:
1047
1048 @quotation
1049 Portions Copyright @copyright{} 1993 by Digital Equipment Corporation.
1050
1051 Permission to use, copy, modify, and distribute this software for any
1052 purpose with or without fee is hereby granted, provided that the above
1053 copyright notice and this permission notice appear in all copies, and
1054 that the name of Digital Equipment Corporation not be used in
1055 advertising or publicity pertaining to distribution of the document or
1056 software without specific, written prior permission.
1057
1058 @sc{the software is provided ``as is'' and digital equipment corp.
1059 disclaims all warranties with regard to this software, including all
1060 implied warranties of merchantability and fitness.  in no event shall
1061 digital equipment corporation be liable for any special, direct,
1062 indirect, or consequential damages or any damages whatsoever resulting
1063 from loss of use, data or profits, whether in an action of contract,
1064 negligence or other tortious action, arising out of or in connection
1065 with the use or performance of this software.}
1066 @end quotation
1067
1068 @item
1069 The code to support Sun RPC is taken verbatim from Sun's
1070 @w{@sc{rpcsrc-4.0}} distribution, and is covered by this copyright:
1071
1072 @quotation
1073 @display
1074 Copyright @copyright{} 1984, Sun Microsystems, Inc.
1075 @end display
1076
1077 Sun RPC is a product of Sun Microsystems, Inc. and is provided for
1078 unrestricted use provided that this legend is included on all tape media
1079 and as a part of the software program in whole or part.  Users may copy
1080 or modify Sun RPC without charge, but are not authorized to license or
1081 distribute it to anyone else except as part of a product or program
1082 developed by the user.
1083
1084 @sc{sun rpc is provided as is with no warranties of any kind including the
1085 warranties of design, merchantibility and fitness for a particular
1086 purpose, or arising from a course of dealing, usage or trade practice.}
1087
1088 Sun RPC is provided with no support and without any obligation on the
1089 part of Sun Microsystems, Inc. to assist in its use, correction,
1090 modification or enhancement.
1091
1092 @sc{sun microsystems, inc. shall have no liability with respect to the
1093 infringement of copyrights, trade secrets or any patents by sun rpc
1094 or any part thereof.}
1095
1096 In no event will Sun Microsystems, Inc. be liable for any lost revenue
1097 or profits or other special, indirect and consequential damages, even if
1098 Sun has been advised of the possibility of such damages.
1099
1100 @display
1101 Sun Microsystems, Inc.
1102 2550 Garcia Avenue
1103 Mountain View, California  94043
1104 @end display
1105 @end quotation
1106
1107 @item
1108 Some of the support code for Mach is taken from Mach 3.0 by CMU,
1109 and is under the following copyright terms:
1110
1111 @quotation
1112 @display
1113 Mach Operating System
1114 Copyright @copyright{} 1991,1990,1989 Carnegie Mellon University
1115 All Rights Reserved.
1116 @end display
1117
1118 Permission to use, copy, modify and distribute this software and its
1119 documentation is hereby granted, provided that both the copyright
1120 notice and this permission notice appear in all copies of the
1121 software, derivative works or modified versions, and any portions
1122 thereof, and that both notices appear in supporting documentation.
1123
1124 @sc{carnegie mellon allows free use of this software in its ``as is''
1125 condition.  carnegie mellon disclaims any liability of any kind for
1126 any damages whatsoever resulting from the use of this software.}
1127
1128 Carnegie Mellon requests users of this software to return to
1129
1130 @display
1131  Software Distribution Coordinator
1132  School of Computer Science
1133  Carnegie Mellon University
1134  Pittsburgh PA 15213-3890
1135 @end display
1136
1137 @noindent
1138 or @email{Software.Distribution@@CS.CMU.EDU} any improvements or
1139 extensions that they make and grant Carnegie Mellon the rights to
1140 redistribute these changes.
1141 @end quotation
1142
1143 @item
1144 The code for the database library @file{libdb} comes from the 2.3
1145 release of Berkeley DB. That code is under the same copyright as 4.4 BSD
1146 and also:
1147
1148 @quotation
1149 @display
1150 Copyright @copyright{} 1990, 1993, 1994, 1995, 1996, 1997
1151 Sleepycat Software.  All rights reserved.
1152 @end display
1153
1154 Redistribution and use in source and binary forms, with or without
1155 modification, are permitted provided that the following conditions
1156 are met:
1157
1158 @enumerate
1159 @item
1160 Redistributions of source code must retain the above copyright
1161 notice, this list of conditions and the following disclaimer.
1162 @item
1163 Redistributions in binary form must reproduce the above copyright
1164 notice, this list of conditions and the following disclaimer in the
1165 documentation and/or other materials provided with the distribution.
1166 @item
1167 Redistributions in any form must be accompanied by information on
1168 how to obtain complete source code for the DB software and any
1169 accompanying software that uses the DB software.  The source code
1170 must either be included in the distribution or be available for no
1171 more than the cost of distribution plus a nominal fee, and must be
1172 freely redistributable under reasonable conditions.  For an
1173 executable file, complete source code means the source code for all
1174 modules it contains.  It does not mean source code for modules or
1175 files that typically accompany the operating system on which the
1176 executable file runs, e.g., standard library modules or system
1177 header files.
1178 @end enumerate
1179
1180 @sc{this software is provided by sleepycat software ``as is'' and
1181 any express or implied warranties, including, but not limited to, the
1182 implied warranties of merchantability and fitness for a particular purpose
1183 are disclaimed.  in no event shall sleepycat software be liable
1184 for any direct, indirect, incidental, special, exemplary, or consequential
1185 damages (including, but not limited to, procurement of substitute goods
1186 or services; loss of use, data, or profits; or business interruption)
1187 however caused and on any theory of liability, whether in contract, strict
1188 liability, or tort (including negligence or otherwise) arising in any way
1189 out of the use of this software, even if advised of the possibility of
1190 such damage.}
1191
1192 @display
1193 Portions copyright @copyright{} 1995, 1996
1194 The President and Fellows of Harvard University.
1195 All rights reserved.
1196 @end display
1197
1198 Redistribution and use in source and binary forms, with or without
1199 modification, are permitted provided that the following conditions
1200 are met:
1201 @enumerate
1202 @item
1203 Redistributions of source code must retain the above copyright
1204 notice, this list of conditions and the following disclaimer.
1205 @item
1206 Redistributions in binary form must reproduce the above copyright
1207 notice, this list of conditions and the following disclaimer in the
1208 documentation and/or other materials provided with the distribution.
1209 @item
1210 All advertising materials mentioning features or use of this software
1211 must display the following acknowledgement:
1212 @quotation
1213  This product includes software developed by Harvard University
1214  and its contributors.
1215 @end quotation
1216 @item
1217 Neither the name of the University nor the names of its contributors
1218 may be used to endorse or promote products derived from this software
1219 without specific prior written permission.
1220 @end enumerate
1221
1222 @sc{this software is provided by harvard and its contributors ``as is'' and
1223 any express or implied warranties, including, but not limited to, the
1224 implied warranties of merchantability and fitness for a particular purpose
1225 are disclaimed.  in no event shall harvard or its contributors be liable
1226 for any direct, indirect, incidental, special, exemplary, or consequential
1227 damages (including, but not limited to, procurement of substitute goods
1228 or services; loss of use, data, or profits; or business interruption)
1229 however caused and on any theory of liability, whether in contract, strict
1230 liability, or tort (including negligence or otherwise) arising in any way
1231 out of the use of this software, even if advised of the possibility of
1232 such damage.}
1233
1234 @noindent
1235 For a license to use, redistribute or sell DB software under conditions
1236 other than those described above, or to purchase support for this
1237 software, please contact Sleepycat Software at
1238
1239 @display
1240  Sleepycat Software
1241  394 E. Riding Dr.
1242  Carlisle, MA 01741
1243  USA
1244  +1-508-287-4781
1245 @end display
1246
1247 or @email{db@@sleepycat.com}.
1248
1249 @end quotation
1250
1251 @end itemize
1252
1253 @c @bye