Go to file
Alistair Francis aa706e13f4 Split up endian.h to minimize exposure of BYTE_ORDER.
With only two exceptions (sys/types.h and sys/param.h, both of which
historically might have defined BYTE_ORDER) the public headers that
include <endian.h> only want to be able to test __BYTE_ORDER against
__*_ENDIAN.

This patch creates a new bits/endian.h that can be included by any
header that wants to be able to test __BYTE_ORDER and/or
__FLOAT_WORD_ORDER against the __*_ENDIAN constants, or needs
__LONG_LONG_PAIR.  It only defines macros in the implementation
namespace.

The existing bits/endian.h (which could not be included independently
of endian.h, and only defines __BYTE_ORDER and maybe __FLOAT_WORD_ORDER)
is renamed to bits/endianness.h.  I also took the opportunity to
canonicalize the form of this header, which we are stuck with having
one copy of per architecture.  Since they are so short, this means git
doesn’t understand that they were renamed from existing headers, sigh.

endian.h itself is a nonstandard header and its only remaining use
from a standard header is guarded by __USE_MISC, so I dropped the
__USE_MISC conditionals from around all of the public-namespace things
it defines.  (This means, an application that requests strict library
conformance but includes endian.h will still see the definition of
BYTE_ORDER.)

A few changes to specific bits/endian(ness).h variants deserve
mention:

 - sysdeps/unix/sysv/linux/ia64/bits/endian.h is moved to
   sysdeps/ia64/bits/endianness.h.  If I remember correctly, ia64 did
   have selectable endianness, but we have assembly code in
   sysdeps/ia64 that assumes it’s little-endian, so there is no reason
   to treat the ia64 endianness.h as linux-specific.

 - The C-SKY port does not fully support big-endian mode, the compile
   will error out if __CSKYBE__ is defined.

 - The PowerPC port had extra logic in its bits/endian.h to detect a
   broken compiler, which strikes me as unnecessary, so I removed it.

 - The only files that defined __FLOAT_WORD_ORDER always defined it to
   the same value as __BYTE_ORDER, so I removed those definitions.
   The SH bits/endian(ness).h had comments inconsistent with the
   actual setting of __FLOAT_WORD_ORDER, which I also removed.

 - I *removed* copyright boilerplate from the few bits/endian(ness).h
   headers that had it; these files record a single fact in a fashion
   dictated by an external spec, so I do not think they are copyrightable.

As long as I was changing every copy of ieee754.h in the tree, I
noticed that only the MIPS variant includes float.h, because it uses
LDBL_MANT_DIG to decide among three different versions of
ieee854_long_double.  This patch makes it not include float.h when
GCC’s intrinsic __LDBL_MANT_DIG__ is available.

	* string/endian.h: Unconditionally define LITTLE_ENDIAN,
	BIG_ENDIAN, PDP_ENDIAN, and BYTE_ORDER.	 Condition byteswapping
	macros only on !__ASSEMBLER__.	Move the definitions of
	__BIG_ENDIAN, __LITTLE_ENDIAN, __PDP_ENDIAN, __FLOAT_WORD_ORDER,
	and __LONG_LONG_PAIR to...
	* string/bits/endian.h: ...this new file, which includes
	the renamed header bits/endianness.h for the definition of
	__BYTE_ORDER and possibly __FLOAT_WORD_ORDER.

	* string/Makefile: Install bits/endianness.h.
	* include/bits/endian.h: New wrapper.

	* bits/endian.h: Rename to bits/endianness.h.
	Add multiple-include guard.  Rewrite the comment explaining what
	the machine-specific variants of this file should do.

	* sysdeps/unix/sysv/linux/ia64/bits/endian.h:
	Move to sysdeps/ia64.

	* sysdeps/aarch64/bits/endian.h
	* sysdeps/alpha/bits/endian.h
	* sysdeps/arm/bits/endian.h
	* sysdeps/csky/bits/endian.h
	* sysdeps/hppa/bits/endian.h
	* sysdeps/ia64/bits/endian.h
	* sysdeps/m68k/bits/endian.h
	* sysdeps/microblaze/bits/endian.h
	* sysdeps/mips/bits/endian.h
	* sysdeps/nios2/bits/endian.h
	* sysdeps/powerpc/bits/endian.h
	* sysdeps/riscv/bits/endian.h
	* sysdeps/s390/bits/endian.h
	* sysdeps/sh/bits/endian.h
	* sysdeps/sparc/bits/endian.h
	* sysdeps/x86/bits/endian.h:
	Rename to endianness.h; canonicalize form of file; remove
	redundant definitions of __FLOAT_WORD_ORDER.

	* sysdeps/powerpc/bits/endianness.h: Remove logic to check for
	broken compilers.

	* ctype/ctype.h
	* sysdeps/aarch64/nptl/bits/pthreadtypes-arch.h
	* sysdeps/arm/nptl/bits/pthreadtypes-arch.h
	* sysdeps/csky/nptl/bits/pthreadtypes-arch.h
	* sysdeps/ia64/ieee754.h
	* sysdeps/ieee754/ieee754.h
	* sysdeps/ieee754/ldbl-128/ieee754.h
	* sysdeps/ieee754/ldbl-128ibm/ieee754.h
	* sysdeps/m68k/nptl/bits/pthreadtypes-arch.h
	* sysdeps/microblaze/nptl/bits/pthreadtypes-arch.h
	* sysdeps/mips/ieee754/ieee754.h
	* sysdeps/mips/nptl/bits/pthreadtypes-arch.h
	* sysdeps/nios2/nptl/bits/pthreadtypes-arch.h
	* sysdeps/nptl/pthread.h
	* sysdeps/riscv/nptl/bits/pthreadtypes-arch.h
	* sysdeps/sh/nptl/bits/pthreadtypes-arch.h
	* sysdeps/sparc/sparc32/ieee754.h
	* sysdeps/unix/sysv/linux/generic/bits/stat.h
	* sysdeps/unix/sysv/linux/generic/bits/statfs.h
	* sysdeps/unix/sysv/linux/sys/acct.h
	* wctype/bits/wctype-wchar.h:
	Include bits/endian.h, not endian.h.

	* sysdeps/unix/sysv/linux/hppa/pthread.h: Don’t include endian.h.

	* sysdeps/mips/ieee754/ieee754.h: Use __LDBL_MANT_DIG__
	in ifdefs, instead of LDBL_MANT_DIG.  Only include float.h
	when __LDBL_MANT_DIG__ is not predefined, in which case
	define __LDBL_MANT_DIG__ to equal LDBL_MANT_DIG.
2019-10-01 14:54:46 -07:00
argp Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
assert Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
benchtests Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
bits Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
catgets Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
ChangeLog.old Correct the spelling of more contributors 2019-08-29 02:50:04 -07:00
conform Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
crypt Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
csu Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
ctype Split up endian.h to minimize exposure of BYTE_ORDER. 2019-10-01 14:54:46 -07:00
debug Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
dirent Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
dlfcn Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
elf Add UNSUPPORTED check in elf/tst-pldd. 2019-09-18 12:42:39 +02:00
gmon Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
gnulib Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
grp Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
gshadow Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
hesiod Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
htl Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
hurd Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
iconv Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
iconvdata Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
include Split up endian.h to minimize exposure of BYTE_ORDER. 2019-10-01 14:54:46 -07:00
inet inet/net-internal.h: Fix uninitalised clntudp_call() variable 2019-09-24 21:55:36 +01:00
intl Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
io Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
libio Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
locale Regenerate charmap-kw.h, locfile-kw.h 2019-09-09 14:16:40 -07:00
localedata Sync "language", "lang_name", "territory", "country_name" with CLDR/langtable 2019-10-01 10:27:02 +02:00
login Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
mach Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
malloc Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
manual Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
math Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
mathvec Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
misc Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
nis Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
nptl Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
nptl_db Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
nscd Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
nss Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
po Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
posix Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
pwd Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
resolv Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
resource Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
rt Set the expects flags to clock_nanosleep 2019-09-25 16:28:45 -07:00
scripts Use binutils 2.33 branch in build-many-glibcs.py. 2019-09-30 22:21:39 +00:00
setjmp Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
shadow Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
signal Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
socket Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
soft-fp Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
stdio-common Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
stdlib Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
string Split up endian.h to minimize exposure of BYTE_ORDER. 2019-10-01 14:54:46 -07:00
sunrpc Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
support Fix building support_ptrace.c on i686-gnu. 2019-09-19 12:26:18 +02:00
sysdeps Split up endian.h to minimize exposure of BYTE_ORDER. 2019-10-01 14:54:46 -07:00
sysvipc Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
termios Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
time Set the expects flags to clock_nanosleep 2019-09-25 16:28:45 -07:00
timezone Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
wcsmbs Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
wctype Split up endian.h to minimize exposure of BYTE_ORDER. 2019-10-01 14:54:46 -07:00
.gitattributes Assume __NR_openat is always defined 2016-03-23 23:35:08 +01:00
.gitignore
abi-tags Remove the bulk of the NaCl port. 2017-05-20 08:09:10 -04:00
aclocal.m4 LIBC_SLIBDIR_RTLDDIR: substitute arguments in single quotes 2018-01-25 17:20:28 +01:00
ChangeLog Split up endian.h to minimize exposure of BYTE_ORDER. 2019-10-01 14:54:46 -07:00
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 Fix http: URL in 'configure' 2019-09-09 14:16:40 -07:00
configure.ac Fix http: URL in 'configure' 2019-09-09 14:16:40 -07:00
COPYING
COPYING.LIB
extra-lib.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
gen-locales.mk Improve gen-locales.mk and gen-locale.sh to make test files with @ options work 2018-02-27 17:01:57 +01:00
INSTALL Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
libc-abis libc-abis: Define ABSOLUTE ABI [BZ #19818][BZ #23307] 2018-07-05 18:06:43 +01:00
libof-iterator.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
LICENSES Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
MAINTAINERS Add MAINTAINERS 2017-05-11 13:38:30 -04:00
Makeconfig Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
Makefile Add helper script for glibc debugging 2019-09-30 08:37:18 -03:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
NEWS Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
o-iterator.mk
README Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
Rules Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
shlib-versions Extend NSS test suite 2017-07-17 15:52:44 -04:00
test-skeleton.c Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
version.h Open master for 2.31 development. 2019-08-01 00:41:53 -04: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.

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