New file.
[glibc.git] / README
blob7c54caac449230185c5217506ec825ab18e00f27
1 This directory contains the version 2.2.1 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                 sparc-*-linux-gnu       Linux-2.x on SPARC
14                 sparc64-*-linux-gnu     Linux-2.x on UltraSPARC
15                 arm-*-none              ARM standalone systems
16                 arm-*-linux             Linux-2.x on ARM
17                 arm-*-linuxaout         Linux-2.x on ARM using a.out binaries
18                 mips*-*-linux-gnu       Linux-2.x on MIPS
19                 ia64-*-linux-gnu        Linux-2.x on ia64
20                 s390-*-linux-gnu        Linux-2.x on IBM S/390
22 Former releases of this library (version 1.09.1 and perhaps earlier
23 versions) used to run on the following configurations:
25                 alpha-dec-osf1
26                 i[3456]86-*-bsd4.3
27                 i[3456]86-*-isc2.2
28                 i[3456]86-*-isc3
29                 i[3456]86-*-sco3.2
30                 i[3456]86-*-sco3.2v4
31                 i[3456]86-*-sysv
32                 i[3456]86-*-sysv4
33                 i[3456]86-force_cpu386-none
34                 i[3456]86-sequent-bsd
35                 i960-nindy960-none
36                 m68k-hp-bsd4.3
37                 m68k-mvme135-none
38                 m68k-mvme136-none
39                 m68k-sony-newsos3
40                 m68k-sony-newsos4
41                 m68k-sun-sunos4
42                 mips-dec-ultrix4
43                 mips-sgi-irix4
44                 sparc-sun-solaris2
45                 sparc-sun-sunos4
47 Since no one has volunteered to test and fix the above configurations,
48 these are not supported at the moment.  It's expected that these don't
49 work anymore.  Porting the library is not hard.  If you are interested
50 in doing a port, please contact the glibc maintainers by sending
51 electronic mail to <bug-glibc@gnu.org>.
53 There are some add-ons which can be used together with GNU libc.  They
54 are designed in a way to ease the installation by integrating them in
55 the libc source tree.  Simply get the add-ons you need and use the
56 --enable-add-ons option of the `configure' script to tell where the
57 add-ons are found.  Please read the FAQ file for more details.
59 See the file INSTALL to find out how to configure, build, install, and port
60 the GNU C library.  You might also consider reading the WWW pages for the
61 GNU libc at http://www.gnu.org/software/libc/libc.html.
63 The GNU C Library is completely documented by the Texinfo manual found
64 in the `manual/' subdirectory.  The manual is still being updated and
65 contains some known errors and omissions; we regret that we do not
66 have the resources to work on the manual as much as we would like.
67 Please send comments on the manual to <bug-glibc-manual@gnu.org>, and
68 not to the library bug-reporting address.
70 The file NOTES contains a description of the feature-test macros used
71 in the GNU C library, explaining how you can tell the library what
72 facilities you want it to make available.
74 We prefer to get bug reports sent using the `glibcbug' shell script which
75 is installed together with the rest of the GNU libc to <bugs@gnu.org>.
76 Simply run this shell script and fill in the information.  Nevertheless
77 you can still send bug reports to <bug-glibc@gnu.org> as normal electronic
78 mails.
80 The GNU C Library is free software.  See the file COPYING.LIB for copying
81 conditions.