getdents — get directory entries
#include <unistd.h> #include <linux/types.h> #include <linux/dirent.h> #include <linux/unistd.h> #include <errno.h> _syscall3(int, getdents, uint, fd, struct dirent *, dirp, uint, count) /* Using syscall(2) may be preferable; see intro(2) */
int
getdents( |
unsigned int | fd, |
struct dirent * | dirp, | |
unsigned int | count) ; |
This is not the function you are interested in. Look at readdir(3) for the POSIX conforming C library interface. This page documents the bare kernel system call interface.
The system call getdents
()
reads several dirent
structures from the
directory pointed at by fd
into the memory area pointed
to by dirp
. The
parameter count
is
the size of the memory area.
The dirent
structure is declared as follows:
struct dirent { long d_ino; /* inode number */ off_t d_off; /* offset to nextdirent
*/ unsigned short d_reclen; /* length of thisdirent
*/ char d_name [NAME_MAX+1]; /* filename (null-terminated) */ }
d_ino
is an
inode number. d_off
is the distance from the start of the directory to the start
of the next dirent
.
d_reclen
is the
size of this entire dirent
. d_name
is a null-terminated
filename.
This call supersedes readdir(2).
On success, the number of bytes read is returned. On end
of directory, 0 is returned. On error, −1 is returned,
and errno
is set
appropriately.
Invalid file descriptor fd
.
Argument points outside the calling process's address space.
Result buffer is too small.
No such directory.
File descriptor does not refer to a directory.
|