Update.
[glibc.git] / NEWS
blobac563679b2512d834a2d5aa67f87abc00ca50535
1 GNU C Library NEWS -- history of user-visible changes.  1998-03-04
3 Copyright (C) 1992, 93, 94, 95, 96, 97, 98 Free Software Foundation, Inc.
4 See the end for copying conditions.
6 Please send GNU C library bug reports using the `glibcbug' script to
7 <bugs@gnu.org>.  Questions and suggestions should be send to
8 <bug-glibc@gnu.org>.
9 \f
10 Version 2.1
12 * Richard Henderson corrected size of struct timeval on Linux/Alpha to
13   conform to POSIX member type requirements.  Symbol versions have been
14   adjusted as needed within the library, and for direct use by applications,
15   but there is potential for problems if third-party libraries use
16   struct timeval as part of their interface.  This does not present
17   a problem for X and other "essential" system libraries.
19 * An additional locale model to support C++ Standard Library locale
20   model and probably more was implemented by Ulrich Drepper.
22 * Eric Youngdale and Ulrich Drepper implemented versioning of objects on
23   symbol level.
25 * Miles Bader provided the `argp' function family to support hierachical
26   command line argument parsing, layered on top of getopt.
28 * strtod accepts new hexadecimal floating-point format from ISO C 9X.
30 * printf has two new specifiers %a and %A to print hexadecimal flaoting-point
31   numbers.
33 * scanf recognizes the %a and %A format for scanning floating point numbers.
35 * the new headers <stdint.h> and <inttypes.h> from ISO C 9X provides
36   information and interfaces for the available integer types.
38 * the new header <complex.h> contains definitions of the complex math
39   functions from ISO C 9X.
41 * the new header <tgmath.h> defines generic macros to use complex or
42   real valued functions.
44 * Thorsten Kukuk provided an implementation for NIS+, securelevel 0, 1 and 2.
46 * Andreas Jaeger provided a test suite for the math library.
48 * Mark Kettenis implemented the utmpx interface and an utmp daemon.
50 * Ulrich Drepper added character conversion functions.
52 * Optimized string functions have been added.
54 * The localedata addon is now part of glibc.
56 * An implementation of profiling shared libraries was added by Ulrich Drepper.
58 * Thorsten Kukuk and Ulrich Drepper provided an implementation for a caching
59   daemon for NSS (nscd).
61   Missing a better place here are some numbers on improvements.  Under
62   Linux 2.1.125 un-tar-ing the kernel sources takes
64                                   user  system     wall
66     using local files           12.19s   6.88s   22.91s
68     using NIS                   13.92s   8.91s   26.34s
70     using NIS & nscd            10.37s   7.34s   25.30s
72     using NIS+                  27.57s  30.37s  640.46s
74     using NIS+ & nscd           10.25s   7.83s   26.51s
76     using NIS & old nscd [1]    13.83s   8.32s   29.60s
78   Keep in mind that non-namelookup related operations dominate above times.
79   It was just a common complain that using NIS+ unpacking the kernel is
80   horribly slow.
82   [1] The old nscd implementation is not available anymore since it was
83   distributed with glibc up to version 2.0.98 and thus is now replaced.
85 * Tim Waugh provided an implementation of the POSIX.2 wordexp function family.
87 * Mark Kettenis provided a Hesiod NSS module.
89 * The ELF dynamic loader knows how to process dynamic string tokens ($ORIGIN
90   and $PLATFORM) in RPATHs and similar strings (Ulrich Drepper).
92 * rcmd can now handle netgroups (Dick Streefland).
94 * A port to the ARM was contributed by Phil Blundell, Pat Beirne and Scott
95   Bambrough.
97 * Support for the IPv6 protocol has been added to the socket API, as per the
98   latest draft standards.
100 * Interface changes relative to the latest 2.0.x release:
101 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
102 addseverity                     NEW: Unix98
103 alphasort64                     NEW: LFS
104 argp_err_exit_status            NEW: argp, GNU ext
105 argp_error                      NEW: argp, GNU ext
106 argp_failure                    NEW: argp, GNU ext
107 argp_help                       NEW: argp, GNU ext
108 argp_parse                      NEW: argp, GNU ext
109 argp_program_bug_address        NEW: argp, GNU ext
110 argp_program_version            NEW: argp, GNU ext
111 argp_program_version_hook       NEW: argp, GNU ext
112 argp_state_help                 NEW: argp, GNU ext
113 argp_usage                      NEW: argp, GNU ext
114 authdes_create                  NEW: Secure RPC
115 authdes_getucred                NEW: Secure RPC
116 authdes_pk_create               NEW: Secure RPC
117 backtrace                       NEW: GNU ext.
118 backtrace_symbols               NEW: GNU ext.
119 backtrace_symbols_fd            NEW: GNU ext.
120 cacos                           NEW: ISO C 9x
121 cacosf                          NEW: ISO C 9x
122 cacosh                          NEW: ISO C 9x
123 cacoshf                         NEW: ISO C 9x
124 cacoshl                         NEW: ISO C 9x
125 cacosl                          NEW: ISO C 9x
126 capget                          NEW: kernel
127 capset                          NEW: kernel
128 carg                            NEW: ISO C 9x
129 cargf                           NEW: ISO C 9x
130 cargl                           NEW: ISO C 9x
131 casin                           NEW: ISO C 9x
132 casinf                          NEW: ISO C 9x
133 casinh                          NEW: ISO C 9x
134 casinhf                         NEW: ISO C 9x
135 casinhl                         NEW: ISO C 9x
136 casinl                          NEW: ISO C 9x
137 catan                           NEW: ISO C 9x
138 catanf                          NEW: ISO C 9x
139 catanh                          NEW: ISO C 9x
140 catanhf                         NEW: ISO C 9x
141 catanhl                         NEW: ISO C 9x
142 catanl                          NEW: ISO C 9x
143 cbc_crypt                       NEW: Secure RPC
144 ccos                            NEW: ISO C 9x
145 ccosf                           NEW: ISO C 9x
146 ccosh                           NEW: ISO C 9x
147 ccoshf                          NEW: ISO C 9x
148 ccoshl                          NEW: ISO C 9x
149 ccosl                           NEW: ISO C 9x
150 cexp                            NEW: ISO C 9x
151 cexpf                           NEW: ISO C 9x
152 cexpl                           NEW: ISO C 9x
153 cimag                           NEW: ISO C 9x
154 cimagf                          NEW: ISO C 9x
155 cimagl                          NEW: ISO C 9x
156 clearerr_locked                 REMOVED
157 clntunix_create                 NEW: sunrpc ext
158 clog                            NEW: ISO C 9x
159 clog10                          NEW: ISO C 9x
160 clog10f                         NEW: ISO C 9x
161 clog10l                         NEW: ISO C 9x
162 clogf                           NEW: ISO C 9x
163 clogl                           NEW: ISO C 9x
164 conj                            NEW: ISO C 9x
165 conjf                           NEW: ISO C 9x
166 conjl                           NEW: ISO C 9x
167 cpow                            NEW: ISO C 9x
168 cpowf                           NEW: ISO C 9x
169 cpowl                           NEW: ISO C 9x
170 cproj                           NEW: ISO C 9x
171 cprojf                          NEW: ISO C 9x
172 cprojl                          NEW: ISO C 9x
173 creal                           NEW: ISO C 9x
174 crealf                          NEW: ISO C 9x
175 creall                          NEW: ISO C 9x
176 creat64                         NEW: LFS
177 csin                            NEW: ISO C 9x
178 csinf                           NEW: ISO C 9x
179 csinh                           NEW: ISO C 9x
180 csinhf                          NEW: ISO C 9x
181 csinhl                          NEW: ISO C 9x
182 csinl                           NEW: ISO C 9x
183 csqrt                           NEW: ISO C 9x
184 csqrtf                          NEW: ISO C 9x
185 csqrtl                          NEW: ISO C 9x
186 ctan                            NEW: ISO C 9x
187 ctanf                           NEW: ISO C 9x
188 ctanh                           NEW: ISO C 9x
189 ctanhf                          NEW: ISO C 9x
190 ctanhl                          NEW: ISO C 9x
191 ctanl                           NEW: ISO C 9x
192 des_setparity                   NEW: Secure RPC
193 ecb_crypt                       NEW: Secure RPC
194 endutxent                       NEW: Unix98
195 exp10                           NEW: ISO C 9x
196 exp10f                          NEW: ISO C 9x
197 exp10l                          NEW: ISO C 9x
198 exp2                            NEW: ISO C 9x
199 exp2f                           NEW: ISO C 9x
200 exp2l                           NEW: ISO C 9x
201 fattach                         NEW: STREAMS
202 fdetach                         NEW: STREAMS
203 fdim                            NEW: ISO C 9x
204 fdimf                           NEW: ISO C 9x
205 fdiml                           NEW: ISO C 9x
206 feclearexcept                   NEW: ISO C 9x
207 fegetenv                        NEW: ISO C 9x
208 fegetexceptflag                 NEW: ISO C 9x
209 fegetround                      NEW: ISO C 9x
210 feholdexcept                    NEW: ISO C 9x
211 feof_locked                     REMOVED
212 feraiseexcept                   NEW: ISO C 9x
213 ferror_locked                   REMOVED
214 fesetenv                        NEW: ISO C 9x
215 fesetexceptflag                 NEW: ISO C 9x
216 fesetround                      NEW: ISO C 9x
217 fetestexcept                    NEW: ISO C 9x
218 feupdateenv                     NEW: ISO C 9x
219 fflush_locked                   REMOVED
220 ffsl                            NEW: GNU ext.
221 ffsll                           NEW: GNU ext.
222 fgetpos64                       NEW: LFS
223 fgets_unlocked                  NEW: GNU ext.
224 fileno_locked                   REMOVED
225 fma                             NEW: ISO C 9x
226 fmaf                            NEW: ISO C 9x
227 fmal                            NEW: ISO C 9x
228 fmax                            NEW: ISO C 9x
229 fmaxf                           NEW: ISO C 9x
230 fmaxl                           NEW: ISO C 9x
231 fmin                            NEW: ISO C 9x
232 fminf                           NEW: ISO C 9x
233 fminl                           NEW: ISO C 9x
234 fmtmsg                          NEW: Unix98
235 fopen64                         NEW: LFS
236 fputc_locked                    REMOVED
237 fputs_unlocked                  NEW: GNU ext.
238 fread_unlocked                  NEW: GNU ext.
239 freopen64                       NEW: LFS
240 fseeko                          NEW: Unix98
241 fsetpos64                       NEW: LFS
242 fstatfs64                       NEW: LFS
243 fstatvfs                        NEW: Unix98
244 fstatvfs64                      NEW: LFS
245 ftello                          NEW: Unix98
246 ftello64                        NEW: LFS
247 ftruncate64                     NEW: LFS
248 ftw64                           NEW: LFS
249 fwrite_unlocked                 NEW: GNU ext.
250 gai_strerror                    NEW: IPv6
251 gamma_r                         REMOVED
252 gammaf_r                        REMOVED
253 gammal_r                        REMOVED
254 getchar_locked                  REMOVED
255 getdate                         NEW: Unix98
256 getdate_err                     NEW: Unix98
257 getdate_r                       NEW: GNU ext.
258 getmsg                          NEW: STREAMS
259 getnameinfo                     NEW: IPv6
260 getnetname                      NEW: Secure RPC
261 getpmsg                         NEW: STREAMS
262 getpt                           NEW: Unix98 PTY
263 getrlimit64                     NEW: LFS
264 getutxent                       NEW: Unix98
265 getutxid                        NEW: Unix98
266 getutxline                      NEW: Unix98
267 glob64                          NEW: GNU ext.
268 globfree64                      NEW: GNU ext.
269 gnu_get_libc_release            NEW: GNU ext.
270 gnu_get_libc_version            NEW: GNU ext.
271 grantpt                         NEW: Unix98 PTY
272 host2netname                    NEW: Secure RPC
273 iconv                           NEW: iconv
274 iconv_close                     NEW: iconv
275 iconv_open                      NEW: iconv
276 if_freenameindex                NEW: IPv6
277 if_indextoname                  NEW: IPv6
278 if_nameindex                    NEW: IPv6
279 if_nametoindex                  NEW: IPv6
280 in6addr_any                     NEW: IPv6
281 in6addr_loopback                NEW: IPv6
282 inet6_isipv4mapped              NEW: IPv6
283 isastream                       NEW: STREAMS
284 iswblank                        NEW: GNU ext.
285 key_decryptsession              NEW: Secure RPC
286 key_decryptsession_pk           NEW: Secure RPC
287 key_encryptsession              NEW: Secure RPC
288 key_encryptsession_pk           NEW: Secure RPC
289 key_gendes                      NEW: Secure RPC
290 key_get_conv                    NEW: Secure RPC
291 key_secretkey_is_set            NEW: Secure RPC
292 key_setnet                      NEW: Secure RPC
293 key_setsecret                   NEW: Secure RPC
294 llrint                          NEW: ISO C 9x
295 llrintf                         NEW: ISO C 9x
296 llrintl                         NEW: ISO C 9x
297 llround                         NEW: ISO C 9x
298 llroundf                        NEW: ISO C 9x
299 llroundl                        NEW: ISO C 9x
300 log2                            NEW: ISO C 9x
301 log2f                           NEW: ISO C 9x
302 log2l                           NEW: ISO C 9x
303 lrint                           NEW: ISO C 9x
304 lrintf                          NEW: ISO C 9x
305 lrintl                          NEW: ISO C 9x
306 lround                          NEW: ISO C 9x
307 lroundf                         NEW: ISO C 9x
308 lroundl                         NEW: ISO C 9x
309 lseek64                         NEW: LFS
310 makecontext                     NEW: Unix98
311 mempcpy                         NEW: GNU ext.
312 mmap64                          NEW: LFS
313 moncontrol                      REMOVED
314 modify_ldt                      NEW: kernel
315 nan                             NEW: ISO C 9x
316 nanf                            NEW: ISO C 9x
317 nanl                            NEW: ISO C 9x
318 nearbyint                       NEW: ISO C 9x
319 nearbyintf                      NEW: ISO C 9x
320 nearbyintl                      NEW: ISO C 9x
321 netname2host                    NEW: Secure RPC
322 netname2user                    NEW: Secure RPC
323 nexttoward                      NEW: ISO C 9x
324 nexttowardf                     NEW: ISO C 9x
325 nexttowardl                     NEW: ISO C 9x
326 nftw                            NEW: Unix98
327 nftw64                          NEW: LFS
328 open64                          NEW: LFS
329 passwd2des                      NEW: Secure RPC
330 pow10                           NEW: GNU ext.
331 pow10f                          NEW: GNU ext.
332 pow10l                          NEW: GNU ext.
333 pread                           NEW: Unix98
334 pread64                         NEW: LFS
335 printf_size                     NEW: GNU ext.
336 printf_size_info                NEW: GNU ext.
337 profil_counter                  REMOVED
338 pthread_mutexattr_getkind_np    REPLACED
339 pthread_mutexattr_setkind_np    REPLACED
340 ptsname                         NEW: Unix98 PTY
341 ptsname_r                       NEW: Unix98 PTY
342 putc_locked                     REMOVED
343 putchar_locked                  REMOVED
344 putgrent                        NEW: GNU ext.
345 putmsg                          NEW: STREAMS
346 putpmsg                         NEW: STREAMS
347 pututxline                      NEW: Unix98
348 pwrite                          NEW: Unix98
349 pwrite64                        NEW: LFS
350 readdir64                       NEW: LFS
351 readdir64_r                     NEW: LFS
352 remquo                          NEW: ISO C 9x
353 remquof                         NEW: ISO C 9x
354 remquol                         NEW: ISO C 9x
355 round                           NEW: ISO C 9x
356 roundf                          NEW: ISO C 9x
357 roundl                          NEW: ISO C 9x
358 rtime                           NEW: GNU ext.
359 scalbln                         NEW: ISO C 9x
360 scalblnf                        NEW: ISO C 9x
361 scalblnl                        NEW: ISO C 9x
362 scandir64                       NEW: LFS
363 sendfile                        NEW: kernel
364 setcontext                      NEW: Unix98
365 setrlimit64                     NEW: LFS
366 setutxent                       NEW: Unix98
367 sighold                         NEW: Unix98
368 sigignore                       NEW: Unix98
369 sigqueue                        NEW: POSIX.1b
370 sigrelse                        NEW: Unix98
371 sigset                          NEW: POSIX.1b
372 sigtimedwait                    NEW: POSIX.1b
373 sigwaitinfo                     NEW: POSIX.1b
374 sincos                          NEW: GNU ext.
375 sincosf                         NEW: GNU ext.
376 sincosl                         NEW: GNU ext.
377 statfs64                        NEW: LFS
378 statvfs                         NEW: Unix98
379 statvfs64                       NEW: LFS
380 strcasestr                      NEW: GNU ext.
381 strtoimax                       NEW: ISO C 9x
382 strtoumax                       NEW: ISO C 9x
383 strverscmp                      NEW: GNU ext.
384 svcauthdes_stats                NEW: Secure RPC
385 svcunix_create                  NEW: sunrpc etx
386 svcunixfd_create                NEW: sunrpc ext
387 swapcontext                     NEW: Unix98
388 tcgetsid                        NEW: Unix98 PTY
389 tdestroy                        NEW: GNU ext.
390 tgamma                          NEW: ISO C 9x
391 tgammaf                         NEW: ISO C 9x
392 tgammal                         NEW: ISO C 9x
393 tmpfile64                       NEW: LFS
394 trunc                           NEW: ISO C 9x
395 truncate64                      NEW: LFS
396 truncf                          NEW: ISO C 9x
397 truncl                          NEW: ISO C 9x
398 umount2                         NEW: kernel
399 unlockpt                        NEW: Unix98 PTY
400 updwtmpx                        NEW: Unix98
401 user2netname                    NEW: Secure RPC
402 utmpxname                       NEW: Unix98
403 versionsort                     NEW: GNU ext.
404 versionsort64                   NEW: GNU ext.
405 waitid                          NEW: Unix98
406 wcscasecmp                      NEW: GNU ext.
407 wcsncasecmp                     NEW: GNU ext.
408 wcsnlen                         NEW: GNU ext.
409 wcstoimax                       NEW: ISO C 9x
410 wcstoll                         NEW: ISO C 9x
411 wcstoull                        NEW: ISO C 9x
412 wcstoumax                       NEW: ISO C 9x
413 wcswcs                          NEW: Unix98
414 wordexp                         NEW: POSIX.2
415 wordfree                        NEW: POSIX.2
416 write_profiling                 REMOVED
417 xdecrypt                        NEW: Secure RPC
418 xdr_authdes_cred                NEW: Secure RPC
419 xdr_authdes_verf                NEW: Secure RPC
420 xdr_cryptkeyarg                 NEW: Secure RPC
421 xdr_cryptkeyarg2                NEW: Secure RPC
422 xdr_cryptkeyres                 NEW: Secure RPC
423 xdr_getcredres                  NEW: Secure RPC
424 xdr_key_netstarg                NEW: Secure RPC
425 xdr_key_netstres                NEW: Secure RPC
426 xdr_keybuf                      NEW: Secure RPC
427 xdr_keystatus                   NEW: Secure RPC
428 xdr_netnamestr                  NEW: Secure RPC
429 xdr_sizeof                      NEW: Secure RPC
430 xdr_unixcred                    NEW: sunrpc ext
431 xencrypt                        NEW: Secure RPC
432 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
434 Version 2.0.5
436 * more bug fixes
438 * inet_ntoa is thread-safe
440 * updwtmp is moved from libutil to libc
442 * rewrite of cbrt function
444 * update of timezone data
446 Version 2.0.4
448 * more bug fixes
450 Version 2.0.3
452 * more bug fixes
454 Version 2.0.2
456 * more bug fixes
458 * add atoll function
460 * fix complex problems in Berkeley DB code
462 * fix math functions
464 Version 2.0.1
466 * fixed lots of header problems (especially Linux/GNU specific)
468 * dynamic loader preserves all registers
470 * Roland McGrath provided support for handling of auxiliary objects in
471   the ELF dynamic loader.
473 * support for parallel builds is improved
475 Version 2.0
477 * GNU extensions are no longer declared by default.  To enable them you
478   must define the macro `_GNU_SOURCE' in your program or compile with
479   `-D_GNU_SOURCE'.
481 * The library has changed from using GNU ld symbol aliases to using weak
482   symbols where available.  The ELF object file format supports weak
483   symbols; GNU ld also supports weak symbols in the a.out format.  (There
484   is also now support for other GNU ld extensions in ELF.  Use the
485   `--with-elf' option to configure to indicate you have ELF, and
486   `--with-gnu-ld' if using GNU ld.)  This change resulted in the deletion
487   of many files which contained only symbol aliases, reducing the size of
488   the source and the compiled library; many other files were renamed to
489   less cryptic names previously occupied by the symbol alias files.
490   There is a new header file <elf.h> for programs which operate on
491   files in the ELF format.
493 * Converted to Autoconf version 2, so `configure' has more options.
494   Run `configure --help' to see the details.
496 * The library can now be configured to build profiling, highly-optimized
497   (but undebuggable), and/or shared libraries (ELF with GNU ld only).  The
498   `--enable-profile', `--enable-omitfp', and `--enable-shared' options to
499   `configure' enable building these extra libraries.  The shared library is
500   built by default when using both ELF and GNU ld.  When shared libraries
501   are enabled, the new library `-ldl' is available for arbitrary run-time
502   loading of shared objects; its interface is defined in <dlfcn.h>.  The
503   new header file <link.h> gives access to the internals of the run-time
504   dynamic linker, `ld.so'.  The shell script `ldd' is similar to the
505   application of same name on other systems and it provides information
506   about dynamically linked binaries.
508 * The C library now provides the run-time support code for profiling
509   executables compiled with `-pg'.  Programs can control the profiling code
510   through the interface in <sys/gmon.h>.  The `gmon.out' files written by
511   the GNU C library can be read only by GNU `gprof' (from GNU binutils);
512   the support for this file format was contributed by David Mosberger-Tang.
514 * The math code has been replaced with a math library based on fdlibm from
515   Sun, and modified by JT Conklin and Ulrich Drepper with i387 support, by
516   Ian Taylor with `float' functions and by Ulrich Drepper with `long double'
517   functions.  The math functions now reside in a separate library,  so
518   programs using them will need to use `-lm' their linking commands.
520 * John C. Bowman contributed optimized ix87 assembler inline functions.
522 * Ulrich Drepper has contributed support for an `/etc/nsswitch.conf'
523   mechanism similar to that found in Solaris 2.  This is now used for the
524   group, passwd, hosts, networks, services, protocols, rpc, ethers,
525   shadow, netgroup, publickey, and alias databases.  The `nsswitch.conf'
526   file controls what services are used for each individual database.  This
527   works by loading shared libraries with names specified in `nsswitch.conf',
528   so service modules can be changed or added at any time without even
529   relinking any program.  Currently there are the file, db, and NIS based
530   NSS services available.
532 * The new functions `strtoq' and `strtouq' parse integer values from
533   strings, like `strtol' and `strtoul', but they return `long long int' and
534   `unsigned long long int' values, respectively (64-bit quantities).
536 * The new functions `strtof' and `strtold' parse floating-point values from
537   strings, like `strtod', but they return `float' and `long double' values,
538   respectively (on some machines `double' and `long double' are the same).
540 * Ulrich Drepper has contributed new implementations of the floating-point
541   printing and reading code used in the `printf' family of functions and
542   `strtod', `strtof', and `strtold'.  These new functions are perfectly
543   accurate, and much faster than the old ones.
545 * The implementation of the POSIX locale model was completely rewritten by
546   Ulrich Drepper.  This includes the new programs `localedef' and `locale'
547   to compile the POSIX locale definition.
549 * The former dummy implementations of the strcoll and strxfrm function are
550   now replaced by fully functional code contributed by Ulrich Drepper.  The
551   collation information comes from the POSIX locale definitions.
553 * The new header <langinfo.h> defines an interface for accessing
554   various locale-dependent data (using the locale chosen with `setlocale').
556 * Ulrich Drepper has contributed a new suite of functions for operation on
557   wide-character and multibyte-character strings, in <wchar.h>;
558   and classification and case conversion of wide characters, in <wctype.h>.
559   These new functions are conforming to the ISO C, Amendement 1 specification.
561 * There is now a second implementation of the standard I/O library available.
562   It comes from GNU libg++ as was written by Per Bothner, heavily modified
563   by Hongjiu Lu and made thread safe by Ulrich Drepper.
565 * You can now use positional parameter specifications in format strings
566   for the `printf' and `scanf' families of functions.  For example,
567   `printf ("Number %2$d, Mr %1$s\n", "Jones", 6);'' prints
568   ``Number 6, Mr Jones''.  This is mainly useful when providing different
569   format strings for different languages, whose grammars may dictate
570   different orderings of the values being printed.  To support this
571   feature, the interface for `register_printf_handler' has changed; see
572   the header file <printf.h> for details.
574 * The `printf' and `scanf' families of functions now understand a new
575   formatting flag for numeric conversions: the ' flag (e.g. %'d or %'f) says
576   to group numbers as indicated by the locale; for `scanf' and friends, this
577   says to accept as valid only a number with all the proper grouping
578   separators in the right places.  In the default "C" locale, numbers are
579   not grouped; but locales for specific countries will define the usual
580   conventions (i.e. separate thousands with `,' in the US locale).
582 * The pgrp functions have been regularized, slightly incompatibly but much
583   less confusingly.  The core functions are now `getpgid' and `setpgid',
584   which take arguments for the PID to operate on; the POSIX.1 `getpgrp' (no
585   argument) and BSD `setpgrp' (identical to `setpgid') functions are
586   provided for compatibility.  There is no longer an incompatible `getpgrp'
587   with an argument declared under _BSD_SOURCE; no BSD code uses it.
589 * The new header file <fts.h> and suite of functions simplify programs that
590   operate on directory trees.  This code comes from 4.4 BSD.
592 * The resolver code has been updated from the BIND 4.9.5-P1 release.
593   Parts of the code were heavily modified by Ulrich Drepper to fit in the
594   NSS scheme used in glibc.
596 * There is a new malloc debugging hook `__memalign_hook'.
598 * There are new typedefs `ushort' for `unsigned short int' and `uint' for
599   `unsigned int' in <sys/types.h>.  These are for compatibility only and
600   their use is discouraged.
602 * The `-lmcheck' library to enable standard malloc debugging hooks is now
603   done differently, so that it works even without GNU ld.
605 * New function `euidaccess' checks allowed access to a file like `access',
606   but using the effective IDs instead of the real IDs.
608 * The time zone data files have been updated for the latest and greatest
609   local time conventions of the countries of the world.
611 * The new function `dirfd' extracts the file descriptor used by a DIR stream;
612   see <dirent.h>.
614 * The new functions `ecvt', `fcvt', and `gcvt' provide an obsolete interface
615   for formatting floating-point numbers.  They are provided only for
616   compatibility; new programs should use `sprintf' instead.  There are
617   also equivalent function for the `long double' floating-point type and
618   all functions also exist in a reentrant form.
620 * The new auxiliary library `-lutil' from 4.4 BSD contains various
621   functions for maintaining the login-record files (primarily of use to
622   system programs such as `login'), and convenient functions for
623   allocating and initializing a pseudo-terminal (pty) device.
625 * Ulrich Drepper has contributed new support for System V style
626   shared memory and IPC on systems that support it.
628 * Ulrich Drepper has contributed several miscellaneous new functions found
629   in System V: The `hsearch' family of functions provide an effective
630   implementation of hash tables; `a64l' and `l64a' provide a very simple
631   binary to ASCII mapping; `drand48' and friends provide a 48-bit random
632   number generator.
634 * Ulrich Drepper has contributed new reentrant counterparts for the
635   `random' and `hsearch' families of functions; `random_r', `hsearch_r', etc.
637 * Ulrich Drepper has contributed new, highly-optimized versions of several
638   string functions for the i486/Pentium family of processors.
640 * Ulrich Drepper has updated the Linux-specific code, based largely
641   on work done in Hongjiu Lu's version of GNU libc for Linux.
642   The GNU library now supports Linux versions 2.0.10 and later,
643   using the ELF object file format (i[3456]86-*-linux).
645 * Andreas Schwab has ported the C library to Linux/m68k (m68k-*-linux).
647 * David Mosberger-Tang and Richard Henderson have ported the C library
648   to Linux/Alpha (alpha-*-linux).  Richard Henderson contributed the
649   dynamic linking support for ELF/Alpha.
651 * Richard Henderson contributed several Alpha optimized assembler function
652   for arithmetic and string handling.
654 * Ulrich Drepper has contributed a new set of message catalog functions to
655   support multiple languages using the <libintl.h> interface, for use with
656   his new package GNU gettext.  Translation volunteers have contributed
657   catalogs of the library's messages in Spanish, German, and Korean.
659 * For compatibility with XPG4, Ulrich Drepper has contributed the `gencat'
660   program and the `catgets' function for reading the catalog files it
661   creates.  (The <libintl.h> interface is preferred; we include the
662   <nl_types.h> interface using `catgets' only for source compatibility with
663   programs already written to use it.)
665 * New header file <values.h> gives SVID-compatible names for <limits.h>
666   constants.
668 * Various new macros, declarations, and small header files for compatibility
669   with 4.4 BSD.
671 * New function `group_member' is a convenient way to check if a process has
672   a given effective group ID.
674 * When using GCC 2.7 and later, the socket functions are now declared in a
675   special way so that passing an argument of type `struct sockaddr_in *',
676   `struct sockaddr_ns *', or `struct sockaddr_un *' instead of the generic
677   `struct sockaddr *' type, does not generate a type-clash warning.
679 * New function `error' declared in header file <error.h> is a convenient
680   function for printing error messages and optionally exiting; this is the
681   canonical function used in GNU programs.  The new functions `err', `warn',
682   and friends in header file <err.h> are the canonical 4.4 BSD interface for
683   doing the same thing.
685 * The <glob.h> interface has several new flags from 4.4 BSD that extend the
686   POSIX.2 `glob' function to do ~ and {...} expansion.
688 * New function `unsetenv' complements `setenv' for compatibility with 4.4 BSD.
689   `clearenv' which is used in POSIX.9 is also available.
691 * New function `getsid' returns session ID number on systems that support it.
693 * We have incorporated the 4.4 BSD `db' library (version 1.85).  New header
694   files <db.h> and <mpool.h> provide a rich set of functions for several
695   types of simple databases stored in memory and in files, and <ndbm.h> is
696   an old `ndbm'-compatible interface using the `db' functions.  Link with
697   `-ldb' to get these functions.
699 * New macro `strdupa' copies a string like `strdup', but uses local stack
700   space from `alloca' instead of dynamic heap space from `malloc'.
702 * New function `strnlen' is like `strlen' but searches only a given maximum
703   number of characters for the null terminator.  `stpncpy', `strndup' and
704   `strndupa' are similar variants for the `stpcpy', `strdup' and `strdupa'
705   function.
707 * New function `statfs' in header <sys/statfs.h>.
709 * The new <argz.h> and <envz.h> interfaces contributed by Miles Bader
710   provide convenient functions for operating on blocks of null-terminated
711   strings.
713 * A new suite of functions in <utmp.h> handle all the details of reading
714   and writing the utmp file.
716 * An implementation of the NIS/YP(tm) based NSS service was contributed by
717   Thorsten Kukuk.
719 * Paul Eggert and Ulrich Drepper modified the `strftime' function to be
720   completely POSIX compliant and also implemented the extended functionality
721   to handle alternate digit representation and alternate era date formats.
723 * Ulrich Drepper provided an implementation of the `strptime' function
724   defined in XPG4.2 which transforms a string into a `struct tm' value.
726 * Paul Eggert provided the tzselect shell script as part of the timezone
727   code.  The shell script makes it easy to select the correct timezone
728   specification.
730 * The implementation of the malloc family of functions is completely replaced
731   by a new implementation by Doug Lea with many improvements by Wolfram Gloger.
732   The implementation uses the mmap function (if available) and it is
733   optimized for the use in multi threaded programs.
735 * Ulrich Drepper contributed a MD5 "encryption" for the crypt family of
736   functions.  This new functionality is usable by specifying a special
737   salt string and it is compatible with implementation on *BSD systems.
739 * Lots of functions from the XPG4.2 standard were added by Ulrich Drepper:
740   `getsubopt' to handle second level command line options, `bsd_signal'
741   to access BSD style `signal' functionality, the obsolete `regexp' style
742   expression matcher.
744 * the `lchown' function is available on system which support this
745   functionality.
747 * The implementation of the shadow password handling function was contributed
748   by Ulrich Drepper.
750 * David Mosberger-Tang changed the SunRPC implementation to be 64bit safe.
752 * POSIX.1g support was added.  The <sys/select.h> header is available,
753   `isfdtype' and `pselect' are implemented.  Craig Metz contributed an
754   implementation of `getaddrinfo'.
756 Version 1.09
758 * For cross-compilation you should now set `BUILD_CC' instead of `HOST_CC'.
760 * New header file <fstab.h> and new functions `getfsspec', `getfsent' and
761   friends, for parsing /etc/fstab.  This code comes from 4.4 BSD.
763 * The new function `daemon' from 4.4 BSD is useful for server programs that
764   want to put themselves in the background.
766 * Joel Sherrill has contributed support for several standalone boards that
767   run without an operating system.
769 * `printf', `scanf' and friends now accept a `q' type modifier for long
770   long int as well as `ll'.  Formats using these might be `%qu' or `%lld'.
772 * All of the code taken from BSD (notably most of the math and networking
773   routines) has been updated from the BSD 4.4-Lite release.
775 * The resolver code has been updated from the BIND-4.9.3-BETA9 release.
777 * The new functions `getdomainname' and `setdomainname' fetch or change the
778   YP/NIS domain name.  These are system calls which exist on systems which
779   have YP (aka NIS).
781 * The time zone data files have been updated for the latest international
782   conventions.
784 * The SunRPC programs `portmap' and `rpcinfo' are now installed in
785   $(sbindir) (usually /usr/local/sbin) instead of $(bindir).
787 Version 1.08
789 * The C library now includes support for Sun RPC, from Sun's free
790   RPCSRC-4.0 distribution.  The `portmap', `rpcinfo', and `rpcgen' programs
791   are included.  (There is still no support for YP.)
793 * Tom Quinn has contributed a port of the C library to SGI machines running
794   Irix 4 (mips-sgi-irix4).
796 * The new `lockf' function is a simplified interface to the locking
797   facilities of `fcntl', included for compatibility.
799 * New time functions `timegm', `timelocal', and `dysize' for compatibility.
801 * New header file <sys/timeb.h> and new function `ftime' for compatibility.
803 * New header files <poll.h> and <sys/poll.h> and new function `poll' for
804   compatibility.
806 * The error message printed by `assert' for a failed assertion now includes
807   the name of the program (if using GNU ld) and the name of the calling
808   function (with versions of GCC that support this).
810 * The `psignal' function is now declared in <signal.h>, not <stdio.h>.
812 * The library now includes the <sys/mman.h> header file and memory
813   management functions `mmap', `munmap', `mprotect', `msync', and
814   `madvise', on systems that support those facilities.
816 * The interface for `mcheck' has changed slightly: the function called to
817   abort the program when an allocation inconsistency is detected now takes
818   an argument that indicates the type of failure.  The new function
819   `mprobe' lets you request a consistency check for a particular block at
820   any time (checks are normally done only when you call `free' or `realloc'
821   on a block).
823 * It is now possible to easily cross-compile the C library, building on one
824   system a library to run on another machine and/or operating system.  All
825   you need to do is set the variable `HOST_CC' in `configparms' to the
826   native compiler for programs to run on the machine you are building on (a
827   few generator programs are used on Unix systems); set `CC' to the
828   cross-compiler.
830 * The new function `fexecve' (only implemented on the GNU system) executes
831   a program file given a file descriptor already open on the file.
833 Version 1.07
835 * Brendan Kehoe has contributed most of a port to the DEC Alpha
836   running OSF/1 (alpha-dec-osf1).  He says it is 75% complete.
838 * You can set the variable `libprefix' in `configparms' to specify a prefix
839   to be prepended to installed library files; this makes it easy to install
840   the GNU C library to be linked as `-lgnuc' or whatever.
842 * The new `stpncpy' is a cross between `stpcpy' and `strncpy': It
843   copies a limited number of characters from a string, and returns the
844   address of the last character written.
846 * You no longer need to check for whether the installed `stddef.h' is
847   compatible with the GNU C library.  configure now checks for you.
849 * You can now define a per-stream `fileno' function to convert the
850   stream's cookie into an integral file descriptor.
852 * ``malloc (0)'' no longer returns a null pointer.  Instead, it
853   allocates zero bytes of storage, and returns a unique pointer which
854   you can pass to `realloc' or `free'.  The behavior is undefined if
855   you dereference this pointer.
857 * The C library now runs on Sony NEWS m68k machines running either
858   NewsOS 3 or NewsOS 4.
860 * The new `syscall' function is a system-dependent primitive function
861   for invoking system calls.  It has the canonical behavior on Unix
862   systems, including unreliable return values for some calls (such as
863   `pipe', `fork' and `getppid').
865 * The error code `EWOULDBLOCK' is now obsolete; it is always defined
866   to `EAGAIN', which is the preferred name.  On systems whose kernels
867   use two distinct codes, the C library now translates EWOULDBLOCK to
868   EAGAIN in every system call function.
870 Version 1.06
872 * The GNU C Library Reference Manual is now distributed with the library.
873   `make dvi' will produce a DVI file of the printed manual.
874   `make info' will produce Info files that you can read on line using C-h i
875   in Emacs or the `info' program.
876   Please send comments on the manual to bug-glibc-manual@gnu.org.
878 * The library now supports SVR4 on i386s (i386-unknown-sysv4).
880 * Brendan Kehoe has contributed a port to Sun SPARCs running Solaris 2.
882 * Jason Merrill has contributed a port to the Sequent Symmetry running
883   Dynix version 3 (i386-sequent-dynix).
885 * The library has been ported to i386s running SCO 3.2.4 (also known as SCO
886   ODT 2.0; i386-unknown-sco3.2.4) or SCO 3.2 (i386-unknown-sco3.2).
888 * New function `memory_warnings' lets you arrange to get warnings when
889   malloc is running out of memory to allocate, like Emacs gives you.
891 * The C library now contains the relocating allocator used in Emacs 19 for
892   its editing buffers.  This allocator (ralloc) minimizes allocation
893   overhead and fragmentation by moving allocated regions around whenever it
894   needs to.  You always refer to a ralloc'd region with a "handle" (a
895   pointer to a pointer--an object of type `void **').
897 * There is a new `printf' format: `%m' gives you the string corresponding
898   to the error code in `errno'.
900 * In `scanf' formats, you can now use `%as' or `%a[' to do the normal `%s'
901   or `%[' conversion, but instead of filling in a fixed-sized buffer you
902   pass, the `a' modifier says to fill in a `char **' you pass with a
903   malloc'd string.
905 * The `fnmatch' function supports the new flag bits `FNM_LEADING_DIR' and
906   `FNM_CASEFOLD'.  `FNM_LEADING_DIR' lets a pattern like `foo*' match a
907   name like `foo/bar'.  `FNM_CASEFOLD' says to ignore case in matching.
909 * `mkstemp' is a traditional Unix function to atomically create and open a
910   uniquely-named temporary file.
912 Version 1.05
914 * The standard location for the file that says what the local timezone is
915   has changed again.  It is now `/usr/local/etc/localtime' (or more
916   precisely, `${prefix}/etc/localtime') rather than `/etc/localtime'.
918 * The distribution no longer contains any files with names longer than 14
919   characters.
921 * `struct ttyent' has two new flag bits: TTY_TRUSTED and TTY_CONSOLE.
922   These are set by the new `trusted' and `console' keywords in `/etc/ttys'.
924 * New functions `ttyslot' and `syslog' from 4.4 BSD.
926 Version 1.04
928 * The configuration process has changed quite a bit.  The `configure'
929   script is now used just like the configuration scripts for other GNU
930   packages.  The `sysdeps' directory hierarchy is much rearranged.
931   The file `INSTALL' explains the new scheme in detail.
933 * The header files no longer need to be processed into ANSI C and
934   traditional C versions.  There is just one set of files to install, and
935   it will work with ANSI or old C compilers (including `gcc -traditional').
937 * Brendan Kehoe and Ian Lance Taylor have ported the library to the
938   MIPS DECStation running Ultrix 4.
940 * The Sun 4 startup code (crt0) can now properly load SunOS 4 shared libraries.
941   Tom Quinn contributed the initial code.  The GNU C library can NOT yet be
942   made itself into a shared library.
944 * Yet further improved support for the i386, running 4.3 BSD-like systems
945   (such as Mach 3 with the Unix single-server), or System V.
947 * New function `strncasecmp' to do case-insensitive string comparison
948   with limited length.
950 * New function `strsep' is a reentrant alternative to `strtok'.
952 * New functions `scandir' and `alphasort' for searching directories.
954 * New function `setenv' is a better interface to `putenv'.
956 * Ian Lance Taylor has contributed an implementation of the SVID `ftw'
957   function for traversing a directory tree.
959 * The GNU obstack package is now also part of the C library.
960   The new function `open_obstack_stream' creates a stdio stream that
961   writes onto an obstack; `obstack_printf' and `obstack_vprintf' do
962   formatted output directly to an obstack.
964 * Miscellaneous new functions: reboot, nice, sigaltstack (4.4 BSD only),
965   cfmakeraw, getusershell, getpass, swab, getttyent, seteuid, setegid.
967 * `FNM_FILE_NAME' is another name for `FNM_PATHNAME', used with `fnmatch'.
969 * The new functions `strfry' and `memfrob' do mysterious and wonderful
970   things to your strings.
972 * There are some new test programs: test-fseek, testmb, and testrand.
974 * Some work has been done to begin porting the library to 4.4 BSD and Linux.
975   These ports are not finished, but are a good starting place for really
976   supporting those systems.
978 * `/etc/localtime' is now the standard location for the file that says what
979   the local timezone is, rather than `/usr/local/lib/zoneinfo/localtime'.
980   This follows the general principle that `/etc' is the place for all local
981   configuration files.
983 * The C library header files now use `extern "C"' when used by the C++
984   compiler, so the C library should now work with C++ code.
986 * The header file <bstring.h> is gone.  <string.h> now declares bcopy,
987   bcmp, bzero, and ffs.
989 * Mike Haertel (of GNU e?grep and malloc fame) has written a new sorting
990   function which uses the `merge sort' algorithm, and is said to be
991   significantly faster than the old GNU `qsort' function.  Merge sort is
992   now the standard `qsort' function.  The new algorithm can require a lot
993   of temporary storage; so, the old sorting function is called when the
994   required storage is not available.
996 * The C library now includes Michael Glad's Ultra Fast Crypt, which
997   provides the Unix `crypt' function, plus some other entry points.
998   Because of the United States export restriction on DES implementations,
999   we are distributing this code separately from the rest of the C library.
1000   There is an extra distribution tar file just for crypt; it is called
1001   `glibc-VERSION-crypt.tar.Z', e.g. `glibc-1.04-crypt.tar.Z'.  You can just
1002   unpack the crypt distribution along with the rest of the C library and
1003   build; you can also build the library without getting crypt.  Users
1004   outside the USA can get the crypt distribution via anonymous FTP from
1005   ftp.uni-c.dk [129.142.6.74], or another archive site outside the U.S.
1007 * The code and header files taken from 4.4 BSD have been updated with the
1008   latest files released from Berkeley.
1010 ----------------------------------------------------------------------
1011 Copyright information:
1013 Copyright (C) 1992, 93, 94, 95, 96 Free Software Foundation, Inc.
1015    Permission is granted to anyone to make or distribute verbatim copies
1016    of this document as received, in any medium, provided that the
1017    copyright notice and this permission notice are preserved,
1018    thus giving the recipient permission to redistribute in turn.
1020    Permission is granted to distribute modified versions
1021    of this document, or of portions of it,
1022    under the above conditions, provided also that they
1023    carry prominent notices stating who last changed them.
1025 Local variables:
1026 version-control: never
1027 end: