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