NOME¶

getdents - obtém as entradas de diretórios

SINOPSE¶

#include <unistd.h>
#include <linux/types.h>
#include <linux/dirent.h>
#include <linux/unistd.h>

_syscall3(int, getdents, uint, fd, struct dirent *, dirp, uint, count);

int getdents(unsigned int fd, struct dirent *dirp, unsigned int count);

DESCRIÇÃO¶

getdents lê várias estruturas dirent a partir do diretório apontado por fd dentro da área de memória apontada por dirp. O parãmetro count é o tamanho da área de memória.

A estrutura dirent é declarada como segue:

struct dirent
{


    long d_ino;                 /* inode number */


    off_t d_off;                /* offset to next dirent */


    unsigned short d_reclen;    /* length of this dirent */


    char d_name [NAME_MAX+1];   /* file name (null-terminated) */
}

d_ino é um número de inode. d_off é a distãncia a partir do início do diretório para o iníco do próximo dirent. d_reclen é o tamanho da completa dirent. d_name é um nome de arquivo vazio.

Esta chamada substitui readdir(2).

VALORES RETORNADOS¶

Em caso de sucesso, o número de bytes lidos é retornado. No final do diretório, 0 é retornado. Caso contrário, -1 is retornado, e errno é selecionado apropriadamente.

ERROS¶

EBADF

Descritor de arquivos inválido fd.

EFAULT

O argumento aponta para o espaço de enderenço dp processo solicitante.

EINVAL

O buffer de resultado é muito pequeno.

ENOENT

Sem aquele diretório.

ENOTDIR

O descritor de arquivos não se refere para um diretório.

DE ACORDO COM¶

SVr4, SVID. Na documentação SVr4 condições de erro adicionais ENOLINK, EIO.

VEJA TAMBÉM¶

readdir(2), readdir(3)

TRADUZIDO POR LDP-BR em 21/08/2000.¶

André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)