opendir()

opendir(3)

Name

opendir, fdopendir - open a directory

Synopsis

#include <sys/types.h>
#include <dirent.h>

DIR *opendir(const char *name);
DIR *fdopendir(int fd);

Feature Test Macro Requirements for glibc (see [feature_test_macros(7)):

• fdopendir():

  Since glibc 2.10:

  _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L

  Before glibc 2.10:

  _GNU_SOURCE

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.

The fdopendir() function is like opendir(), but returns a directory stream for the directory referred to by the open file descriptor fd. After a successful call to fdopendir(), fd is used internally by the implementation, and should not otherwise be used by the application.

Errors

• EACCES
  • Permission denied.
• EBADF
  • fd is not a valid file descriptor opened for reading.
• 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.