opendir(3) - Linux man page
Name
opendir - open a directory
Synopsis
#include <sys/types.h>
#include <dirent.h>
DIR *opendir(const char *name);
Description
The
opendir() function opens a directory stream corresponding to the directory
name, and
returns a pointer to the directory stream. The stream is positioned at the first entry in the directory.
Return Value
The
opendir() function returns a pointer to the directory stream. On error, NULL is returned, and
errno is set appropriately.
Errors
- EACCES
- Permission denied.
- EMFILE
- Too many file descriptors in use by process.
- ENFILE
- Too many files are currently open in the system.
- ENOENT
- Directory does not exist, or name is an empty string.
- ENOMEM
- Insufficient memory to complete the operation.
- ENOTDIR
- name is not a directory.
Notes
The underlying file descriptor of the directory stream can be obtained using
dirfd(3).
Conforming to
SVr4, 4.3BSD, POSIX.1-2001.
See Also
open(2),
closedir(3),
dirfd(3),
readdir(3),
rewinddir(3),
scandir(3),
seekdir(3),
telldir(3)
Referenced By
fts(3),
getdirentries(3),
glob(3)
