Merge branch 'stable'
[gnulib.git] / doc / posix-functions / ftell.texi
1 @node ftell
2 @section @code{ftell}
3 @findex ftell
4
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/ftell.html}
6
7 Gnulib module: ftell
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function mistakenly succeeds on pipes on some platforms:
13 mingw, MSVC 9.
14 @item
15 This function produces incorrect results after @code{putc} that followed a
16 @code{getc} call that reached EOF on some platforms:
17 Solaris 11 2010-11.
18 @end itemize
19
20 Portability problems not fixed by Gnulib:
21 @itemize
22 @item
23 This function produces incorrect results immediately after @code{fseek} on some
24 platforms:
25 HP-UX 11.
26 @item
27 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
28 on input streams that are opened in @code{O_TEXT} mode and whose contents
29 contains Unix line terminators (LF), on some platforms: mingw, MSVC 9.
30 @item
31 On platforms where @code{long} is a 32-bit type, @code{ftell} does not work
32 correctly with files larger than 2 GB, even when the @code{AC_SYS_LARGEFILE}
33 macro is used.  The fix is to use @code{ftello} instead.
34 @end itemize