Go to file
Joseph Myers acf0cb6f24 Don't include <bits/stdio-lock.h> from installed <libio.h>.
Every so often someone gets confused by the fact that the installed
<bits/stdio-lock.h> header includes the non-installed <lowlevellock.h>
header.

This inclusion is not in fact a bug, because <bits/stdio-lock.h> only
gets included by any header that users should include directly if
_IO_MTSAFE_IO is defined, and that's an internal define used when
building libio, not a feature test macro it's valid for users to
define.  However, on general principles it's best to have as little as
possible in the installed headers that is inapplicable for valid uses
of the installed glibc.

This patch moves the include of <bits/stdio-lock.h> to the internal
header include/libio.h, so that even if someone defines _IO_MTSAFE_IO
it won't get included.  This is intended as preparation for stopping
<bits/stdio-lock.h> and <bits/libc-lock.h> from being installed at all
(after this patch they aren't used in any installed header; formally
of course they don't need to be installed even before this patch, but
stopping them being installed before removing the #include would just
exacerbate the confusion described above), and then moving those out
of the bits/ namespace in accordance with the principle that that
namespace is only for installed headers.

The tests scanf15.c and scanf17.c avoid the internal headers; after
this patch that means they need to undefine _IO_MTSAFE_IO as well as
_LIBC so as to get a working _IO_lock_t definition for libio.h.  This
brings them closer to using the headers as an installed program would,
which clearly accords with the intent of those tests.

Tested for x86_64 (testsuite, and that installed stripped shared
libraries are unchanged by the patch).

	* libio/libio.h [_IO_MTSAFE_IO]: Remove include of
	<bits/stdio-lock.h> and commented-out include of <comthread.h>.
	* include/libio.h [!_ISOMAC && _IO_MTSAFE_IO]: Include
	<bits/stdio-lock.h>.
	* stdio-common/scanf15.c (_IO_MTSAFE_IO): Undefine.
	* stdio-common/scanf17.c (_IO_MTSAFE_IO): Likewise.
2015-09-03 20:24:54 +00:00
argp
assert Add ersatz _Static_assert on older C hosts 2015-02-07 14:43:27 -08:00
benchtests S390: Optimize wmemcmp. 2015-08-26 10:26:25 +02:00
bits Add SIGWINCH to generic <bits/signum.h>. 2015-07-23 16:44:47 -07:00
catgets Fix trailing space. 2015-08-08 15:54:40 -07:00
conf
conform Fix spurious conform test failures 2015-07-27 16:13:55 +02:00
crypt
csu Fix gcrt0.o compilation 2015-08-07 01:38:39 +02:00
ctype
debug Fix strcpy_chk and stpcpy_chk performance. 2015-08-25 15:06:33 +02:00
dirent Modify several tests to use test-skeleton.c 2015-08-06 02:59:04 -04:00
dlfcn
elf Fix dynamic linker issue with bind-now 2015-08-19 05:37:01 -07:00
gmon
gnulib
grp Fix grp.h endgrent, getgrent namespace (bug 18528). 2015-06-12 22:29:19 +00:00
gshadow
hesiod
hurd Fix warnings 2015-03-21 04:49:44 +01:00
iconv
iconvdata fix non-portable `echo -n` usage 2015-08-09 04:19:12 -04:00
include Don't include <bits/stdio-lock.h> from installed <libio.h>. 2015-09-03 20:24:54 +00:00
inet Add netinet/in.h values from Linux 4.2. 2015-09-01 13:47:25 +00:00
intl Remove obsolete aliases that broke 'locale -a' 2015-05-22 15:12:01 -07:00
io Readd O_LARGEFILE flag for openat64 (bug 18781) 2015-08-10 18:10:19 +02:00
libidn
libio Don't include <bits/stdio-lock.h> from installed <libio.h>. 2015-09-03 20:24:54 +00:00
locale Also check dead->data[category] != NULL 2015-08-05 08:15:51 -07:00
localedata relocate localedata ChangeLog entries 2015-08-19 17:55:06 -04:00
login Fix -Wundef warnings in login/tst-utmp.c. 2015-08-19 00:50:17 +00:00
mach mach: fix typo 2015-06-06 11:48:42 +02:00
malloc Filter out NULL entries. 2015-09-01 08:35:38 -07:00
manual manual: skip build when perl is unavailable 2015-08-21 17:10:59 -04:00
math Don't use -Wno-uninitialized in math/. 2015-08-20 18:00:09 +00:00
mathvec
misc getmntent: fix memory corruption w/blank lines [BZ #18887] 2015-08-29 18:07:00 -04:00
nis
nptl gawk: fix gensub usage 2015-08-09 04:19:17 -04:00
nptl_db
nscd nscd: drop selinux/flask.h include 2015-07-08 03:18:27 -04:00
nss fix non-portable `echo -n` usage 2015-08-09 04:19:12 -04:00
po de.po: fix SIGALRM typo [BZ #4404] 2015-08-29 16:44:54 -04:00
posix Fix wordsize-32 mmap offset for negative value (BZ#18877) 2015-08-28 10:42:07 -03:00
pwd pwd.h: revert __nonnull markings on putpwent [BZ #18641] 2015-07-27 23:45:49 -04:00
resolv Modify several tests to use test-skeleton.c 2015-08-06 02:59:04 -04:00
resource Fix nice getpriority, setpriority namespace (bug 18553). 2015-06-17 20:22:39 +00:00
rt Fix mq_receive, mq_send mq_timed* namespace (bug 18545). 2015-06-17 20:19:04 +00:00
scripts [BZ #18796] 2015-08-19 16:54:28 +03:00
setjmp Modify several tests to use test-skeleton.c 2015-07-15 15:10:23 +05:30
shadow
signal Fix psignal, psiginfo declaration conditions (bug 18483). 2015-06-05 21:14:16 +00:00
socket Fix mq_notify socket, recv namespace (bug 18546). 2015-06-17 20:20:08 +00:00
soft-fp Fix undefined warning messages in GCC 6. 2015-08-27 08:09:49 -07:00
stdio-common Don't include <bits/stdio-lock.h> from installed <libio.h>. 2015-09-03 20:24:54 +00:00
stdlib fix missing ctype.h include 2015-08-06 02:59:52 -04:00
streams
string S390: Optimize wmemset. 2015-08-26 10:26:25 +02:00
sunrpc
sysdeps Add netinet/in.h values from Linux 4.2. 2015-09-01 13:47:25 +00:00
sysvipc
termios
time time/tst-strptime2.c: test full input range +/- 0-9999 2015-08-28 23:48:10 -04:00
timezone Don't use -Wno-strict-prototypes in timezone/. 2015-08-20 20:51:22 +00:00
wcsmbs S390: Optimize wmemset. 2015-08-26 10:26:25 +02:00
wctype Fix regex wctype namespace (bug 18495). 2015-06-05 20:04:47 +00:00
.gitattributes
.gitignore Add *.pyc to .gitignore 2015-05-18 15:26:26 +05:30
BUGS
CONFORMANCE
COPYING
COPYING.LIB
ChangeLog Don't include <bits/stdio-lock.h> from installed <libio.h>. 2015-09-03 20:24:54 +00:00
ChangeLog.1
ChangeLog.2
ChangeLog.3
ChangeLog.4
ChangeLog.5
ChangeLog.6
ChangeLog.7
ChangeLog.8
ChangeLog.9
ChangeLog.10
ChangeLog.11
ChangeLog.12
ChangeLog.13
ChangeLog.14
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 Attempting to install glibc configured with --prefix=/usr into 2015-06-12 13:15:57 -06:00
LICENSES
Makeconfig Don't use -Wno-error=undef. 2015-08-20 20:50:05 +00:00
Makefile Succeed if make check does not report any errors 2015-05-19 06:36:29 +05:30
Makefile.in
Makerules Fix some places to use $(LN_S) makefile variable. 2015-07-08 14:21:41 -07:00
NAMESPACE
NEWS Fix BZ #18757. 2015-09-01 08:48:15 -07:00
PROJECTS
README
Rules
WUR-REPORT
abi-tags
aclocal.m4
config.h.in S390: configure check for vector instruction support in assembler. 2015-08-26 10:26:19 +02:00
config.make.in Support compilers defaulting to PIE 2015-06-25 02:49:53 -07:00
configure Support compilers defaulting to PIE 2015-06-25 02:49:53 -07:00
configure.ac Support compilers defaulting to PIE 2015-06-25 02:49:53 -07:00
cppflags-iterator.mk
extra-lib.mk
extra-modules.mk
gen-locales.mk
libc-abis
o-iterator.mk
shlib-versions
test-skeleton.c test-skeleton: add usage information 2015-08-05 04:40:00 -04:00
version.h Open development for 2.23. 2015-08-05 03:01:50 -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 2.6.32 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	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.