README.template

   1 This directory contains the version VERSION test release of the GNU C Library.
   2 Many bugs have been fixed since the last release.
   3 Some bugs surely remain.
   4
   5 As of this release, the GNU C library is known to run on the following
   6 configurations:
   7
   8                 *-*-gnu                 GNU Hurd
   9                 i[3456]86-*-linux-gnu   Linux-2.0 on Intel
  10                 m68k-*-linux-gnu        Linux-2.0 on Motorola 680x0
  11                 alpha-*-linux-gnu       Linux-2.0 on DEC Alpha
  12
  13
  14 Former releases of this library (version 1.09.1 and perhaps earlier
  15 versions) used to run on the following configurations:
  16
  17                 alpha-dec-osf1
  18                 i[3456]86-*-bsd4.3
  19                 i[3456]86-*-isc2.2
  20                 i[3456]86-*-isc3
  21                 i[3456]86-*-sco3.2
  22                 i[3456]86-*-sco3.2v4
  23                 i[3456]86-*-sysv
  24                 i[3456]86-*-sysv4
  25                 i[3456]86-force_cpu386-none
  26                 i[3456]86-sequent-bsd
  27                 i960-nindy960-none
  28                 m68k-hp-bsd4.3
  29                 m68k-mvme135-none
  30                 m68k-mvme136-none
  31                 m68k-sony-newsos3
  32                 m68k-sony-newsos4
  33                 m68k-sun-sunos4
  34                 mips-dec-ultrix4
  35                 mips-sgi-irix4
  36                 sparc-sun-solaris2
  37                 sparc-sun-sunos4
  38
  39 Whether this is still true for this release is unknown.  Porting the
  40 library is not hard.  If you are interested in doing a port, please
  41 get on the mailing list by sending electronic mail to
  42 <bug-glibc-request@prep.ai.mit.edu>.
  43
  44 The GNU C library now includes Michael Glad's Ultra Fast Crypt, which
  45 provides the Unix `crypt' function, plus some other entry points.
  46 Because of the United States export restriction on DES implementations,
  47 we are distributing this code separately from the rest of the C
  48 library.  There is an extra distribution tar file just for crypt; it is
  49 called `glibc-crypt-VERSION.tar.gz'.  You can just unpack the crypt
  50 distribution along with the rest of the C library and build; you can
  51 also build the library without getting crypt.  Users outside the USA
  52 can get the crypt distribution via anonymous FTP from ftp.ifi.uio.no
  53 [129.240.64.21], or another archive site outside the USA.  Archive
  54 maintainers are encouraged to copy this distribution to their archives
  55 outside the USA.  Please get it from ftp.ifi.uio.no; transferring this
  56 distribution from prep.ai.mit.edu (or any other site in the USA) to a
  57 site outside the USA is in violation of US export laws.
  58
  59 Beside the separate crypt tar file there are some more add-ons which can be
  60 used together with GNU libc.  They are designed in a way to ease the
  61 installation by integrating them in the libc source tree.  Simply get the
  62 add-ons you need and use the --enable-add-ons option of the `configure'
  63 script to tell where the add-ons are found.  Please read the FAQ file for
  64 more details.
  65
  66 See the file INSTALL to find out how to configure, build, install, and port
  67 the GNU C library.  You might also consider reading the WWW pages for the
  68 GNU libc at http://www.gnu.org/software/libc/libc.html.
  69
  70 The GNU C Library is completely documented by the Texinfo manual found
  71 in the `manual/' subdirectory.  The manual is still being updated and
  72 contains some known errors and omissions; we regret that we do not have
  73 the resources to work on the manual as much as we would like.  Please
  74 send comments on the manual to <bug-glibc-manual@prep.ai.mit.edu>, and
  75 not to the library bug-reporting address.
  76
  77 The file NOTES contains a description of the feature-test macros used
  78 in the GNU C library, explaining how you can tell the library what
  79 facilities you want it to make available.
  80
  81 We prefer to get bug reports sent using the `glibcbug' shell script which
  82 is install together with the rest of the GNU libc to <bugs@gnu.ai.mit.edu>.
  83 Simply run this shell script and fill in the information.  Nevertheless
  84 you can still send bug reports to <bug-glibc@prep.ai.mit.edu> as normal
  85 electronic mails.
  86
  87 The GNU C Library is free software.  See the file COPYING.LIB for copying
  88 conditions.