1 .TH direntry 3

     2 .SH NAME

     3 direntry \- read directory entries

     4 .SH SYNTAX

     5 .B #include <direntry.h>

     6 

     7 DIR *\fBopendir\fP(\fIfn\fR);

     8 

     9 struct direntry *\fBreaddir\fP(\fIdir\fP);

    10 

    11 void \fBclosedir\fP(\fIdir\fP);

    12 

    13 DIR *\fIdir\fR;

    14 .br

    15 char *\fIfn\fR;

    16 .SH DESCRIPTION

    17 The point of

    18 .B direntry.h

    19 is to provide a uniform interface to BSD's

    20 .B sys/dir.h

    21 and POSIX's

    22 .BR dirent.h .

    23 

    24 The

    25 .B readdir

    26 interface is highly unsatisfactory.

    27 It does not distinguish between I/O errors and end-of-directory.

    28 It uses

    29 .BR malloc .

    30 The return type for

    31 .B closedir

    32 varies: some implementations return the

    33 .B close

    34 return value.

    35 .SH "SEE ALSO"

    36 readdir(3)