Go to file
Siddhesh Poyarekar ea33158c96 Fix offset caching for streams and use it for ftell (BZ #16680)
The ftell implementation was made conservative to ensure that
incorrectly cached offsets never affect it.  However, this causes
problems for append mode when a file stream is rewound.  Additionally,
the 'clever' trick of using stat to get position for append mode files
caused more problems than it solved and broke old behavior.  I have
described the various problems that it caused and then finally the
solution.

For a and a+ mode files, rewinding the stream should result in ftell
returning 0 as the offset, but the stat() trick caused it to
(incorrectly) always return the end of file.  Now I couldn't find
anything in POSIX that specifies the stream position after rewind()
for a file opened in 'a' mode, but for 'a+' mode it should be set to
0.  For 'a' mode too, it probably makes sense to keep it set to 0 in
the interest of retaining old behavior.

The initial file position for append mode files is implementation
defined, so the implementation could either retain the current file
position or move the position to the end of file.  The earlier ftell
implementation would move the offset to end of file for append-only
mode, but retain the old offset for a+ mode.  It would also cache the
offset (this detail is important).  My patch broke this and would set
the initial position to end of file for both append modes, thus
breaking old behavior.  I was ignorant enough to write an incorrect
test case for it too.

The Change:

I have now brought back the behavior of seeking to end of file for
append-only streams, but with a slight difference.  I don't cache the
offset though, since we would want ftell to query the current file
position through lseek while the stream is not active.  Since the
offset is moved to the end of file, we can rely on the file position
reported by lseek and we don't need to resort to the stat() nonsense.

Finally, the cache is always reliable, except when there are unflished
writes in an append mode stream (i.e. both a and a+).  In the latter
case, it is safe to just do an lseek to SEEK_END.  The value can be
safely cached too, since the file handle is already active at this
point.  Incidentally, this is the only state change we affect in the
file handle (apart from taking locks of course).

I have also updated the test case to correct my impression of the
initial file position for a+ streams to the initial behavior.  I have
verified that this does not break any existing tests in the testsuite
and also passes with the new tests.
2014-03-17 21:23:56 +05:30
argp Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
assert Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
benchtests Make strtok benchmark competive. 2014-02-28 22:45:33 +01:00
bits Fix POSIX namespace for <bits/siginfo.h> (bug 16674). 2014-03-07 23:57:56 +00:00
catgets Count miscellaneous files built on host for testing as tests. 2014-03-07 03:31:41 +00:00
conf (NEED_INETADDR, NEED_INETATON): Define to 1, not empty. 1995-09-08 20:24:57 +00:00
conform Fix POSIX namespace for <bits/siginfo.h> (bug 16674). 2014-03-07 23:57:56 +00:00
crypt Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
csu Remove "Compiled on ..." crapola from version text. 2014-03-14 16:05:31 -07:00
ctype Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
debug tst-longjmp_chk2: add comments/sanity check 2014-03-13 17:05:29 -04:00
dirent Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
dlfcn Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
elf stop supporting bash-1.x 2014-03-13 20:20:12 -04:00
gmon Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
gnulib Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
grp Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
gshadow Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
hesiod Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
hurd Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
iconv Make tests consistently use *.out output files. 2014-03-07 03:29:23 +00:00
iconvdata Make tests consistently use *.out output files. 2014-03-07 03:29:23 +00:00
include Compile with -Wundef. 2014-03-14 11:32:51 -07:00
inet Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
intl Make tests consistently use *.out output files. 2014-03-07 03:29:23 +00:00
io Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
libidn Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
libio Fix offset caching for streams and use it for ftell (BZ #16680) 2014-03-17 21:23:56 +05:30
locale Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
localedata Count miscellaneous files built on host for testing as tests. 2014-03-07 03:31:41 +00:00
login Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
mach Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
malloc Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
manual Do not terminate default test runs on test failure. 2014-03-14 21:02:40 +00:00
math Add libm-test support for per-rounding-mode manually specified results. 2014-03-17 12:29:26 +00:00
misc Make tests consistently use *.out output files. 2014-03-07 03:29:23 +00:00
nis Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
nptl Get rid of __LT_SPINLOCK_INIT 2014-03-17 19:35:11 +05:30
nptl_db Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
nscd Provide correct buffer length to netgroup queries in nscd (BZ #16695) 2014-03-12 17:28:13 +05:30
nss Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
po Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
ports Compile with -Wundef. 2014-03-14 11:32:51 -07:00
posix Include all of <time.h> from <sched.h> for older standards (bug 16670). 2014-03-07 20:54:03 +00:00
pwd Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
resolv Make tests consistently use *.out output files. 2014-03-07 03:29:23 +00:00
resource Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
rt Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
scripts Do not terminate default test runs on test failure. 2014-03-14 21:02:40 +00:00
setjmp Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
shadow Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
signal Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
socket Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
soft-fp Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
stdio-common Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
stdlib Enumerate tests with special rules in tests-special variable. 2014-03-06 22:35:33 +00:00
streams Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
string PowerPC: strspn optimization for PPC64/POWER7 2014-03-11 08:54:33 -05:00
sunrpc Fix fallout from Joseph's untested Makeconfig change. 2014-02-28 13:00:27 -08:00
sysdeps Compile with -Wundef. 2014-03-14 11:32:51 -07:00
sysvipc Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
termios Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
time Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
timezone Count miscellaneous files built on host for testing as tests. 2014-03-07 03:31:41 +00:00
wcsmbs Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
wctype Consistently include Makeconfig after defining subdir. 2014-02-26 23:12:03 +00:00
.gitattributes exempt timezone files from the no-bad-whitespace policy 2009-06-15 18:15:54 +02:00
.gitignore ignore gdb related files 2013-12-27 16:30:50 -05:00
abi-tags * abi-tags (*-.*-syllable.*): New match, with ABI value 5. 2006-01-04 17:14:58 +00:00
aclocal.m4 rename configure.in to configure.ac 2013-10-30 17:32:08 +10:00
BUGS [BZ #5222] 2007-10-28 08:24:07 +00:00
CANCEL-FCT-WAIVE Update. 2004-03-08 07:58:18 +00:00
CANCEL-FILE-WAIVE Update. 2004-03-08 07:58:18 +00:00
ChangeLog Fix offset caching for streams and use it for ftell (BZ #16680) 2014-03-17 21:23:56 +05:30
ChangeLog.1 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.2 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.3 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.4 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.5 * sysdeps/posix/getaddrinfo.c: Implement configuration file 2006-05-04 06:38:07 +00:00
ChangeLog.6 Update. 1997-07-22 00:10:33 +00:00
ChangeLog.7 Update. 1997-11-18 02:50:07 +00:00
ChangeLog.8 Update. Old logs are in ChangeLog.7. 1998-08-11 18:44:11 +00:00
ChangeLog.9 Update. 2000-04-28 06:14:43 +00:00
ChangeLog.10 Update. 2000-02-29 01:13:44 +00:00
ChangeLog.11 2.5-18.1 2007-07-12 18:26:36 +00:00
ChangeLog.12 2.5-18.1 2007-07-12 18:26:36 +00:00
ChangeLog.13 Update. 2002-10-03 16:37:04 +00:00
ChangeLog.14 Update. 2004-04-20 04:28:00 +00:00
ChangeLog.15 Split out ChangeLog.15 at 2.3 branch point 2005-02-16 07:34:17 +00:00
ChangeLog.16 Fix typo in name 2012-06-21 16:45:27 +02:00
ChangeLog.17 Revert "Sun agreed to a change of the license for the RPC code to a BSD-like license." 2010-06-27 19:34:03 -07:00
config.h.in Save and restore AVX-512 zmm registers to x86-64 ld.so 2014-03-13 11:19:08 -07:00
config.make.in stop supporting bash-1.x 2014-03-13 20:20:12 -04:00
configure stop supporting bash-1.x 2014-03-13 20:20:12 -04:00
configure.ac stop supporting bash-1.x 2014-03-13 20:20:12 -04:00
CONFORMANCE Move __STDC_* predefined macros from features.h to stdc-predef.h. 2012-02-22 12:53:04 +00:00
COPYING Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
COPYING.LIB Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
cppflags-iterator.mk 2004-03-11 Jeroen Dekkers <jeroen@dekkers.cx> 2004-03-14 19:13:17 +00:00
extra-lib.mk Remove --disable-versioning. 2013-09-04 15:25:42 +00:00
extra-modules.mk Update. 2004-03-08 21:31:23 +00:00
INSTALL Do not terminate default test runs on test failure. 2014-03-14 21:02:40 +00:00
libc-abis A few more archs have IFUNC support. 2010-03-17 02:43:12 -07:00
LICENSES Expand LICENSES file. 2012-12-05 21:56:15 +00:00
Makeconfig Do not terminate default test runs on test failure. 2014-03-14 21:02:40 +00:00
Makefile Do not terminate default test runs on test failure. 2014-03-14 21:02:40 +00:00
Makefile.in Add target bench-clean 2013-04-16 14:07:21 +05:30
Makerules Get rid of Versions.def source file 2014-03-14 11:39:56 -07:00
NAMESPACE Add and update many more entries. 2000-03-20 00:42:58 +00:00
NEWS Fix offset caching for streams and use it for ftell (BZ #16680) 2014-03-17 21:23:56 +05:30
o-iterator.mk Fri Mar 17 12:58:37 1995 Roland McGrath <roland@churchy.gnu.ai.mit.edu> 1995-03-17 18:42:51 +00:00
PROJECTS Update. 2004-10-12 06:19:23 +00:00
README [MicroBlaze]: Move MicroBlaze from ports to sysdeps. 2014-02-17 11:08:21 +10:00
Rules Generate overall summary of test results. 2014-03-07 03:25:57 +00:00
shlib-versions PowerPC: Change powerpc64le start ABI to 2.17. 2014-02-04 09:49:08 -02:00
test-skeleton.c tests: unify fortification handler logic 2014-02-08 06:58:43 -05:00
version.h Open development for 2.20 2014-02-08 08:10:29 +10:00
WUR-REPORT * posix/unistd.h (setuid, setreuid, seteuid, setresuid): 2012-08-01 18:12:58 +02: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.  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.16 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
	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

The code for other CPU configurations supported by volunteers outside of
the core glibc maintenance effort is contained in the `ports' add-on,
located in the `ports' subdirectory of the source tree.

	hppa-*-linux-gnu	Not currently functional without patches.

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., 2000-2013, indicating that every year in
the range, inclusive, is a copyrightable year that would otherwise be listed
individually.