ОБЗОР
#include <sys/types.h>
#include <dirent.h>
int dirfd(DIR *dirp);
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
dirfd():
|| /* начиная с glibc 2.10: */ (_POSIX_C_SOURCE >= 200809L || _XOPEN_SOURCE >= 700)
ОПИСАНИЕ
Функция dirfd() возвращает файловый дескриптор, связанный с потоком
каталога dirp.
Этот файловый дескриптор используется внутри функции потоком каталога. В результате он полезен только для функций, которые не зависят и не изменяют положение в файле, например fstat(2) и fchdir(2). Он автоматически закрывается при вызове closedir(3).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении возвращается неотрицательный файловый
дескриптор. При ошибке возвращается -1 и errno устанавливается в
соответствующее значение.
ОШИБКИ
В POSIX.1-2008 определены две ошибки, ни одна из которых не возвращается
текущей реализацией.
EINVAL Значение dirp не указывает на допустимый поток каталога.
ENOTSUP Реализация не поддерживает связь файлового дескриптора с каталогом.
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс Атрибут Значение
dirfd()
безвредность в потоках: безвредно (MT-Safe)
