Provided by:
manpages-pt-dev_20040726-2_all 
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)