NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | SEE ALSO | COLOPHON

The Linux Programming Interface

GETDIRENTRIES(3)              Linux Programmer's Manual              GETDIRENTRIES(3)

NAME         top

       getdirentries - get directory entries in a file system-independent format

SYNOPSIS         top

       #include <dirent.h>

       ssize_t getdirentries(int fd, char *buf, size_t nbytes , off_t *basep);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       getdirentries(): _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION         top

       Read directory entries from the directory specified by fd into buf.  At most
       nbytes are read.  Reading starts at offset *basep, and *basep is updated with
       the new position after reading.

RETURN VALUE         top

       getdirentries() returns the number of bytes read or zero when at the end of
       the directory.  If an error occurs, -1 is returned, and errno is set
       appropriately.

ERRORS         top

       See the Linux library source code for details.

CONFORMING TO         top

       Not in POSIX.1-2001.  Present on the BSDs, and a few other systems.  Use
       opendir(3) and readdir(3) instead.

SEE ALSO         top

       lseek(2), open(2)

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

GNU                                   2007-07-26                     GETDIRENTRIES(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface