119 lines
2.5 KiB
Groff
119 lines
2.5 KiB
Groff
|
||
|
||
DIRECTORY(3) Minix Programmer's Manual DIRECTORY(3)
|
||
|
||
|
||
NAME
|
||
directory, opendir, readdir, rewinddir, closedir, telldir, seekdir -
|
||
directory routines
|
||
|
||
SYNOPSIS
|
||
#include <sys/types.h>
|
||
#include <dirent.h>
|
||
|
||
DIR *opendir(const char *dirname)
|
||
struct dirent *readdir(DIR *dirp)
|
||
void rewinddir(DIR *dirp)
|
||
int closedir(DIR *dirp)
|
||
|
||
#define _MINIX 1
|
||
#include <sys/types.h>
|
||
#include <dirent.h>
|
||
|
||
long telldir(DIR *dirp)
|
||
int seekdir(DIR *dirp, long pos)
|
||
|
||
DESCRIPTION
|
||
These routines form a system independent interface to access directories.
|
||
|
||
Opendir() opens the directory dirname and returns a pointer to this open
|
||
directory stream.
|
||
|
||
Readdir() reads one entry from the directory as a pointer to a structure
|
||
containing the field d_name, a character array containing the null-
|
||
terminated name of the entry.
|
||
|
||
Rewinddir() allows the directory to be read again from the beginning.
|
||
|
||
Closedir() closes the directory and releases administrative data.
|
||
|
||
The Minix specific functions telldir() and seekdir() allow one to get the
|
||
current position in the directory file and to return there later.
|
||
Seekdir() may only be called with a position returned by telldir() or 0
|
||
(rewind). These functions should not be used in portable programs.
|
||
|
||
SEE ALSO
|
||
dir(5).
|
||
|
||
DIAGNOSTICS
|
||
Opendir() returns a null pointer if dirname can't be opened, or if it
|
||
can't allocate enough memory for the DIR structure.
|
||
|
||
Readdir() returns null if there are no more directory entries or on
|
||
error.
|
||
|
||
|
||
|
||
|
||
1
|
||
|
||
|
||
|
||
DIRECTORY(3) Minix Programmer's Manual DIRECTORY(3)
|
||
|
||
|
||
Closedir() and seekdir() returns 0 on success, -1 on error.
|
||
|
||
Telldir() returns -1 on error.
|
||
|
||
All of them set errno appropriately. Readdir() will only set errno on
|
||
error, not on end-of-dir, so you should set errno to zero beforehand, and
|
||
check its value if readdir() returns null.
|
||
|
||
NOTES
|
||
The return value of readdir() needs to be copied before the next
|
||
operation on the same directory if it is to be saved.
|
||
|
||
AUTHOR
|
||
Kees J. Bot (kjb@cs.vu.nl)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
2
|
||
|