a692859eeff488846f972b3cccd3348b06441f42
[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/susv3xsh/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: mingw.
13 @item
14 This function produces incorrect results immediately after @code{fseek} on some
15 platforms:
16 HP-UX 11.
17 @end itemize
18
19 Portability problems not fixed by Gnulib:
20 @itemize
21 @item
22 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
23 on input streams that are opened in @code{O_TEXT} mode and whose contents
24 contains Unix line terminators (LF), on some platforms: mingw.
25 @item
26 On platforms where @code{long} is a 32-bit type, @code{ftell} does not work
27 correctly with files larger than 2 GB.  The fix is to use @code{ftello}
28 instead and to invoke the @code{AC_SYS_LARGEFILE} macro.
29 @end itemize