]>
Commit | Line | Data |
---|---|---|
effbd42a | 1 | This is the glibc ports add-on, an add-on for the GNU C Library (glibc). |
43d37683 | 2 | It contains code that is not maintained in the official glibc source tree. |
717de822 | 3 | |
43d37683 RM |
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. | |
10 | ||
effbd42a JM |
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 | |
b3c737fd | 14 | http://www.gnu.org/software/libc/download.html for details on using |
effbd42a | 15 | git. To report a bug in code housed in the ports add-on, please go to |
d9814526 JM |
16 | http://sourceware.org/bugzilla/ and file a bug report under the glibc |
17 | "ports" component. | |
43d37683 RM |
18 | |
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. | |
717de822 RM |
23 | |
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.in; 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.in, 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 | |
effbd42a | 38 | into a single add-on without interfering with each other. |
717de822 | 39 | |
43d37683 RM |
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. | |
717de822 | 42 | |
e1102f72 JM |
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 | |
e6898b8d | 47 | notation, e.g., 2000-2013, indicating that every year in the range, |
e1102f72 JM |
48 | inclusive, is a copyrightable year that would otherwise be listed |
49 | individually. |