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)