GNU
2017-09-15
Aliases: fdopendir(3), fdopendir(3), fdopendir(3), fdopendir(3), fdopendir(3), fdopendir(3), fdopendir(3), fdopendir(3)
man-pages-ru
Russian man pages from the Linux Documentation Project
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
ИМЯ
opendir, fdopendir - открывает каталог
ОБЗОР
#include <sys/types.h> #include <dirent.h>
DIR *opendir(const char *name); DIR *fdopendir(int fd);
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
fdopendir():
| Начиная с glibc 2.10: | |
| _POSIX_C_SOURCE >= 200809L | |
| До glibc 2.10: | |
| _GNU_SOURCE | |
ОПИСАНИЕ
Функция opendir() открывает поток каталога, соответствующий каталогу с именем name, и возвращает указатель на поток каталога. Поток устанавливается на первую запись в каталоге.
Функция fdopendir() похожа на opendir(), но возвращает поток каталога для каталога, на который ссылается открытый файловый дескриптор fd. После успешного вызова fdopendir(), дескриптор fd используется только внутри реализации и не должен использоваться в приложении.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функции opendir() и fdopendir() возвращают указатель на поток каталога. В случае ошибки возвращается NULL, а errno присваивается соответствующее значение.
ОШИБКИ
| EACCES | Доступ запрещен. |
| EBADF | Значение fd не является подходящим файловым дескриптором, открытым для чтения. |
| EMFILE | Было достигнуто ограничение по количеству открытых файловых дескрипторов на процесс. |
| ENFILE | Достигнуто максимальное количество открытых файлов в системе. |
| ENOENT | Каталог не существует, либо name содержит пустую строку. |
| ENOMEM | Недостаточно памяти для завершения операции. |
| ENOTDIR | |
| Значение name не является каталогом. | |
ВЕРСИИ
Функция fdopendir() доступна в glibc начиная с версии 2.4.
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
| Интерфейс | Атрибут | Значение |
| opendir(), fdopendir() | Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ
Функция opendir() присутствует в SVr4, 4.3BSD и описана в стандарте POSIX.1-2001. Функция fdopendir() описана в POSIX.1-2008.
ЗАМЕЧАНИЯ
Записи имён файлов можно читать из потока каталога с помощью readdir(3).
Задействованный файловый дескриптор потока каталога может быть получен в помощью dirfd(3).
Функция opendir() устанавливает флаг close-on-exec для файлового дескриптора, указывающего на DIR *. Функция fdopendir() оставляет флаг close-on-exec не изменённым для файлового дескриптора fd. В POSIX.1-200x нет точного определения на этот счет, хотя успешный вызов fdopendir() установит флаг close-on-exec для файлового дескриптора fd.
