Implementation status: to be implemented

Synopsis

#include <dirent.h>

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

Description

The functions open the directory associated with a file descriptor or a name.

Arguments:

fd - the file descriptor.
dirname - the name of the directory to open.

Upon successful return from fdopendir(), the file descriptor is under the control of the system, and if any attempt is made to close the file descriptor, or to modify the state of the associated description, other than by means of closedir(), readdir(), readdir_r(), rewinddir(), or seekdir(), the behavior is undefined. Upon calling closedir() the file descriptor is closed.

The FD_CLOEXEC flag is set on the file descriptor by a successful call to fdopendir().

The opendir() function opens a directory stream corresponding to the directory named by the dirname argument. The directory stream is positioned at the first entry.

Return value

Upon successful completion, fdopendir() and opendir() return a pointer to an object of type DIR. Otherwise, these functions return a null pointer and set errno to indicate the error.

Errors

For fdopendir():

[EBADF] The fd argument is not a valid file descriptor open for reading.
[ENOTDIR] The descriptor fd is not associated with a directory.

For the opendir() function:

[EACCES] Search permission is denied for the component of the path prefix of dirname or read permission is denied for dirname.
[ELOOP] A loop exists in symbolic links encountered during resolution of the dirname argument.
[ENAMETOOLONG] The length of a component of a pathname is longer than {NAME_MAX}.
[ENOENT] A component of dirname does not name an existing directory or dirname is an empty string.
[ENOTDIR] A component of dirname names an existing file that is neither a directory nor a symbolic link to a directory.
[ELOOP] More than {SYMLOOP_MAX} symbolic links were encountered during resolution of the dirname argument.
[EMFILE] All file descriptors available to the process are currently open.
[ENAMETOOLONG] The length of a pathname exceeds {PATH_MAX}, or pathname resolution of a symbolic link produced an intermediate result with a length that exceeds {PATH_MAX}.
[ENFILE] Too many files are currently open in the system.

Implementation tasks

  • Implement fdopendir() function
  • Implement error detection as described above.