Go to file
Maciej W. Rozycki 1b97a9f23b support: Add FAIL test failure helper
Add a FAIL test failure helper analogous to FAIL_RET, that does not
cause the current function to return, providing a standardized way to
report a test failure with a message supplied while permitting the
caller to continue executing, for further reporting, cleaning up, etc.

Update existing test cases that provide a conflicting definition of FAIL
by removing the local FAIL definition and then as follows:

- tst-fortify-syslog: provide a meaningful message in addition to the
  file name already added by <support/check.h>; 'support_record_failure'
  is already called by 'support_print_failure_impl' invoked by the new
  FAIL test failure helper.

- tst-ctype: no update to FAIL calls required, with the name of the file
  and the line number within of the failure site additionally included
  by the new FAIL test failure helper, and error counting plus count
  reporting upon test program termination also already provided by
  'support_record_failure' and 'support_report_failure' respectively,
  called by 'support_print_failure_impl' and 'adjust_exit_status' also
  respectively.  However in a number of places 'printf' is called and
  the error count adjusted by hand, so update these places to make use
  of FAIL instead.  And last but not least adjust the final summary just
  to report completion, with any error count following as reported by
  the test driver.

- test-tgmath2: no update to FAIL calls required, with the name of the
  file of the failure site additionally included by the new FAIL test
  failure helper.  Also there is no need to track the return status by
  hand as any call to FAIL will eventually cause the test case to return
  an unsuccesful exit status regardless of the return status from the
  test function, via a call to 'adjust_exit_status' made by the test
  driver.

Reviewed-by: DJ Delorie <dj@redhat.com>
2024-07-26 13:21:34 +01:00
ChangeLog.old Add ChangeLog file 2024-07-21 18:33:37 +02:00
advisories
argp
assert
benchtests
bits
catgets
conform
csu
ctype
debug support: Add FAIL test failure helper 2024-07-26 13:21:34 +01:00
dirent
dlfcn
elf elf: Parse the auxv values as unsigned on tst-tunables-enable_secure-env.c (BZ 31890) 2024-07-19 08:50:38 -03:00
gmon
gnulib
hesiod
htl hurd: Fix pthread_self() without libpthread 2024-07-17 14:14:21 +02:00
hurd hurd: Fix restoring message to be retried 2024-07-13 17:05:13 +02:00
iconv
iconvdata
include Increase version number to 2.40 2024-07-21 18:23:25 +02:00
inet
intl
io
libio libio: handle opening a file when all files are closed (bug 31963) 2024-07-09 10:12:36 +02:00
locale
localedata support: Add FAIL test failure helper 2024-07-26 13:21:34 +01:00
login
mach
malloc malloc: add multi-threaded tests for aligned_alloc/calloc/malloc 2024-07-22 11:54:46 +02:00
manual manual: Do not mention STATIC_TLS in dynamic linker hardening recommendations 2024-07-24 12:50:17 +02:00
math support: Add FAIL test failure helper 2024-07-26 13:21:34 +01:00
mathvec
misc
nis
nptl nptl: Convert tst-sem11 and tst-sem12 tests to use the test driver 2024-07-12 20:41:08 +02:00
nptl_db
nscd
nss
po po/*: regenerate (only line number changes) 2024-07-21 17:50:35 +02:00
posix posix: Use <support/check.h> facilities in tst-truncate and tst-truncate64 2024-07-26 13:21:34 +01:00
resolv resolv: Implement strict-error stub resolver option (bug 27929) 2024-07-24 12:10:37 +02:00
resource
rt
scripts elf: Fix localplt.awk for DT_RELR-enabled builds (BZ 31978) 2024-07-19 22:50:26 +02:00
setjmp
signal
socket
soft-fp
stdio-common
stdlib Fix usage of _STACK_GROWS_DOWN and _STACK_GROWS_UP defines [BZ 31989] 2024-07-19 10:10:17 -04:00
string
sunrpc
support support: Add FAIL test failure helper 2024-07-26 13:21:34 +01:00
sysdeps nptl: Use <support/check.h> facilities in tst-setuid3 2024-07-26 13:21:34 +01:00
sysvipc
termios
time time/Makefile: Split and sort tests 2024-07-12 17:33:28 +02:00
timezone
wcsmbs
wctype
.clang-format
.gitattributes
.gitignore
CONTRIBUTED-BY
COPYING
COPYING.LIB
INSTALL install.texi: bump "latest verified" versions 2024-07-21 00:27:35 +02:00
LICENSES
MAINTAINERS
Makeconfig
Makefile
Makefile.help
Makefile.in
Makerules
NEWS resolv: Implement strict-error stub resolver option (bug 27929) 2024-07-24 12:10:37 +02:00
README
Rules
SECURITY.md
SHARED-FILES
abi-tags
aclocal.m4
config.h.in Add pthread_getname_np and pthread_setname_np for Hurd 2024-07-16 09:21:52 +02:00
config.make.in manual: add syscalls 2024-07-09 11:54:29 +02:00
configure manual: add syscalls 2024-07-09 11:54:29 +02:00
configure.ac manual: add syscalls 2024-07-09 11:54:29 +02:00
extra-lib.mk
gen-locales.mk
libc-abis
libof-iterator.mk
o-iterator.mk
shlib-versions
test-skeleton.c
version.h Increase version number to 2.40.9000 2024-07-21 18:49:35 +02: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 and x86_64-gnu.

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
	arc*-*-linux-gnu
	arm-*-linux-gnueabi
	csky-*-linux-gnuabiv2
	hppa-*-linux-gnu
	i[4567]86-*-linux-gnu
	x86_64-*-linux-gnu	Can build either x86_64 or x32
	loongarch64-*-linux-gnu Hardware floating point, LE only.
	m68k-*-linux-gnu
	microblaze*-*-linux-gnu
	mips-*-linux-gnu
	mips64-*-linux-gnu
	or1k-*-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
	riscv32-*-linux-gnu
	riscv64-*-linux-gnu
	sh[34]-*-linux-gnu
	sparc*-*-linux-gnu
	sparc64*-*-linux-gnu

If you are interested in doing a port, please contact the glibc
maintainers; see https://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 https://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 https://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.