NEWS

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