Provided by:
manpages-es_1.55-10_all 
NOMBRE
getdents - obtiene las entradas de un directorio
SINOPSIS
#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);
DESCRIPCI'ON
getdents lee varias estructuras dirent del directorio senalado por el
puntero fd en el area de memoria senalada por dirp. El parametro count
es el tamano del area de memoria.
La estructura dirent se declara de la siguente manera:
struct dirent
{
long d_ino; /* numero de nodo-i */
off_t d_off; /* desplazamiento al proximo dirent */
unsigned short d_reclen; /* longitud de este dirent */
char d_name [NAME_MAX+1]; /* Nombre del fichero (terminado en NUL) */
}
d_ino es un numero de nodo-i. d_off es la distancia desde el principio
del directorio al comienzo del proximo dirent. d_reclen es el tamano
de todo el dirent. d_name es un nombre de fichero terminado en NUL (el
caracter de codigo 0).
Esta llamada sustituye a readdir(2).
VALOR DEVUELTO
En caso de exito de regresa el numero de bytes leidos. Si se llega al
final del directorio se devuelve 0. En caso de error se devuelve -1, y
en la variable errno se pone un valor apropiado.
ERRORES
EBADF Descriptor de fichero invalido fd.
EFAULT El argumento apunta afuera del espacio de direcciones del
proceso llamador.
EINVAL El bufer del resultado es demasiado pequeno.
ENOENT El directorio no existe.
ENOTDIR
El descriptor de fichero no se refiere a un directorio.
CONFORME A
SVr4, SVID. SVr4 documenta las condiciones de error adicionales
ENOLINK y EIO.
V'EASE TAMBI'EN
readdir(2), readdir(3).