table of contents
OPENDIR(3) | Руководство программиста Linux | OPENDIR(3) |
ИМЯ¶
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:
- _XOPEN_SOURCE >= 700 || _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.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
Функция opendir() присутствует в SVr4, 4.3BSD и описана в стандарте POSIX.1-2001. Функция fdopendir() описана в POSIX.1-2008.
ЗАМЕЧАНИЯ¶
Задействованный файловый дескриптор потока каталога может быть получен в помощью dirfd(3).
Функция opendir() устанавливает флаг close-on-exec для файлового дескриптора, указывающего на DIR *. Функция fdopendir() оставляет флаг close-on-exec не изменённым для файлового дескриптора fd. В POSIX.1-200x нет точного определения на этот счет, хотя успешный вызов fdopendir() установит флаг close-on-exec для файлового дескриптора fd.
СМОТРИТЕ ТАКЖЕ¶
open(2), closedir(3), dirfd(3), readdir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)
2010-06-20 | GNU |