GETDENTS(2)

НАЗВАНИЕ
getdents - чтение элементов каталога и преобразование в системно-независимый формат

СИНТАКСИС


        #include <sys/dirent.h>



        int getdents (fildes, buf, nbyte)

        int fildes;

        char *buf;

        unsigned nbyte;

ОПИСАНИЕ
Аргумент fildes - это дескриптор файла, полученный от системного вызова open(2) или dup(2).

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

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

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

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

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

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

СМ. ТАКЖЕ
directory(3X), dirent(4).

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