Go to file
Joseph Myers 02c78f02a9 Make build-many-glibcs.py track component versions requested and used.
This patch makes build-many-glibcs.py record the component versions
checked out, and whether those versions were explicitly requested or
defaults, in a file versions.json in the source directory.

The preferred version of a component is the first of: one explicitly
specified on the command line; one explicitly specified on the command
line in a previous run of build-many-glibcs.py; a default version for
that component.  Thus, once you've run build-many-glibcs.py checkout
once with the updated script (making sure to specify the right
versions of any components previously checked out with a non-default
version), in future you can just run it without version specifiers and
it will know when a default-version component has changed its default
version and so should be checked out again.

Because you might have local changes and not want a default-version
component checkout replaced, you need to pass the --replace-sources
option to allow the script to delete and replace a component source
directory automatically; otherwise, it will give an error if a version
has changed.  The script does not try to change branches of git or SVN
checkouts without checking out from scratch; if the version number
requested has changed and --replace-sources is used, the relevant
source directory will be removed completely and a new one checked out
from scratch.

Apart from allowing automatic updates of components with default
versions, this also facilitates bots reporting on the versions used in
a given build.  versions.json contains not just information on the
version number and whether that was requested explicitly, but also git
or SVN revision information intended to be used in email reports from
bots.

	* scripts/build-many-glibcs.py: Import json module.
	(Context.__init__): Take replace_sources argument.  Load
	versions.json.
	(Context.load_versions_json): New function.
	(Context.store_json): Likewise.
	(Context.store_versions_json): Likewise.
	(Context.set_component_version): Likewise.
	(Context.checkout): Update versions.json.  Check for and handle
	changes of version.  Prefer previously explicitly specified
	version to default version.
	(Context.checkout_vcs): Return a revision identifier.
	(Context.git_checkout): Likewise.
	(Context.gcc_checkout): Likewise.
	(get_parser): Add --replace-sources option.
	(main): Pass replace_sources argument to Context call.
2016-11-24 22:25:58 +00:00
argp Installed-header hygiene (BZ#20366): Simple self-contained fixes. 2016-09-23 08:43:55 -04:00
assert
benchtests Use -fno-builtin for sqrt benchmark. 2016-10-21 21:18:03 +00:00
bits Refactor float_t, double_t information into bits/flt-eval-method.h. 2016-11-24 18:44:50 +00:00
catgets
conform Enable linknamespace testing for libdl and libcrypt. 2016-11-16 22:47:57 +00:00
crypt Fix crypt snprintf namespace (bug 20829). 2016-11-16 22:46:48 +00:00
csu Remove __libc_csu_irel declaration 2016-09-10 15:50:53 +05:30
ctype
debug Add tests for fortification of bcopy and bzero. 2016-08-19 09:04:35 -04:00
dirent
dlfcn Fix warning caused by unused-result in bug-atexit3-lib.cc 2016-10-28 19:26:14 -02:00
elf elf: Assume TLS is initialized in _dl_map_object_from_fd 2016-11-23 13:12:03 +01:00
gmon Installed-header hygiene (BZ#20366): obsolete BSD u_* types. 2016-09-23 08:43:56 -04:00
gnulib
grp Don't install the internal header grp-merge.h 2016-07-18 09:33:21 -03:00
gshadow
hesiod hesiod: Avoid heap overflow in get_txt_records [BZ #20031] 2016-05-02 16:04:32 +02:00
hurd Fix hurd __access_noerrno implementation. 2016-11-18 16:49:08 -02:00
iconv gconv.h: fix build with GCC 7 2016-11-06 21:33:10 +01:00
iconvdata Bug 20729: Fix building with -Os. 2016-10-29 23:50:56 -04:00
include Fix hurd __access_noerrno implementation. 2016-11-18 16:49:08 -02:00
inet Installed-header hygiene (BZ#20366): conditionally defined structures. 2016-09-23 08:43:56 -04:00
intl hurd: fix pathconf visibility 2016-09-18 23:45:12 +02:00
io New internal function __access_noerrno 2016-11-16 15:53:58 -02:00
libidn
libio Fix tst-memstream3 build failure 2016-10-02 10:24:32 -03:00
locale Bug 20729: Include libc-internal.h where required. 2016-10-31 16:46:57 -04:00
localedata localedata: lt_LT: use hyphens in d_fmt [BZ #20497] 2016-08-24 16:07:02 -04:00
login 2016-06-11 Paul Pluzhnikov <ppluzhnikov@google.com> 2016-06-11 14:50:16 -07:00
mach Fix old-style function definition 2016-09-20 23:10:51 +02:00
malloc malloc: Update comments about chunk layout 2016-10-28 22:36:58 +02:00
manual Add setpayload, setpayloadf, setpayloadl. 2016-11-19 00:16:28 +00:00
math Refactor float_t, double_t information into bits/flt-eval-method.h. 2016-11-24 18:44:50 +00:00
mathvec
misc Fix multiple definitions of mk[o]stemp[s]64 2016-11-22 13:51:19 +01:00
nis Installed-header hygiene (BZ#20366): Simple self-contained fixes. 2016-09-23 08:43:55 -04:00
nptl Remove cached PID/TID in clone 2016-11-24 19:38:51 -02:00
nptl_db Remove cached PID/TID in clone 2016-11-24 19:38:51 -02:00
nscd Fix incorrect double-checked locking related to _res_hconf.initialized. 2016-08-18 20:53:37 +02:00
nss Fix incorrect double-checked locking related to _res_hconf.initialized. 2016-08-18 20:53:37 +02:00
po Update PO files. 2016-08-04 11:41:27 -04:00
posix Fix writes past the allocated array bounds in execvpe (BZ#20847) 2016-11-22 10:23:07 -02:00
pwd
resolv Bug 20729: Fix build failures on ppc64 and other arches. 2016-11-02 13:01:36 -04:00
resource
rt Use libc_ifunc macro for clock_* symbols in librt. 2016-10-07 10:12:47 +02:00
scripts Make build-many-glibcs.py track component versions requested and used. 2016-11-24 22:25:58 +00:00
setjmp
shadow
signal Installed-header hygiene (BZ#20366): time.h types. 2016-09-23 08:43:56 -04:00
socket Installed-header hygiene (BZ#20366): conditionally defined structures. 2016-09-23 08:43:56 -04:00
soft-fp [soft-fp] Add support for various half-precision conversion routines. 2016-09-21 21:02:54 +00:00
stdio-common Fix crypt snprintf namespace (bug 20829). 2016-11-16 22:46:48 +00:00
stdlib Ignore -Wmaybe-uninitialized in stdlib/bug-getcontext.c. 2016-11-11 21:05:51 +00:00
streams
string Correct comments in string.h re strcoll_l, strxfrm_l. 2016-11-16 14:18:32 -05:00
sunrpc Fix build-and-build-again bug in sunrpc tests. 2016-11-14 14:25:11 -05:00
sysdeps Remove cached PID/TID in clone 2016-11-24 19:38:51 -02:00
sysvipc Installed-header hygiene (BZ#20366): time.h types. 2016-09-23 08:43:56 -04:00
termios Declare tcgetsid for XPG4 (bug 20055). 2016-05-11 18:05:37 +00:00
time Fix -Wformat-length warning in time/tst-strptime2.c 2016-11-02 16:00:39 -07:00
timezone
wcsmbs Add tst-wcstod-round 2016-08-19 11:17:07 -05:00
wctype
.gitattributes
.gitignore
BUGS
CONFORMANCE
COPYING
COPYING.LIB
ChangeLog Make build-many-glibcs.py track component versions requested and used. 2016-11-24 22:25:58 +00:00
ChangeLog.1
ChangeLog.2
ChangeLog.3
ChangeLog.4
ChangeLog.5
ChangeLog.6
ChangeLog.7
ChangeLog.8 ChangeLog: change Winblowz to Windows 2016-08-10 00:49:28 +08:00
ChangeLog.9
ChangeLog.10
ChangeLog.11 ChangeLog: change Winblowz to Windows 2016-08-10 00:49:28 +08:00
ChangeLog.12
ChangeLog.13
ChangeLog.14
ChangeLog.15
ChangeLog.16
ChangeLog.17
ChangeLog.old-ports
ChangeLog.old-ports-aarch64
ChangeLog.old-ports-aix
ChangeLog.old-ports-alpha
ChangeLog.old-ports-am33
ChangeLog.old-ports-arm
ChangeLog.old-ports-cris
ChangeLog.old-ports-hppa
ChangeLog.old-ports-ia64
ChangeLog.old-ports-linux-generic
ChangeLog.old-ports-m68k
ChangeLog.old-ports-microblaze
ChangeLog.old-ports-mips
ChangeLog.old-ports-powerpc
ChangeLog.old-ports-tile
INSTALL Add configure check to test if gcc supports attribute ifunc. 2016-10-07 10:02:59 +02:00
LICENSES
Makeconfig Generate .op pattern rules for profiling builds only 2016-09-21 10:45:19 +02:00
Makefile Installed header hygiene (BZ#20366): Test of installed headers. 2016-09-23 08:43:56 -04:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Avoid running $(CXX) during build to obtain header file paths 2016-09-21 10:45:32 +02:00
NAMESPACE
NEWS More NEWS entries / fixes for float_t / double_t changes. 2016-11-23 21:30:04 +00:00
PROJECTS
README
Rules Do not generate UNRESOLVED results for run-built-tests = no. 2016-11-04 21:29:00 +00:00
WUR-REPORT
abi-tags
aclocal.m4
config.h.in Add configure check to test if gcc supports attribute ifunc. 2016-10-07 10:02:59 +02:00
config.make.in Avoid running $(CXX) during build to obtain header file paths 2016-09-21 10:45:32 +02:00
configure configure: accept __stack_chk_fail_local for ssp support too [BZ #20662] 2016-11-15 14:15:19 -05:00
configure.ac configure: accept __stack_chk_fail_local for ssp support too [BZ #20662] 2016-11-15 14:15:19 -05:00
cppflags-iterator.mk
extra-lib.mk
extra-modules.mk
gen-locales.mk
libc-abis
o-iterator.mk
shlib-versions
test-skeleton.c Document do_test in test-skeleton.c 2016-11-07 08:28:52 -08:00
version.h Open development for 2.25. 2016-08-01 23:00:21 -04:00

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 on all architectures except
i[4567]86 and x86_64, where Linux kernel version 2.6.32 or later
suffices.

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.