]> git.ipfire.org Git - thirdparty/glibc.git/blobdiff - README
elf: Use nocancel pread64() instead of lseek()+read()
[thirdparty/glibc.git] / README
diff --git a/README b/README
index 36a2af9129d2db286471eb9f6708393fb65db020..31c5da0405bd4566c69e1cb42e9696f97da9120b 100644 (file)
--- a/README
+++ b/README
@@ -1,58 +1,72 @@
-This directory contains the version 2.3.4 release of the GNU C Library.
-Many bugs have been fixed since the last release.
-Some bugs surely remain.
-
-As of this release, the GNU C library is known to run on the following
-configurations:
-
-               *-*-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
-               powerpc64-*-linux-gnu   Linux-2.4.19+ on 64-bit PowerPC systems
-               sparc-*-linux-gnu       Linux-2.x on SPARC
-               sparc64-*-linux-gnu     Linux-2.x on UltraSPARC 64-bit
-               arm-*-none              ARM standalone systems
-               arm-*-linux             Linux-2.x on ARM
-               arm-*-linuxaout         Linux-2.x on ARM using a.out binaries
-               mips*-*-linux-gnu       Linux-2.x on MIPS
-               ia64-*-linux-gnu        Linux-2.x on ia64
-               s390-*-linux-gnu        Linux-2.x on IBM S/390
-               s390x-*-linux-gnu       Linux-2.4+ on IBM S/390 64-bit
-               sh-*-linux-gnu          Linux-2.x on Super Hitachi
-               x86-64-*-linux-gnu      Linux-2.4+ on x86-64
-
-Past releases of this library ran on a variety of configurations that are
-no longer supported.  Porting the library is not hard.  If you are
-interested in doing a port, please contact the glibc maintainers;
-see http://www.gnu.org/software/libc/ for more information.
-
-There are some 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.
-
-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.
-
-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 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.
-
-Please see http://www.gnu.org/software/libc/bugs.html for bug reporting
+This directory contains the sources of the GNU C Library.
+See the file "version.h" for what release version you have.
+
+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.
+
+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.
+
+When working with Linux kernels, this version of the GNU C Library
+requires Linux kernel version 3.2 or later.
+
+Also note that the shared version of the libgcc_s library must be
+installed for the pthread library to work correctly.
+
+The GNU C Library supports these configurations for using Linux kernels:
+
+       aarch64*-*-linux-gnu
+       alpha*-*-linux-gnu
+       arm-*-linux-gnueabi
+       csky-*-linux-gnuabiv2
+       hppa-*-linux-gnu
+       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
+       riscv64-*-linux-gnu
+       sh[34]-*-linux-gnu
+       sparc*-*-linux-gnu
+       sparc64*-*-linux-gnu
+
+If you are interested in doing a port, please contact the glibc
+maintainers; see https://www.gnu.org/software/libc/ for more
+information.
+
+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 https://www.gnu.org/software/libc/.
+
+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.
+
+Please see https://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, and LICENSES for notices about a few contributions that require
-these additional notices to be distributed.
+these additional notices to be distributed.  License copyright years may be
+listed using range notation, e.g., 1996-2015, indicating that every year in
+the range, inclusive, is a copyrightable year that would otherwise be listed
+individually.