Back to home page

glibc Cross Reference

 
 

    


0001 This directory contains the sources of the GNU C Library.
0002 See the file "version.h" for what release version you have.
0003 
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.
0009 
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.
0013 
0014 The GNU C Library implements much of the POSIX.1 functionality in the
0015 GNU/Hurd system, using configurations i[4567]86-*-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.
0018 
0019 When working with Linux kernels, this version of the GNU C Library
0020 requires Linux kernel version 2.6.16 or later.
0021 
0022 Also note that the shared version of the libgcc_s library must be
0023 installed for the pthread library to work correctly.
0024 
0025 The GNU C Library supports these configurations for using Linux kernels:
0026 
0027         i[4567]86-*-linux-gnu
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.
0031         s390-*-linux-gnu
0032         s390x-*-linux-gnu
0033         sh[34]-*-linux-gnu
0034         sparc*-*-linux-gnu
0035         sparc64*-*-linux-gnu
0036 
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.
0040 
0041         aarch64*-*-linux-gnu
0042         alpha*-*-linux-gnu
0043         am33*-*-linux-gnu       Not currently functional
0044         arm-*-linux-gnueabi
0045         hppa-*-linux-gnu        Not currently functional without patches.
0046         ia64-*-linux-gnu
0047         m68k-*-linux-gnu
0048         mips-*-linux-gnu
0049         mips64-*-linux-gnu
0050         tilegx-*-linux-gnu
0051         tilepro-*-linux-gnu
0052 
0053 If you are interested in doing a port, please contact the glibc
0054 maintainers; see http://www.gnu.org/software/libc/ for more
0055 information.
0056 
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/.
0060 
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.
0069 
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.
0073 
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
0079 individually.