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