Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

rewinddir(3) OSS Library Calls Ref
erence Manual
Directory Operations After fork Operations |
If, after a call to a fork() or tdm_fork() function, both the parent and child processes make calls |
to the readdir() function to access an OSS directory, the results of the calls are undefined. |
If, after a call to a fork() or tdm_fork() function, both the parent and child processes make calls |
to the rewinddir() function and the readdir() function to access an OSS directory, the results |
are undefined. |
Use on Guardian Objects |
|
• ||
Only disks appear as entries in the /G directory. A call to rewinddir() rewinds the list of |
disks to the beginning. A call to rewinddir() on a specific disk rewinds the list of its |
subvolumes to the beginning. |
RETURN VALUES
|
The rewinddir( ) function does not return a value. If rewinddir( ) detects a problem, it sets |
errno. For correct processing of errors, set errno to the value 0 (zero) before each rewinddir() |
function call and test the value of errno after each call. |
ERRORS |
If any of the following conditions occur, the rewinddir() function sets errno to the correspond- |
ing value: |
[EBADF] ||
The dir_pointer parameter does not refer to an open directory stream. This error |
is returned instead of [EFAULT] if the process has copied and altered the struc- |
ture pointed to by the dir_pointer parameter after the system has freed the buffer |
that contains the structure. |
[EFAULT] ||
The dir_pointer parameter does not point to a valid directory structure open for |
reading. |
RELATED INFORMATION
|
Functions: closedir(3), mkdir(2), opendir(3), readdir(3), rmdir(2), seekdir(3), telldir(3).|
STANDARDS CONFORMANCE
|
The POSIX standards leave some features to the implementing vendor to define. The following |
features are affected in the HP implementation: |
|
• ||
If files are removed from a directory after the most recent call to the opendir() or |
rewinddir( ) function but prior to the first call to the readdir() function, the readdir() |
function does not return entries for these files. If files are added to a directory after the |
most recent call to the opendir() or rewinddir() function but prior to the first call to the |
readdir() function, the readdir() function returns entries for these files. |
|
• ||
The ramifications of buffering more than one directory entry per read operation are |
defined. |
5−114 Hewlett-Packard Company 527187-007