Go to file
Zack Weinberg cab4d74b01 Add utility macros for clang detection, and deprecation with messages.
There are three new macros added to features.h and sys/cdefs.h:

 * __glibc_clang_prereq: just like __GNUC_PREREQ, but for clang.
 * __glibc_clang_has_extension: wraps clang's intrinsic __has_extension.
   Writing "#if defined __clang__ && __has_extension (...)" doesn't work,
   because compilers other than clang will object to the unknown macro
   __has_extension even though they don't need to evaluate it.
   Instead, write "#if __glibc_clang_has_extension (...)".

 * __attribute_deprecated_msg__(msg): like __attribute_deprecated__, but
   if possible, prints a message.

The first two are used to define the third.  The third will be used
in subsequent patches.

	* include/features.h (__glibc_clang_prereq): New macro.
	* misc/sys/cdefs.h (__glibc_clang_has_extension)
	(__attribute_deprecated_msg__): New macros.
2016-08-03 14:03:46 -04:00
argp argp: Use fwrite_unlocked instead of __fxprintf when !_LIBC 2016-01-07 04:25:54 -05:00
assert
benchtests Clear destination buffer updated by the previous run 2016-05-18 05:51:59 -07:00
bits Support __STDC_WANT_IEC_60559_BFP_EXT__ feature test macro. 2016-08-03 17:30:41 +00:00
catgets Fix building glibc master with NDEBUG and --with-cpu. 2016-03-15 23:23:24 -04:00
conform Revert {send,sendm,recv,recvm}msg conformance changes 2016-06-10 11:58:16 -03:00
crypt Fix build failures with -DDEBUG. 2016-01-15 11:07:41 -07:00
csu elf: Avoid using memalign for TLS allocations [BZ #17730] 2016-08-03 16:15:38 +02:00
ctype
debug libio: Implement vtable verification [BZ #20191] 2016-06-23 20:01:52 +02:00
dirent Deprecate readdir_r, readdir64_r [BZ #19056] 2016-02-20 12:56:55 +01:00
dlfcn tst-rec-dlopen: Fix build fail due to missing inclusion of string.h 2016-06-06 11:03:04 +02:00
elf elf: Do not use memalign for TCB/TLS blocks allocation [BZ #17730] 2016-08-03 16:16:57 +02:00
gmon Copy x86_64 _mcount.op from _mcount.o 2016-03-03 06:56:22 -08:00
gnulib
grp Don't install the internal header grp-merge.h 2016-07-18 09:33:21 -03:00
gshadow
hesiod hesiod: Avoid heap overflow in get_txt_records [BZ #20031] 2016-05-02 16:04:32 +02:00
hurd Fix O_DIRECTORY lookup on trivial translators 2016-01-13 00:48:30 +01:00
iconv Fix UTF-16 surrogate handling. [BZ #19727] 2016-05-25 17:18:06 +02:00
iconvdata Fix UTF-16 surrogate handling. [BZ #19727] 2016-05-25 17:18:06 +02:00
include Add utility macros for clang detection, and deprecation with messages. 2016-08-03 14:03:46 -04:00
inet Fix macro API for __USE_KERNEL_IPV6_DEFS. 2016-06-02 23:52:06 -04:00
intl Enable --localedir to set message catalog directory (Bug 14259) 2016-02-24 20:06:04 -05:00
io 2016-06-11 Paul Pluzhnikov <ppluzhnikov@google.com> 2016-06-11 14:50:16 -07:00
libidn
libio Support __STDC_WANT_LIB_EXT2__ feature test macro. 2016-08-02 17:40:35 +00:00
locale S390: Fix relocation of _nl_current_LC_CATETORY_used in static build. [BZ #19860] 2016-06-28 12:28:53 +02:00
localedata localedata: fix de_LI locale 2016-07-07 14:49:20 +02:00
login 2016-06-11 Paul Pluzhnikov <ppluzhnikov@google.com> 2016-06-11 14:50:16 -07:00
mach mach: Add mach_print sycsall declaration 2016-06-09 01:43:49 +02:00
malloc elf: dl-minimal malloc needs to respect fundamental alignment 2016-08-03 16:11:01 +02:00
manual Support __STDC_WANT_IEC_60559_BFP_EXT__ feature test macro. 2016-08-03 17:30:41 +00:00
math Support __STDC_WANT_IEC_60559_BFP_EXT__ feature test macro. 2016-08-03 17:30:41 +00:00
mathvec
misc Add utility macros for clang detection, and deprecation with messages. 2016-08-03 14:03:46 -04:00
nis Return proper status from _nss_nis_initgroups_dyn (bug 20262) 2016-06-30 13:55:36 +02:00
nptl elf: Do not use memalign for TCB/TLS blocks allocation [BZ #17730] 2016-08-03 16:16:57 +02:00
nptl_db Update and install proc_service.h [BZ #20311] 2016-08-03 16:26:32 +02:00
nscd Remove atomic_compare_and_exchange_bool_rel. 2016-06-24 23:04:40 +03:00
nss nss_db: Fix initialization of iteration position [BZ #20237] 2016-06-11 12:12:56 +02:00
po Update libc.pot and NEWS. 2016-08-01 21:24:59 -04:00
posix Test p{read,write}64 with offset > 4GB 2016-07-12 08:29:17 -07:00
pwd
resolv resolv: Call gmtime_r instead of gmtime in p_secstodate [BZ #20017] 2016-05-10 10:50:24 +02:00
resource
rt Fix rt/tst-aio64.c as well, and mention login/tst-utmp.c in ChangeLog 2016-06-11 14:59:27 -07:00
scripts Revert "Add pretty printers for the NPTL lock types" 2016-07-11 20:32:12 +05:30
setjmp
shadow
signal
socket
soft-fp Update copyright dates with scripts/update-copyrights. 2016-01-04 16:05:18 +00:00
stdio-common libio: Implement vtable verification [BZ #20191] 2016-06-23 20:01:52 +02:00
stdlib libio: Implement vtable verification [BZ #20191] 2016-06-23 20:01:52 +02:00
streams
string Fix wide-char testsuite SIGBUS on platforms such as Sparc. 2016-08-02 17:46:58 -07:00
sunrpc CVE-2016-4429: sunrpc: Do not use alloca in clntudp_call [BZ #20112] 2016-05-23 20:18:34 +02:00
sysdeps Remove tacit double usage in ldbl-128 2016-08-03 11:01:25 -05:00
sysvipc Update copyright dates with scripts/update-copyrights. 2016-01-04 16:05:18 +00:00
termios Declare tcgetsid for XPG4 (bug 20055). 2016-05-11 18:05:37 +00:00
time Fix build failures with -DDEBUG. 2016-01-15 11:07:41 -07:00
timezone Remove mention of checktab.awk in timezone/README. 2016-03-14 14:11:51 -04:00
wcsmbs Support __STDC_WANT_LIB_EXT2__ feature test macro. 2016-08-02 17:40:35 +00:00
wctype
.gitattributes Assume __NR_openat is always defined 2016-03-23 23:35:08 +01:00
.gitignore
BUGS
CONFORMANCE
COPYING
COPYING.LIB
ChangeLog Add utility macros for clang detection, and deprecation with messages. 2016-08-03 14:03:46 -04:00
ChangeLog.1
ChangeLog.2
ChangeLog.3
ChangeLog.4
ChangeLog.5
ChangeLog.6 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.7 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.8 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.9
ChangeLog.10 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.11 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.12 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.13
ChangeLog.14 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.15
ChangeLog.16
ChangeLog.17
ChangeLog.old-ports
ChangeLog.old-ports-aarch64
ChangeLog.old-ports-aix
ChangeLog.old-ports-alpha
ChangeLog.old-ports-am33
ChangeLog.old-ports-arm
ChangeLog.old-ports-cris
ChangeLog.old-ports-hppa
ChangeLog.old-ports-ia64
ChangeLog.old-ports-linux-generic
ChangeLog.old-ports-m68k
ChangeLog.old-ports-microblaze
ChangeLog.old-ports-mips
ChangeLog.old-ports-powerpc
ChangeLog.old-ports-tile
INSTALL 2016-06-05 Paul Pluzhnikov <ppluzhnikov@google.com> 2016-06-05 08:41:13 -07:00
LICENSES
Makeconfig Revert "Add pretty printers for the NPTL lock types" 2016-07-11 20:32:12 +05:30
Makefile Support __STDC_WANT_LIB_EXT2__ feature test macro. 2016-08-02 17:40:35 +00:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Revert "Add pretty printers for the NPTL lock types" 2016-07-11 20:32:12 +05:30
NAMESPACE
NEWS Support __STDC_WANT_IEC_60559_BFP_EXT__ feature test macro. 2016-08-03 17:30:41 +00:00
PROJECTS
README Require Linux 3.2 except on x86 / x86_64, 3.2 headers everywhere. 2016-02-24 17:15:12 +00:00
Rules Revert "Add pretty printers for the NPTL lock types" 2016-07-11 20:32:12 +05:30
WUR-REPORT
abi-tags
aclocal.m4
config.h.in Require binutils 2.24 to build x86-64 glibc [BZ #20139] 2016-07-01 06:03:05 -07:00
config.make.in Enable --localedir to set message catalog directory (Bug 14259) 2016-02-24 20:06:04 -05:00
configure x86-64: Properly align stack in _dl_tlsdesc_dynamic [BZ #20309] 2016-07-12 06:30:08 -07:00
configure.ac x86-64: Properly align stack in _dl_tlsdesc_dynamic [BZ #20309] 2016-07-12 06:30:08 -07:00
cppflags-iterator.mk
extra-lib.mk
extra-modules.mk
gen-locales.mk
libc-abis
o-iterator.mk
shlib-versions
test-skeleton.c malloc: Run tests without calling mallopt [BZ #19469] 2016-08-02 17:06:11 +02:00
version.h Open development for 2.25. 2016-08-01 23:00:21 -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.  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 3.2 or later on all architectures except
i[4567]86 and x86_64, where Linux kernel version 2.6.32 or later
suffices.

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	Not currently functional without patches.
	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

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.