mdw@git.distorted.org.uk Git - qmail/blob - direntry.3

   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)