rewinddir() -- General Function (libc)

Rewind a directory stream
#include <dirent.h>
void rewinddir(dirp)
DIR *dirp;

The COHERENT function rewinddir() is one of a set of COHERENT routines that
manipulate  directories  in a  device-independent  manner.   It resets  the
current  position within  the directory  stream pointed to  by dirp  to the
beginning of the directory.

rewinddir() discards  all buffered data for its  data stream.  This ensures
that  your program  knows  about all  modifications to  the directory  that
occurred since the last time the directory stream was opened or rewound.

If  an error  occurs, rewinddir()  exits and sets  errno to  an appropriate
value.

See Also

closedir(),
dirent.h,
getdents(),
libc,
opendir(),
readdir(),
seekdir(),
telldir()
POSIX Standard, §5.1.2

Notes

Because directory entries can dynamically appear and disappear, and because
directory contents are buffered  by these routines, an application may need
to continually  rescan a directory  to maintain an accurate  picture of its
active entries.

The COHERENT implementation of the dirent routines was written by D. Gwynn.

© 2012 by Stephen A. Ness