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.3, FreeBSD 6.0, NetBSD 3.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 some platforms, @code{fstatat(fd,"file/",buf,flag)} succeeds instead of
  18 failing with @code{ENOTDIR}.
  19 Solaris 9.
  20 @item
  21 For symlinks, when the argument ends in a slash, some platforms don't
  22 dereference the argument:
  23 Solaris 9.
  24 @end itemize
  25
  26 Portability problems not fixed by Gnulib:
  27 @itemize
  28 @item
  29 On platforms where @code{off_t} is a 32-bit type, @code{fstatat} may
  30 not correctly report the size of files or block devices larger than 2
  31 GB.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.
  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