View Source: getdents(2) - Waikato Linux Users Group

You are viewing an old revision of this page. View the current version.

GETDENTS
!!!GETDENTS
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
CONFORMING TO
SEE ALSO
----
!!NAME


getdents - get directory entries
!!SYNOPSIS


__#include
__ ''fd''__, struct dirent *__''dirp''__, unsigned int__ ''count''__);
__
!!DESCRIPTION


__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 next ''dirent'' */
unsigned short d_reclen;    /* length of this ''dirent'' */
char d_name [[NAME_MAX+1];   /* file name (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 file
name.


This call supersedes readdir(2).
!!RETURN VALUE


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.
!!ERRORS


__EBADF__


Invalid file descriptor ''fd''.


__EFAULT__


Argument points outside the calling process's address
space.


__EINVAL__


Result buffer is too small.


__ENOENT__


No such directory.


__ENOTDIR__


File descriptor does not refer to a directory.
!!CONFORMING TO


SVr4, SVID. SVr4 documents additional ENOLINK, EIO error
conditions.
!!SEE ALSO


readdir(2), readdir(3)
----

3 pages link to getdents(2):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Version 1, saved on Tuesday, June 4, 2002 12:23:41 am by "perry"

Edit PageHistory Diff Info LikePages