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