NAME

opendirat - open a directory

SYNOPSIS

#include <fcntl.h> /* AT_FDCWD */
#include <limb/direntry.h>

DIR *opendirat(int fd, const char *name)

DESCRIPTION

The opendirat() 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.

It is equivalent to the function opendir(3) except when name specifies a relative path, the directory to be opened is then determined relative to the directory associated with the file descriptor fd instead of the current working directory.

If passed the special value AT_FDCWD in the fd parameter, the current working directory shall be used and the behavior shall be identical to a call to opendir(3).

RETURN VALUE

Upon successful completion, the opendirat function returns a pointer to the opened directory stream. Otherwise, it returns NULL and sets errno to indicate the error.

ERRORS

The opendirat() function may fail and set errno for any of the errors specified for the functions open(3) and fdopendir(3).