NOME

       readdir - lê a entrada do diretório

SINOPSE

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

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

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

DESCRIÇÃO

       Está não é a função que você possa se interessar.  Veja em readdir(3) para a interface POSIX adequada com
       a biblioteca C.  Esta página documenta a interface de chamada bare do kernel, que pode  ser  alterado,  e
       substituído por getdents(2).

       readdir lê uma estrutura dirent a partir do diretório apontado por fd para a área de memória apontada por
       dirp.  O parãmetro count é ignorado; no máximo uma strutura dirent é lida.

       A estrutura dirent é declarada como segue:

              struct dirent
              {
                  long d_ino;                 /* inode number */
                  off_t d_off;                /* offset to this dirent */
                  unsigned short d_reclen;    /* length of this d_name */
                  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  esta  dirent.
       d_reclen  é  o  tamanho  de d_name, sem contar o caractere terminador.  d_name é um nome de arquivo com o
       caracter terminador nulo.

VALORES RETORNADOS

       Em caso de sucesso, 1 é retornado.  No  final  do  diretório,  0  é  retornado.   Caso  contrário,  -1  é
       retornado, e errno é selecionado adequadamente.

ERROS

       EBADF  É um descritor de arquivos inválido fd.

       EFAULT O argumento aponta para fora da área de endereços do processo solicitante.

       EINVAL O buffer de resultado é muito pequeno.

       ENOENT Não encontrado o diretório.

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

DE ACORDO COM

       Esta chamada de sistema é específica do Linux.

VEJA TAMBÉM

       getdents(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)