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