doc/posix-functions/readdir.texi

   1 @node readdir
   2 @section @code{readdir}
   3 @findex readdir
   4
   5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/readdir.html}
   6
   7 Gnulib module: readdir
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 This function is missing on some platforms:
  13 MSVC 14.
  14 @item
  15 On platforms where @code{off_t} is a 32-bit type, this function may not
  16 work correctly on huge directories larger than 2 GB@.  Also, on platforms
  17 where @code{ino_t} is a 32-bit type, this function may report inode numbers
  18 incorrectly.  This can occur with file systems such as XFS (typically on
  19 large disks) and NFS@.  (Cf. @code{AC_SYS_LARGEFILE}.)
  20 @end itemize
  21
  22 Portability problems not fixed by Gnulib:
  23 @itemize
  24 @item
  25 Although POSIX places no restrictions on @code{d_ino} values, some
  26 older systems are rumored to return @code{d_ino} values equal to zero
  27 for directory entries that do not really exist.  Although Gnulib
  28 formerly attempted to cater to these older systems, this caused
  29 misbehavior on standard systems and so Gnulib does not attempt to
  30 cater to them any more.  If you know of any problems caused by this,
  31 please send a bug report.
  32 @end itemize