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