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-BETA26 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
 111 * Ulrich Drepper has contributed new support for System V style
 112   shared memory and IPC on systems that support it.
 113
 114 * Ulrich Drepper has contributed several miscellaneous new functions found
 115   in System V: The `hsearch' family of functions provide an effective
 116   implementation of hash tables; `a64l' and `l64a' provide a very simple
 117   binary to ASCII mapping; `drand48' and friends provide a 48-bit random
 118   number generator.
 119
 120 * Ulrich Drepper has contributed new reentrant counterparts for the
 121   `random' and `hsearch' families of functions; `random_r', `hsearch_r', etc.
 122
 123 * Ulrich Drepper has contributed new, highly-optimized versions of several
 124   string functions for the i486/Pentium family of processors.
 125
 126 * Ulrich Drepper has updated the Linux-specific code, based largely
 127   on work done in Hongjiu Lu's version of GNU libc for Linux.
 128   The GNU library now supports Linux versions 1.3.29 and later,
 129   using the ELF object file format (i[345]86-*-linux).
 130
 131 * Ulrich Drepper has contributed a new set of message catalog functions to
 132   support multiple languages, for use with his new package GNU gettext.
 133 \f
 134 Version 1.09
 135
 136 * For cross-compilation you should now set `BUILD_CC' instead of `HOST_CC'.
 137
 138 * New header file <fstab.h> and new functions `getfsspec', `getfsent' and
 139   friends, for parsing /etc/fstab.  This code comes from 4.4 BSD.
 140
 141 * The new function `daemon' from 4.4 BSD is useful for server programs that
 142   want to put themselves in the background.
 143
 144 * Joel Sherrill has contributed support for several standalone boards that
 145   run without an operating system.
 146
 147 * `printf', `scanf' and friends now accept a `q' type modifier for long
 148   long int as well as `ll'.  Formats using these might be `%qu' or `%lld'.
 149
 150 * All of the code taken from BSD (notably most of the math and networking
 151   routines) has been updated from the BSD 4.4-Lite release.
 152
 153 * The resolver code has been updated from the BIND-4.9.3-BETA9 release.
 154
 155 * The new functions `getdomainname' and `setdomainname' fetch or change the
 156   YP/NIS domain name.  These are system calls which exist on systems which
 157   have YP (aka NIS).
 158
 159 * The time zone data files have been updated for the latest international
 160   conventions.
 161
 162 * The SunRPC programs `portmap' and `rpcinfo' are now installed in
 163   $(sbindir) (usually /usr/local/sbin) instead of $(bindir).
 164 \f
 165 Version 1.08
 166
 167 * The C library now includes support for Sun RPC, from Sun's free
 168   RPCSRC-4.0 distribution.  The `portmap', `rpcinfo', and `rpcgen' programs
 169   are included.  (There is still no support for YP.)
 170
 171 * Tom Quinn has contributed a port of the C library to SGI machines running
 172   Irix 4 (mips-sgi-irix4).
 173
 174 * The new `lockf' function is a simplified interface to the locking
 175   facilities of `fcntl', included for compatibility.
 176
 177 * New time functions `timegm', `timelocal', and `dysize' for compatibility.
 178
 179 * New header file <sys/timeb.h> and new function `ftime' for compatibility.
 180
 181 * New header files <poll.h> and <sys/poll.h> and new function `poll' for
 182   compatibility.
 183
 184 * The error message printed by `assert' for a failed assertion now includes
 185   the name of the program (if using GNU ld) and the name of the calling
 186   function (with versions of GCC that support this).
 187
 188 * The `psignal' function is now declared in <signal.h>, not <stdio.h>.
 189
 190 * The library now includes the <sys/mman.h> header file and memory
 191   management functions `mmap', `munmap', `mprotect', `msync', and
 192   `madvise', on systems that support those facilities.
 193
 194 * The interface for `mcheck' has changed slightly: the function called to
 195   abort the program when an allocation inconsistency is detected now takes
 196   an argument that indicates the type of failure.  The new function
 197   `mprobe' lets you request a consistency check for a particular block at
 198   any time (checks are normally done only when you call `free' or `realloc'
 199   on a block).
 200
 201 * It is now possible to easily cross-compile the C library, building on one
 202   system a library to run on another machine and/or operating system.  All
 203   you need to do is set the variable `HOST_CC' in `configparms' to the
 204   native compiler for programs to run on the machine you are building on (a
 205   few generator programs are used on Unix systems); set `CC' to the
 206   cross-compiler.
 207
 208 * The new function `fexecve' (only implemented on the GNU system) executes
 209   a program file given a file descriptor already open on the file.
 210 \f
 211 Version 1.07
 212
 213 * Brendan Kehoe has contributed most of a port to the DEC Alpha
 214   running OSF/1 (alpha-dec-osf1).  He says it is 75% complete.
 215
 216 * You can set the variable `libprefix' in `configparms' to specify a prefix
 217   to be prepended to installed library files; this makes it easy to install
 218   the GNU C library to be linked as `-lgnuc' or whatever.
 219
 220 * The new `stpncpy' is a cross between `stpcpy' and `strncpy': It
 221   copies a limited number of characters from a string, and returns the
 222   address of the last character written.
 223
 224 * You no longer need to check for whether the installed `stddef.h' is
 225   compatible with the GNU C library.  configure now checks for you.
 226
 227 * You can now define a per-stream `fileno' function to convert the
 228   stream's cookie into an integral file descriptor.
 229
 230 * ``malloc (0)'' no longer returns a null pointer.  Instead, it
 231   allocates zero bytes of storage, and returns a unique pointer which
 232   you can pass to `realloc' or `free'.  The behavior is undefined if
 233   you dereference this pointer.
 234
 235 * The C library now runs on Sony NEWS m68k machines running either
 236   NewsOS 3 or NewsOS 4.
 237
 238 * The new `syscall' function is a system-dependent primitive function
 239   for invoking system calls.  It has the canonical behavior on Unix
 240   systems, including unreliable return values for some calls (such as
 241   `pipe', `fork' and `getppid').
 242
 243 * The error code `EWOULDBLOCK' is now obsolete; it is always defined
 244   to `EAGAIN', which is the preferred name.  On systems whose kernels
 245   use two distinct codes, the C library now translates EWOULDBLOCK to
 246   EAGAIN in every system call function.
 247 \f
 248 Version 1.06
 249
 250 * The GNU C Library Reference Manual is now distributed with the library.
 251   `make dvi' will produce a DVI file of the printed manual.
 252   `make info' will produce Info files that you can read on line using C-h i
 253   in Emacs or the `info' program.
 254   Please send comments on the manual to bug-glibc-manual@prep.ai.mit.edu.
 255
 256 * The library now supports SVR4 on i386s (i386-unknown-sysv4).
 257
 258 * Brendan Kehoe has contributed a port to Sun SPARCs running Solaris 2.
 259
 260 * Jason Merrill has contributed a port to the Sequent Symmetry running
 261   Dynix version 3 (i386-sequent-dynix).
 262
 263 * The library has been ported to i386s running SCO 3.2.4 (also known as SCO
 264   ODT 2.0; i386-unknown-sco3.2.4) or SCO 3.2 (i386-unknown-sco3.2).
 265
 266 * New function `memory_warnings' lets you arrange to get warnings when
 267   malloc is running out of memory to allocate, like Emacs gives you.
 268
 269 * The C library now contains the relocating allocator used in Emacs 19 for
 270   its editing buffers.  This allocator (ralloc) minimizes allocation
 271   overhead and fragmentation by moving allocated regions around whenever it
 272   needs to.  You always refer to a ralloc'd region with a "handle" (a
 273   pointer to a pointer--an object of type `void **').
 274
 275 * There is a new `printf' format: `%m' gives you the string corresponding
 276   to the error code in `errno'.
 277
 278 * In `scanf' formats, you can now use `%as' or `%a[' to do the normal `%s'
 279   or `%[' conversion, but instead of filling in a fixed-sized buffer you
 280   pass, the `a' modifier says to fill in a `char **' you pass with a
 281   malloc'd string.
 282
 283 * The `fnmatch' function supports the new flag bits `FNM_LEADING_DIR' and
 284   `FNM_CASEFOLD'.  `FNM_LEADING_DIR' lets a pattern like `foo*' match a
 285   name like `foo/bar'.  `FNM_CASEFOLD' says to ignore case in matching.
 286
 287 * `mkstemp' is a traditional Unix function to atomically create and open a
 288   uniquely-named temporary file.
 289 \f
 290 Version 1.05
 291
 292 * The standard location for the file that says what the local timezone is
 293   has changed again.  It is now `/usr/local/etc/localtime' (or more
 294   precisely, `${prefix}/etc/localtime') rather than `/etc/localtime'.
 295
 296 * The distribution no longer contains any files with names longer than 14
 297   characters.
 298
 299 * `struct ttyent' has two new flag bits: TTY_TRUSTED and TTY_CONSOLE.
 300   These are set by the new `trusted' and `console' keywords in `/etc/ttys'.
 301
 302 * New functions `ttyslot' and `syslog' from 4.4 BSD.
 303 \f
 304 Version 1.04
 305
 306 * The configuration process has changed quite a bit.  The `configure'
 307   script is now used just like the configuration scripts for other GNU
 308   packages.  The `sysdeps' directory hierarchy is much rearranged.
 309   The file `INSTALL' explains the new scheme in detail.
 310
 311 * The header files no longer need to be processed into ANSI C and
 312   traditional C versions.  There is just one set of files to install, and
 313   it will work with ANSI or old C compilers (including `gcc -traditional').
 314
 315 * Brendan Kehoe and Ian Lance Taylor have ported the library to the
 316   MIPS DECStation running Ultrix 4.
 317
 318 * The Sun 4 startup code (crt0) can now properly load SunOS 4 shared libraries.
 319   Tom Quinn contributed the initial code.  The GNU C library can NOT yet be
 320   made itself into a shared library.
 321
 322 * Yet further improved support for the i386, running 4.3 BSD-like systems
 323   (such as Mach 3 with the Unix single-server), or System V.
 324
 325 * New function `strncasecmp' to do case-insensitive string comparison
 326   with limited length.
 327
 328 * New function `strsep' is a reentrant alternative to `strtok'.
 329
 330 * New functions `scandir' and `alphasort' for searching directories.
 331
 332 * New function `setenv' is a better interface to `putenv'.
 333
 334 * Ian Lance Taylor has contributed an implementation of the SVID `ftw'
 335   function for traversing a directory tree.
 336
 337 * The GNU obstack package is now also part of the C library.
 338   The new function `open_obstack_stream' creates a stdio stream that
 339   writes onto an obstack; `obstack_printf' and `obstack_vprintf' do
 340   formatted output directly to an obstack.
 341
 342 * Miscellaneous new functions: reboot, nice, sigaltstack (4.4 BSD only),
 343   cfmakeraw, getusershell, getpass, swab, getttyent, seteuid, setegid.
 344
 345 * `FNM_FILE_NAME' is another name for `FNM_PATHNAME', used with `fnmatch'.
 346
 347 * The new functions `strfry' and `memfrob' do mysterious and wonderful
 348   things to your strings.
 349
 350 * There are some new test programs: test-fseek, testmb, and testrand.
 351
 352 * Some work has been done to begin porting the library to 4.4 BSD and Linux.
 353   These ports are not finished, but are a good starting place for really
 354   supporting those systems.
 355
 356 * `/etc/localtime' is now the standard location for the file that says what
 357   the local timezone is, rather than `/usr/local/lib/zoneinfo/localtime'.
 358   This follows the general principle that `/etc' is the place for all local
 359   configuration files.
 360
 361 * The C library header files now use `extern "C"' when used by the C++
 362   compiler, so the C library should now work with C++ code.
 363
 364 * The header file <bstring.h> is gone.  <string.h> now declares bcopy,
 365   bcmp, bzero, and ffs.
 366
 367 * Mike Haertel (of GNU e?grep and malloc fame) has written a new sorting
 368   function which uses the `merge sort' algorithm, and is said to be
 369   significantly faster than the old GNU `qsort' function.  Merge sort is
 370   now the standard `qsort' function.  The new algorithm can require a lot
 371   of temporary storage; so, the old sorting function is called when the
 372   required storage is not available.
 373
 374 * The C library now includes Michael Glad's Ultra Fast Crypt, which
 375   provides the Unix `crypt' function, plus some other entry points.
 376   Because of the United States export restriction on DES implementations,
 377   we are distributing this code separately from the rest of the C library.
 378   There is an extra distribution tar file just for crypt; it is called
 379   `glibc-VERSION-crypt.tar.Z', e.g. `glibc-1.04-crypt.tar.Z'.  You can just
 380   unpack the crypt distribution along with the rest of the C library and
 381   build; you can also build the library without getting crypt.  Users
 382   outside the USA can get the crypt distribution via anonymous FTP from
 383   ftp.uni-c.dk [129.142.6.74], or another archive site outside the U.S.
 384
 385 * The code and header files taken from 4.4 BSD have been updated with the
 386   latest files released from Berkeley.
 387 \f
 388 ----------------------------------------------------------------------
 389 Copyright information:
 390
 391 Copyright (C) 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
 392
 393    Permission is granted to anyone to make or distribute verbatim copies
 394    of this document as received, in any medium, provided that the
 395    copyright notice and this permission notice are preserved,
 396    thus giving the recipient permission to redistribute in turn.
 397
 398    Permission is granted to distribute modified versions
 399    of this document, or of portions of it,
 400    under the above conditions, provided also that they
 401    carry prominent notices stating who last changed them.
 402 \f
 403 Local variables:
 404 version-control: never
 405 end: