X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=README;h=ce7d10342bc6ceef5b5c1d1fc45c3733e44fcaa5;hb=585d9c182d34e96553f18ae357c46d2af4e57dee;hp=4feebff1e2b2e6c1303906fbbcee3f6025ff23c6;hpb=ae063ec2fbe30b9c423e486f73206983cae720e6;p=platform%2Fupstream%2Fglibc.git diff --git a/README b/README index 4feebff..ce7d103 100644 --- a/README +++ b/README @@ -1,87 +1,74 @@ -This directory contains the version 2.3.2 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 - 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 - cris-*-linux-gnu Linux-2.4+ on CRIS - x86-64-*-linux-gnu Linux-2.4+ on x86-64 +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. -Former releases of this library (version 1.09.1 and perhaps earlier -versions) used to run on the following configurations: +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. - 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 +When working with Linux kernels, this version of the GNU C Library +requires Linux kernel version 2.6.32 or later. -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 . +Also note that the shared version of the libgcc_s library must be +installed for the pthread library to work correctly. -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. +The GNU C Library supports these configurations for using Linux kernels: -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. + 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 -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 , and -not to the library bug-reporting address. +If you are interested in doing a port, please contact the glibc +maintainers; see http://www.gnu.org/software/libc/ for more +information. -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. +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/. -We prefer to get bug reports sent using the `glibcbug' shell script which -is installed together with the rest of the GNU libc to . -Simply run this shell script and fill in the information. Nevertheless -you can still send bug reports to as normal electronic -mails. +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. +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.