summaryrefslogtreecommitdiff
path: root/doc/posix-headers/dirent.texi
blob: 0a19fd3c2a4ab782b15818eb39f437ec069bd752 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
@node dirent.h
@section @file{dirent.h}

POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/basedefs/dirent.h.html}

Gnulib module: dirent

Portability problems fixed by Gnulib:
@itemize
@item
The type @code{ino_t} is missing on some platforms:
glibc 2.8 and others.
@end itemize

Portability problems not fixed by Gnulib:
@itemize
@item
This header file is missing on some platforms:
MSVC 14.

@item
Although many systems define a @code{struct dirent} member named
@code{d_type} and directory entry type macros like @code{DT_DIR} and
@code{DT_LINK}, some do not:
AIX 7.2, HP-UX 11, Solaris 11, probably others.

@item
On systems with @code{d_type}, not every filesystem supports
@code{d_type}, and those lacking support will set it to @code{DT_UNKNOWN}.

@item
Some systems define a @code{struct dirent} member named @code{d_namlen}
containing the string length of @code{d_name}, but others do not.

@item
Some systems define a @code{struct dirent} member named @code{d_off}
containing a magic cookie suitable as an argument to @code{seekdir},
but others do not.

@item
Some systems define a @code{struct dirent} member named
@code{d_reclen} containing the number of bytes in the directory entry
record, but others do not.  This member has limited utility, as it is
an implementation detail.
@end itemize