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)