Go to file
Joseph Myers f214606a0e Enumerate tests with special rules in tests-special variable.
This patch is a revised and updated version of
<https://sourceware.org/ml/libc-alpha/2014-01/msg00196.html>.

In order to generate overall summaries of the results of all tests in
the glibc testsuite, we need to identify and concatenate the files
with the results of individual tests.

Tomas Dohnalek's patch used $(common-objpfx)*/*.test-result for this.
However, the normal glibc approach is explicit enumeration of the
expected set of files with a given property, rather than all files
matching some pattern like that.  Furthermore, we would like to be
able to mark tests as UNRESOLVED if the file with their results is for
some reason missing, and in future we would like to be able to mark
tests as UNSUPPORTED if they are disabled for a particular
configuration (rather than simply having them missing from the list of
tests as at present).  Such handling of tests that were not run or did
not record results requires an explicit enumeration of tests.

For the tests following the default makefile rules, $(tests) (and
$(xtests)) provides such an enumeration.  Others, however, are added
directly as dependencies of the "tests" and "xtests" makefile
targets.  This patch changes the makefiles to put them in variables
tests-special and xtests-special, with appropriate dependencies on the
tests listed there then being added centrally.

Those variables are used in Rules and so need to be set before Rules
is included in a subdirectory makefile, which is often earlier in the
makefile than the dependencies were present before.  We previously
discussed the question of where to include Rules; see the question at
<https://sourceware.org/ml/libc-alpha/2012-11/msg00798.html>, and a
discussion in
<https://sourceware.org/ml/libc-alpha/2013-01/msg00337.html> of why
Rules is included early rather than late in subdirectory makefiles.

It was necessary to avoid an indirection through the check-abi target
and get the check-abi-* targets for individual libraries into the
tests-special variable.  The intl/ test $(objpfx)tst-gettext.out,
previously built only because of dependencies from other tests, was
also added to tests-special for the same reason.

The entries in tests-special are the full makefile targets, complete
with $(objpfx) and .out.  If a future change causes tests to be named
consistently with a .out suffix, this can be changed to include just
the path relative to $(objpfx), without .out.

Tested x86_64, including that the same set of files is generated in
the build directory by a build and testsuite run both before and after
the patch (except for changes to the
elf/tst-null-argv.debug.out.<number> file name), and a build with
run-built-tests=no to verify there aren't any more obvious instances
of the issue Marcus Shawcroft reported with a previous version in
<https://sourceware.org/ml/libc-alpha/2014-01/msg00462.html>.

	* Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	(tests): Depend on $(tests-special).
	* Makerules (check-abi-list): New variable.
	(check-abi): Depend on $(check-abi-list).
	[$(subdir) = elf] (tests-special): Add
	$(objpfx)check-abi-libc.out.
	[$(build-shared) = yes && subdir] (tests-special): Add
	$(check-abi-list).
	[$(build-shared) = yes && subdir] (tests): Do not depend on
	check-abi.
	* Rules (tests): Depend on $(tests-special).
	(xtests): Depend on $(xtests-special).
	* catgets/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* conform/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* elf/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* grp/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* iconv/Makefile (xtests): Change dependencies to ....
	(xtests-special): ... additions to this variable.
	* iconvdata/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* intl/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.  Also add
	$(objpfx)tst-gettext.out.
	* io/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* libio/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* malloc/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* misc/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* nptl/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* nptl_db/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* posix/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	(xtests): Change dependencies to ....
	(xtests-special): ... additions to this variable.
	* resolv/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	(xtests): Change dependencies to ....
	(xtests-special): ... additions to this variable.
	* stdio-common/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	(do-tst-unbputc): Remove target.
	(do-tst-printf): Likewise.
	* stdlib/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* string/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
	* sysdeps/x86/Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.

localedata:
	* Makefile (tests): Change dependencies to ....
	(tests-special): ... additions to this variable.
2014-03-06 22:35:33 +00:00
argp Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
assert Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
benchtests Make strtok benchmark competive. 2014-02-28 22:45:33 +01:00
bits Complete _BSD_SOURCE / _SVID_source followup cleanup. 2014-02-21 21:45:26 +00:00
catgets Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
conf
conform Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
crypt Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
csu Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
ctype Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
debug Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
dirent Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
dlfcn Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
elf Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
gmon Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
gnulib Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
grp Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
gshadow Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
hesiod Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
hurd Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
iconv Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
iconvdata Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
include BZ #16632: Change [_BSD/_SVID]_SOURCE warning. 2014-02-25 13:23:25 -05:00
inet Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
intl Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
io Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
libidn Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
libio Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
locale Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
localedata Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
login Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
mach Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
malloc Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
manual Remove INSTALL_INFO setting in manual/Makefile. 2014-03-06 15:57:24 +00:00
math Prepare libm-test.inc structures for multi-rounding-mode testing. 2014-03-06 14:15:00 +00:00
misc Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
nis Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
nptl Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
nptl_db Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
nscd nscd: Improved support for tracking startup failure in nscd service (BZ #16639) 2014-03-03 23:18:31 +05:30
nss Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
po Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
ports Don't include individual test ulps in libm-test-ulps. 2014-03-05 15:02:38 +00:00
posix Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
pwd Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
resolv Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
resource Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
rt Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
scripts Support expected failures in .test-result files. 2014-02-27 03:25:27 +00:00
setjmp Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
shadow Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
signal Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
socket Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
soft-fp Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
stdio-common Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
stdlib Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
streams Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
string Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
sunrpc Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
sysdeps Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
sysvipc Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
termios Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
time Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
timezone Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
wcsmbs Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
wctype Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
.gitattributes exempt timezone files from the no-bad-whitespace policy 2009-06-15 18:15:54 +02:00
.gitignore ignore gdb related files 2013-12-27 16:30:50 -05:00
abi-tags * abi-tags (*-.*-syllable.*): New match, with ABI value 5. 2006-01-04 17:14:58 +00:00
aclocal.m4 rename configure.in to configure.ac 2013-10-30 17:32:08 +10:00
BUGS [BZ #5222] 2007-10-28 08:24:07 +00:00
CANCEL-FCT-WAIVE
CANCEL-FILE-WAIVE
ChangeLog Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
ChangeLog.1
ChangeLog.2
ChangeLog.3
ChangeLog.4
ChangeLog.5 * sysdeps/posix/getaddrinfo.c: Implement configuration file 2006-05-04 06:38:07 +00:00
ChangeLog.6
ChangeLog.7
ChangeLog.8
ChangeLog.9
ChangeLog.10
ChangeLog.11 2.5-18.1 2007-07-12 18:26:36 +00:00
ChangeLog.12 2.5-18.1 2007-07-12 18:26:36 +00:00
ChangeLog.13
ChangeLog.14 Update. 2004-04-20 04:28:00 +00:00
ChangeLog.15 Split out ChangeLog.15 at 2.3 branch point 2005-02-16 07:34:17 +00:00
ChangeLog.16 Fix typo in name 2012-06-21 16:45:27 +02:00
ChangeLog.17 Revert "Sun agreed to a change of the license for the RPC code to a BSD-like license." 2010-06-27 19:34:03 -07:00
config.h.in tst-fanotify: switch to AC_DEFINE 2014-01-04 08:34:01 -05:00
config.make.in Remove --disable-versioning. 2013-09-04 15:25:42 +00:00
configure Set AUTOCONF variable when maintainer-mode is not used 2013-12-16 21:45:27 +10:00
configure.ac Set AUTOCONF variable when maintainer-mode is not used 2013-12-16 21:45:27 +10:00
CONFORMANCE Move __STDC_* predefined macros from features.h to stdc-predef.h. 2012-02-22 12:53:04 +00:00
COPYING Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
COPYING.LIB Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
cppflags-iterator.mk 2004-03-11 Jeroen Dekkers <jeroen@dekkers.cx> 2004-03-14 19:13:17 +00:00
extra-lib.mk Remove --disable-versioning. 2013-09-04 15:25:42 +00:00
extra-modules.mk Update. 2004-03-08 21:31:23 +00:00
INSTALL Stop partial menu generation in INSTALL file 2013-12-19 11:54:06 +10:00
libc-abis A few more archs have IFUNC support. 2010-03-17 02:43:12 -07:00
LICENSES Expand LICENSES file. 2012-12-05 21:56:15 +00:00
Makeconfig Support expected failures in .test-result files. 2014-02-27 03:25:27 +00:00
Makefile Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
Makefile.in Add target bench-clean 2013-04-16 14:07:21 +05:30
Makerules Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
NAMESPACE
NEWS Separate ftell from fseek logic and avoid modifying FILE data (#16532) 2014-03-04 07:45:58 +05:30
o-iterator.mk
PROJECTS Update. 2004-10-12 06:19:23 +00:00
README [MicroBlaze]: Move MicroBlaze from ports to sysdeps. 2014-02-17 11:08:21 +10:00
Rules Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
shlib-versions PowerPC: Change powerpc64le start ABI to 2.17. 2014-02-04 09:49:08 -02:00
test-skeleton.c tests: unify fortification handler logic 2014-02-08 06:58:43 -05:00
version.h Open development for 2.20 2014-02-08 08:10:29 +10:00
Versions.def Add GLIBC_2.17 to librt in Version.def 2014-02-21 11:32:19 +01:00
WUR-REPORT * posix/unistd.h (setuid, setreuid, seteuid, setresuid): 2012-08-01 18:12:58 +02:00

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 2.6.16 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
	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

The code for other CPU configurations supported by volunteers outside of
the core glibc maintenance effort is contained in the `ports' add-on,
located in the `ports' subdirectory of the source tree.

	hppa-*-linux-gnu	Not currently functional without patches.

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., 2000-2013, indicating that every year in
the range, inclusive, is a copyrightable year that would otherwise be listed
individually.