ia64: implement futex requeue pi support
[glibc.git] / ports / README
blob2c73b1e803fd6c1ad11e77a1781131f1993eb112
1 This is the glibc ports add-on, an add-on for the GNU C Library (glibc).
2 It contains code that is not maintained in the official glibc source tree.
4 This includes working ports to GNU/Linux on some machine architectures that
5 are not maintained in the official glibc source tree.  It also includes
6 some code once used by old libc ports now defunct, which has been abandoned
7 but may be useful for some future porter to examine.  It may also include
8 some optimized functions tailored for specific CPU implementations of an
9 architecture, to be selected using --with-cpu.
11 The ports add-on is cooperatively maintained by volunteers on the
12 <libc-ports@sourceware.org> mailing list, and housed in the ports
13 subdirectory of the glibc git repository.  See
14 http://www.gnu.org/software/libc/download.html for details on using
15 git.  To report a bug in code housed in the ports add-on, please go to
16 http://sourceware.org/bugzilla/ and file a bug report under the glibc
17 "ports" component.
19 An add-on for an individual port can be made from just the sysdeps/
20 subdirectories containing the port's code.  You may want to include a
21 README and Banner of your own talking about your port's code in particular,
22 rather than the generic ones here.
24 The real source code for any ports is found in the sysdeps/ subdirectories.
25 These should be exactly what would go into the main libc source tree if you
26 were to incorporate it directly.  The only exceptions are the files
27 sysdeps/*/preconfigure and sysdeps/*/preconfigure.ac; these are fragments
28 used by this add-on's configure fragment.  The purpose of these is to set
29 $base_machine et al when the main libc configure's defaults are not right
30 for some machine.  Everything else can and should be done from a normal
31 sysdeps/.../configure fragment that is used only when the configuration
32 selects that sysdeps subdirectory.  Each port that requires some special
33 treatment before the sysdeps directory list is calculated, should add a
34 sysdeps/CPU/preconfigure file; this can either be written by hand or
35 generated by Autoconf from sysdeps/CPU/preconfigure.ac, and follow the
36 rules for glibc add-on configure fragments.  No preconfigure file should do
37 anything on an unrelated configuration, so that disparate ports can be put
38 into a single add-on without interfering with each other.
40 Like all glibc add-ons, this must be used by specifying the directory in
41 the --enable-add-ons option when running glibc's configure script.
43 The GNU C Library is free software.  See the file COPYING.LIB in the
44 libc repository for copying conditions, and LICENSES for notices about
45 a few contributions that require these additional notices to be
46 distributed.  License copyright years may be listed using range
47 notation, e.g., 2000-2013, indicating that every year in the range,
48 inclusive, is a copyrightable year that would otherwise be listed
49 individually.