Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for readdir (redhat section 3)

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

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.

       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.  POSIX-2001 also documents the
       field ino_t d_ino as an XSI extension.

       The data returned by readdir() may be overwritten by subsequent calls to readdir() for the
       same directory stream.

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
       read(2),  closedir(3),  dirfd(3),  opendir(3),	rewinddir(3),	scandir(3),   seekdir(3),
       telldir(3)

					    1996-04-22				       READDIR(3)


All times are GMT -4. The time now is 11:50 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password