update from main archive 960825
[kopensolaris-gnu/glibc.git] / NEWS
1 GNU C Library NEWS -- history of user-visible changes.  25 August 1996
2
3 Copyright (C) 1992, 93, 94, 95, 96 Free Software Foundation, Inc.
4 See the end for copying conditions.
5
6 Please send GNU C library bug reports to bug-glibc@prep.ai.mit.edu.
7 \f
8 Version 2.0
9
10 * GNU extensions are no longer declared by default.  To enable them you
11   must define the macro `_GNU_SOURCE' in your program or compile with
12   `-D_GNU_SOURCE'.
13
14 * The library has changed from using GNU ld symbol aliases to using weak
15   symbols where available.  The ELF object file format supports weak
16   symbols; GNU ld also supports weak symbols in the a.out format.  (There
17   is also now support for other GNU ld extensions in ELF.  Use the
18   `--with-elf' option to configure to indicate you have ELF, and
19   `--with-gnu-ld' if using GNU ld.)  This change resulted in the deletion
20   of many files which contained only symbol aliases, reducing the size of
21   the source and the compiled library; many other files were renamed to
22   less cryptic names previously occupied by the symbol alias files.
23   There is a new header file <elf.h> for programs which operate on
24   files in the ELF format.
25
26 * Converted to Autoconf version 2, so `configure' has more options.
27   Run `configure --help' to see the details.
28
29 * The library can now be configured to build profiling, highly-optimized
30   (but undebuggable), and/or shared libraries (ELF with GNU ld only).  The
31   `--enable-profile', `--enable-omitfp', and `--enable-shared' options to
32   `configure' enable building these extra libraries.  The shared library is
33   built by default when using both ELF and GNU ld.  When shared libraries
34   are enabled, the new library `-ldl' is available for arbitrary run-time
35   loading of shared objects; its interface is defined in <dlfcn.h>.  The
36   new header file <link.h> gives access to the internals of the run-time
37   dynamic linker, `ld.so'.
38
39 * The C library now provides the run-time support code for profiling
40   executables compiled with `-pg'.  Programs can control the profiling code
41   through the interface in <sys/gmon.h>.  The `gmon.out' files written by
42   the GNU C library can be read only by GNU `gprof' (from GNU binutils);
43   the support for this file format was contributed by David Mosberger-Tang.
44
45 * The math code has been replaced with a math library based on fdlibm from
46   Sun, and modified by JT Conklin with i387 support and by Ian Taylor with
47   `float' functions.  The math functions now reside in a separate library,
48   so programs using them will need to use `-lm' their linking commands.
49
50 * Ulrich Drepper has contributed support for an `/etc/nsswitch.conf'
51   mechanism similar to that found in Solaris 2.  This is now used for the
52   group, passwd, hosts, networks, services, protocols, and rpc databases.
53   The `nsswitch.conf' file controls what services are used for each
54   individual database.  This works by loading shared libraries with names
55   specified in `nsswitch.conf', so service modules can be changed or added at
56   any time without even relinking any program.  A future release of the
57   separate NYS package will provide NIS/YP and NIS+ modules for this interface.
58
59 * The new functions `strtoq' and `strtouq' parse integer values from
60   strings, like `strtol' and `strtoul', but they return `long long int' and
61   `unsigned long long int' values, respectively (64-bit quantities).
62
63 * The new functions `strtof' and `strtold' parse floating-point values from
64   strings, like `strtod', but they return `float' and `long double' values,
65   respectively (on some machines `double' and `long double' are the same).
66
67 * Ulrich Drepper has contributed new implementations of the floating-point
68   printing and reading code used in the `printf' family of functions and
69   `strtod', `strtof', and `strtold'.  These new functions are perfectly
70   accurate, and much faster than the old ones.
71
72 * The new header <langinfo.h> defines an interface for accessing
73   various locale-dependent data (using the locale chosen with `setlocale').
74
75 * Ulrich Drepper has contributed a new suite of functions for operation on
76   wide-character and multibyte-character strings, in <wcstr.h> and <mbstr.h>;
77   and classification and case conversion of wide characters, in <wctype.h>.
78   These new functions are intended to conform to the ISO C specification.
79
80 * You can now use positional parameter specifications in format strings
81   for the `printf' and `scanf' families of functions.  For example,
82   `printf ("Number %2$d, Mr %1$s\n", "Jones", 6);'' prints
83   ``Number 6, Mr Jones''.  This is mainly useful when providing different
84   format strings for different languages, whose grammars may dictate
85   different orderings of the values being printed.  To support this
86   feature, the interface for `register_printf_handler' has changed; see
87   the header file <printf.h> for details.
88
89 * The `printf' and `scanf' families of functions now understand a new
90   formatting flag for numeric conversions: the ' flag (e.g. %'d or %'f) says
91   to group numbers as indicated by the locale; for `scanf' and friends, this
92   says to accept as valid only a number with all the proper grouping
93   separators in the right places.  In the default "C" locale, numbers are
94   not grouped; but locales for specific countries will define the usual
95   conventions (i.e. separate thousands with `,' in the US locale).
96
97 * The pgrp functions have been regularized, slightly incompatibly but much
98   less confusingly.  The core functions are now `getpgid' and `setpgid',
99   which take arguments for the PID to operate on; the POSIX.1 `getpgrp' (no
100   argument) and BSD `setpgrp' (identical to `setpgid') functions are
101   provided for compatibility.  There is no longer an incompatible `getpgrp'
102   with an argument declared under _BSD_SOURCE; no BSD code uses it.
103
104 * The new header file <fts.h> and suite of functions simplify programs that
105   operate on directory trees.  This code comes from 4.4 BSD.
106
107 * The resolver code has been updated from the BIND 4.9.5-T1A release.
108
109 * The new function `malloc_find_object_address' finds the starting address
110   of a malloc'd block, given any address within the block;
111   `malloc_object_allocated_size' returns the size of an allocated block;
112   and `malloc_walk' lets you walk through all allocated blocks.  These can
113   be useful for debugging; see <malloc.h> for the interfaces.
114
115 * There is a new malloc debugging hook `__memalign_hook'.
116
117 * There are new typedefs `ushort' for `unsigned short int' and `uint' for
118   `unsigned int' in <sys/types.h>.  These are for compatibility only and
119   their use is discouraged.
120
121 * The `-lmcheck' library to enable standard malloc debugging hooks is now
122   done differently, so that it works even without GNU ld.
123
124 * New function `euidaccess' checks allowed access to a file like `access',
125   but using the effective IDs instead of the real IDs.
126
127 * The time zone data files have been updated for the latest and greatest
128   local time conventions of the countries of the world.
129
130 * The new function `dirfd' extracts the file descriptor used by a DIR stream;
131   see <dirent.h>.
132
133 * The new functions `ecvt', `fcvt', and `gcvt' provide an obsolete interface
134   for formatting floating-point numbers.  They are provided only for
135   compatibility; new programs should use `sprintf' instead.
136
137 * The new auxiliary library `-lutil' from 4.4 BSD contains various
138   functions for maintaining the login-record files (primarily of use to
139   system programs such as `login'), and convenient functions for
140   allocating and initializing a pseudo-terminal (pty) device.
141
142 * Ulrich Drepper has contributed new support for System V style
143   shared memory and IPC on systems that support it.
144
145 * Ulrich Drepper has contributed several miscellaneous new functions found
146   in System V: The `hsearch' family of functions provide an effective
147   implementation of hash tables; `a64l' and `l64a' provide a very simple
148   binary to ASCII mapping; `drand48' and friends provide a 48-bit random
149   number generator.
150
151 * Ulrich Drepper has contributed new reentrant counterparts for the
152   `random' and `hsearch' families of functions; `random_r', `hsearch_r', etc.
153
154 * Ulrich Drepper has contributed new, highly-optimized versions of several
155   string functions for the i486/Pentium family of processors.
156
157 * Ulrich Drepper has updated the Linux-specific code, based largely
158   on work done in Hongjiu Lu's version of GNU libc for Linux.
159   The GNU library now supports Linux versions 1.3.29 and later,
160   using the ELF object file format (i[345]86-*-linux).
161
162 * Andreas Schwab has ported the C library to Linux/m68k (m68k-*-linux).
163
164 * David Mosberger-Tang has ported the C library to Linux/Alpha (alpha-*-linux).
165   Richard Henderson contributed the dynamic linking support for ELF/Alpha.
166
167 * Ulrich Drepper has contributed a new set of message catalog functions to
168   support multiple languages using the <libintl.h> interface, for use with
169   his new package GNU gettext.  Translation volunteers have contributed
170   catalogs of the library's messages in Spanish, German, and Korean.
171
172 * For compatibility with XPG4, Ulrich Drepper has contributed the `gencat'
173   program and the `catgets' function for reading the catalog files it
174   creates.  (The <libintl.h> interface is preferred; we include the
175   <nl_types.h> interface using `catgets' only for source compatibility with
176   programs already written to use it.)
177
178 * New header file <values.h> gives SVID-compatible names for <limits.h>
179   constants.
180
181 * Various new macros, declarations, and small header files for compatibility
182   with 4.4 BSD.
183
184 * New function `group_member' is a convenient way to check if a process has
185   a given effective group ID.
186
187 * When using GCC 2.7 and later, the socket functions are now declared in a
188   special way so that passing an argument of type `struct sockaddr_in *',
189   `struct sockaddr_ns *', or `struct sockaddr_un *' instead of the generic
190   `struct sockaddr *' type, does not generate a type-clash warning.
191
192 * New function `error' declared in header file <error.h> is a convenient
193   function for printing error messages and optionally exitting; this is the
194   canonical function used in GNU programs.  The new functions `err', `warn',
195   and friends in header file <err.h> are the canonical 4.4 BSD interface for
196   doing the same thing.
197
198 * The <glob.h> interface has several new flags from 4.4 BSD that extend the
199   POSIX.2 `glob' function to do ~ and {...} expansion.
200
201 * New function `unsetenv' complements `setenv' for compatibility with 4.4 BSD.
202
203 * New function `getsid' returns session ID number on systems that support it.
204
205 * We have incorporated the 4.4 BSD `db' library (version 1.85).  New header
206   files <db.h> and <mpool.h> provide a rich set of functions for several
207   types of simple databases stored in memory and in files, and <ndbm.h> is
208   an old `ndbm'-compatbile interface using the `db' functions.  Link with
209   `-ldb' to get these functions.
210
211 * New macro `strdupa' copies a string like `strdup', but uses local stack
212   space from `alloca' instead of dynamic heap space from `malloc'.
213
214 * New function `strnlen' is like `strlen' but searches only a given maximum
215   number of characters for the null terminator.
216
217 * New function `statfs' in header <sys/statfs.h>.
218
219 * The new <argz.h> and <envz.h> interfaces contributed by Miles Bader
220   provide convenient functions for operating on blocks of null-terminated
221   strings.
222
223 * A new suite of functions in <utmp.h> handle all the details of reading
224   and writing the utmp file.
225 \f
226 Version 1.09
227
228 * For cross-compilation you should now set `BUILD_CC' instead of `HOST_CC'.
229
230 * New header file <fstab.h> and new functions `getfsspec', `getfsent' and
231   friends, for parsing /etc/fstab.  This code comes from 4.4 BSD.
232
233 * The new function `daemon' from 4.4 BSD is useful for server programs that
234   want to put themselves in the background.
235
236 * Joel Sherrill has contributed support for several standalone boards that
237   run without an operating system.
238
239 * `printf', `scanf' and friends now accept a `q' type modifier for long
240   long int as well as `ll'.  Formats using these might be `%qu' or `%lld'.
241
242 * All of the code taken from BSD (notably most of the math and networking
243   routines) has been updated from the BSD 4.4-Lite release.
244
245 * The resolver code has been updated from the BIND-4.9.3-BETA9 release.
246
247 * The new functions `getdomainname' and `setdomainname' fetch or change the
248   YP/NIS domain name.  These are system calls which exist on systems which
249   have YP (aka NIS).
250
251 * The time zone data files have been updated for the latest international
252   conventions.
253
254 * The SunRPC programs `portmap' and `rpcinfo' are now installed in
255   $(sbindir) (usually /usr/local/sbin) instead of $(bindir).
256 \f
257 Version 1.08
258
259 * The C library now includes support for Sun RPC, from Sun's free
260   RPCSRC-4.0 distribution.  The `portmap', `rpcinfo', and `rpcgen' programs
261   are included.  (There is still no support for YP.)
262
263 * Tom Quinn has contributed a port of the C library to SGI machines running
264   Irix 4 (mips-sgi-irix4).
265
266 * The new `lockf' function is a simplified interface to the locking
267   facilities of `fcntl', included for compatibility.
268
269 * New time functions `timegm', `timelocal', and `dysize' for compatibility.
270
271 * New header file <sys/timeb.h> and new function `ftime' for compatibility.
272
273 * New header files <poll.h> and <sys/poll.h> and new function `poll' for
274   compatibility.
275
276 * The error message printed by `assert' for a failed assertion now includes
277   the name of the program (if using GNU ld) and the name of the calling
278   function (with versions of GCC that support this).
279
280 * The `psignal' function is now declared in <signal.h>, not <stdio.h>.
281
282 * The library now includes the <sys/mman.h> header file and memory
283   management functions `mmap', `munmap', `mprotect', `msync', and
284   `madvise', on systems that support those facilities.
285
286 * The interface for `mcheck' has changed slightly: the function called to
287   abort the program when an allocation inconsistency is detected now takes
288   an argument that indicates the type of failure.  The new function
289   `mprobe' lets you request a consistency check for a particular block at
290   any time (checks are normally done only when you call `free' or `realloc'
291   on a block).
292
293 * It is now possible to easily cross-compile the C library, building on one
294   system a library to run on another machine and/or operating system.  All
295   you need to do is set the variable `HOST_CC' in `configparms' to the
296   native compiler for programs to run on the machine you are building on (a
297   few generator programs are used on Unix systems); set `CC' to the
298   cross-compiler.
299
300 * The new function `fexecve' (only implemented on the GNU system) executes
301   a program file given a file descriptor already open on the file.
302 \f
303 Version 1.07
304
305 * Brendan Kehoe has contributed most of a port to the DEC Alpha
306   running OSF/1 (alpha-dec-osf1).  He says it is 75% complete.
307
308 * You can set the variable `libprefix' in `configparms' to specify a prefix
309   to be prepended to installed library files; this makes it easy to install
310   the GNU C library to be linked as `-lgnuc' or whatever.
311
312 * The new `stpncpy' is a cross between `stpcpy' and `strncpy': It
313   copies a limited number of characters from a string, and returns the
314   address of the last character written.
315
316 * You no longer need to check for whether the installed `stddef.h' is
317   compatible with the GNU C library.  configure now checks for you.
318
319 * You can now define a per-stream `fileno' function to convert the
320   stream's cookie into an integral file descriptor.
321
322 * ``malloc (0)'' no longer returns a null pointer.  Instead, it
323   allocates zero bytes of storage, and returns a unique pointer which
324   you can pass to `realloc' or `free'.  The behavior is undefined if
325   you dereference this pointer.
326
327 * The C library now runs on Sony NEWS m68k machines running either
328   NewsOS 3 or NewsOS 4.
329
330 * The new `syscall' function is a system-dependent primitive function
331   for invoking system calls.  It has the canonical behavior on Unix
332   systems, including unreliable return values for some calls (such as
333   `pipe', `fork' and `getppid').
334
335 * The error code `EWOULDBLOCK' is now obsolete; it is always defined
336   to `EAGAIN', which is the preferred name.  On systems whose kernels
337   use two distinct codes, the C library now translates EWOULDBLOCK to
338   EAGAIN in every system call function.
339 \f
340 Version 1.06
341
342 * The GNU C Library Reference Manual is now distributed with the library.
343   `make dvi' will produce a DVI file of the printed manual.
344   `make info' will produce Info files that you can read on line using C-h i
345   in Emacs or the `info' program.
346   Please send comments on the manual to bug-glibc-manual@prep.ai.mit.edu.
347
348 * The library now supports SVR4 on i386s (i386-unknown-sysv4).
349
350 * Brendan Kehoe has contributed a port to Sun SPARCs running Solaris 2.
351
352 * Jason Merrill has contributed a port to the Sequent Symmetry running
353   Dynix version 3 (i386-sequent-dynix).
354
355 * The library has been ported to i386s running SCO 3.2.4 (also known as SCO
356   ODT 2.0; i386-unknown-sco3.2.4) or SCO 3.2 (i386-unknown-sco3.2).
357
358 * New function `memory_warnings' lets you arrange to get warnings when
359   malloc is running out of memory to allocate, like Emacs gives you.
360
361 * The C library now contains the relocating allocator used in Emacs 19 for
362   its editing buffers.  This allocator (ralloc) minimizes allocation
363   overhead and fragmentation by moving allocated regions around whenever it
364   needs to.  You always refer to a ralloc'd region with a "handle" (a
365   pointer to a pointer--an object of type `void **').
366
367 * There is a new `printf' format: `%m' gives you the string corresponding
368   to the error code in `errno'.
369
370 * In `scanf' formats, you can now use `%as' or `%a[' to do the normal `%s'
371   or `%[' conversion, but instead of filling in a fixed-sized buffer you
372   pass, the `a' modifier says to fill in a `char **' you pass with a
373   malloc'd string.
374
375 * The `fnmatch' function supports the new flag bits `FNM_LEADING_DIR' and
376   `FNM_CASEFOLD'.  `FNM_LEADING_DIR' lets a pattern like `foo*' match a
377   name like `foo/bar'.  `FNM_CASEFOLD' says to ignore case in matching.
378
379 * `mkstemp' is a traditional Unix function to atomically create and open a
380   uniquely-named temporary file.
381 \f
382 Version 1.05
383
384 * The standard location for the file that says what the local timezone is
385   has changed again.  It is now `/usr/local/etc/localtime' (or more
386   precisely, `${prefix}/etc/localtime') rather than `/etc/localtime'.
387
388 * The distribution no longer contains any files with names longer than 14
389   characters.
390
391 * `struct ttyent' has two new flag bits: TTY_TRUSTED and TTY_CONSOLE.
392   These are set by the new `trusted' and `console' keywords in `/etc/ttys'.
393
394 * New functions `ttyslot' and `syslog' from 4.4 BSD.
395 \f
396 Version 1.04
397
398 * The configuration process has changed quite a bit.  The `configure'
399   script is now used just like the configuration scripts for other GNU
400   packages.  The `sysdeps' directory hierarchy is much rearranged.
401   The file `INSTALL' explains the new scheme in detail.
402
403 * The header files no longer need to be processed into ANSI C and
404   traditional C versions.  There is just one set of files to install, and
405   it will work with ANSI or old C compilers (including `gcc -traditional').
406
407 * Brendan Kehoe and Ian Lance Taylor have ported the library to the
408   MIPS DECStation running Ultrix 4.
409
410 * The Sun 4 startup code (crt0) can now properly load SunOS 4 shared libraries.
411   Tom Quinn contributed the initial code.  The GNU C library can NOT yet be
412   made itself into a shared library.
413
414 * Yet further improved support for the i386, running 4.3 BSD-like systems
415   (such as Mach 3 with the Unix single-server), or System V.
416
417 * New function `strncasecmp' to do case-insensitive string comparison
418   with limited length.
419
420 * New function `strsep' is a reentrant alternative to `strtok'.
421
422 * New functions `scandir' and `alphasort' for searching directories.
423
424 * New function `setenv' is a better interface to `putenv'.
425
426 * Ian Lance Taylor has contributed an implementation of the SVID `ftw'
427   function for traversing a directory tree.
428
429 * The GNU obstack package is now also part of the C library.
430   The new function `open_obstack_stream' creates a stdio stream that
431   writes onto an obstack; `obstack_printf' and `obstack_vprintf' do
432   formatted output directly to an obstack.
433
434 * Miscellaneous new functions: reboot, nice, sigaltstack (4.4 BSD only),
435   cfmakeraw, getusershell, getpass, swab, getttyent, seteuid, setegid.
436
437 * `FNM_FILE_NAME' is another name for `FNM_PATHNAME', used with `fnmatch'.
438
439 * The new functions `strfry' and `memfrob' do mysterious and wonderful
440   things to your strings.
441
442 * There are some new test programs: test-fseek, testmb, and testrand.
443
444 * Some work has been done to begin porting the library to 4.4 BSD and Linux.
445   These ports are not finished, but are a good starting place for really
446   supporting those systems.
447
448 * `/etc/localtime' is now the standard location for the file that says what
449   the local timezone is, rather than `/usr/local/lib/zoneinfo/localtime'.
450   This follows the general principle that `/etc' is the place for all local
451   configuration files.
452
453 * The C library header files now use `extern "C"' when used by the C++
454   compiler, so the C library should now work with C++ code.
455
456 * The header file <bstring.h> is gone.  <string.h> now declares bcopy,
457   bcmp, bzero, and ffs.
458
459 * Mike Haertel (of GNU e?grep and malloc fame) has written a new sorting
460   function which uses the `merge sort' algorithm, and is said to be
461   significantly faster than the old GNU `qsort' function.  Merge sort is
462   now the standard `qsort' function.  The new algorithm can require a lot
463   of temporary storage; so, the old sorting function is called when the
464   required storage is not available.
465
466 * The C library now includes Michael Glad's Ultra Fast Crypt, which
467   provides the Unix `crypt' function, plus some other entry points.
468   Because of the United States export restriction on DES implementations,
469   we are distributing this code separately from the rest of the C library.
470   There is an extra distribution tar file just for crypt; it is called
471   `glibc-VERSION-crypt.tar.Z', e.g. `glibc-1.04-crypt.tar.Z'.  You can just
472   unpack the crypt distribution along with the rest of the C library and
473   build; you can also build the library without getting crypt.  Users
474   outside the USA can get the crypt distribution via anonymous FTP from
475   ftp.uni-c.dk [129.142.6.74], or another archive site outside the U.S.
476
477 * The code and header files taken from 4.4 BSD have been updated with the
478   latest files released from Berkeley.
479 \f
480 ----------------------------------------------------------------------
481 Copyright information:
482
483 Copyright (C) 1992, 93, 94, 95, 96 Free Software Foundation, Inc.
484
485    Permission is granted to anyone to make or distribute verbatim copies
486    of this document as received, in any medium, provided that the
487    copyright notice and this permission notice are preserved,
488    thus giving the recipient permission to redistribute in turn.
489
490    Permission is granted to distribute modified versions
491    of this document, or of portions of it,
492    under the above conditions, provided also that they
493    carry prominent notices stating who last changed them.
494 \f
495 Local variables:
496 version-control: never
497 end: