dirfd

dirfd - get directory stream file descriptor

#include <sys/types.h>
#include <dirent.h> I int dirfd(DIR * dir );

The function R dirfd () returns the file descriptor associated with the directory stream R dir .

This descriptor is the one used internally by the directory stream. As a result, it is only useful for functions which do not depend on or alter the file position, such as fstat(2) and fchdir(2). It will be automatically closed when closedir(3) is called.

On error -1 is returned.

This is a BSD extension, present in 4.3BSD-Reno, not in 4.2BSD. It is present in libc5 (since 5.1.2) and in glibc2. This function is under consideration for inclusion in a future version of POSIX.1.

The prototype for R dirfd () is only available if _BSD_SOURCE or _SVID_SOURCE is defined.

open(2), closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)