|
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 or NULL if an error occurred.
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
SVID 3,
POSIX, BSD 4.3
See Also
open(2)
, closedir(3)
, dirfd(3)
, readdir(3)
, rewinddir(3)
,
scandir(3)
, seekdir(3)
, telldir(3)
|
|
jamesthornton.com>