READDIR Section: Linux Programmer's Manual (3) Updated: 22 April 2025 Index   NAME readdir - read a directory   SYNOPSIS #include <sys/types.h> #include <dirent.h> struct dirent *readdir(DIR *dir);   DESCRIPTION The readdir() function returns a pointer to a dirent structure representing the next directory entry in the directory stream pointed to by dir. It returns NULL on reaching the end-of-file or if an error occurred. The data returned by readdir() is overwritten by subsequent calls to readdir() for the same directory stream. According to POSIX, the dirent structure contains a field char d_name[] of unspecified size, with at most NAME_MAX characters preceding the terminating null character. Use of other fields will harm the portability of your programs.   RETURN VALUE The readdir() function returns a pointer to a dirent structure, or NULL if an error occurs or end-of-file is reached.   ERRORS EBADF Invalid directory stream descriptor dir.   CONFORMING TO SVID 3, POSIX, BSD 4.3   SEE ALSO   Index NAME SYNOPSIS DESCRIPTION RETURN VALUE ERRORS CONFORMING TO SEE ALSO This document was created by using the manual pages. Time: 11:58:05 GMT, March 24, 2025