d6789b752856941e976f53ef4c1c563cb5444fab
[gnulib.git] / doc / functions / ftello.texi
1 @node ftello
2 @section @code{ftello}
3 @findex ftello
4
5 POSIX specification: @url{http://www.opengroup.org/susv3xsh/ftello.html}
6
7 Gnulib module: ftello
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 OSF/1 4.0, Solaris 2.5.1, mingw.
14 @item
15 The declaration of @code{ftello} in @code{<stdio.h>} is not enabled by default
16 on some platforms: glibc 2.3.6.
17 @item
18 This function fails on seekable stdin, stdout, and stderr: cygwin 1.5.x.
19 @end itemize
20
21 Portability problems not fixed by Gnulib:
22 @itemize
23 @item
24 On platforms where @code{off_t} is a 32-bit type, @code{ftello} does not work
25 correctly with files larger than 2 GB.  The fix is to use the
26 @code{AC_SYS_LARGEFILE} macro.
27 @item
28 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
29 on input streams that are opened in @code{O_TEXT} mode and whose contents
30 contains Unix line terminators (LF), on some platforms: mingw.
31 @end itemize