Go to file
Adhemerval Zanella a43565ac44 Refactor sigcontextinfo.h
This patch refactor sigcontextinfo.h header to use SA_SIGINFO as default
for both gmon and debug implementations.  This allows simplify
profil-counter.h on Linux to use a single implementation and remove the
requirements for newer ports to redefine __sigaction/sigaction to use
SA_SIGINFO.

The GET_PC macro is also replaced with a function sigcontext_get_pc that
returns an uintptr_t instead of a void pointer.  It allows easier convertion
to integer on ILP32 architecture, such as x32, without the need to suppress
compiler warnings.

The patch also requires some refactor of register-dump.h file for some
architectures (to reflect it is now called from a sa_sigaction instead of
sa_handler signal context).

   - Alpha, i386, and s390 are straighfoward to take in consideration the
     new argument type.

   - ia64 takes in consideration the kernel pass a struct sigcontextt
     as third argument for sa_sigaction.

   - sparc take in consideration the kernel pass a pt_regs struct
     as third argument for sa_sigaction.

   - m68k dummy function is removed and the FP state is dumped on
     register_dump itself.

   - For SH the register-dump.h file is consolidate on a common implementation
     and the floating-point state is checked based on ownedfp field.

The register_dump does not change its output format in any affected
architecture.

I checked on x86_64-linux-gnu, i686-linux-gnu, aarch64-linux-gnu,
arm-linux-gnueabihf, sparcv9-linux-gnu, sparc64-linux-gnu, powerpc-linux-gnu,
powerpc64-linux-gnu, and powerpc64le-linux-gnu.

I also checked the libSegFault.so through catchsegv on alpha-linux-gnu,
m68k-linux-gnu and sh4-linux-gnu to confirm the output has not changed.

	Adhemerval Zanella  <adhemerval.zanella@linaro.org>
	Florian Weimer  <fweimer@redhat.com>

	* debug/segfault.c (install_handler): Use SA_SIGINFO if defined.
	* sysdeps/generic/profil-counter.h (__profil_counter): Cast to
	uintptr_t.
	* sysdeps/generic/sigcontextinfo.h (GET_PC): Rename to
	sigcontext_get_pc and return aligned cast to uintptr_t.
	* sysdeps/mach/hurd/i386/sigcontextinfo.h (GET_PC): Likewise.
	* sysdeps/posix/profil.c (profil_count): Change PC argument to
	uintptr_t.
	(__profil): Use SA_SIGINFO.
	* sysdeps/posix/sprofil.c (profil_count): Change PCP argument to
	uintptr_t.
	(__sprofil): Use SA_SIGINFO.
	* sysdeps/unix/sysv/linux/profil-counter.h: New file.
	* sysdeps/unix/sysv/linux/aarch64/profil-counter.h: Remove file.
	* sysdeps/unix/sysv/linux/csky/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/hppa/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/i386/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/ia64/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/microblaze/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/mips/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/nios2/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/powerpc/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/x86_64/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/riscv/profil-counter.h: Likewise.
	* sysdeps/sysv/linux/s390/s390-32/profil-counter.h: Likewise.
	* sysdeps/sysv/linux/s390/s390-64/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/sh/profil-counter.h: Likewise.
	* sysdeps/unix/sysv/linux/arm/profil-counter.h (__profil_counter):
	Assume SA_SIGINFO and use sigcontext_get_pc instead of GET_PC.
	* sysdeps/unix/sysv/linux/sparc/profil-counter.h: New file.
	* sysdeps/unix/sysv/linux/sparc/sparc64/profil-counter.h: Remove file.
	* sysdeps/unix/sysv/linux/sparc/sparc32/profil-counter.h: Likewise.
	* sysdpes/unix/sysv/linux/aarch64/sigcontextinfo.h (SIGCONTEXT,
	GET_PC, __sigaction, sigaction): Remove defines.
	(sigcontext_get_pc): New function.
	* sysdeps/unix/sysv/linux/alpha/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/arm/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/csky/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/hppa/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/i386/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/ia64/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/m68k/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/mips/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/nios2/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/s390/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/microblaze/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/powerpc/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/riscv/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/sh/sigcontextinfo.h: Likewise.
	* sysdeps/sysv/linux/sparc/sparc32/sigcontextinfo.h: Likewise.
	* sysdeps/sysv/linux/sparc/sparc64/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/x86_64/sigcontextinfo.h: Likewise.
	* sysdeps/unix/sysv/linux/alpha/register-dump.h (register_dump):
	Handle CTX argument as ucontext_t.
	* sysdeps/unix/sysv/linux/i386/register-dump.h: Likewise.
	Likewise.
	* sysdeps/unix/sysv/linux/m68k/register-dump.h: Likewise.
	* sysdeps/sysv/linux/s390/s390-32/register-dump.h: Likewise.
	* sysdeps/sysv/linux/s390/s390-64/register-dump.h: Likewise.
	* sysdeps/unix/sysv/linux/sh/register-dump.h: New file.
	* sysdeps/unix/sysv/linux/sh/sh4/register-dump.h: Remove File.
	* sysdeps/unix/sysv/linux/sh/sh3/register-dump.h: Likewise.
	* sysdeps/unix/sysv/linux/sparc/sparc32/register-dump.h: Likewise.
	* sysdeps/unix/sysv/linux/sparc/sparc64/register-dump.h: Likewise.
	* sysdeps/unix/sysv/linux/Makefile (tests-internal): Add
	tst-sigcontextinfo-get_pc.
	* sysdeps/unix/sysv/linux/tst-sigcontextinfo-get_pc.c: New file.
	(CFLAGS-tst-sigcontextinfo-get_pc.c): New rule.
2019-08-23 11:30:56 -03:00
ChangeLog.old Add more bug numbers to historic ChangeLog entries 2019-04-11 09:32:08 +02:00
argp Fix gcc 9 build errors for make xcheck. [BZ #24556] 2019-06-19 12:32:04 +02:00
assert Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
benchtests benchtests: Add logb{f} benchmark 2019-07-08 17:22:22 -03:00
bits login: Add nonstring attributes to struct utmp, struct utmpx [BZ #24899] 2019-08-15 16:09:43 +02:00
catgets Add some spaces before '('. 2019-02-27 13:55:45 +00:00
conform Remove obsolete, never-implemented XSI STREAMS declarations 2019-03-14 15:44:15 +01:00
crypt Break some lines before not after operators. 2019-02-22 01:32:36 +00:00
csu Update copyright dates not handled by scripts/update-copyrights. 2019-01-01 00:15:13 +00:00
ctype Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
debug Refactor sigcontextinfo.h 2019-08-23 11:30:56 -03:00
dirent Linux: Move getdents64 to <dirent.h> 2019-07-29 21:02:46 +02:00
dlfcn dlfcn: Avoid one-element flexible array in Dl_serinfo [BZ #24166] 2019-06-19 10:13:50 +02:00
elf elf: Self-dlopen failure with explict loader invocation [BZ #24900] 2019-08-15 18:53:32 +02:00
gmon Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
gnulib Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
grp nss: Turn __nss_database_lookup into a compatibility symbol 2019-05-15 15:07:49 +02:00
gshadow Break more lines before not after operators. 2019-02-25 13:19:19 +00:00
hesiod Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
htl Break more lines before not after operators. 2019-02-25 13:19:19 +00:00
hurd hurd: Fix comment style 2019-03-16 19:44:04 +01:00
iconv iconv: Revert steps array reference counting changes 2019-07-31 11:43:59 +02:00
iconvdata Add some spaces before '('. 2019-02-27 13:55:45 +00:00
include Do not print backtraces on fatal glibc errors 2019-08-19 15:41:29 +02:00
inet Add INADDR_ALLSNOOPERS_GROUP from Linux 5.1 to netinet/in.h. 2019-06-03 11:16:02 +00:00
intl intl: Do not return NULL on asprintf failure in gettext [BZ #24018] 2019-01-02 16:26:58 +01:00
io Add AT_RECURSIVE from Linux 5.2 to fcntl.h. 2019-08-06 21:17:59 +00:00
libio iconv: Revert steps array reference counting changes 2019-07-31 11:43:59 +02:00
locale locale/C-translit.h.in: Cyrillic -> ASCII transliteration [BZ #2872] 2019-07-20 21:49:38 +02:00
localedata Chinese locales: Set first_weekday to 2 (bug 24682). 2019-08-23 00:07:06 +02:00
login login: Use struct flock64 in utmp [BZ #24880] 2019-08-15 16:09:20 +02:00
mach Break some lines before not after operators. 2019-02-22 01:32:36 +00:00
malloc malloc: Various cleanups for malloc/tst-mxfast 2019-08-15 11:37:18 +02:00
manual Document strftime %Ob and %OB as C2X features. 2019-08-22 12:38:40 +00:00
math Add tgmath.h macros for narrowing functions. 2019-08-21 12:06:44 +00:00
mathvec Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
misc Don't use the argument to time. 2019-08-21 08:26:36 -04:00
nis nss_nis, nss_nisplus: Remove RES_USE_INET6 handling 2019-05-16 17:23:23 +02:00
nptl nptl: Move pthread_attr_getdetachstate implementation into libc 2019-08-16 22:44:44 +02:00
nptl_db Move remaining nptl_db headers to sysdeps/nptl 2019-02-16 08:25:16 +01:00
nscd nscd: Improve nscd.conf comments. 2019-08-19 09:57:58 -04:00
nss nss: Make nsswitch.conf more distribution friendly. 2019-08-19 09:56:59 -04:00
po Update translations. 2019-07-31 23:38:15 -04:00
posix Remove dead regex code 2019-08-21 11:02:19 -07:00
pwd Break more lines before not after operators. 2019-02-25 13:19:19 +00:00
resolv Mark IDN tests unsupported with libidn2 before 2.0.5. 2019-08-22 12:56:49 +00:00
resource Break some lines before not after operators. 2019-02-22 01:32:36 +00:00
rt Remove __get_clockfreq 2019-03-22 16:52:29 -03:00
scripts build-many-glibcs.py: Use Linux 5.2 by default 2019-07-24 10:59:45 +02:00
setjmp Break some lines before not after operators. 2019-02-22 01:32:36 +00:00
shadow Break more lines before not after operators. 2019-02-25 13:19:19 +00:00
signal Linux: Add the tgkill function 2019-05-14 22:55:51 +02:00
socket Fix a few typos in comments 2019-01-12 13:44:51 +00:00
soft-fp soft-fp: Properly check _FP_W_TYPE_SIZE [BZ #24066] 2019-01-07 09:04:39 -08:00
stdio-common Prepare vfprintf to use __printf_fp/__printf_fphex with float128 arg 2019-06-27 17:51:59 -03:00
stdlib Declare most TS 18661-1 interfaces for C2X. 2019-08-13 11:28:51 +00:00
string Don't use the argument to time. 2019-08-21 08:26:36 -04:00
sunrpc Remove qualifier from function return type in tst-svc_register.c. 2019-02-15 13:45:19 +00:00
support support: Include <support/descriptors.h> in support_descriptors.c 2019-08-14 16:24:46 +02:00
sysdeps Refactor sigcontextinfo.h 2019-08-23 11:30:56 -03:00
sysvipc Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
termios Break some lines before not after operators. 2019-02-22 01:32:36 +00:00
time Don't use the argument to time. 2019-08-21 08:26:36 -04:00
timezone Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
wcsmbs iconv: Revert steps array reference counting changes 2019-07-31 11:43:59 +02:00
wctype Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
.gitattributes
.gitignore
COPYING
COPYING.LIB
ChangeLog Refactor sigcontextinfo.h 2019-08-23 11:30:56 -03:00
INSTALL Update install and NEWS for 2.30 release. 2019-08-01 00:22:46 -04:00
LICENSES
MAINTAINERS
Makeconfig test-container: Install with $(sorted-subdirs) [BZ #24794] 2019-07-29 10:31:06 -03:00
Makefile test-container: Install with $(sorted-subdirs) [BZ #24794] 2019-07-29 10:31:06 -03:00
Makefile.in
Makerules Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
NEWS Add tgmath.h macros for narrowing functions. 2019-08-21 12:06:44 +00:00
README
Rules Use a proper C tokenizer to implement the obsolete typedefs test. 2019-03-13 09:39:43 -04:00
abi-tags
aclocal.m4
config.h.in S390: Add configure check to detect support for arch13. 2019-03-22 11:14:08 +01:00
config.make.in Make --bindir effective 2019-05-14 11:04:33 -03:00
configure elf/Makefile: Run IFUNC tests if binutils supports IFUNC 2019-02-27 13:21:55 -08:00
configure.ac elf/Makefile: Run IFUNC tests if binutils supports IFUNC 2019-02-27 13:21:55 -08:00
extra-lib.mk
gen-locales.mk
libc-abis
libof-iterator.mk
o-iterator.mk
shlib-versions
test-skeleton.c Update copyright dates with scripts/update-copyrights. 2019-01-01 00:11:28 +00:00
version.h Open master for 2.31 development. 2019-08-01 00:41:53 -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.

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
	csky-*-linux-gnuabiv2
	hppa-*-linux-gnu
	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
	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 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.