Provided by:
manpages-de-dev_0.10-1_all 
BEZEICHNUNG
readdir - liest einen Verzeichniseintrag
Diese Handbuchseite ist eventuell veraltet. Im Zweifelsfall ziehen Sie
die englischsprachige Handbuchseite zu Rate, indem Sie
man -LC 2 readdir
eingeben.
"UBERSICHT
#include <unistd.h>
#include <linux/dirent.h>
#include <linux/unistd.h>
_syscall3(int, readdir, uint, fd, struct dirent *, dirp, uint, count);
int readdir(unsigned int fd, struct dirent *dirp, unsigned int count);
BESCHREIBUNG
Dies ist nicht die Funktion, an der sie interessiert sind. Unter
readdir(3) finden sie eine POSIX-konforme C-Funktion. Diese Seite
beschreibt den rohen Kernelsystemaufruf, der sich jederzeit andern kann
und durch getdents(2) ersetzt wurde.
readdir liest eine dirent-Struktur von dem Verzeichnis auf das die
Variable fd zeigt in den Speicher an die Stelle auf die dirp zeigt.
Der Parameter count wird ignoriert; es wird hochstens eine dirent-
Struktur gelesen.
Die dirent-Struktur ist wie folgt deklariert:
struct dirent
{
long d_ino; /* inode Nummer */
off_t d_off; /* Offset zu diesem dirent */
unsigned short d_reclen; /* Lange von d_name */
char d_name [NAME_MAX+1]; /* Dateiname (Null-terminiert) */
}
d_ino ist eine Inode-Nummer. d_off ist der Abstand zwischen dem Beginn
des Verzeichnisses und diesem dirent. d_reclen ist die Lange von
d_name, den abschlieBenden Null-terminator nicht mitgezahlt. d_name
ist ein Null-terminierter Dateiname.
R"UCKGABEWERT
Bei Erfolg wird eine 1 zuruckgeliefert. Beim Ende eines Verzeichnisses
wird eine 0 zuruckgeliefert. Beim Auftreten eines Fehlers wird -1
zuruckgeliefert und errno entsprechend gesetzt.
FEHLER
EBADF Ungultiger Dateideskriptor fd.
ENOTDIR
Dateideskriptor zeigt nicht auf ein Verzeichnis.
KONFORM ZU
Dieser Systemaufruf ist Linuxspezifisch.
SIEHE AUCH
getdents(2), readdir(3).