Provided by: manpages-de-dev_0.10-1_all bug

BEZEICHNUNG

       readdir - Liest einen Verzeichniseintrag

       Diese  Handbuchseite ist eventuell veraltet. Im Zweifelsfall ziehen Sie
       die englischsprachige Handbuchseite zu Rate, indem Sie

              man -LC 3 readdir

       eingeben.

ÜBERSICHT

       #include <sys/types.h>

       #include <dirent.h>

       struct dirent *readdir(DIR *dir);

BESCHREIBUNG

       Die readdir()-Funktion liefert einen Zeiger  auf  eine  dirent-Struktur
       zurück,  welcher  auf  den  nächsten Verzeichniseintrag zeigt. Dir muss
       dabei auf eine Verzeichnisdatei ("directory stream") zeigen.  Wenn  das
       Dateiende  erreicht  wurde oder ein Fehler auftrat, dann wird ein NULL-
       Zeiger zurückgeliefert.

       Wird  readdir()  mehrfach  für   ein   Verzeichnis   aufgerufen,   dann
       überschreiben  die nachfolgenden Aufrufe die Daten, die von den vorigen
       readdir()-Aufrufen zurückgeliefert wurden.

       Die dirent-Struktur ist in <linux/dirent.h> folgendermaßen definiert:

              struct dirent {
                      long            d_ino;  /* Inode Nummer */
                      off_t           d_off;  /* Offset zum nächsten dirent */
                      unsigned short  d_reclen;/* Länge dieses Eintrags */
                      char            d_name[NAME_MAX+1]; /* Dateiname */
              };

RÜCKGABEWERT

       Die readdir()-Funktion liefert einen Zeiger  auf  eine  dirent-Struktur
       zurück. Wenn das Dateiende erreicht wurde oder ein Fehler auftrat, dann
       wird ein NULL-Zeiger zurückgeliefert.

FEHLER

       EBADF  dir ist kein gültiger Zeiger auf eine Verzeichnisdatei.

KONFORM ZU

       SVID 3, POSIX, BSD 4.3

SIEHE AUCH

       read(2), opendir(3), closedir(3), rewinddir(3), seekdir(3), telldir(3),
       scandir(3).

                                 31. Mai 1996                       READDIR(3)