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.


"UBERSICHT
       #include <sys/types.h>

       #include <dirent.h>

       struct dirent *readdir(DIR *dir);


BESCHREIBUNG
       Die readdir()-Funktion liefert einen Zeiger  auf  eine  dirent-Struktur
       zuruck,  welcher  auf  den nachsten 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 zuruckgeliefert.

       Wird  readdir()  mehrfach  fur   ein   Verzeichnis   aufgerufen,   dann
       uberschreiben  die nachfolgenden Aufrufe die Daten, die von den vorigen
       readdir()-Aufrufen zuruckgeliefert wurden.

       Die dirent-Struktur ist in <linux/dirent.h> folgendermaBen definiert:

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


R"UCKGABEWERT
       Die readdir()-Funktion liefert einen Zeiger  auf  eine  dirent-Struktur
       zuruck.   Wenn  das  Dateiende  erreicht wurde oder ein Fehler auftrat,
       dann wird ein NULL-Zeiger zuruckgeliefert.


FEHLER
       EBADF  dir ist kein gultiger 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)