Go to file
Joseph Myers 644d38570a Remove add-ons mechanism.
glibc has an add-ons mechanism to allow additional software to be
integrated into the glibc build.  Such add-ons may be within the glibc
source tree, or outside it at a path passed to the --enable-add-ons
configure option.

localedata and crypt were once add-ons, distributed in separate
release tarballs, but long since stopped using that mechanism.
Linuxthreads was always an add-on.  Ports spent some time as an add-on
with separate release tarballs, then was first moved into the glibc
source tree, then had its sysdeps files moved into the main sysdeps
hierarchy so the add-ons mechanism was no longer used.  NPTL spent
some time as an add-on in the main glibc tree before stopping using
the add-on mechanism.  libidn used to have separate release tarballs
but no longer does so, but still uses the add-ons mechanism within the
glibc source tree.  Various other software has supported building with
the add-ons mechanism at times in the past, but I don't think any is
still widely used.

Add-ons involve significant, little-used complexity in the glibc build
system, and make it hard to understand what the space of possible
glibc configurations is.  This patch removes the add-ons mechanism.
libidn is now built via the Subdirs mechanism to cause any
configuration using sysdeps/unix/inet to build libidn; HAVE_LIBIDN
(which effectively means shared libraries are available) is now
defined via sysdeps/unix/inet/configure.  Various references to
add-ons around the source tree are removed (in the case of maint.texi,
the example list of sysdeps directories is still very out of date).

Externally maintained ports should now put their files in the normal
sysdeps directory structure rather than being arranged as add-ons;
they probably need to change e.g. elf.h anyway, rather than actually
being able to work just as a drop-in subtree.  Hurd libpthread should
be arranged similarly to NPTL, so some files might go in a
hurd-pthreads (or similar) top-level directory in glibc, while sysdeps
files should go in the normal sysdeps directory structure (possibly in
hurd or hurd-pthreads subdirectories, just as there are nptl
subdirectories in the sysdeps tree).

Tested for x86_64, and with build-many-glibcs.py.

	* configure.ac (--enable-add-ons): Remove option.
	(machine): Do not mention add-ons in comment.
	(LIBC_PRECONFIGURE): Likewise.
	(add_ons): Remove variable and sanity checks and logic to locate
	add-ons.
	(add_ons_automatic): Remove variable.
	(configured_add_ons): Likewise.
	(add_ons_sfx): Likewise.
	(add_ons_pfx): Likewise.
	(add_on_subdirs): Likewise.
	(sysnames_add_ons): Likewise.  Remove loop over add-ons and
	consideration of add-ons in Implies handling.
	(sysdeps_add_ons): Likewise.
	* configure: Regenerated.
	* libidn/configure.ac: Remove.
	* libidn/configure: Likewise.
	* sysdeps/unix/inet/configure.ac: New file.
	* sysdeps/unix/inet/configure: New generated file.
	* sysdeps/unix/inet/Subdirs: Add libidn.
	* Makeconfig (sysdeps-srcdirs): Remove variable.
	(+sysdep_dirs): Do not include $(sysdeps-srcdirs).
	($(common-objpfx)config.status): Do not depend on add-on files.
	($(common-objpfx)shlib-versions.v.i): Do not mention add-ons in
	comment.
	(all-subdirs): Do not include $(add-on-subdirs).
	* Makefile (dist-prepare): Do not use $(sysdeps-add-ons).
	* config.make.in (add-ons): Remove variable.
	(add-on-subdirs): Likewise.
	(sysdeps-add-ons): Likewise.
	* manual/Makefile (add-chapters): Remove.
	($(objpfx)texis): Do not depend on $(add-chapters).
	(nonexamples): Do not handle $(add-chapters).
	(examples): Do not handle $(add-ons).
	(chapters.% top-menu.%): Do not pass '$(add-chapters)' to
	libc-texinfo.sh.
	* manual/install.texi (Installation): Do not mention add-ons.
	(--enable-add-ons): Do not document configure option.
	* INSTALL: Regenerated.
	* manual/libc-texinfo.sh: Do not handle $2 add-ons argument.
	* manual/maint.texi (Hierarchy Conventions): Do not mention
	add-ons.
	* scripts/build-many-glibcs.py (Glibc.build_glibc): Do not use
	--enable-add-ons.
	* scripts/gen-sorted.awk: Do not handle Subdirs files from
	add-ons.
	* scripts/test-installation.pl: Do not handle glibc-compat add-on.
	* sysdeps/nptl/Makeconfig: Do not mention add-ons in comment.
2017-10-05 15:58:13 +00:00
ChangeLog.old Move all old ChangeLogs to a top-level ChangeLog.old directory. 2017-09-01 09:31:43 -04:00
argp Mark internal argp functions with attribute_hidden [BZ #18822] 2017-10-01 15:10:27 -07:00
assert Fix position of tests-unsupported definition in assert/Makefile. 2017-08-22 00:30:51 +00:00
benchtests Add exp2f and log2f benchmark trace 2017-09-20 10:04:12 +01:00
bits hurd: Fix bits/socket.h conformity 2017-09-24 22:21:41 +02:00
catgets Don't compile non-lib modules as lib modules [BZ #21864] 2017-08-21 05:34:54 -07:00
conform Fix mcontext_t sigcontext namespace (bug 21457). 2017-08-30 22:02:04 +00:00
crypt crypt: Use NSPR header files in addition to NSS header files [BZ #17956] 2017-10-04 15:02:35 +02:00
csu Hide internal __libc_print_version function [BZ #18822] 2017-10-01 17:55:30 -07:00
ctype Use locale_t, not __locale_t, throughout glibc 2017-06-20 20:30:06 -04:00
debug Enable unwind info in libc-start.c and backtrace.c 2017-09-19 15:07:58 +01:00
dev Rename xlocale.h to bits/types/__locale_t.h. 2017-06-20 20:28:11 -04:00
dirent hurd: Fix dirfd symbol exposition from ftw 2017-09-28 00:49:05 +02:00
dlfcn Mark __dso_handle as hidden [BZ #18822] 2017-09-26 16:53:44 -07:00
elf Use $(DEFAULT-LDFLAGS-$(@F)) in +link-static-before-libc 2017-10-04 17:16:04 -07:00
gmon tst-gmon: Build with -fno-omit-frame-pointer 2017-10-05 14:34:45 +02:00
gnulib Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
grp Remove compat from DEFAULT_CONFIG lookup strings 2017-09-12 10:21:48 -07:00
gshadow Remove __need macros from stdio.h and wchar.h. 2017-06-08 13:58:17 -04:00
hesiod Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
hurd hurd: fix gethostname(NULL, 0) 2017-09-07 00:51:17 +02:00
iconv Mark internal functions with attribute_hidden [BZ #18822] 2017-10-01 15:07:23 -07:00
iconvdata Add new codepage charmaps/IBM858 [BZ #21084] 2017-09-14 15:50:57 +02:00
include Don't use hidden visibility in libc.a with PIE on i386 2017-10-04 17:18:42 -07:00
inet Hide internal idna functions [BZ #18822] 2017-10-01 17:33:22 -07:00
intl Hide internal __hash_string function [BZ #18822] 2017-10-01 17:41:34 -07:00
io hurd: Fix dirfd symbol exposition from ftw 2017-09-28 00:49:05 +02:00
libidn Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
libio Always do locking when iterating over list of streams (bug 15142) 2017-10-05 17:26:05 +02:00
locale Mark internal functions with attribute_hidden [BZ #18822] 2017-10-01 15:07:23 -07:00
localedata Add new codepage charmaps/IBM858 [BZ #21084] 2017-09-14 15:50:57 +02:00
login Mark internal utmp functions with attribute_hidden [BZ #18822] 2017-10-01 15:51:56 -07:00
mach hurd: Remove duplicate symbol version 2017-08-28 14:19:55 +02:00
malloc Mark __dso_handle as hidden [BZ #18822] 2017-09-26 16:53:44 -07:00
manual Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
math test-math-iscanonical.cc: Return errors != 0 2017-10-04 14:31:16 -07:00
mathvec Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
misc Hide internal __hasmntopt function [BZ #18822] 2017-10-01 17:37:42 -07:00
nis Move nss_compat from nis to nss subdir and install it unconditionally 2017-10-04 14:20:48 +02:00
nptl Mark __dso_handle as hidden [BZ #18822] 2017-09-26 16:53:44 -07:00
nptl_db Move all old ChangeLogs to a top-level ChangeLog.old directory. 2017-09-01 09:31:43 -04:00
nscd Hide internal __nis_hash function [BZ #18822] 2017-10-01 17:49:59 -07:00
nss Move nss_compat from nis to nss subdir and install it unconditionally 2017-10-04 14:20:48 +02:00
po Update translations 2017-09-11 05:50:49 +05:30
posix Hide internal __sched_setparam function [BZ #18822] 2017-10-01 17:43:25 -07:00
pwd Remove __need macros from stdio.h and wchar.h. 2017-06-08 13:58:17 -04:00
resolv Mark internal functions with attribute_hidden [BZ #18822] 2017-10-01 15:07:23 -07:00
resource Hide internal __setrlimit function [BZ #18822] 2017-10-01 17:46:54 -07:00
rt aio: Remove internal_function function attribute 2017-08-31 15:59:06 +02:00
scripts Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
setjmp Remove __need macros from signal.h. 2017-05-20 19:04:43 -04:00
shadow Remove __need macros from stdio.h and wchar.h. 2017-06-08 13:58:17 -04:00
signal Hide internal signal functions [BZ #18822] 2017-10-01 16:04:41 -07:00
socket __opensock: Remove internal_function attribute 2017-08-17 10:18:15 +02:00
soft-fp Remove non-add-on Banner files. 2017-09-21 17:49:51 +00:00
stdio-common linux: Implement tmpfile with O_TMPFILE (BZ#21530) 2017-09-01 09:52:47 -03:00
stdlib abort: Do not flush stdio streams [BZ #15436] 2017-10-05 14:48:16 +02:00
streams Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
string Hide internal __strsep function [BZ #18822] 2017-10-01 16:03:41 -07:00
sunrpc sunrpc/tst-udp-nonblocking: Fix timeout value 2017-09-10 21:09:28 +02:00
support support_format_hostent: Add more error information for NETDB_INTERNAL 2017-10-05 12:20:19 +02:00
sysdeps Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
sysvipc Fix test-sysvsem on some platforms 2017-01-02 18:53:50 -02:00
termios Hide internal __tcgetattr function [BZ #18822] 2017-10-01 17:48:24 -07:00
time time: Remove the internal_function attribute 2017-08-31 15:59:07 +02:00
timezone zic: Use PRIdMAX to print line numbers 2017-07-25 12:34:14 +05:30
wcsmbs Mark ____wcsto*_l_internal functions with attribute_hidden [BZ #18822] 2017-10-01 15:09:28 -07:00
wctype Use locale_t, not __locale_t, throughout glibc 2017-06-20 20:30:06 -04:00
.gitattributes
.gitignore
COPYING
COPYING.LIB
ChangeLog Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
INSTALL Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
LICENSES
MAINTAINERS Add MAINTAINERS 2017-05-11 13:38:30 -04:00
Makeconfig Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
Makefile Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
Makefile.in
Makerules Place $(elf-objpfx)sofini.os last [BZ #22051] 2017-08-31 06:28:46 -07:00
NEWS Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
README Require Linux kernel 3.2 or later on x86 / x86_64. 2017-05-08 10:45:20 +00:00
Rules Suppress internal declarations for most of the testsuite. 2017-05-11 19:27:59 -04:00
abi-tags Remove the bulk of the NaCl port. 2017-05-20 08:09:10 -04:00
aclocal.m4 gmon: Add test for basic mcount/gprof functionality 2017-08-15 15:49:45 +02:00
config.h.in Don't use hidden visibility in libc.a with PIE on i386 2017-10-04 17:18:42 -07:00
config.make.in Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
configure Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
configure.ac Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
extra-lib.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
gen-locales.mk
libc-abis
libof-iterator.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
o-iterator.mk
shlib-versions Extend NSS test suite 2017-07-17 15:52:44 -04:00
test-skeleton.c Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
version.h Open master for development 2017-08-02 19:23:16 +05:30

README

This directory contains the sources of the GNU C Library.
See the file "version.h" for what release version you have.

The GNU C Library is the standard system C library for all GNU systems,
and is an important part of what makes up a GNU system.  It provides the
system API for all programs written in C and C-compatible languages such
as C++ and Objective C; the runtime facilities of other programming
languages use the C library to access the underlying operating system.

In GNU/Linux systems, the C library works with the Linux kernel to
implement the operating system behavior seen by user applications.
In GNU/Hurd systems, it works with a microkernel and Hurd servers.

The GNU C Library implements much of the POSIX.1 functionality in the
GNU/Hurd system, using configurations i[4567]86-*-gnu.  The current
GNU/Hurd support requires out-of-tree patches that will eventually be
incorporated into an official GNU C Library release.

When working with Linux kernels, this version of the GNU C Library
requires Linux kernel version 3.2 or later.

Also note that the shared version of the libgcc_s library must be
installed for the pthread library to work correctly.

The GNU C Library supports these configurations for using Linux kernels:

	aarch64*-*-linux-gnu
	alpha*-*-linux-gnu
	arm-*-linux-gnueabi
	hppa-*-linux-gnu	Not currently functional without patches.
	i[4567]86-*-linux-gnu
	x86_64-*-linux-gnu	Can build either x86_64 or x32
	ia64-*-linux-gnu
	m68k-*-linux-gnu
	microblaze*-*-linux-gnu
	mips-*-linux-gnu
	mips64-*-linux-gnu
	powerpc-*-linux-gnu	Hardware or software floating point, BE only.
	powerpc64*-*-linux-gnu	Big-endian and little-endian.
	s390-*-linux-gnu
	s390x-*-linux-gnu
	sh[34]-*-linux-gnu
	sparc*-*-linux-gnu
	sparc64*-*-linux-gnu
	tilegx-*-linux-gnu
	tilepro-*-linux-gnu

If you are interested in doing a port, please contact the glibc
maintainers; see http://www.gnu.org/software/libc/ for more
information.

See the file INSTALL to find out how to configure, build, and install
the GNU C Library.  You might also consider reading the WWW pages for
the C library at http://www.gnu.org/software/libc/.

The GNU C Library is (almost) completely documented by the Texinfo manual
found in the `manual/' subdirectory.  The manual is still being updated
and contains some known errors and omissions; we regret that we do not
have the resources to work on the manual as much as we would like.  For
corrections to the manual, please file a bug in the `manual' component,
following the bug-reporting instructions below.  Please be sure to check
the manual in the current development sources to see if your problem has
already been corrected.

Please see http://www.gnu.org/software/libc/bugs.html for bug reporting
information.  We are now using the Bugzilla system to track all bug reports.
This web page gives detailed information on how to report bugs properly.

The GNU C Library is free software.  See the file COPYING.LIB 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., 1996-2015, indicating that every year in
the range, inclusive, is a copyrightable year that would otherwise be listed
individually.