table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
readdir(2) | System Calls Manual | readdir(2) |
BEZEICHNUNG¶
readdir - Verzeichniseintrag lesen
BIBLIOTHEK¶
Standard-C-Bibliothek (libc, -lc)
ÜBERSICHT¶
#include <sys/syscall.h> /* Definition der SYS_*-Konstanten */ #include <unistd.h>
int syscall(SYS_readdir, unsigned int dd, struct old_linux_dirent *Verzz, unsigned int Anzahl);
Hinweis: Es gibt in Glibc keine Definition von struct old_linux_dirent; siehe ANMERKUNGEN.
BESCHREIBUNG¶
Dies ist nicht die Funktion, an der Sie interessiert sind. Unter readdir(3) finden Sie eine POSIX-konforme Schnittstelle zur C-Bibliothek. Diese Seite beschreibt den reinen/puren Kernel-Systemaufruf, der durch getdents(2) ersetzt wurde.
readdir() liest eine old_linux_dirent-Struktur für das Verzeichnis, auf das der Dateideskriptor dd zeigt, in den Puffer, auf den Verzz zeigt. Der Parameter Anzahl wird ignoriert; es wird höchstens eine old_linux_dirent-Struktur gelesen.
Die Struktur old_linux_dirent ist wie folgt (privat in der Linux-Kernel-Datei fs/readdir.c) definiert:
struct old_linux_dirent {
unsigned long d_ino; /* Inode-Number */
unsigned long d_offset; /* Offset zu diesem old_linux_dirent */
unsigned short d_namlen; /* Länge von d_name */
char d_name[1]; /* Dateiname (abgeschlossen mit */
/* Nullbyte) */ }
d_ino ist eine Inode-Nummer. d_offset ist der Abstand zwischen dem Anfang des Verzeichnisses und diesem old_linux_dirent. d_reclen ist die Größe von d_name, das abschließende Nulbyte nicht mitgezählt (»\0«). d_name ist ein mit Nullbytes abgeschlossener Dateiname.
RÜCKGABEWERT¶
Bei Erfolg wird 1 zurückgegeben. Beim Ende des Verzeichnisses wird 0 zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.
FEHLER¶
STANDARDS¶
Dieser Systemaufruf ist Linux-spezifisch.
ANMERKUNGEN¶
Sie müssen die Struktur old_linux_dirent selbst definieren. Allerdings sollten Sie wahrscheinlich stattdessen readdir(3) verwenden.
Dieser Systemaufruf existiert auf X86-64 nicht.
SIEHE AUCH¶
ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Kaufmann <markus.kaufmann@gmx.de>, Helge Kreutzmann <debian@helgefjell.de>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.
5. Februar 2023 | Linux man-pages 6.03 |