-This directory contains the version 2.1 release of the GNU C Library.
-Many bugs have been fixed since the last release.
-Some bugs surely remain.
+This directory contains the sources of the GNU C Library.
+See the file "version.h" for what release version you have.
-As of this release, the GNU C library is known to run on the following
-configurations:
+The GNU C Library is the standard system C library for all GNU systems,
+and is an important part of what makes up a GNU system. It provides the
+system API for all programs written in C and C-compatible languages such
+as C++ and Objective C; the runtime facilities of other programming
+languages use the C library to access the underlying operating system.
- *-*-gnu GNU Hurd
- i[3456]86-*-linux-gnu Linux-2.x on Intel
- m68k-*-linux-gnu Linux-2.x on Motorola 680x0
- alpha-*-linux-gnu Linux-2.x on DEC Alpha
- powerpc-*-linux-gnu Linux and MkLinux on PowerPC systems
- sparc-*-linux-gnu Linux-2.x on SPARC
- sparc64-*-linux-gnu Linux-2.x on UltraSPARC
- arm-*-none ARM standalone systems
- arm-*-linux Linux-2.x on ARM
- arm-*-linuxaout Linux-2.x on ARM using a.out binaries
+In GNU/Linux systems, the C library works with the Linux kernel to
+implement the operating system behavior seen by user applications.
+In GNU/Hurd systems, it works with a microkernel and Hurd servers.
+The GNU C Library implements much of the POSIX.1 functionality in the
+GNU/Hurd system, using configurations i[4567]86-*-gnu. The current
+GNU/Hurd support requires out-of-tree patches that will eventually be
+incorporated into an official GNU C Library release.
-Former releases of this library (version 1.09.1 and perhaps earlier
-versions) used to run on the following configurations:
+When working with Linux kernels, this version of the GNU C Library
+requires Linux kernel version 2.6.32 or later.
- alpha-dec-osf1
- i[3456]86-*-bsd4.3
- i[3456]86-*-isc2.2
- i[3456]86-*-isc3
- i[3456]86-*-sco3.2
- i[3456]86-*-sco3.2v4
- i[3456]86-*-sysv
- i[3456]86-*-sysv4
- i[3456]86-force_cpu386-none
- i[3456]86-sequent-bsd
- i960-nindy960-none
- m68k-hp-bsd4.3
- m68k-mvme135-none
- m68k-mvme136-none
- m68k-sony-newsos3
- m68k-sony-newsos4
- m68k-sun-sunos4
- mips-dec-ultrix4
- mips-sgi-irix4
- sparc-sun-solaris2
- sparc-sun-sunos4
+Also note that the shared version of the libgcc_s library must be
+installed for the pthread library to work correctly.
-Since no one has volunteered to test and fix the above configurations,
-these are not supported at the moment. It's expected that these don't
-work anymore. Porting the library is not hard. If you are interested
-in doing a port, please contact the glibc maintainers by sending
-electronic mail to <bug-glibc@gnu.org>.
+The GNU C Library supports these configurations for using Linux kernels:
-The GNU C library now includes Michael Glad's Ultra Fast Crypt, which
-provides the Unix `crypt' function, plus some other entry points.
-Because of the United States export restriction on DES
-implementations, we are distributing this code separately from the
-rest of the C library. There is an extra distribution tar file just
-for crypt; it is called `glibc-crypt-2.1.tar.gz'. You can just
-unpack the crypt distribution along with the rest of the C library and
-build; you can also build the library without getting crypt. Users
-outside the USA can get the crypt distribution via anonymous FTP from
-ftp.funet.fi [128.214.248.6] in the directory pub/gnu/funet, or
-another archive site outside the USA. Archive maintainers are
-encouraged to copy this distribution to their archives outside the
-USA. Please get it from ftp.funet.fi; transferring this distribution
-from ftp.gnu.org (or any other site in the USA) to a site outside the
-USA is in violation of US export laws.
+ aarch64*-*-linux-gnu
+ alpha*-*-linux-gnu
+ arm-*-linux-gnueabi
+ hppa-*-linux-gnu Not currently functional without patches.
+ i[4567]86-*-linux-gnu
+ x86_64-*-linux-gnu Can build either x86_64 or x32
+ ia64-*-linux-gnu
+ m68k-*-linux-gnu
+ microblaze*-*-linux-gnu
+ mips-*-linux-gnu
+ mips64-*-linux-gnu
+ powerpc-*-linux-gnu Hardware or software floating point, BE only.
+ powerpc64*-*-linux-gnu Big-endian and little-endian.
+ s390-*-linux-gnu
+ s390x-*-linux-gnu
+ sh[34]-*-linux-gnu
+ sparc*-*-linux-gnu
+ sparc64*-*-linux-gnu
+ tilegx-*-linux-gnu
+ tilepro-*-linux-gnu
-Beside the separate crypt tar file there are some more add-ons which can be
-used together with GNU libc. They are designed in a way to ease the
-installation by integrating them in the libc source tree. Simply get the
-add-ons you need and use the --enable-add-ons option of the `configure'
-script to tell where the add-ons are found. Please read the FAQ file for
-more details.
+If you are interested in doing a port, please contact the glibc
+maintainers; see http://www.gnu.org/software/libc/ for more
+information.
-See the file INSTALL to find out how to configure, build, install, and port
-the GNU C library. You might also consider reading the WWW pages for the
-GNU libc at http://www.gnu.org/software/libc/libc.html.
+See the file INSTALL to find out how to configure, build, and install
+the GNU C Library. You might also consider reading the WWW pages for
+the C library at http://www.gnu.org/software/libc/.
-The GNU C Library is completely documented by the Texinfo manual found
-in the `manual/' subdirectory. The manual is still being updated and
-contains some known errors and omissions; we regret that we do not
-have the resources to work on the manual as much as we would like.
-Please send comments on the manual to <bug-glibc-manual@gnu.org>, and
-not to the library bug-reporting address.
+The GNU C Library is (almost) completely documented by the Texinfo manual
+found in the `manual/' subdirectory. The manual is still being updated
+and contains some known errors and omissions; we regret that we do not
+have the resources to work on the manual as much as we would like. For
+corrections to the manual, please file a bug in the `manual' component,
+following the bug-reporting instructions below. Please be sure to check
+the manual in the current development sources to see if your problem has
+already been corrected.
-The file NOTES contains a description of the feature-test macros used
-in the GNU C library, explaining how you can tell the library what
-facilities you want it to make available.
-
-We prefer to get bug reports sent using the `glibcbug' shell script which
-is installed together with the rest of the GNU libc to <bugs@gnu.org>.
-Simply run this shell script and fill in the information. Nevertheless
-you can still send bug reports to <bug-glibc@gnu.org> as normal electronic
-mails.
+Please see http://www.gnu.org/software/libc/bugs.html for bug reporting
+information. We are now using the Bugzilla system to track all bug reports.
+This web page gives detailed information on how to report bugs properly.
The GNU C Library is free software. See the file COPYING.LIB for copying
-conditions.
+conditions, and LICENSES for notices about a few contributions that require
+these additional notices to be distributed. License copyright years may be
+listed using range notation, e.g., 2000-2013, indicating that every year in
+the range, inclusive, is a copyrightable year that would otherwise be listed
+individually.