glibc/ports
Thomas Schwinge c7b275d6b3 bits/nan.h: Change __attribute_used__ to __attribute__ ((unused)). 2013-02-20 16:49:58 +01:00
..
sysdeps bits/nan.h: Change __attribute_used__ to __attribute__ ((unused)). 2013-02-20 16:49:58 +01:00
ChangeLog Update miscellaneous copyright dates. 2013-01-02 19:43:40 +00:00
ChangeLog.aarch64 Add __cxa_thread_atexit_impl to aarch64 abilist 2013-02-18 22:23:19 +05:30
ChangeLog.aix Move all files into ports/ subdirectory in preparation for merge with glibc 2012-07-01 13:06:41 +00:00
ChangeLog.alpha C++11 thread_local destructors support 2013-02-18 19:08:21 +05:30
ChangeLog.am33 Remove miscellaneous bounded-pointers relics in C code. 2013-02-15 00:51:53 +00:00
ChangeLog.arm Add FUTEX_*_REQUEUE_PI support for ARM. 2013-02-18 23:49:05 +00:00
ChangeLog.cris Move all files into ports/ subdirectory in preparation for merge with glibc 2012-07-01 13:06:41 +00:00
ChangeLog.hppa hppa: Remove unused lll_unlock_wake_cb. 2013-02-14 10:34:48 -05:00
ChangeLog.ia64 C++11 thread_local destructors support 2013-02-18 19:08:21 +05:30
ChangeLog.linux-generic Update copyright notices with scripts/update-copyrights. 2013-01-02 19:05:09 +00:00
ChangeLog.m68k C++11 thread_local destructors support 2013-02-18 19:08:21 +05:30
ChangeLog.mips bits/nan.h: Change __attribute_used__ to __attribute__ ((unused)). 2013-02-20 16:49:58 +01:00
ChangeLog.powerpc C++11 thread_local destructors support 2013-02-18 19:08:21 +05:30
ChangeLog.tile C++11 thread_local destructors support 2013-02-18 19:08:21 +05:30
README Update miscellaneous copyright dates. 2013-01-02 19:43:40 +00:00

README

This is the glibc ports add-on, an add-on for the GNU C Library (glibc).
It contains code that is not maintained in the official glibc source tree.

This includes working ports to GNU/Linux on some machine architectures that
are not maintained in the official glibc source tree.  It also includes
some code once used by old libc ports now defunct, which has been abandoned
but may be useful for some future porter to examine.  It may also include
some optimized functions tailored for specific CPU implementations of an
architecture, to be selected using --with-cpu.

The ports add-on is cooperatively maintained by volunteers on the
<libc-ports@sourceware.org> mailing list, and housed in the ports
subdirectory of the glibc git repository.  See
http://www.gnu.org/software/libc/download.html for details on using
git.  To report a bug in code housed in the ports add-on, please go to
http://sourceware.org/bugzilla/ and file a bug report under the glibc
"ports" component.

An add-on for an individual port can be made from just the sysdeps/
subdirectories containing the port's code.  You may want to include a
README and Banner of your own talking about your port's code in particular,
rather than the generic ones here.

The real source code for any ports is found in the sysdeps/ subdirectories.
These should be exactly what would go into the main libc source tree if you
were to incorporate it directly.  The only exceptions are the files
sysdeps/*/preconfigure and sysdeps/*/preconfigure.in; these are fragments
used by this add-on's configure fragment.  The purpose of these is to set
$base_machine et al when the main libc configure's defaults are not right
for some machine.  Everything else can and should be done from a normal
sysdeps/.../configure fragment that is used only when the configuration
selects that sysdeps subdirectory.  Each port that requires some special
treatment before the sysdeps directory list is calculated, should add a
sysdeps/CPU/preconfigure file; this can either be written by hand or
generated by Autoconf from sysdeps/CPU/preconfigure.in, and follow the
rules for glibc add-on configure fragments.  No preconfigure file should do
anything on an unrelated configuration, so that disparate ports can be put
into a single add-on without interfering with each other.

Like all glibc add-ons, this must be used by specifying the directory in
the --enable-add-ons option when running glibc's configure script.

The GNU C Library is free software.  See the file COPYING.LIB in the
libc repository for copying conditions, and LICENSES for notices about
a few contributions that require these additional notices to be
distributed.  License copyright years may be listed using range
notation, e.g., 2000-2013, indicating that every year in the range,
inclusive, is a copyrightable year that would otherwise be listed
individually.