poll tests: Avoid test failure on BSD and Solaris systems.
[gnulib.git] / doc / posix-functions / readdir_r.texi
blob5a7391bfd655192fde93540cf1e85921865c0285
1 @node readdir_r
2 @section @code{readdir_r}
3 @findex readdir_r
5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/readdir_r.html}
7 Gnulib module: extensions
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is planned to be removed from POSIX and to be deprecated
13 in glibc.  Portable applications should use @code{readdir}.
14 @item
15 This function has an incompatible declaration on some platforms:
16 Solaris 11.4 (when @code{_POSIX_PTHREAD_SEMANTICS} is not defined).
17 @end itemize
19 Portability problems not fixed by Gnulib:
20 @itemize
21 @item
22 This function is missing on some platforms:
23 Minix 3.1.8, mingw, MSVC 14.
24 @item
25 On platforms where @code{off_t} is a 32-bit type, this function may not
26 work correctly on huge directories larger than 2 GB@.  Also, on platforms
27 where @code{ino_t} is a 32-bit type, this function may report inode numbers
28 incorrectly.  This can occur with file systems such as XFS (typically on
29 large disks) and NFS@.  The fix is to use the @code{AC_SYS_LARGEFILE} macro.
30 @end itemize