rewinddir(3C)
NAME
rewinddir - reset position of directory stream to the begin-
ning of a directory
SYNOPSIS
#include <sys/types.h>
#include <dirent.h>
void rewinddir(DIR *dirp);
DESCRIPTION
The rewinddir() function resets the position of the direc-
tory stream to which dirp refers to the beginning of the
directory. It also causes the directory stream to refer to
the current state of the corresponding directory, as a call
to opendir(3C) would have done. If dirp does not refer to a
directory stream, the effect is undefined.
After a call to the fork(2) function, either the parent or
child (but not both) may continue processing the directory
stream using readdir(3C), rewinddir() or seekdir(3C). If
both the parent and child processes use these functions, the
result is undefined.
RETURN VALUES
The rewinddir() function does not return a value.
ERRORS
No errors are defined.
USAGE
The rewinddir() function should be used in conjunction with
opendir(), readdir(), and closedir(3C) to examine the con-
tents of the directory. This method is recommended for por-
tability.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| MT-Level | Safe |
|_____________________________|_____________________________|
SEE ALSO
fork(2), closedir(3C), opendir(3C), readdir(3C),
seekdir(3C), attributes(5)
Man(1) output converted with
man2html