getdirentries - get directory entries in a filesystem-independent format
Contents
Attributes
For an explanation of the terms used in this section, see attributes(7).
┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
│ Interface │ Attribute │ Value │
├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
│ getdirentries() │ Thread safety │ MT-Safe │
└─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘
Description
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.
Errors
See the Linux library source code for details.
Library
Standard C library (libc, -lc)
Name
getdirentries - get directory entries in a filesystem-independent format
Notes
Use opendir(3) and readdir(3) instead.
Return Value
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 to indicate the error.
See Also
lseek(2), open(2) Linux man-pages 6.9.1 2024-05-02 getdirentries(3)
Standards
BSD.
Synopsis
#include<dirent.h>ssize_tgetdirentries(intfd,charbuf[restrict.nbytes],size_tnbytes,off_t*restrictbasep); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): getdirentries(): Since glibc 2.19: _DEFAULT_SOURCE glibc 2.19 and earlier: _BSD_SOURCE || _SVID_SOURCE
