ac3e3ebc78684443ab85a294c123a1622b3406c2
[gnulib.git] / doc / posix-functions / ftello.texi
1 @node ftello
2 @section @code{ftello}
3 @findex ftello
4
5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/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 IRIX 5.3, 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 produces incorrect results after @code{putc} that followed a
19 @code{getc} call that reached EOF on some platforms:
20 Solaris 10.
21 @item
22 This function fails on seekable stdin, stdout, and stderr: cygwin <= 1.5.24.
23 @end itemize
24
25 Portability problems not fixed by Gnulib:
26 @itemize
27 @item
28 On platforms where @code{off_t} is a 32-bit type, @code{ftello} does not work
29 correctly with files larger than 2 GB.  The fix is to use the
30 @code{AC_SYS_LARGEFILE} macro.
31 @item
32 This function produces incorrect results immediately after @code{fseek} on some
33 platforms:
34 HP-UX 11.
35 @item
36 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
37 on input streams that are opened in @code{O_TEXT} mode and whose contents
38 contains Unix line terminators (LF), on some platforms: mingw.
39 @item
40 On platforms where @code{off_t} is a 64-bit type, but @code{fseeko} is
41 not present, stream operations on files larger than 2 GB silently do
42 the wrong thing.  This affects BSD/OS, which is mostly obsolete.
43 @end itemize