Unix Man (Справочное руководство)

         

GETDENTS(2)


GETDENTS(2)

НАЗВАНИЕ


getdents - чтение элементов каталога и преобразование в системно-независимый формат

СИНТАКСИС

#include <sys/dirent.h>

int getdents (fildes, buf, nbyte) int fildes; char *buf; unsigned nbyte;

ОПИСАНИЕ


Аргумент fildes - это дескриптор файла, полученный от системного вызова или .

Системный вызов пытается прочитать nbyte байт из каталога, ассоциированного с дескриптором fildes, переформатировать их в не зависящие от типа файловой системы элементы каталога и поместить результат в буфер, заданный указателем buf. Так как не зависящие от типа файловой системы элементы каталога имеют переменную длину, в большинстве случаев фактическое число возвращенных байт будет строго меньше, чем nbyte.

Не зависящий от типа файловой системы формат элемента каталога задается структурой dirent. Она описана в .

При работе с устройствами, допускающими позиционирование, чтение начинается с позиции в файле, заданной указателем файла, соответствующего дескриптору fildes. После завершения системного вызова getdents указатель файла получает приращение и указывает на следующий элемент каталога.

Данный системный вызов был разработан для реализации функции [см. ]; не следует использовать его для других целей.

Системный вызов getdents завершается неудачей, если выполнено хотя бы одно из следующих условий:

[EBADF] Аргумент fildes не является корректным дескриптором файла, открытого на чтение. [EFAULT] Аргумент buf указывает за пределы отведенного процессу адресного пространства. [EINVAL] Значение аргумента nbyte меньше длины одного элемента каталога. [ENOENT] Текущий указатель файла для каталога установлен не на корректный элемент. [ENOLINK] Аргумент fildes указывает на удаленный компьютер, связи с которым в данный момент нет. [ENOTDIR] Дескриптор fildes ассоциирован не с каталогом. [EIO] Во время доступа к файловой системе произошла ошибка ввода/вывода.

СМ. ТАКЖЕ


, .

ДИАГНОСТИКА


При успешном завершении возвращается неотрицательное целое число, равное количеству фактически прочитанных байт. Значение 0 обозначает, что был достигнут конец каталога. В случае ошибки возвращается -1, а переменной errno присваивается код ошибки.



Содержание раздела