← Back to branch summary

~ubuntu-branches/ubuntu/natty/eglibc/natty-security

« back to all changes in this revision

Viewing changes to ports/README

  • Committer: Bazaar Package Importer
  • Author(s): Aurelien Jarno
  • Date: 2009-05-05 09:54:14 UTC
  • Revision ID: james.westby@ubuntu.com-20090505095414-c45qsg9ixjheohru
Import upstream version 2.9

Show diffs side-by-side

added added

removed removed

Lines of Context:
ports/README
 
1
This is the glibc ports repository, an add-on for the GNU C Library (glibc).
 
2
It contains code that is not maintained in the official glibc source tree.
 
3
 
 
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
 
 
11
The ports repository is cooperatively maintained by volunteers on the
 
12
<libc-ports@sourceware.org> mailing list, and housed in the glibc CVS as a
 
13
module called "ports".  See http://www.gnu.org/software/libc/resources.html
 
14
for details on using CVS.  To report a bug in code housed in the ports
 
15
repository, please go to http://sources.redhat.com/bugzilla/ and file a bug
 
16
report under the glibc "ports" component.
 
17
 
 
18
An add-on for an individual port can be made from just the sysdeps/
 
19
subdirectories containing the port's code.  You may want to include a
 
20
README and Banner of your own talking about your port's code in particular,
 
21
rather than the generic ones here.
 
22
 
 
23
The real source code for any ports is found in the sysdeps/ subdirectories.
 
24
These should be exactly what would go into the main libc source tree if you
 
25
were to incorporate it directly.  The only exceptions are the files
 
26
sysdeps/*/preconfigure and sysdeps/*/preconfigure.in; these are fragments
 
27
used by this add-on's configure fragment.  The purpose of these is to set
 
28
$base_machine et al when the main libc configure's defaults are not right
 
29
for some machine.  Everything else can and should be done from a normal
 
30
sysdeps/.../configure fragment that is used only when the configuration
 
31
selects that sysdeps subdirectory.  Each port that requires some special
 
32
treatment before the sysdeps directory list is calculated, should add a
 
33
sysdeps/CPU/preconfigure file; this can either be written by hand or
 
34
generated by Autoconf from sysdeps/CPU/preconfigure.in, and follow the
 
35
rules for glibc add-on configure fragments.  No preconfigure file should do
 
36
anything on an unrelated configuration, so that disparate ports can be put
 
37
into a single add-on without interfering with each other.
 
38
 
 
39
Like all glibc add-ons, this must be used by specifying the directory in
 
40
the --enable-add-ons option when running glibc's configure script.
 
41
 
 
42
 
 
43
$Id: README,v 1.2 2006/02/28 08:23:38 roland Exp $