X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=README;h=eb9b0b34a35e63712fd6146f752a188cce694c67;hb=6e8ba7fd574f530afb9681f21604475d5756d773;hp=8e416b7d48bf82849b5c8fbd77bc92c873c16985;hpb=717de822dcc29cc7f34e7c94e63b3f4cf572f470;p=thirdparty%2Fglibc.git diff --git a/README b/README index 8e416b7d48b..eb9b0b34a35 100644 --- a/README +++ b/README @@ -1,39 +1,72 @@ -This directory is an add-on for the GNU C Library (glibc). -It provides additional ports to machines and/or operating systems that are -not maintained in the official glibc source tree. - -The scripts in the top level of this directory provide the infrastructure -necessary for a glibc add-on. You can make a new add-on containing one or -more ports by copying configure, configure.in, and Makeconfig into your own -add-on directory, which you can give any name (it doesn't have to be -`ports'). You may want to include a README and Banner of your own talking -about your port's code in particular, rather than the generic ones here. - -The real source code for any ports is found in the sysdeps/ subdirectories. -These should be exactly what would go into the main libc source tree if you -were to incorporate it directly. The only exceptions are the files -sysdeps/*/preconfigure and sysdeps/*/preconfigure.in; these are fragments -used by this add-on's configure fragment. The purpose of these is to set -$base_machine et al when the main libc configure's defaults are not right -for some machine. Everything else can and should be done from a normal -sysdeps/.../configure fragment that is used only when the configuration -selects that sysdeps subdirectory. Each port that requires some special -treatment before the sysdeps directory list is calculated, should add a -sysdeps/CPU/preconfigure file; this can either be written by hand or -generated by Autoconf from sysdeps/CPU/preconfigure.in, and follow the -rules for glibc add-on configure fragments. No preconfigure file should do -anything on an unrelated configuration, so that disparate ports can be put -into a single add-on without interfering with each other. - -Like all glibc add-ons, the only way to use this is to place this directory -(just a symlink won't do) inside the top-level glibc source directory. -Then include the name of this directory (e.g. `ports') when you specify -`--enable-add-ons=...' to glibc's configure (or use just --enable-add-ons -to have it try every add-on directory sitting in your source tree). - -If you find problems with the top-level scripts in this add-on, please go -to http://sources.redhat.com/bugzilla/ and file a report for the glibc -under the "admin" component. - - -$Id$ +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 http://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 http://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 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, 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., 1996-2015, indicating that every year in +the range, inclusive, is a copyrightable year that would otherwise be listed +individually.