README.template

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