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