redhat man page for opendir

OPENDIR(3)						     Linux Programmer's Manual							OPENDIR(3)

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)

								    1995-06-11								OPENDIR(3)