.
[glibc/history.git] / NEWS
blob411c2c3bc824310bade5eb16bb81b7ad98815ee6
1 GNU C Library NEWS -- history of user-visible changes.  2009-4-23
2 Copyright (C) 1992-2008, 2009 Free Software Foundation, Inc.
3 See the end for copying conditions.
5 Please send GNU C library bug reports via <http://sources.redhat.com/bugzilla/>
6 using `glibc' in the "product" field.
7 \f
8 Version 2.10
10 * New interfaces: preadv, preadv64, pwritev, pwritev64, malloc_info
11   Implemented by Ulrich Drepper.
13 * New Linux interfaces: accept4, fallocate, fallocate64.
14   Implemented by Ulrich Drepper.
16 * Correct declarations of string function when used in C++ code.  This
17   could lead to compile errors for invalid C++ code.
19 * XPG7/POSIX 2008 compilation environment.  Many GNU-specific functions are
20   now in POSIX.
22 * New POSIX 2008 interface: psiginfo
23   Implemented by Ulrich Drepper.
25 * New ISO C++1x interfaces: quick_exit, at_quick_exit
26   Implemented by Ulrich Drepper.
28 * Support for selecting between multiple function definitions at runtime
29   using STT_GNU_IFUNC symbols.  Implemented by Ulrich Drepper.
31 * The libcrypt library can now use the hash function implementations in
32   NSS.  Implemented by Ulrich Drepper.
34 * The malloc implementation can be compiled to be less memory efficient
35   but higher performing in multi-threaded programs.
36   Implemented by Ulrich Drepper.
38 * New locales: nan_TW@latin, ks_IN
40 * Faster strlen, strchr, strchrnul, strrchr, memchr, and rawmemchr for x86-64.
41   Implemented by Ulrich Drepper.
43 * Extended printf hook support.  It is possible to use user-defined types
44   and extend existing format specifiers.
45   Implemented by Ulrich Drepper.
47 * Handling for group shadow files has been added.
48   Implemented by Ulrich Drepper.
51 Version 2.9
53 * Unified lookup for getaddrinfo: IPv4 and IPv6 addresses are now looked
54   up at the same time.  Implemented by Ulrich Drepper.
56 * TLS descriptors for LD and GD on x86 and x86-64.
57   Implemented by Alexandre Oliva.
59 * getaddrinfo now handles DCCP and UDPlite.
60   Implemented by Ulrich Drepper.
62 * New fixed-size conversion macros: htobe16, htole16, be16toh, le16toh,
63   htobe32, htole32, be32toh, le32toh, htobe64, htole64, be64toh, le64toh.
64   Implemented by Ulrich Drepper.
66 * New implementation of memmem, strstr, and strcasestr which is O(n).
67   Implemented by Eric Blake.
69 * New Linux interfaces: inotify_init1, dup3, epoll_create1, pipe2
71 * Implement "e" option for popen to open file descriptor with the
72   close-on-exec flag set.  Implemented by Ulrich Drepper.
74 * Implement "b" mode for fmemopen.  In this mode writes writes don't
75   implicitly add a NUL byte and seeks from the end of the buffer really
76   use the buffer end, not the string length as the basis.
77   Implemented by Ulrich Drepper.
79 * Many functions, exported and internal, now atomically set the close-on-exec
80   flag when run on a sufficiently new kernel.  Implemented by Ulrich Drepper.
82 * Sorting rules for some Indian languages (Kannada, Gurumukhi, Telugu,
83   Sinhala)
84   Implemented by Pravin Satpute.
86 * New locales: sd_IN, sd_IN@devanagari, ks_IN@devanagari, ht_HT, en_AG, nl_AW.
88 Version 2.8
90 * New locales: bo_CN, bo_IN, shs_CA.
92 * New encoding: HP-ROMAN9, HP-GREEK8, HP-THAI8, HP-TURKISH8.
94 * Sorting rules for some Indian languages (Devanagari and Gujarati).
95   Implemented by Pravin Satpute.
97 * IPV6 addresses in /etc/resolv.conf can now have a scope ID
99 * nscd caches now all timeouts for DNS entries
100   Implemented by Ulrich Drepper.
102 * nscd is more efficient and wakes up less often.
103   Implemented by Ulrich Drepper.
105 * More checking functions: asprintf, dprintf, obstack_printf, vasprintf,
106   vdprintf, and obstack_vprintf.
107   Implemented by Jakub Jelinek.
109 * Faster memset for x86-64.
110   Implemented by Harsha Jagasia and H.J. Lu.
112 * Faster memcpy on x86.
113   Implemented by Ulrich Drepper.
115 * ARG_MAX is not anymore constant on Linux.  Use sysconf(_SC_ARG_MAX).
116   Implemented by Ulrich Drepper.
118 * Faster sqrt and sqrtf implemention for some PPC variants.
119   Implemented by Stephen Munroe.
121 Version 2.7
123 * More checking functions: fread, fread_unlocked, open*, mq_open.
124   Implemented by Jakub Jelinek and Ulrich Drepper.
126 * Extend fortification to C++.  Implemented by Jakub Jelinek.
128 * Implement 'm' modifier for scanf.  Add stricter C99/SUS compliance
129   by not recognizing 'a' as a modifier when those specs are requested.
130   Implemented by Jakub Jelinek.
132 * PPC optimizations to math and string functions.
133   Implemented by Steven Munroe.
135 * New interfaces: mkostemp, mkostemp64.  Like mkstemp* but allow additional
136   options to be passed.  Implemented by Ulrich Drepper.
138 * More CPU set manipulation functions.  Implemented by Ulrich Drepper.
140 * New Linux interfaces: signalfd, eventfd, eventfd_read, and eventfd_write.
141   Implemented by Ulrich Drepper.
143 * Handle private futexes in the NPTL implementation.
144   Implemented by Jakub Jelinek and Ulrich Drepper.
146 * Add support for O_CLOEXEC.  Implement in Hurd.  Use throughout libc.
147   Implemented by Roland McGrath and Ulrich Drepper.
149 * Linux/x86-64 vDSO support.  Implemented by Ulrich Drepper.
151 * SHA-256 and SHA-512 based password encryption.
152   Implemented by Ulrich Drepper.
154 * New locales: ber_DZ, ber_MA, en_NG, fil_PH, fur_IT, fy_DE, ha_NG, ig_NG,
155   ik_CA, iu_CA, li_BE, li_NL, nds_DE, nds_NL, pap_AN, sc_IT, tk_TM, ug_CN,
156   yo_NG.
158 + New iconv modules: MAC-CENTRALEUROPE, ISO-8859-9E, KOI8-RU.
159   Implemented by Ulrich Drepper.
161 Version 2.6
163 * New Linux interfaces: epoll_pwait, sched_getcpu.
165 * New generic interfaces: strerror_l.
167 * nscd can now cache the services database.   Implemented by Ulrich Drepper.
170 Version 2.5
172 * For Linux, the sorting of addresses returned by getaddrinfo now also
173   handles rules 3, 4, and 7 from RFC 3484.  I.e., all rules are handled.
174   Implemented by Ulrich Drepper.
176 * Allow system admin to configure getaddrinfo with the /etc/gai.conf file.
177   Implemented by Ulrich Drepper.
179 * New Linux interfaces: splice, tee, sync_file_range, vmsplice.
181 * New iconv module for MIK.  Contributed by Alexander Shopov.
183 * For sites with broken group and/or passwd database, the auto-propagate
184   option of nscd can prevent creating ID lookup entries from the results
185   of a name lookup and vice versa.   This usually is no problem but some
186   site might have problems with the default behavior.
187   Implemented by Ulrich Drepper.
189 * Iterating over entire database in NIS can be slow.  With the
190   SETENT_BATCH_READ option in /etc/default/nss a system admin can decide
191   to trade time for memory.  The entire database will be read at once.
192   Implemented by Ulrich Drepper.
194 * The interfaces introduced in RFC 3542 have been implemented by
195   Ulrich Drepper.
197 * Support for the new ELF hash table format was added by Ulrich Drepper.
199 * Support for priority inheritance mutexes added by Jakub Jelinek and
200   Ulrich Drepper.
202 * Support for priority protected mutexes added by Jakub Jelinek.
204 * New locales: nr_ZA, pa_PK, ca_AD, ca_FR, ca_IT, el_CY, tr_CY, as_IN,
205   or_IN, csb_PL, fy_NL, sr_ME.
207 Version 2.4
209 * More overflow detection functions.
211 * New iconv converters for IBM1025, IBM1122, IBM1137, IBM1153,
212   IBM1154, IBM1155, IBM1156, IBM1157, and IBM1158 contributed by Jiro Sekiba.
214   More converters for IBM803, IBM901, IBM902, IBM921, IBM1008, IBM1097,
215   IBM1112, IBM1123, IBM1130, IBM1140, IBM1141, IBM1142, IBM1143, IBM1144,
216   IBM1145, IBM1146, IBM1147, IBM1148, IBM1149, IBM1166, IBM1167, IBM4517,
217   IBM4899, IBM4909, IBM4971, IBM5347, IBM9030, IBM9066, IBM9448, IBM12712,
218   IBM16804, IBM1364, IBM1371, IBM1388, IBM1390, and IBM1399 contributed
219   by Masahide Washizawa.
221 * It is now possible to install audit libraries for the dynamic linker using
222   LD_AUDIT.  Implemented by Ulrich Drepper.
224 * The LinuxThreads add-on, providing pthreads on Linux 2.4 kernels, is no
225   longer supported.  The new NPTL implementation requires Linux 2.6 kernels.
226   For a libc and libpthread that works well on Linux 2.4 kernels, we
227   recommend using the stable 2.3 branch.
229 * The new function open_wmemstream acts like open_memstream,
230   but uses a wchar_t wide character buffer.
232 * The new function ppoll is an improved version of poll, similar to pselect.
234 * New interfaces: fdopendir, openat, fstatat, fchmodat, fchownat,
235   futimesat, faccessat, mkdirat, mkfifoat, mknodat,
236   renameat, unlinkat, linkat, symlinkat, readlinkat.
238 * New Linux kernel system calls: unshare,
239   inotify_init, inotify_add_watch, inotify_rm_watch.
241 * The euidaccess function is now also known by the alias eaccess,
242   for compatibility with some other systems.
244 * Timezone data updated to 2006b version.
246 Version 2.3.6
248 * The following bugs are resolved with this release:
250   38, 253, 549, 622, 653, 721, 758, 851, 877, 915, 934, 955, 961,
251   1016, 1037, 1076, 1079, 1080, 1081, 1082, 1083, 1084, 1085, 1086,
252   1087, 1088, 1090, 1091, 1092, 1093, 1094, 1095, 1096, 1097, 1098,
253   1099, 1100, 1101, 1102, 1103, 1104, 1105, 1106, 1107, 1108, 1109,
254   1110, 1111, 1112, 1113, 1125, 1137, 1138, 1249, 1250, 1251, 1252,
255   1253, 1254, 1350, 1358, 1394, 1438, 1498, 1534
257   Visit <http://sources.redhat.com/bugzilla/> for the details of each bug.
259 * As of this release, GCC 4 can be used to compile the C Library.
261 * Timezone data updated to 2005m version.
263 Version 2.3.5
265 * The following bugs are resolved with this release:
267   284, 592, 602, 626, 633, 640, 650, 661, 671, 681, 693, 700, 710, 719,
268   722, 723, 725, 726, 727, 728, 729, 730, 731, 732, 733, 734, 735, 736,
269   737, 738, 739, 740, 741, 742, 743, 744, 745, 765, 767, 768, 769, 776,
270   777, 787, 821, 822, 823, 825
272   Visit <http://sources.redhat.com/bugzilla/> for the details of each bug.
274 Version 2.3.4
276 * Support for RFC 3678.  Real implementations exist only for Linux so far.
277   Implemented by Ulrich Drepper.
279 * nscd can now cache entries persistently.  Expiring entries are reloaded.
280   For speedups the cache can be shared in memory with client processes.
281   Implemented by Ulrich Drepper.
283 * nscd can now perform SELinux checks.
284   Implemented by Matthew Rickard <mjricka@epoch.ncsc.mil>.
286 * getaddrinfo queries are now cached.  Canonical name lookup is performed
287   efficiently.
288   Implemented by Ulrich Drepper.
290 * The nothrow function attribute is used when headers are used by gcc when
291   compiling C code.  This can avoid significant amounts of exception
292   handling data.
294 * The malloc functions perform more error checking and are stricter when
295   it comes to reacting on errors.  The default action is to terminate
296   the process after showing an error message.  Implemented by Ulrich Drepper.
298 * Reverse lookups of IPv6 addresses does not use bit string or .ip6.int
299   lookups anymore unless explicitly requested.  Implemented by Ulrich Drepper.
301 * Namespaces in ld.so are implemented.  DSOs can be loaded in separate
302   namespaces using the new function dlmopen().  This feature is of course,
303   like most other dynamic loading functionality, not available in statically
304   linked applications.  Implemented by Ulrich Drepper.
306 * Low-overhead boundary checking variants of string and some stdio functions
307   were added.  These are to be used in conjunction with a gcc patch by
308   Jakub Jelinek which adds calls to these functions if possible.
309   Implemented by Jakub Jelinek and Ulrich Drepper.
311 * Old code for several operating systems and machine architectures that
312   have not been in working condition in a long time have been removed from
313   the main source tree maintained by the GNU C Library's maintainers.
314   These files are now reside in the separate `ports' source module
315   that is usable as an add-on when building the library.
317 Version 2.3.3
319 * New functions `dladdr1' and `dlinfo' in <dlfcn.h> provide more ways to
320   interrogate the dynamic linker, compatible with the Solaris interface.
322 * ELF thread-local storage support (TLS) now works on PowerPC and PowerPC64;
323   implemented by Paul Mackerras, Steven Munroe, and Roland McGrath.
325 * getifaddrs now uses the netlink interface on Linux to get its information.
326   Implemented by Thorsten Kukuk.
328 * getaddrinfo now implements AI_V4MAPPED, AI_ALL, and AI_ADDRCONF.
329   Implemented by Ulrich Drepper.
331 * support for non-executable stacks on x86 has been added.  Changes mostly
332   by Roland McGrath.
334 * regex is now much faster for multibyte locales.  Changes by Jakub Jelinek
335   and Ulrich Drepper.
337 * getaddrinfo now performs destination address selection according to
338   RFC 3484.
340 Version 2.3.2
342 * Thread-safe interfaces for many functions that access locale data
343   were added in version 2.3, but these features were omitted from NEWS.
344   Many functions have variants with an `_l' suffix that take a `locale_t'
345   object as a parameter rather than consulting the current locale.
346   The new functions `newlocale', `duplocale', and `freelocale' in <locale.h>
347   create and maintain `locale_t' objects.  Additionally, the new function
348   `uselocale' sets "the current locale" (as used by functions not so
349   parameterized) set for an individual thread.  These features were added
350   in version 2.3, implemented by Ulrich Drepper and Roland McGrath.
352 * The functions getresuid, getresgid, setresuid, and setresgid, which
353   have long been available on Linux, are now declared in <unistd.h>
354   and are now also available on the Hurd.
356 * ELF thread-local storage support (TLS) now works on x86-64.
358 * The new dynamic string token $LIB is expanded in shared library names.
359   This normally expands to lib, but on some 64-bit platforms to lib64 instead.
361 * Aldy Hernandez contributed complete software floating point support for
362   PowerPC machines with no FPU.
364 * fexecve is implemented on Linux.
366 * The `btowc' function should work at least twice as fast due to
367   specialized callbacks in the iconv modules.  Implemented by Bruno Haible.
369 * With approriate thread add-ons cancelable functions are now implemented
370   in libc.so as well.  No need to call the function in libpthread.  This
371   change allowed to finally disable the incorrect and expensive handling
372   of weak definition in ld.so.
374 * Yet more PLT entries in libc.so have been removed.  We finally arrived
375   at the bare minimum.  Startup times improved appropriately.
377 * Support for the new Linux/x86 system call interface was added.  The
378   AT_SYSINFO auxiliary vector entry is recognized and handled.
380 Version 2.3
382 * Masahide Washizawa contributed iconv modules for IBM1163 and IBM1164
383   charsets.
385 * iconv (the program and the interface) now accepts empty names (excluding
386   options like //TRANSLIT) to mean "use charset of current locale".
388 * localedef can now transliterate characters in strings which are not in
389   the provided charmap.  The information from the input locale is used.
391 * Prelinking support was added for ELF targets.  This requires additional
392   tools and recent versions of the GNU binutils.  Contributed by Jakub Jelinek.
394 * Read-only stdio streams now use mmap to speed up operation by eliminating
395   copying and buffer underflows.  To use add 'm' to the mode string of
396   the fopen/fdopen/freopen call.  Implemented by Ulrich Drepper.
398 * The malloc functions were completely rewritten by Wolfram Gloger based
399   on Doug Lea's malloc-2.7.0.c.
401 * Isamu Hasegawa contributed a completely new and POSIX-conformant
402   implementation of regex.
404 * Bruno Haible upgraded the iconv and locale implementation to support
405   Unicode 3.2.
407 * Contents of the LC_* and LANG environment variables in the CEN style are
408   not recognized anymore.   It never was used.  Change by Ulrich Drepper.
410 * The runtime (ld.so, libc, libpthread for Linux) now can handle the ELF
411   thread-local storage (TLS) ABI on some platforms.
412   Changes by Ulrich Drepper.  SH support by Kaz Kojima.
414 * Bruno Haible contributed iconv converters for ISO-2022-JP-3, SHIFT JIS-X0213,
415   EUC-JISX0213, and TSCII.
417 * New header <ifaddrs.h> with functions `getifaddrs' and `freeifaddrs':
418   BSD-compatible interface for getting all network interface addresses.
419   Implementation for IPv4 by Roland McGrath.
421 * Loading of locale data is faster due to the introduction of a locale
422   archive.  Implemented by Roland McGrath and Ulrich Drepper.
424 * Startup times are significantly reduced by not using exported functions
425   inside the library itself.  Changes by Jakub Jelinek, Roland McGrath,
426   and Ulrich Drepper.
428 * Steven Munroe contributed a port to PowerPC64/Linux.
430 Version 2.2.6
432 * The Hurd now uses the GNU libio implementation of stdio rather than the
433   old GNU stdio implementation, and uses a new ABI (libc.so.0.3).
435 * The Hurd on x86 now has the `ioperm' function and <sys/io.h> header file
436   with the same behavior as the Linux system call of the same name.
438 Version 2.2.5
440 * Stephen Moshier implemented log2, log10, powl and cbrtl for the
441   128-bit long double format.
443 * Masahide Washizawa contributed iconv modules for IBM1132, IBM1133, IBM1160,
444   IBM1161, and IBM1162 charsets.
446 * Andreas Jaeger contributed a port to x86-64/Linux.
448 * Peter Bruin contributed a port to PowerPC/Hurd.
450 * libc functions using I/O streams now can handle wide-oriented streams
451   as well.
453 * optimizations in the dynamic linker.  Binaries created by recent binutils
454   versions start up quicker due to reduced time spent on relocations.
456 * Support for use of gcc3 added by Jakub Jelinek and HJ Lu.
458 Version 2.2.4
460 * Stephen Moshier implemented cosh, expm1, log1p, acos, sinh, tanh,
461   asinh, atanh, j0 for the 128-bit long double format.
463 * Bruno Haible updated all the code handling Unicode in some form to
464   support Unicode 3.1.
466 * Speed of regex for single-byte locales is back to previous levels.
467   Patch by Isamu Hasegawa.
469 * Alpha, SPARC, and IA-64 now also using floating stacks.
471 * Startup time of internationalized applications greatly improved through
472   iconv cache.  Use iconvconfig to generate the cache file.
473   Contributed by Ulrich Drepper.
475 * The IA-64 specific part of ld.so was rewritten to eliminate some pretty
476   severe performance problems.  Patch by David Mosberger.
478 * The Hurd port got a lot more functionality like AIO, various stdio
479   extensions, etc.  Mainly done by Roland McGrath.
481 * mtrace can now lookup symbols in shared libraries.
483 Version 2.2.3
485 * Intel's IA-64 math library is largely integrated.  It provides fast and
486   accurate implementatations for most basic and standard math functions
487   in float, double, and long double format.
489 * Stephen Moshier implemented j0, j1, jn, y0, y1, yn, lgamma, erf, erfc,
490   and asin for the 96-bit long double format and asin, log, tan for the
491   128-bit long double format.
493 * The beginning of a last-bit accurate math library by IBM Haifa were added.
494   The basic double functions exist today.  Contributed by Abraham Ziv
495   <ziv@il.ibm.com>, Moshe Olshansky <olshansk@il.ibm.com>, Ealan Henis
496   <ealan@il.ibm.com>, and Anna Reitman <reitman@il.ibm.com>.
498 * An asynchronous name lookup library was added.  The interface is designed
499   after POSIX AIO.  The proposal was circulated beforehand to get comments.
500   No negative ones came in.  Implemented by Ulrich Drepper.
502 * Port to S390/64bit contributed by Martin Schwidefsky
503   <schwidefsky@de.ibm.com>.
505 * David Mosberger <davidm@hpl.hp.com> implemented the setcontext family
506   of functions for Linux/IA-64.
508 * The RPC code is now thread safe.  Threads can now use the same service
509   of different services at the same time.  Patch by Eric Norum
510   <eric.norum@usask.ca> with some help by Ulrich Drepper.
512 * Martin Schwidefsky <schwidefsky@de.ibm.com> implemented the setcontext
513   family of functions for Linux/S390.
515 * Ulrich Drepper <drepper@redhat.com> implemented the setcontext family
516   of functions for Linux/x86.
518 * Port to Linux/CRIS contributed by Axis Communications.
520 Version 2.2.2
522 * Lots of headers were cleaned up.  Using the tool in the conform/ subdir
523   we can now check for namespace violations and missing declarations.  The
524   result is that almost all headers are now Unix-compliant (as defined in
525   the upcoming XPG6).  The negative side is that some programs might need
526   corrections, too, if they depend on the incorrect form of the headers in
527   previous versions which defined too many symbols and included too many
528   other headers.
530 * regex now handles multibyte character sets correctly.
531   Contributed by Isamu Hasegawa <isamu@yamato.ibm.com>.
533 * iconv (the program) does now conform to the upcoming XPG6 and handles
534   charmaps.  Instead of the charset names the path of charmaps can be
535   provided and the conversion happens based on this data.
536   Contributed by Ulrich Drepper.
538 * The locale program now provides detailed information about the installed
539   locales.  While
541     locale -a
543   only lists the names of the supported locales
545     locale -a --verbose
547   provides details such as country, language, and codeset name.
548   Contributed by Ulrich Drepper.
550 Version 2.2.1
552 * The gencat program now parses the input file according to the charset
553   selected by the LC_CTYPE category.  This is important for stateful
554   character sets.  To make generating catalogs easier there is a way
555   to overwrite the charset selected by the locale: before the first
556   message or $ quote line the catalog can contain a line like
558     $ codeset=ISO-8859-2
560   to select the charset (ISO-8859-2 in this case).
562   Implemented by Shinya Hanataka and Ulrich Drepper.
564 * New codeset conversion modules: IBM-922  (Estonia PC codeset),
565   IBM-1124 (Ukraine PC codeset), IBM-1129 (Vietnamese PC codeset).
566   Contributed by Masahide Washizawa <washi@jp.ibm.com>.
568 * Optimized string functions for Alpha ev6 and ev67 by Richard Henderson
569   <rth@redhat.com> and Rick Gorton <rick.gorton@alpha-processor.com>.
571 * The LANGUAGE environment variable is now ignored unless the locale is
572   changed from the default "C" locale.
574 * The usual bug fixes.
576 Version 2.2
578 * Greg McGary added runtime support for bounds checking using gcc's
579   new -fbounded-pointers option.  ix86 target is complete.  PowerPC
580   is in progress.
582 * Thorsten Kukuk added secure mode support to nscd.
584 * The Berkeley db libraries have been removed.
586   Related, the nss_db module is now in a separate package since it
587   obviously requires a database library being available.
589 * Wide character I/O streams implemented by Ulrich Drepper.
591 * Functions from the extended socket API added by Ulrich Drepper.
593 * Functions feenableexcept and fedisableexcept to control the
594   behaviour of individual exceptions have been added by Andreas Jaeger.
596 * ldconfig program added by Andreas Jaeger and Jakub Jelinek.
598 * The resolver code has been updated from bind 8.2.3-T5B which supports
599   threads.  The integration was done by Andreas Jaeger, Adam D. Bradley,
600   and Mark Kettenis.
602   This change could in some situations effect backward compatibility.  Since
603   now `_res' is a thread-local instead of a global variable, modifying it
604   in one thread does not have any effect in other threads.
606   The resolver library was also extended to allow IPv6 as the transport
607   protocol for the requests.  This work was done by Stig Venaas.
609 * Compatibility code for K&R C compilers has been removed from the
610   header files.  A ISO C compiler is needed to use the library
611   (conforming to either C89 or C99 standard).
613 * Complete rewrite of the localedef program to support multibyte character
614   sets.  Implement handling of ISO 14651 and ISO 14652.  Rewrite strcoll,
615   strxfrm, wcscoll, and wcsxfrm functions.  Make isw*() functions work.
616   Implemented by Ulrich Drepper.
618   Bruno Haible significantly improved the generation and use of the data
619   structures for the wide character tables.
621 * Plural handling in gettext implemented by Ulrich Drepper.
623 * The utmp daemon has been removed.
625 * The port to MIPS-Linux has been finished by Andreas Jaeger.
627 * A port to Hitachi SH3 and SH4 has been contributed by Kazumoto Kojima
628   and Yutaka Niibe.
630 * POSIX clocks and timers implemented by Kaz Kylheku and Ulrich Drepper.
632 * POSIX barriers implemented by Kaz Kylheku.
634 * POSIX spawn function family implemented by Ulrich Drepper.
636 * POSIX spinlocks are now available.
638 * Timed wait functions for mutex, rwlock, and semaphores are implemented.
640 * the configure option --enable-kernel=X.Y.Z allows to strip out
641   compatibility for kernel versions before X.Y.Z.  This is currently only
642   implemented for Linux.
644 * the sockaddr_in6 structure changed.  The IPv6 working group added a new
645   field sin6_scope_id.  This means that all programs using IPv6 should be
646   recompiled.  Don't expect binary compatibility with previous glibc
647   versions.
649 * various conversion modules for IBM character sets contributed by
650   Masahide Washizawa.
652 * IA-64 port by Jes Sorensen and HJ Lu.
654 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
655 Compiling the GNU C Library for Linux/ia64
656 ******************************************
658    Please refer to the file INSTALL in the same directory as you found
659 this file for general information about configuring and compiling
660 glibc.
662    For general inquiries about glibc under Linux/ia64 please use the
663 following mailing list linux-ia64@linuxia64.org or one of the relevant
664 glibc mailing lists.
666 Recommended Tools for Compilation
667 =================================
669    In order for glibc-2.2 to build correctly on the ia64 you need at
670 least the following versions of the GNU tools (the :
672    * The Cygnus toolchain snapshot for the ia64 as of August 4
673      including the provided set of patches.  It is however recommend
674      you use the October 24 toolchain snapshot or a more recent version.
676    OR alternatively you can try the following (the Cygnus toolchain is
677    the recommended solution):
679    * GCC and binutils, GAS and GNU LD out of CVS from
680      sources.redhat.com as of August 28, 2000 or later.  The CVS tree
681      may require special patches to work properly on the ia64.
683 Configuring and compiling GNU Libc for Linux/ia64
684 =================================================
686    The library requires Linux kernel version 2.4.0-test4-000728 or
687 later to funtion properly. Besides that it support for debug libraries
688 is currently untested. Hence the following options
689 are required for configuring the library:
691    --disable-debug --enable-kernel=2.4.0
693    It is also important that you make sure the library picks up the
694 appropriate kernel header files, if you do not have recent enough
695 kernel headers in /usr/src/linux/include, you should use the
696 --with-headers=<path> option to specify the location.
698    As an example I personally use the following options to configure
699 the library:
701    --disable-debug
702    --disable-cvs
703    --enable-kernel=2.4.0
704    --host=ia64-linux
705    --enable-add-ons=yes
706    --prefix=/usr
707    --with-headers=/home/jes/linux/include
710 Good luck
712 Jes Sorensen <jes@linuxcare.com>,
713 November 14th, 2000
714 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
716 Version 2.1.3
718 * bug fixes
721 Version 2.1.2
723 * bug fixes
726 Version 2.1.1
728 * New ISO C 9x function _Exit, imaxabs, and imaxdiv are added.
730 * New xdr functions are added; some rpc functions are now 64bit clean.
732 * Fixed a number of bugs and memory leaks (especially in NIS+ code).
734 * Fixed known incompatibilities with glibc 2.0.
736 * New functions lock64, strchrnul, rawmemchr, getutmp and getutmpx.
738 * Optimized a number of functions (especially the ELF dynamic loader).
740 * Update timezone data files.
742 * lots of charmaps corrections
744 * some new locale definitions and charmaps
747 Version 2.1
749 * Richard Henderson corrected size of struct timeval on Linux/Alpha to
750   conform to POSIX member type requirements.  Symbol versions have been
751   adjusted as needed within the library, and for direct use by applications,
752   but there is potential for problems if third-party libraries use
753   struct timeval as part of their interface.  This does not present
754   a problem for X and other "essential" system libraries.
756 * An additional locale model to support C++ Standard Library locale
757   model and probably more was implemented by Ulrich Drepper.
759 * Eric Youngdale and Ulrich Drepper implemented versioning of objects on
760   symbol level.
762 * Miles Bader provided the `argp' function family to support hierachical
763   command line argument parsing, layered on top of getopt.
765 * strtod accepts new hexadecimal floating-point format from ISO C 9X.
767 * printf has two new specifiers %a and %A to print hexadecimal flaoting-point
768   numbers.
770 * scanf recognizes the %a and %A format for scanning floating point numbers.
772 * the new headers <stdint.h> and <inttypes.h> from ISO C 9X provides
773   information and interfaces for the available integer types.
775 * about 130 new math functions were added to implement the ISO C9x math
776   library.
778 * the new header <complex.h> contains definitions of the complex math
779   functions from ISO C 9X.
781 * the new header <tgmath.h> defines generic macros to use complex or
782   real valued functions.
784 * Thorsten Kukuk provided an implementation for NIS+, securelevel 0, 1 and 2.
786 * Andreas Jaeger provided a test suite for the math library.
788 * Mark Kettenis implemented the utmpx interface and an utmp daemon.
790 * Ulrich Drepper added character set conversion functions (iconv).
792 * Optimized string functions have been added.
794 * The localedata addon is now part of glibc.
796 * An implementation of profiling shared libraries was added by Ulrich Drepper.
798 * Thorsten Kukuk and Ulrich Drepper provided an implementation for a caching
799   daemon for NSS (nscd).
801   Missing a better place here are some numbers on improvements.  Under
802   Linux 2.1.125 un-tar-ing the kernel sources takes
804                                   user  system     wall
806     using local files           12.19s   6.88s   22.91s
808     using NIS                   13.92s   8.91s   26.34s
810     using NIS & nscd            10.37s   7.34s   25.30s
812     using NIS+                  27.57s  30.37s  640.46s
814     using NIS+ & nscd           10.25s   7.83s   26.51s
816     using NIS & old nscd [1]    13.83s   8.32s   29.60s
818   Keep in mind that non-namelookup related operations dominate above times.
819   It was just a common complain that using NIS+ unpacking the kernel is
820   horribly slow.
822   [1] The old nscd implementation is not available anymore since it was
823   distributed with glibc up to version 2.0.98 and thus is now replaced.
825 * Tim Waugh provided an implementation of the POSIX.2 wordexp function family.
827 * Mark Kettenis provided a Hesiod NSS module.
829 * The ELF dynamic loader knows how to process dynamic string tokens ($ORIGIN
830   and $PLATFORM) in RPATHs and similar strings (Ulrich Drepper).
832 * rcmd can now handle netgroups (Dick Streefland).
834 * A port to the ARM was contributed by Phil Blundell, Pat Beirne and Scott
835   Bambrough.
837 * Support for the IPv6 protocol has been added to the socket API, as per the
838   latest draft standards.
840 * Support for Linux 2.2 has been added.
842 * Interface changes relative to the latest 2.0.x release:
843 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
844 addseverity                     NEW: Unix98
845 alphasort64                     NEW: LFS
846 argp_err_exit_status            NEW: argp, GNU ext
847 argp_error                      NEW: argp, GNU ext
848 argp_failure                    NEW: argp, GNU ext
849 argp_help                       NEW: argp, GNU ext
850 argp_parse                      NEW: argp, GNU ext
851 argp_program_bug_address        NEW: argp, GNU ext
852 argp_program_version            NEW: argp, GNU ext
853 argp_program_version_hook       NEW: argp, GNU ext
854 argp_state_help                 NEW: argp, GNU ext
855 argp_usage                      NEW: argp, GNU ext
856 authdes_create                  NEW: Secure RPC
857 authdes_getucred                NEW: Secure RPC
858 authdes_pk_create               NEW: Secure RPC
859 backtrace                       NEW: GNU ext.
860 backtrace_symbols               NEW: GNU ext.
861 backtrace_symbols_fd            NEW: GNU ext.
862 cacos                           NEW: ISO C 9x
863 cacosf                          NEW: ISO C 9x
864 cacosh                          NEW: ISO C 9x
865 cacoshf                         NEW: ISO C 9x
866 cacoshl                         NEW: ISO C 9x
867 cacosl                          NEW: ISO C 9x
868 capget                          NEW: kernel
869 capset                          NEW: kernel
870 carg                            NEW: ISO C 9x
871 cargf                           NEW: ISO C 9x
872 cargl                           NEW: ISO C 9x
873 casin                           NEW: ISO C 9x
874 casinf                          NEW: ISO C 9x
875 casinh                          NEW: ISO C 9x
876 casinhf                         NEW: ISO C 9x
877 casinhl                         NEW: ISO C 9x
878 casinl                          NEW: ISO C 9x
879 catan                           NEW: ISO C 9x
880 catanf                          NEW: ISO C 9x
881 catanh                          NEW: ISO C 9x
882 catanhf                         NEW: ISO C 9x
883 catanhl                         NEW: ISO C 9x
884 catanl                          NEW: ISO C 9x
885 cbc_crypt                       NEW: Secure RPC
886 ccos                            NEW: ISO C 9x
887 ccosf                           NEW: ISO C 9x
888 ccosh                           NEW: ISO C 9x
889 ccoshf                          NEW: ISO C 9x
890 ccoshl                          NEW: ISO C 9x
891 ccosl                           NEW: ISO C 9x
892 cexp                            NEW: ISO C 9x
893 cexpf                           NEW: ISO C 9x
894 cexpl                           NEW: ISO C 9x
895 cimag                           NEW: ISO C 9x
896 cimagf                          NEW: ISO C 9x
897 cimagl                          NEW: ISO C 9x
898 clearerr_locked                 REMOVED
899 clntunix_create                 NEW: sunrpc ext
900 clog                            NEW: ISO C 9x
901 clog10                          NEW: ISO C 9x
902 clog10f                         NEW: ISO C 9x
903 clog10l                         NEW: ISO C 9x
904 clogf                           NEW: ISO C 9x
905 clogl                           NEW: ISO C 9x
906 conj                            NEW: ISO C 9x
907 conjf                           NEW: ISO C 9x
908 conjl                           NEW: ISO C 9x
909 cpow                            NEW: ISO C 9x
910 cpowf                           NEW: ISO C 9x
911 cpowl                           NEW: ISO C 9x
912 cproj                           NEW: ISO C 9x
913 cprojf                          NEW: ISO C 9x
914 cprojl                          NEW: ISO C 9x
915 creal                           NEW: ISO C 9x
916 crealf                          NEW: ISO C 9x
917 creall                          NEW: ISO C 9x
918 creat64                         NEW: LFS
919 csin                            NEW: ISO C 9x
920 csinf                           NEW: ISO C 9x
921 csinh                           NEW: ISO C 9x
922 csinhf                          NEW: ISO C 9x
923 csinhl                          NEW: ISO C 9x
924 csinl                           NEW: ISO C 9x
925 csqrt                           NEW: ISO C 9x
926 csqrtf                          NEW: ISO C 9x
927 csqrtl                          NEW: ISO C 9x
928 ctan                            NEW: ISO C 9x
929 ctanf                           NEW: ISO C 9x
930 ctanh                           NEW: ISO C 9x
931 ctanhf                          NEW: ISO C 9x
932 ctanhl                          NEW: ISO C 9x
933 ctanl                           NEW: ISO C 9x
934 des_setparity                   NEW: Secure RPC
935 ecb_crypt                       NEW: Secure RPC
936 endutxent                       NEW: Unix98
937 exp10                           NEW: ISO C 9x
938 exp10f                          NEW: ISO C 9x
939 exp10l                          NEW: ISO C 9x
940 exp2                            NEW: ISO C 9x
941 exp2f                           NEW: ISO C 9x
942 exp2l                           NEW: ISO C 9x
943 fattach                         NEW: STREAMS
944 fdetach                         NEW: STREAMS
945 fdim                            NEW: ISO C 9x
946 fdimf                           NEW: ISO C 9x
947 fdiml                           NEW: ISO C 9x
948 feclearexcept                   NEW: ISO C 9x
949 fegetenv                        NEW: ISO C 9x
950 fegetexceptflag                 NEW: ISO C 9x
951 fegetround                      NEW: ISO C 9x
952 feholdexcept                    NEW: ISO C 9x
953 feof_locked                     REMOVED
954 feraiseexcept                   NEW: ISO C 9x
955 ferror_locked                   REMOVED
956 fesetenv                        NEW: ISO C 9x
957 fesetexceptflag                 NEW: ISO C 9x
958 fesetround                      NEW: ISO C 9x
959 fetestexcept                    NEW: ISO C 9x
960 feupdateenv                     NEW: ISO C 9x
961 fflush_locked                   REMOVED
962 ffsl                            NEW: GNU ext.
963 ffsll                           NEW: GNU ext.
964 fgetpos64                       NEW: LFS
965 fgets_unlocked                  NEW: GNU ext.
966 fileno_locked                   REMOVED
967 fma                             NEW: ISO C 9x
968 fmaf                            NEW: ISO C 9x
969 fmal                            NEW: ISO C 9x
970 fmax                            NEW: ISO C 9x
971 fmaxf                           NEW: ISO C 9x
972 fmaxl                           NEW: ISO C 9x
973 fmin                            NEW: ISO C 9x
974 fminf                           NEW: ISO C 9x
975 fminl                           NEW: ISO C 9x
976 fmtmsg                          NEW: Unix98
977 fopen64                         NEW: LFS
978 fputc_locked                    REMOVED
979 fputs_unlocked                  NEW: GNU ext.
980 fread_unlocked                  NEW: GNU ext.
981 freopen64                       NEW: LFS
982 fseeko                          NEW: Unix98
983 fsetpos64                       NEW: LFS
984 fstatfs64                       NEW: LFS
985 fstatvfs                        NEW: Unix98
986 fstatvfs64                      NEW: LFS
987 ftello                          NEW: Unix98
988 ftello64                        NEW: LFS
989 ftruncate64                     NEW: LFS
990 ftw64                           NEW: LFS
991 fwrite_unlocked                 NEW: GNU ext.
992 gai_strerror                    NEW: IPv6
993 gamma_r                         REMOVED
994 gammaf_r                        REMOVED
995 gammal_r                        REMOVED
996 getchar_locked                  REMOVED
997 getdate                         NEW: Unix98
998 getdate_err                     NEW: Unix98
999 getdate_r                       NEW: GNU ext.
1000 getmsg                          NEW: STREAMS
1001 getnameinfo                     NEW: IPv6
1002 getnetname                      NEW: Secure RPC
1003 getpmsg                         NEW: STREAMS
1004 getpt                           NEW: Unix98 PTY
1005 getrlimit64                     NEW: LFS
1006 getutxent                       NEW: Unix98
1007 getutxid                        NEW: Unix98
1008 getutxline                      NEW: Unix98
1009 glob64                          NEW: GNU ext.
1010 globfree64                      NEW: GNU ext.
1011 gnu_get_libc_release            NEW: GNU ext.
1012 gnu_get_libc_version            NEW: GNU ext.
1013 grantpt                         NEW: Unix98 PTY
1014 host2netname                    NEW: Secure RPC
1015 iconv                           NEW: iconv
1016 iconv_close                     NEW: iconv
1017 iconv_open                      NEW: iconv
1018 if_freenameindex                NEW: IPv6
1019 if_indextoname                  NEW: IPv6
1020 if_nameindex                    NEW: IPv6
1021 if_nametoindex                  NEW: IPv6
1022 in6addr_any                     NEW: IPv6
1023 in6addr_loopback                NEW: IPv6
1024 inet6_isipv4mapped              NEW: IPv6
1025 isastream                       NEW: STREAMS
1026 iswblank                        NEW: GNU ext.
1027 key_decryptsession              NEW: Secure RPC
1028 key_decryptsession_pk           NEW: Secure RPC
1029 key_encryptsession              NEW: Secure RPC
1030 key_encryptsession_pk           NEW: Secure RPC
1031 key_gendes                      NEW: Secure RPC
1032 key_get_conv                    NEW: Secure RPC
1033 key_secretkey_is_set            NEW: Secure RPC
1034 key_setnet                      NEW: Secure RPC
1035 key_setsecret                   NEW: Secure RPC
1036 llrint                          NEW: ISO C 9x
1037 llrintf                         NEW: ISO C 9x
1038 llrintl                         NEW: ISO C 9x
1039 llround                         NEW: ISO C 9x
1040 llroundf                        NEW: ISO C 9x
1041 llroundl                        NEW: ISO C 9x
1042 log2                            NEW: ISO C 9x
1043 log2f                           NEW: ISO C 9x
1044 log2l                           NEW: ISO C 9x
1045 lrint                           NEW: ISO C 9x
1046 lrintf                          NEW: ISO C 9x
1047 lrintl                          NEW: ISO C 9x
1048 lround                          NEW: ISO C 9x
1049 lroundf                         NEW: ISO C 9x
1050 lroundl                         NEW: ISO C 9x
1051 lseek64                         NEW: LFS
1052 makecontext                     NEW: Unix98
1053 mempcpy                         NEW: GNU ext.
1054 mmap64                          NEW: LFS
1055 moncontrol                      REMOVED
1056 modify_ldt                      NEW: kernel
1057 nan                             NEW: ISO C 9x
1058 nanf                            NEW: ISO C 9x
1059 nanl                            NEW: ISO C 9x
1060 nearbyint                       NEW: ISO C 9x
1061 nearbyintf                      NEW: ISO C 9x
1062 nearbyintl                      NEW: ISO C 9x
1063 netname2host                    NEW: Secure RPC
1064 netname2user                    NEW: Secure RPC
1065 nexttoward                      NEW: ISO C 9x
1066 nexttowardf                     NEW: ISO C 9x
1067 nexttowardl                     NEW: ISO C 9x
1068 nftw                            NEW: Unix98
1069 nftw64                          NEW: LFS
1070 open64                          NEW: LFS
1071 passwd2des                      NEW: Secure RPC
1072 pow10                           NEW: GNU ext.
1073 pow10f                          NEW: GNU ext.
1074 pow10l                          NEW: GNU ext.
1075 pread                           NEW: Unix98
1076 pread64                         NEW: LFS
1077 printf_size                     NEW: GNU ext.
1078 printf_size_info                NEW: GNU ext.
1079 profil_counter                  REMOVED
1080 pthread_mutexattr_getkind_np    REPLACED
1081 pthread_mutexattr_setkind_np    REPLACED
1082 ptsname                         NEW: Unix98 PTY
1083 ptsname_r                       NEW: Unix98 PTY
1084 putc_locked                     REMOVED
1085 putchar_locked                  REMOVED
1086 putgrent                        NEW: GNU ext.
1087 putmsg                          NEW: STREAMS
1088 putpmsg                         NEW: STREAMS
1089 pututxline                      NEW: Unix98
1090 pwrite                          NEW: Unix98
1091 pwrite64                        NEW: LFS
1092 readdir64                       NEW: LFS
1093 readdir64_r                     NEW: LFS
1094 remquo                          NEW: ISO C 9x
1095 remquof                         NEW: ISO C 9x
1096 remquol                         NEW: ISO C 9x
1097 round                           NEW: ISO C 9x
1098 roundf                          NEW: ISO C 9x
1099 roundl                          NEW: ISO C 9x
1100 rtime                           NEW: GNU ext.
1101 scalbln                         NEW: ISO C 9x
1102 scalblnf                        NEW: ISO C 9x
1103 scalblnl                        NEW: ISO C 9x
1104 scandir64                       NEW: LFS
1105 sendfile                        NEW: kernel
1106 setcontext                      NEW: Unix98
1107 setrlimit64                     NEW: LFS
1108 setutxent                       NEW: Unix98
1109 sighold                         NEW: Unix98
1110 sigignore                       NEW: Unix98
1111 sigqueue                        NEW: POSIX.1b
1112 sigrelse                        NEW: Unix98
1113 sigset                          NEW: POSIX.1b
1114 sigtimedwait                    NEW: POSIX.1b
1115 sigwaitinfo                     NEW: POSIX.1b
1116 sincos                          NEW: GNU ext.
1117 sincosf                         NEW: GNU ext.
1118 sincosl                         NEW: GNU ext.
1119 statfs64                        NEW: LFS
1120 statvfs                         NEW: Unix98
1121 statvfs64                       NEW: LFS
1122 strcasestr                      NEW: GNU ext.
1123 strtoimax                       NEW: ISO C 9x
1124 strtoumax                       NEW: ISO C 9x
1125 strverscmp                      NEW: GNU ext.
1126 svcauthdes_stats                NEW: Secure RPC
1127 svcunix_create                  NEW: sunrpc etx
1128 svcunixfd_create                NEW: sunrpc ext
1129 swapcontext                     NEW: Unix98
1130 tcgetsid                        NEW: Unix98 PTY
1131 tdestroy                        NEW: GNU ext.
1132 tgamma                          NEW: ISO C 9x
1133 tgammaf                         NEW: ISO C 9x
1134 tgammal                         NEW: ISO C 9x
1135 tmpfile64                       NEW: LFS
1136 trunc                           NEW: ISO C 9x
1137 truncate64                      NEW: LFS
1138 truncf                          NEW: ISO C 9x
1139 truncl                          NEW: ISO C 9x
1140 umount2                         NEW: kernel
1141 unlockpt                        NEW: Unix98 PTY
1142 updwtmpx                        NEW: Unix98
1143 user2netname                    NEW: Secure RPC
1144 utmpxname                       NEW: Unix98
1145 versionsort                     NEW: GNU ext.
1146 versionsort64                   NEW: GNU ext.
1147 waitid                          NEW: Unix98
1148 wcscasecmp                      NEW: GNU ext.
1149 wcsncasecmp                     NEW: GNU ext.
1150 wcsnlen                         NEW: GNU ext.
1151 wcstoimax                       NEW: ISO C 9x
1152 wcstoll                         NEW: ISO C 9x
1153 wcstoull                        NEW: ISO C 9x
1154 wcstoumax                       NEW: ISO C 9x
1155 wcswcs                          NEW: Unix98
1156 wordexp                         NEW: POSIX.2
1157 wordfree                        NEW: POSIX.2
1158 write_profiling                 REMOVED
1159 xdecrypt                        NEW: Secure RPC
1160 xdr_authdes_cred                NEW: Secure RPC
1161 xdr_authdes_verf                NEW: Secure RPC
1162 xdr_cryptkeyarg                 NEW: Secure RPC
1163 xdr_cryptkeyarg2                NEW: Secure RPC
1164 xdr_cryptkeyres                 NEW: Secure RPC
1165 xdr_getcredres                  NEW: Secure RPC
1166 xdr_key_netstarg                NEW: Secure RPC
1167 xdr_key_netstres                NEW: Secure RPC
1168 xdr_keybuf                      NEW: Secure RPC
1169 xdr_keystatus                   NEW: Secure RPC
1170 xdr_netnamestr                  NEW: Secure RPC
1171 xdr_sizeof                      NEW: Secure RPC
1172 xdr_unixcred                    NEW: sunrpc ext
1173 xencrypt                        NEW: Secure RPC
1174 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1176 Version 2.0.6
1178 * more bug fixes
1181 Version 2.0.5
1183 * more bug fixes
1185 * inet_ntoa is thread-safe
1187 * updwtmp is moved from libutil to libc
1189 * rewrite of cbrt function
1191 * update of timezone data
1193 Version 2.0.4
1195 * more bug fixes
1197 Version 2.0.3
1199 * more bug fixes
1201 Version 2.0.2
1203 * more bug fixes
1205 * add atoll function
1207 * fix complex problems in Berkeley DB code
1209 * fix math functions
1211 Version 2.0.1
1213 * fixed lots of header problems (especially Linux/GNU specific)
1215 * dynamic loader preserves all registers
1217 * Roland McGrath provided support for handling of auxiliary objects in
1218   the ELF dynamic loader.
1220 * support for parallel builds is improved
1222 Version 2.0
1224 * GNU extensions are no longer declared by default.  To enable them you
1225   must define the macro `_GNU_SOURCE' in your program or compile with
1226   `-D_GNU_SOURCE'.
1228 * The library has changed from using GNU ld symbol aliases to using weak
1229   symbols where available.  The ELF object file format supports weak
1230   symbols; GNU ld also supports weak symbols in the a.out format.  (There
1231   is also now support for other GNU ld extensions in ELF.  Use the
1232   `--with-elf' option to configure to indicate you have ELF, and
1233   `--with-gnu-ld' if using GNU ld.)  This change resulted in the deletion
1234   of many files which contained only symbol aliases, reducing the size of
1235   the source and the compiled library; many other files were renamed to
1236   less cryptic names previously occupied by the symbol alias files.
1237   There is a new header file <elf.h> for programs which operate on
1238   files in the ELF format.
1240 * Converted to Autoconf version 2, so `configure' has more options.
1241   Run `configure --help' to see the details.
1243 * The library can now be configured to build profiling, highly-optimized
1244   (but undebuggable), and/or shared libraries (ELF with GNU ld only).  The
1245   `--enable-profile', `--enable-omitfp', and `--enable-shared' options to
1246   `configure' enable building these extra libraries.  The shared library is
1247   built by default when using both ELF and GNU ld.  When shared libraries
1248   are enabled, the new library `-ldl' is available for arbitrary run-time
1249   loading of shared objects; its interface is defined in <dlfcn.h>.  The
1250   new header file <link.h> gives access to the internals of the run-time
1251   dynamic linker, `ld.so'.  The shell script `ldd' is similar to the
1252   application of same name on other systems and it provides information
1253   about dynamically linked binaries.
1255 * The C library now provides the run-time support code for profiling
1256   executables compiled with `-pg'.  Programs can control the profiling code
1257   through the interface in <sys/gmon.h>.  The `gmon.out' files written by
1258   the GNU C library can be read only by GNU `gprof' (from GNU binutils);
1259   the support for this file format was contributed by David Mosberger-Tang.
1261 * The math code has been replaced with a math library based on fdlibm from
1262   Sun, and modified by JT Conklin and Ulrich Drepper with i387 support, by
1263   Ian Taylor with `float' functions and by Ulrich Drepper with `long double'
1264   functions.  The math functions now reside in a separate library,  so
1265   programs using them will need to use `-lm' their linking commands.
1267 * John C. Bowman contributed optimized ix87 assembler inline functions.
1269 * Ulrich Drepper has contributed support for an `/etc/nsswitch.conf'
1270   mechanism similar to that found in Solaris 2.  This is now used for the
1271   group, passwd, hosts, networks, services, protocols, rpc, ethers,
1272   shadow, netgroup, publickey, and alias databases.  The `nsswitch.conf'
1273   file controls what services are used for each individual database.  This
1274   works by loading shared libraries with names specified in `nsswitch.conf',
1275   so service modules can be changed or added at any time without even
1276   relinking any program.  Currently there are the file, db, and NIS based
1277   NSS services available.
1279 * The new functions `strtoq' and `strtouq' parse integer values from
1280   strings, like `strtol' and `strtoul', but they return `long long int' and
1281   `unsigned long long int' values, respectively (64-bit quantities).
1283 * The new functions `strtof' and `strtold' parse floating-point values from
1284   strings, like `strtod', but they return `float' and `long double' values,
1285   respectively (on some machines `double' and `long double' are the same).
1287 * Ulrich Drepper has contributed new implementations of the floating-point
1288   printing and reading code used in the `printf' family of functions and
1289   `strtod', `strtof', and `strtold'.  These new functions are perfectly
1290   accurate, and much faster than the old ones.
1292 * The implementation of the POSIX locale model was completely rewritten by
1293   Ulrich Drepper.  This includes the new programs `localedef' and `locale'
1294   to compile the POSIX locale definition.
1296 * The former dummy implementations of the strcoll and strxfrm function are
1297   now replaced by fully functional code contributed by Ulrich Drepper.  The
1298   collation information comes from the POSIX locale definitions.
1300 * The new header <langinfo.h> defines an interface for accessing
1301   various locale-dependent data (using the locale chosen with `setlocale').
1303 * Ulrich Drepper has contributed a new suite of functions for operation on
1304   wide-character and multibyte-character strings, in <wchar.h>;
1305   and classification and case conversion of wide characters, in <wctype.h>.
1306   These new functions are conforming to the ISO C, Amendement 1 specification.
1308 * There is now a second implementation of the standard I/O library available.
1309   It comes from GNU libg++ as was written by Per Bothner, heavily modified
1310   by Hongjiu Lu and made thread safe by Ulrich Drepper.
1312 * You can now use positional parameter specifications in format strings
1313   for the `printf' and `scanf' families of functions.  For example,
1314   `printf ("Number %2$d, Mr %1$s\n", "Jones", 6);'' prints
1315   ``Number 6, Mr Jones''.  This is mainly useful when providing different
1316   format strings for different languages, whose grammars may dictate
1317   different orderings of the values being printed.  To support this
1318   feature, the interface for `register_printf_handler' has changed; see
1319   the header file <printf.h> for details.
1321 * The `printf' and `scanf' families of functions now understand a new
1322   formatting flag for numeric conversions: the ' flag (e.g. %'d or %'f) says
1323   to group numbers as indicated by the locale; for `scanf' and friends, this
1324   says to accept as valid only a number with all the proper grouping
1325   separators in the right places.  In the default "C" locale, numbers are
1326   not grouped; but locales for specific countries will define the usual
1327   conventions (i.e. separate thousands with `,' in the US locale).
1329 * The pgrp functions have been regularized, slightly incompatibly but much
1330   less confusingly.  The core functions are now `getpgid' and `setpgid',
1331   which take arguments for the PID to operate on; the POSIX.1 `getpgrp' (no
1332   argument) and BSD `setpgrp' (identical to `setpgid') functions are
1333   provided for compatibility.  There is no longer an incompatible `getpgrp'
1334   with an argument declared under _BSD_SOURCE; no BSD code uses it.
1336 * The new header file <fts.h> and suite of functions simplify programs that
1337   operate on directory trees.  This code comes from 4.4 BSD.
1339 * The resolver code has been updated from the BIND 4.9.5-P1 release.
1340   Parts of the code were heavily modified by Ulrich Drepper to fit in the
1341   NSS scheme used in glibc.
1343 * There is a new malloc debugging hook `__memalign_hook'.
1345 * There are new typedefs `ushort' for `unsigned short int' and `uint' for
1346   `unsigned int' in <sys/types.h>.  These are for compatibility only and
1347   their use is discouraged.
1349 * The `-lmcheck' library to enable standard malloc debugging hooks is now
1350   done differently, so that it works even without GNU ld.
1352 * New function `euidaccess' checks allowed access to a file like `access',
1353   but using the effective IDs instead of the real IDs.
1355 * The time zone data files have been updated for the latest and greatest
1356   local time conventions of the countries of the world.
1358 * The new function `dirfd' extracts the file descriptor used by a DIR stream;
1359   see <dirent.h>.
1361 * The new functions `ecvt', `fcvt', and `gcvt' provide an obsolete interface
1362   for formatting floating-point numbers.  They are provided only for
1363   compatibility; new programs should use `sprintf' instead.  There are
1364   also equivalent function for the `long double' floating-point type and
1365   all functions also exist in a reentrant form.
1367 * The new auxiliary library `-lutil' from 4.4 BSD contains various
1368   functions for maintaining the login-record files (primarily of use to
1369   system programs such as `login'), and convenient functions for
1370   allocating and initializing a pseudo-terminal (pty) device.
1372 * Ulrich Drepper has contributed new support for System V style
1373   shared memory and IPC on systems that support it.
1375 * Ulrich Drepper has contributed several miscellaneous new functions found
1376   in System V: The `hsearch' family of functions provide an effective
1377   implementation of hash tables; `a64l' and `l64a' provide a very simple
1378   binary to ASCII mapping; `drand48' and friends provide a 48-bit random
1379   number generator.
1381 * Ulrich Drepper has contributed new reentrant counterparts for the
1382   `random' and `hsearch' families of functions; `random_r', `hsearch_r', etc.
1384 * Ulrich Drepper has contributed new, highly-optimized versions of several
1385   string functions for the i486/Pentium family of processors.
1387 * Ulrich Drepper has updated the Linux-specific code, based largely
1388   on work done in Hongjiu Lu's version of GNU libc for Linux.
1389   The GNU library now supports Linux versions 2.0.10 and later,
1390   using the ELF object file format (i[3456]86-*-linux).
1392 * Andreas Schwab has ported the C library to Linux/m68k (m68k-*-linux).
1394 * David Mosberger-Tang and Richard Henderson have ported the C library
1395   to Linux/Alpha (alpha-*-linux).  Richard Henderson contributed the
1396   dynamic linking support for ELF/Alpha.
1398 * Richard Henderson contributed several Alpha optimized assembler function
1399   for arithmetic and string handling.
1401 * Ulrich Drepper has contributed a new set of message catalog functions to
1402   support multiple languages using the <libintl.h> interface, for use with
1403   his new package GNU gettext.  Translation volunteers have contributed
1404   catalogs of the library's messages in Spanish, German, and Korean.
1406 * For compatibility with XPG4, Ulrich Drepper has contributed the `gencat'
1407   program and the `catgets' function for reading the catalog files it
1408   creates.  (The <libintl.h> interface is preferred; we include the
1409   <nl_types.h> interface using `catgets' only for source compatibility with
1410   programs already written to use it.)
1412 * New header file <values.h> gives SVID-compatible names for <limits.h>
1413   constants.
1415 * Various new macros, declarations, and small header files for compatibility
1416   with 4.4 BSD.
1418 * New function `group_member' is a convenient way to check if a process has
1419   a given effective group ID.
1421 * When using GCC 2.7 and later, the socket functions are now declared in a
1422   special way so that passing an argument of type `struct sockaddr_in *',
1423   `struct sockaddr_ns *', or `struct sockaddr_un *' instead of the generic
1424   `struct sockaddr *' type, does not generate a type-clash warning.
1426 * New function `error' declared in header file <error.h> is a convenient
1427   function for printing error messages and optionally exiting; this is the
1428   canonical function used in GNU programs.  The new functions `err', `warn',
1429   and friends in header file <err.h> are the canonical 4.4 BSD interface for
1430   doing the same thing.
1432 * The <glob.h> interface has several new flags from 4.4 BSD that extend the
1433   POSIX.2 `glob' function to do ~ and {...} expansion.
1435 * New function `unsetenv' complements `setenv' for compatibility with 4.4 BSD.
1436   `clearenv' which is used in POSIX.9 is also available.
1438 * New function `getsid' returns session ID number on systems that support it.
1440 * We have incorporated the 4.4 BSD `db' library (version 1.85).  New header
1441   files <db.h> and <mpool.h> provide a rich set of functions for several
1442   types of simple databases stored in memory and in files, and <ndbm.h> is
1443   an old `ndbm'-compatible interface using the `db' functions.  Link with
1444   `-ldb' to get these functions.
1446 * New macro `strdupa' copies a string like `strdup', but uses local stack
1447   space from `alloca' instead of dynamic heap space from `malloc'.
1449 * New function `strnlen' is like `strlen' but searches only a given maximum
1450   number of characters for the null terminator.  `stpncpy', `strndup' and
1451   `strndupa' are similar variants for the `stpcpy', `strdup' and `strdupa'
1452   function.
1454 * New function `statfs' in header <sys/statfs.h>.
1456 * The new <argz.h> and <envz.h> interfaces contributed by Miles Bader
1457   provide convenient functions for operating on blocks of null-terminated
1458   strings.
1460 * A new suite of functions in <utmp.h> handle all the details of reading
1461   and writing the utmp file.
1463 * An implementation of the NIS/YP(tm) based NSS service was contributed by
1464   Thorsten Kukuk.
1466 * Paul Eggert and Ulrich Drepper modified the `strftime' function to be
1467   completely POSIX compliant and also implemented the extended functionality
1468   to handle alternate digit representation and alternate era date formats.
1470 * Ulrich Drepper provided an implementation of the `strptime' function
1471   defined in XPG4.2 which transforms a string into a `struct tm' value.
1473 * Paul Eggert provided the tzselect shell script as part of the timezone
1474   code.  The shell script makes it easy to select the correct timezone
1475   specification.
1477 * The implementation of the malloc family of functions is completely replaced
1478   by a new implementation by Doug Lea with many improvements by Wolfram Gloger.
1479   The implementation uses the mmap function (if available) and it is
1480   optimized for the use in multi threaded programs.
1482 * Ulrich Drepper contributed a MD5 "encryption" for the crypt family of
1483   functions.  This new functionality is usable by specifying a special
1484   salt string and it is compatible with implementation on *BSD systems.
1486 * Lots of functions from the XPG4.2 standard were added by Ulrich Drepper:
1487   `getsubopt' to handle second level command line options, `bsd_signal'
1488   to access BSD style `signal' functionality, the obsolete `regexp' style
1489   expression matcher.
1491 * the `lchown' function is available on system which support this
1492   functionality.
1494 * The implementation of the shadow password handling function was contributed
1495   by Ulrich Drepper.
1497 * David Mosberger-Tang changed the SunRPC implementation to be 64bit safe.
1499 * POSIX.1g support was added.  The <sys/select.h> header is available,
1500   `isfdtype' and `pselect' are implemented.  Craig Metz contributed an
1501   implementation of `getaddrinfo'.
1503 Version 1.09
1505 * For cross-compilation you should now set `BUILD_CC' instead of `HOST_CC'.
1507 * New header file <fstab.h> and new functions `getfsspec', `getfsent' and
1508   friends, for parsing /etc/fstab.  This code comes from 4.4 BSD.
1510 * The new function `daemon' from 4.4 BSD is useful for server programs that
1511   want to put themselves in the background.
1513 * Joel Sherrill has contributed support for several standalone boards that
1514   run without an operating system.
1516 * `printf', `scanf' and friends now accept a `q' type modifier for long
1517   long int as well as `ll'.  Formats using these might be `%qu' or `%lld'.
1519 * All of the code taken from BSD (notably most of the math and networking
1520   routines) has been updated from the BSD 4.4-Lite release.
1522 * The resolver code has been updated from the BIND-4.9.3-BETA9 release.
1524 * The new functions `getdomainname' and `setdomainname' fetch or change the
1525   YP/NIS domain name.  These are system calls which exist on systems which
1526   have YP (aka NIS).
1528 * The time zone data files have been updated for the latest international
1529   conventions.
1531 * The SunRPC programs `portmap' and `rpcinfo' are now installed in
1532   $(sbindir) (usually /usr/local/sbin) instead of $(bindir).
1534 Version 1.08
1536 * The C library now includes support for Sun RPC, from Sun's free
1537   RPCSRC-4.0 distribution.  The `portmap', `rpcinfo', and `rpcgen' programs
1538   are included.  (There is still no support for YP.)
1540 * Tom Quinn has contributed a port of the C library to SGI machines running
1541   Irix 4 (mips-sgi-irix4).
1543 * The new `lockf' function is a simplified interface to the locking
1544   facilities of `fcntl', included for compatibility.
1546 * New time functions `timegm', `timelocal', and `dysize' for compatibility.
1548 * New header file <sys/timeb.h> and new function `ftime' for compatibility.
1550 * New header files <poll.h> and <sys/poll.h> and new function `poll' for
1551   compatibility.
1553 * The error message printed by `assert' for a failed assertion now includes
1554   the name of the program (if using GNU ld) and the name of the calling
1555   function (with versions of GCC that support this).
1557 * The `psignal' function is now declared in <signal.h>, not <stdio.h>.
1559 * The library now includes the <sys/mman.h> header file and memory
1560   management functions `mmap', `munmap', `mprotect', `msync', and
1561   `madvise', on systems that support those facilities.
1563 * The interface for `mcheck' has changed slightly: the function called to
1564   abort the program when an allocation inconsistency is detected now takes
1565   an argument that indicates the type of failure.  The new function
1566   `mprobe' lets you request a consistency check for a particular block at
1567   any time (checks are normally done only when you call `free' or `realloc'
1568   on a block).
1570 * It is now possible to easily cross-compile the C library, building on one
1571   system a library to run on another machine and/or operating system.  All
1572   you need to do is set the variable `HOST_CC' in `configparms' to the
1573   native compiler for programs to run on the machine you are building on (a
1574   few generator programs are used on Unix systems); set `CC' to the
1575   cross-compiler.
1577 * The new function `fexecve' (only implemented on the GNU system) executes
1578   a program file given a file descriptor already open on the file.
1580 Version 1.07
1582 * Brendan Kehoe has contributed most of a port to the DEC Alpha
1583   running OSF/1 (alpha-dec-osf1).  He says it is 75% complete.
1585 * You can set the variable `libprefix' in `configparms' to specify a prefix
1586   to be prepended to installed library files; this makes it easy to install
1587   the GNU C library to be linked as `-lgnuc' or whatever.
1589 * The new `stpncpy' is a cross between `stpcpy' and `strncpy': It
1590   copies a limited number of characters from a string, and returns the
1591   address of the last character written.
1593 * You no longer need to check for whether the installed `stddef.h' is
1594   compatible with the GNU C library.  configure now checks for you.
1596 * You can now define a per-stream `fileno' function to convert the
1597   stream's cookie into an integral file descriptor.
1599 * ``malloc (0)'' no longer returns a null pointer.  Instead, it
1600   allocates zero bytes of storage, and returns a unique pointer which
1601   you can pass to `realloc' or `free'.  The behavior is undefined if
1602   you dereference this pointer.
1604 * The C library now runs on Sony NEWS m68k machines running either
1605   NewsOS 3 or NewsOS 4.
1607 * The new `syscall' function is a system-dependent primitive function
1608   for invoking system calls.  It has the canonical behavior on Unix
1609   systems, including unreliable return values for some calls (such as
1610   `pipe', `fork' and `getppid').
1612 * The error code `EWOULDBLOCK' is now obsolete; it is always defined
1613   to `EAGAIN', which is the preferred name.  On systems whose kernels
1614   use two distinct codes, the C library now translates EWOULDBLOCK to
1615   EAGAIN in every system call function.
1617 Version 1.06
1619 * The GNU C Library Reference Manual is now distributed with the library.
1620   `make dvi' will produce a DVI file of the printed manual.
1621   `make info' will produce Info files that you can read on line using C-h i
1622   in Emacs or the `info' program.
1623   Please send comments on the manual to bug-glibc-manual@gnu.org.
1625 * The library now supports SVR4 on i386s (i386-unknown-sysv4).
1627 * Brendan Kehoe has contributed a port to Sun SPARCs running Solaris 2.
1629 * Jason Merrill has contributed a port to the Sequent Symmetry running
1630   Dynix version 3 (i386-sequent-dynix).
1632 * The library has been ported to i386s running SCO 3.2.4 (also known as SCO
1633   ODT 2.0; i386-unknown-sco3.2.4) or SCO 3.2 (i386-unknown-sco3.2).
1635 * New function `memory_warnings' lets you arrange to get warnings when
1636   malloc is running out of memory to allocate, like Emacs gives you.
1638 * The C library now contains the relocating allocator used in Emacs 19 for
1639   its editing buffers.  This allocator (ralloc) minimizes allocation
1640   overhead and fragmentation by moving allocated regions around whenever it
1641   needs to.  You always refer to a ralloc'd region with a "handle" (a
1642   pointer to a pointer--an object of type `void **').
1644 * There is a new `printf' format: `%m' gives you the string corresponding
1645   to the error code in `errno'.
1647 * In `scanf' formats, you can now use `%as' or `%a[' to do the normal `%s'
1648   or `%[' conversion, but instead of filling in a fixed-sized buffer you
1649   pass, the `a' modifier says to fill in a `char **' you pass with a
1650   malloc'd string.
1652 * The `fnmatch' function supports the new flag bits `FNM_LEADING_DIR' and
1653   `FNM_CASEFOLD'.  `FNM_LEADING_DIR' lets a pattern like `foo*' match a
1654   name like `foo/bar'.  `FNM_CASEFOLD' says to ignore case in matching.
1656 * `mkstemp' is a traditional Unix function to atomically create and open a
1657   uniquely-named temporary file.
1659 Version 1.05
1661 * The standard location for the file that says what the local timezone is
1662   has changed again.  It is now `/usr/local/etc/localtime' (or more
1663   precisely, `${prefix}/etc/localtime') rather than `/etc/localtime'.
1665 * The distribution no longer contains any files with names longer than 14
1666   characters.
1668 * `struct ttyent' has two new flag bits: TTY_TRUSTED and TTY_CONSOLE.
1669   These are set by the new `trusted' and `console' keywords in `/etc/ttys'.
1671 * New functions `ttyslot' and `syslog' from 4.4 BSD.
1673 Version 1.04
1675 * The configuration process has changed quite a bit.  The `configure'
1676   script is now used just like the configuration scripts for other GNU
1677   packages.  The `sysdeps' directory hierarchy is much rearranged.
1678   The file `INSTALL' explains the new scheme in detail.
1680 * The header files no longer need to be processed into ANSI C and
1681   traditional C versions.  There is just one set of files to install, and
1682   it will work with ANSI or old C compilers (including `gcc -traditional').
1684 * Brendan Kehoe and Ian Lance Taylor have ported the library to the
1685   MIPS DECStation running Ultrix 4.
1687 * The Sun 4 startup code (crt0) can now properly load SunOS 4 shared libraries.
1688   Tom Quinn contributed the initial code.  The GNU C library can NOT yet be
1689   made itself into a shared library.
1691 * Yet further improved support for the i386, running 4.3 BSD-like systems
1692   (such as Mach 3 with the Unix single-server), or System V.
1694 * New function `strncasecmp' to do case-insensitive string comparison
1695   with limited length.
1697 * New function `strsep' is a reentrant alternative to `strtok'.
1699 * New functions `scandir' and `alphasort' for searching directories.
1701 * New function `setenv' is a better interface to `putenv'.
1703 * Ian Lance Taylor has contributed an implementation of the SVID `ftw'
1704   function for traversing a directory tree.
1706 * The GNU obstack package is now also part of the C library.
1707   The new function `open_obstack_stream' creates a stdio stream that
1708   writes onto an obstack; `obstack_printf' and `obstack_vprintf' do
1709   formatted output directly to an obstack.
1711 * Miscellaneous new functions: reboot, nice, sigaltstack (4.4 BSD only),
1712   cfmakeraw, getusershell, getpass, swab, getttyent, seteuid, setegid.
1714 * `FNM_FILE_NAME' is another name for `FNM_PATHNAME', used with `fnmatch'.
1716 * The new functions `strfry' and `memfrob' do mysterious and wonderful
1717   things to your strings.
1719 * There are some new test programs: test-fseek, testmb, and testrand.
1721 * Some work has been done to begin porting the library to 4.4 BSD and Linux.
1722   These ports are not finished, but are a good starting place for really
1723   supporting those systems.
1725 * `/etc/localtime' is now the standard location for the file that says what
1726   the local timezone is, rather than `/usr/local/lib/zoneinfo/localtime'.
1727   This follows the general principle that `/etc' is the place for all local
1728   configuration files.
1730 * The C library header files now use `extern "C"' when used by the C++
1731   compiler, so the C library should now work with C++ code.
1733 * The header file <bstring.h> is gone.  <string.h> now declares bcopy,
1734   bcmp, bzero, and ffs.  (Update: nowadays these functions are declared
1735   in <strings.h>.)
1737 * Mike Haertel (of GNU e?grep and malloc fame) has written a new sorting
1738   function which uses the `merge sort' algorithm, and is said to be
1739   significantly faster than the old GNU `qsort' function.  Merge sort is
1740   now the standard `qsort' function.  The new algorithm can require a lot
1741   of temporary storage; so, the old sorting function is called when the
1742   required storage is not available.
1744 * The C library now includes Michael Glad's Ultra Fast Crypt, which
1745   provides the Unix `crypt' function, plus some other entry points.
1747 * The code and header files taken from 4.4 BSD have been updated with the
1748   latest files released from Berkeley.
1750 ----------------------------------------------------------------------
1751 Copyright information:
1753 Copyright (C) 1992-1999,2000,2001,2002,2003,2004,2005,2006
1754         Free Software Foundation, Inc.
1756    Permission is granted to anyone to make or distribute verbatim copies
1757    of this document as received, in any medium, provided that the
1758    copyright notice and this permission notice are preserved,
1759    thus giving the recipient permission to redistribute in turn.
1761    Permission is granted to distribute modified versions
1762    of this document, or of portions of it,
1763    under the above conditions, provided also that they
1764    carry prominent notices stating who last changed them.
1766 Local variables:
1767 version-control: never
1768 End: