2004-11-29 Roland McGrath <roland@redhat.com>
[glibc.git] / README
blob69a712a6cfa8d99876f63d564c04dd7d168c1761
1 This directory contains the version 2.3.3 release of the GNU C Library.
2 Many bugs have been fixed since the last release.
3 Some bugs surely remain.
5 As of this release, the GNU C library is known to run on the following
6 configurations:
8                 *-*-gnu                 GNU Hurd
9                 i[3456]86-*-linux-gnu   Linux-2.x on Intel
10                 m68k-*-linux-gnu        Linux-2.x on Motorola 680x0
11                 alpha*-*-linux-gnu      Linux-2.x on DEC Alpha
12                 powerpc-*-linux-gnu     Linux and MkLinux on PowerPC systems
13                 powerpc64-*-linux-gnu   Linux-2.4.19+ on 64-bit PowerPC systems
14                 sparc-*-linux-gnu       Linux-2.x on SPARC
15                 sparc64-*-linux-gnu     Linux-2.x on UltraSPARC 64-bit
16                 arm-*-none              ARM standalone systems
17                 arm-*-linux             Linux-2.x on ARM
18                 arm-*-linuxaout         Linux-2.x on ARM using a.out binaries
19                 mips*-*-linux-gnu       Linux-2.x on MIPS
20                 ia64-*-linux-gnu        Linux-2.x on ia64
21                 s390-*-linux-gnu        Linux-2.x on IBM S/390
22                 s390x-*-linux-gnu       Linux-2.4+ on IBM S/390 64-bit
23                 sh-*-linux-gnu          Linux-2.x on Super Hitachi
24                 cris-*-linux-gnu        Linux-2.4+ on CRIS
25                 x86-64-*-linux-gnu      Linux-2.4+ on x86-64
27 Former releases of this library (version 1.09.1 and perhaps earlier
28 versions) used to run on the following configurations:
30                 alpha-dec-osf1
31                 i[3456]86-*-bsd4.3
32                 i[3456]86-*-isc2.2
33                 i[3456]86-*-isc3
34                 i[3456]86-*-sco3.2
35                 i[3456]86-*-sco3.2v4
36                 i[3456]86-*-sysv
37                 i[3456]86-*-sysv4
38                 i[3456]86-force_cpu386-none
39                 i[3456]86-sequent-bsd
40                 i960-nindy960-none
41                 m68k-hp-bsd4.3
42                 m68k-mvme135-none
43                 m68k-mvme136-none
44                 m68k-sony-newsos3
45                 m68k-sony-newsos4
46                 m68k-sun-sunos4
47                 mips-dec-ultrix4
48                 mips-sgi-irix4
49                 sparc-sun-solaris2
50                 sparc-sun-sunos4
52 Since no one has volunteered to test and fix the above configurations,
53 these are not supported at the moment.  It's expected that these don't
54 work anymore.  Porting the library is not hard.  If you are interested
55 in doing a port, please contact the glibc maintainers by sending
56 electronic mail to <bug-glibc@gnu.org>.
58 There are some add-ons which can be used together with GNU libc.  They
59 are designed in a way to ease the installation by integrating them in
60 the libc source tree.  Simply get the add-ons you need and use the
61 --enable-add-ons option of the `configure' script to tell where the
62 add-ons are found.  Please read the FAQ file for more details.
64 See the file INSTALL to find out how to configure, build, install, and port
65 the GNU C library.  You might also consider reading the WWW pages for the
66 GNU libc at http://www.gnu.org/software/libc/libc.html.
68 The GNU C Library is completely documented by the Texinfo manual found
69 in the `manual/' subdirectory.  The manual is still being updated and
70 contains some known errors and omissions; we regret that we do not
71 have the resources to work on the manual as much as we would like.
72 Please send comments on the manual to <bug-glibc-manual@gnu.org>, and
73 not to the library bug-reporting address.
75 The file NOTES contains a description of the feature-test macros used
76 in the GNU C library, explaining how you can tell the library what
77 facilities you want it to make available.
79 We prefer to get bug reports sent using the `glibcbug' shell script which
80 is installed together with the rest of the GNU libc to <bugs@gnu.org>.
81 Simply run this shell script and fill in the information.  Nevertheless
82 you can still send bug reports to <bug-glibc@gnu.org> as normal electronic
83 mails.
85 The GNU C Library is free software.  See the file COPYING.LIB for copying
86 conditions, and LICENSES for notices about a few contributions that require
87 these additional notices to be distributed.