Go to file
Joseph Myers 8ea4d2b7d1 Unify some sys/procfs.h headers.
As per recent discussions, this patch unifies some of the sys/procfs.h
headers for architectures using the Linux kernel, producing a generic
version that can hopefully be used by all new architectures as well.

The new generic version is based on the AArch64 one.  The register
definitions, the only part that generally needs to vary by
architecture, go in a new bits/procfs.h header (which each
architecture using the generic version needs to provide); that header
also has any #includes that were in the architecture-specific
sys/procfs.h, where those includes went beyond the generic set.

The generic version is used for eight architectures where the generic
definitions were the same as the architecture-specific ones.  (Some of
those architectures had #if 0 fields, now removed; some defined types
or fields using different type names which were typedefs for the same
underlying types.)

Six of the remaining architectures with their own sys/procfs.h use
unsigned short for pr_uid / pr_gid in some cases; moving those to the
generic header will require a bits/ header to define a typedef for the
type of those fields.  In the case of alpha, the generic sys/procfs.h
uses elf_gregset_t (= unsigned long int[33]) to define prgregset_t and
elf_fpregset_t (= double[32]) to define prfpregset_t, but the alpha
version uses gregset_t (= long int[33]) and fpregset_t (= long
int[32]), so avoiding unnecessarily changing the underlying types (and
thus C++ name mangling) again means a bits/ header will need to be
able to define a different choice for those typedefs.

bits/procfs.h is included outside the __BEGIN_DECLS / __END_DECLS pair
(whereas the definitions it contains were previously inside that pair
in various sys/procfs.h headers), because it sometimes includes other
headers and putting those other #includes inside that pair seems
risky.  Because none of the declarations in bits/procfs.h are of
functions or variables or involve function types, I don't think it
makes any difference whether they are inside or outside an extern "C"
context.

Tested with build-many-glibcs.py (again, that does not provide much
validation for the correctness of this patch).

	* sysdeps/unix/sysv/linux/sys/procfs.h: Replace with file based on
	AArch64 version.  Include <bits/procfs.h>.
	* sysdeps/unix/sysv/linux/Makefile [$(subdir) = misc]
	(sysdep_headers): Add bits/procfs.h.
	* sysdeps/unix/sysv/linux/bits/procfs.h: New file.
	* sysdeps/unix/sysv/linux/aarch64/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/hppa/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/ia64/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/microblaze/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/mips/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/nios2/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/powerpc/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/riscv/bits/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/aarch64/sys/procfs.h: Remove file.
	* sysdeps/unix/sysv/linux/hppa/sys/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/ia64/sys/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/microblaze/sys/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/mips/sys/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/nios2/sys/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/powerpc/sys/procfs.h: Likewise.
	* sysdeps/unix/sysv/linux/riscv/sys/procfs.h: Likewise.
2018-09-25 16:48:15 +00:00
ChangeLog.old
argp
assert
benchtests Reallocate buffers for every run in strlen 2018-08-16 14:11:57 +05:30
bits
catgets
conform Replace conform/list-header-symbols.pl with a Python script. 2018-08-31 21:19:51 +00:00
crypt
csu
ctype
debug __readlink_chk: Remove micro-optimization 2018-08-21 11:24:12 +02:00
dirent
dlfcn
elf Include most of elf/ modules-names in modules-names-tests. 2018-09-12 20:31:24 +00:00
gmon
gnulib
grp [BZ #20271] Add newlines in __libc_fatal calls. 2018-08-31 18:04:32 -07:00
gshadow
hesiod
htl hurd: Add missing symbols for proper libc_get/setspecific 2018-08-08 01:55:04 +02:00
hurd hurd: Fix exec usage of mach_setup_thread 2018-08-01 00:10:03 +02:00
iconv Clean up iconv/gconv_int.h for unnecessary declarations 2018-09-25 15:13:15 +02:00
iconvdata
include Use trunc functions not __trunc functions in glibc libm. 2018-09-20 21:11:10 +00:00
inet
intl
io Avoid running some tests if the file system does not support holes 2018-08-21 12:56:53 +02:00
libio
locale Fix out of bounds access in findidxwc (bug 23442) 2018-07-25 10:50:03 +02:00
localedata it_CH/it_IT locales: Correct some LC_TIME formats (bug 10425). 2018-09-21 10:40:20 +02:00
login
mach hurd: Fix exec usage of mach_setup_thread 2018-08-01 00:10:03 +02:00
malloc malloc: Add ChangeLog for accidentally committed change 2018-08-20 14:57:13 +02:00
manual Don't build libnsl for new ABIs 2018-09-24 10:23:10 +02:00
math Add new pow implementation 2018-09-19 10:04:51 +01:00
mathvec
misc misc: New test misc/tst-gethostid 2018-09-20 12:03:01 +02:00
nis Don't build libnsl for new ABIs 2018-09-24 10:23:10 +02:00
nptl [BZ #20271] Add newlines in __libc_fatal calls. 2018-08-31 18:04:32 -07:00
nptl_db
nscd [BZ #20271] Add newlines in __libc_fatal calls. 2018-08-31 18:04:32 -07:00
nss [BZ #20271] Add newlines in __libc_fatal calls. 2018-08-31 18:04:32 -07:00
po Update translations for be. 2018-08-24 22:26:41 -04:00
posix Use libsupport for tst-spawn.c 2018-09-25 10:49:23 -03:00
pwd
resolv
resource
rt
scripts Don't build libnsl for new ABIs 2018-09-24 10:23:10 +02:00
setjmp
shadow
signal
socket
soft-fp
stdio-common error, warn, warnx: Use __fxprintf for wide printing [BZ #23519] 2018-08-14 17:54:49 +02:00
stdlib Fix tst-setcontext9 for optimized small stacks. 2018-09-19 22:33:07 -04:00
streams
string Fix strstr bug with huge needles (bug 23637) 2018-09-19 16:50:18 +01:00
sunrpc
support test-container: Use xcopy_file_range for cross-device copy [BZ #23597] 2018-08-31 13:08:02 -07:00
sysdeps Unify some sys/procfs.h headers. 2018-09-25 16:48:15 +00:00
sysvipc
termios
time Fix mktime localtime offset confusion 2018-09-19 17:09:08 -07:00
timezone Avoid running some tests if the file system does not support holes 2018-08-21 12:56:53 +02:00
wcsmbs
wctype
.gitattributes
.gitignore
COPYING
COPYING.LIB
ChangeLog Unify some sys/procfs.h headers. 2018-09-25 16:48:15 +00:00
INSTALL Don't build libnsl for new ABIs 2018-09-24 10:23:10 +02:00
LICENSES
MAINTAINERS
Makeconfig Don't build libnsl for new ABIs 2018-09-24 10:23:10 +02:00
Makefile Add test-in-container infrastructure. 2018-08-22 21:20:37 -04:00
Makefile.in
Makerules Don't build libnsl for new ABIs 2018-09-24 10:23:10 +02:00
NEWS powerpc: Only enable TLE with PPC_FEATURE2_HTM_NOSC 2018-09-21 10:18:03 -07:00
README
Rules Add test-in-container infrastructure. 2018-08-22 21:20:37 -04:00
abi-tags
aclocal.m4
config.h.in
config.make.in Add --with-nonshared-cflags option to configure 2018-08-17 11:44:39 +02:00
configure Add --with-nonshared-cflags option to configure 2018-08-17 11:44:39 +02:00
configure.ac Add --with-nonshared-cflags option to configure 2018-08-17 11:44:39 +02:00
extra-lib.mk
gen-locales.mk
libc-abis
libof-iterator.mk
o-iterator.mk
shlib-versions
test-skeleton.c
version.h Open master branch for glibc 2.29 development 2018-08-01 01:35:02 -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
	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.