Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

readdir64_r(3) OSS Library Calls Reference Manual
directory is actually read. Applications that need to check for error situations should set errno to
0 (zero) before calling readdir( ).Iferrno is set to a nonzero value on return, an error occurs.
RETURN VALUES
Upon successful completion, the readdir64_r( ) function returns the value 0 (zero). Otherwise, a
nonzero error number is returned, and errno is set to indicate the error. For the possible values
that can be returned, see the ERRORS subsection of this reference page.
ERRORS
If any of these conditions occur, the readdir64_r( ) function sets errno to the corresponding
value:
[EBADF] The dirp parameter does not point to a valid directory structure open for reading.
[EFAULT] The dirp parameter does not point to a valid directory structure open for reading.
[EINVAL] One of these conditions occured:
• Table overflow occurred after the last valid telldir( ) function call for a
Guardian disk volume or subvolume. Only the last 128 values returned
by the telldir( ) function can be saved in the table.
• Either the ret or the result parameter is NULL.
[EIO] An input/output error occurred during a read from the directory.
[ENETDOWN]
The dirp parameter specifies a directory on a remote node, but communication
with the remote node has been lost.
[ENOENT] An invalid position value was used in the previous call to the seekdir( ) function.
[ENOMEM] The system has insufficient resources to complete the request.
[ENOROOT] The root fileset (fileset 0) is not in the STARTED state.
[ENXIO] One of the following events occurred:
• A device was specified that does not exist, or a request was made beyond
the limits of the device.
• The fileset containing the requestor’s current working directory or root
directory is not mounted. This error can occur after failure and restart of
an OSS name server until the fileset has been repaired and remounted.
[EWRONGID] The call cannot be completed because an input/output process has failed or is in
the down state.
RELATED INFORMATION
Functions: closedir(3), mkdir(2), opendir(3), readdir(3), readdir_r(3) rewinddir(3),
rmdir(2), seekdir(3), telldir(3).
Files: thread_safety(5).
STANDARDS CONFORMANCE
This function is an HP extension to the XPG4 Version 2 specification.
This function conforms to IEEE Std 1003.1 2004, POSIX System Application Program Interface.
5−146 Hewlett-Packard Company 527187-017