doc/posix-functions/readdir.texi

   1 @node readdir
   2 @section @code{readdir}
   3 @findex readdir
   4
   5 POSIX specification:@* @url{http://www.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.  (Cf. @code{AC_SYS_LARGEFILE}.)
  19 @end itemize
  20
  21 Portability problems not fixed by Gnulib:
  22 @itemize
  23 @item
  24 Although POSIX places no restrictions on @code{d_ino} values, some
  25 older systems are rumored to return @code{d_ino} values equal to zero
  26 for directory entries that do not really exist.  Although Gnulib
  27 formerly attempted to cater to these older systems, this caused
  28 misbehavior on standard systems and so Gnulib does not attempt to
  29 cater to them any more.  If you know of any problems caused by this,
  30 please send a bug report.
  31 @end itemize