471522c215c7ab60d46d89321ae2a3107ec55800
[gnulib.git] / doc / posix-functions / fstatat.texi
1 @node fstatat
2 @section @code{fstatat}
3 @findex fstatat
4
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/fstatat.html}
6
7 Gnulib module: openat
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 glibc 2.3.6, MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, AIX
14 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
15 But the replacement function is not safe to be used in libraries and is not multithread-safe.
16 @item
17 On platforms where @code{off_t} is a 32-bit type, @code{fstatat} may
18 not correctly report the size of files or block devices larger than 2
19 GB.  (Cf. @code{AC_SYS_LARGEFILE}.)
20 @item
21 On some platforms, @code{fstatat(fd,"file/",buf,flag)} succeeds instead of
22 failing with @code{ENOTDIR}.
23 Solaris 9.
24 @item
25 For symlinks, when the argument ends in a slash, some platforms don't
26 dereference the argument:
27 Solaris 9.
28 @end itemize
29
30 Portability problems not fixed by Gnulib:
31 @itemize
32 @item
33 On Windows platforms (excluding Cygwin), @code{st_ino} is always 0.
34 @item
35 On some file systems, @code{st_size} contains bogus information for
36 symlinks; use the gnulib module areadlink-with-size for a better way
37 to get symlink contents.
38 @end itemize