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