|
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | STANDARDS | NOTES | SEE ALSO | COLOPHON |
|
|
|
getdirentries(3) Library Functions Manual getdirentries(3)
getdirentries - get directory entries in a filesystem-independent
format
Standard C library (libc, -lc)
#include <dirent.h>
ssize_t getdirentries(size_t nbytes;
int fd, char buf[restrict nbytes], size_t nbytes,
off_t *restrict basep);
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
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.
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 the Linux library source code for details.
For an explanation of the terms used in this section, see
attributes(7).
┌──────────────────────────────────────┬───────────────┬─────────┐
│ Interface │ Attribute │ Value │
├──────────────────────────────────────┼───────────────┼─────────┤
│ getdirentries() │ Thread safety │ MT-Safe │
└──────────────────────────────────────┴───────────────┴─────────┘
BSD.
Use opendir(3) and readdir(3) instead.
lseek(2), open(2)
This page is part of the man-pages (Linux kernel and C library
user-space interface documentation) project. Information about
the project can be found at
⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report
for this manual page, see
⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
This page was obtained from the tarball man-pages-6.15.tar.gz
fetched from
⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
2025-08-11. If you discover any rendering problems in this HTML
version of the page, or you believe there is a better or more up-
to-date source for the page, or you have corrections or
improvements to the information in this COLOPHON (which is not
part of the original manual page), send a mail to
[email protected]
Linux man-pages 6.15 2025-06-28 getdirentries(3)