HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

d
directory(3C) directory(3C)
seekdir() does not return any value, but if an error is encountered,
errno is set to indicate the
error.
closedir() upon successful completion, returns a value of
0. Otherwise, it returns a value of -1
and sets errno to indicate the error.
ERRORS
opendir() fails if any of the following conditions are encountered:
[EACCES] Search permission is denied for a component of dirname, or read permission is
denied for dirname.
[EFAULT] dirname points outside the allocated address space of the process. The reliable
detection of this error is implementation dependent.
[ELOOP] Too many symbolic links were encountered in translating the path name.
[EMFILE] Too many open file descriptors are currently open for the calling process.
[ENAMETOOLONG]
A component of dirname exceeds
PATH_MAX bytes, or the entire length of dir-
name exceeds PATH_MAX − 1 bytes while _POSIX_NO_TRUNC
is in effect.
[ENFILE] Too many open file descriptors are currently open on the system.
[ENOENT] A component of dirname does not exist.
[ENOMEM]
malloc() failed to provide sufficient memory to process the directory.
[ENOTDIR] A component of dirname is not a directory.
[ENOENT] The dirname argument points to an empty string.
readdir() or readdir_r() might fail if any of the following conditions are encountered:
[EBADF] dirp does not refer to an open directory stream.
[ENOENT] The directory stream to which dirp refers is not located at a valid directory
entry.
[EFAULT] dirp points outside the allocated address space of the process.
telldir() might fail if any of the following conditions are encountered:
[EBADF] dirp does not refer to an open directory stream.
[ENOENT] dirp specifies an improper file system block size.
seekdir() might fail if the following condition is encountered:
[ENOENT] dirp specifies an improper file system block size.
closedir() might fail if any of the following conditions are encountered:
[EBADF] dirp does not refer to an open directory stream.
[EFAULT] dirp points outside the allocated address space of the process.
rewinddir() might fail if any of the following conditions are encountered:
[EBADF] dirp does not refer to an open directory stream.
[EFAULT] dirp points outside the allocated address space of the process.
EXAMPLES
The following code searches the current directory for an entry name:
DIR *dirp;
struct dirent *dp;
dirp = opendir(".");
while ((dp = readdir(dirp)) != NULL) {
if (strcmp(dp->d_name, name) == 0) {
(void) closedir(dirp);
return FOUND;
}
HP-UX 11i Version 2: December 2007 Update − 2 − Hewlett-Packard Company 287