[qmail] / direntry.3

.TH direntry 3
.SH NAME
direntry \- read directory entries
.SH SYNTAX
.B #include <direntry.h>

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

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

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

DIR *\fIdir\fR;
.br
char *\fIfn\fR;
.SH DESCRIPTION
The point of
.B direntry.h
is to provide a uniform interface to BSD's
.B sys/dir.h
and POSIX's
.BR dirent.h .

The
.B readdir
interface is highly unsatisfactory.
It does not distinguish between I/O errors and end-of-directory.
It uses
.BR malloc .
The return type for
.B closedir
varies: some implementations return the
.B close
return value.
.SH "SEE ALSO"
readdir(3)
Commit	Line	Data
2117e02e MW	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)