poll tests: Avoid test failure on BSD and Solaris systems.
[gnulib.git] / doc / posix-functions / fstatat.texi
blobb75f42189b12a103e0fcc4b98d274c6b5d71f064
1 @node fstatat
2 @section @code{fstatat}
3 @findex fstatat
5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/fstatat.html}
7 Gnulib module: fstatat
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 glibc 2.3.6, Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8,
14 AIX 5.1, HP-UX 11, IRIX 6.5, Cygwin 1.5.x, mingw, MSVC 14.
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 @item
29 On Solaris 11.4, when this function yields a timestamp with a
30 nonpositive @code{tv_sec} value, @code{tv_nsec} might be in the range
31 @minus{}1000000000..@minus{}1, representing a negative nanoseconds
32 offset from @code{tv_sec}.
33 @end itemize
35 Portability problems not fixed by Gnulib:
36 @itemize
37 @item
38 @xref{sys/stat.h}, for general portability problems with @code{struct stat}.
39 @end itemize