0001 This directory contains the sources of the GNU C Library.
0002 See the file "version.h" for what release version you have.
0004 The GNU C Library is the standard system C library for all GNU systems,
0005 and is an important part of what makes up a GNU system. It provides the
0006 system API for all programs written in C and C-compatible languages such
0007 as C++ and Objective C; the runtime facilities of other programming
0008 languages use the C library to access the underlying operating system.
0010 In GNU/Linux systems, the C library works with the Linux kernel to
0011 implement the operating system behavior seen by user applications.
0012 In GNU/Hurd systems, it works with a microkernel and Hurd servers.
0014 The GNU C Library implements much of the POSIX.1 functionality in the
0015 GNU/Hurd system, using configurations i86-*-gnu. The current
0016 GNU/Hurd support requires out-of-tree patches that will eventually be
0017 incorporated into an official GNU C Library release.
0019 When working with Linux kernels, this version of the GNU C Library
0020 requires Linux kernel version 2.6.16 or later.
0022 Also note that the shared version of the libgcc_s library must be
0023 installed for the pthread library to work correctly.
0025 The GNU C Library supports these configurations for using Linux kernels:
0028 x86_64-*-linux-gnu Can build either x86_64 or x32
0029 powerpc-*-linux-gnu Hardware or software floating point, BE only.
0030 powerpc64*-*-linux-gnu Big-endian and little-endian.
0037 The code for other CPU configurations supported by volunteers outside of
0038 the core glibc maintenance effort is contained in the `ports' add-on,
0039 located in the `ports' subdirectory of the source tree.
0043 am33*-*-linux-gnu Not currently functional
0045 hppa-*-linux-gnu Not currently functional without patches.
0053 If you are interested in doing a port, please contact the glibc
0054 maintainers; see http://www.gnu.org/software/libc/ for more
0057 See the file INSTALL to find out how to configure, build, and install
0058 the GNU C Library. You might also consider reading the WWW pages for
0059 the C library at http://www.gnu.org/software/libc/.
0061 The GNU C Library is (almost) completely documented by the Texinfo manual
0062 found in the `manual/' subdirectory. The manual is still being updated
0063 and contains some known errors and omissions; we regret that we do not
0064 have the resources to work on the manual as much as we would like. For
0065 corrections to the manual, please file a bug in the `manual' component,
0066 following the bug-reporting instructions below. Please be sure to check
0067 the manual in the current development sources to see if your problem has
0068 already been corrected.
0070 Please see http://www.gnu.org/software/libc/bugs.html for bug reporting
0071 information. We are now using the Bugzilla system to track all bug reports.
0072 This web page gives detailed information on how to report bugs properly.
0074 The GNU C Library is free software. See the file COPYING.LIB for copying
0075 conditions, and LICENSES for notices about a few contributions that require
0076 these additional notices to be distributed. License copyright years may be
0077 listed using range notation, e.g., 2000-2013, indicating that every year in
0078 the range, inclusive, is a copyrightable year that would otherwise be listed