opendir(3) Library Functions Manual opendir(3) BEZEICHNUNG opendir - ein Verzeichnis offnen BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include #include DIR *opendir(const char *name); DIR *fdopendir(int dd); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): fdopendir(): Seit Glibc 2.10: _POSIX_C_SOURCE >= 200809L Vor Glibc 2.10: _GNU_SOURCE BESCHREIBUNG Die Funktion opendir() offnet einen Verzeichnis-Datenstrom der dem Verzeichnis name entspricht und liefert einen Zeiger auf den ersten Eintrag des Verzeichnisses zuruck. Die Funktion fdopendir() ahnelt opendir(), gibt aber eine Folge der Verzeichniseintrage fur das Verzeichnis zuruck, auf das der Dateideskriptor dd verweist. Nach einem erfolgreichen Aufruf von fdopendir() wird dd intern von der Implementierung benutzt und sollte nicht anderweitig von der Anwendung benutzt werden. RUCKGABEWERT Die Funktionen opendir() und fdopendir() liefern einen Zeiger auf den Verzeichnis-Datenstrom zuruck. Bei einem Fehler wird ein NULL zuruckgegeben und errno gesetzt, um den Fehler anzuzeigen. FEHLER EACCES Zugriff verweigert EBADF dd ist kein gultiger zum Lesen geoffneter Dateideskriptor. EMFILE Die Beschrankung pro Prozess der Anzahl offener Datei-Deskriptoren wurde erreicht. ENFILE Die systemweite Beschrankung fur die Gesamtzahl offener Dateien wurde erreicht. ENOENT Das Verzeichnis existiert nicht oder name ist eine leere Zeichenkette. ENOMEM Der Speicher reicht nicht aus, um den Vorgang zu beenden. ENOTDIR name ist kein Verzeichnis. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |opendir(), fdopendir() | Multithread-Fahigkeit | MT-Sicher | +--------------------------------+-------------------------+-----------+ STANDARDS POSIX.1-2008. STANDARDS opendir() SVr4, 4.3BSD, POSIX.1-2001. fdopendir() POSIX.1-2008. Glibc 2.4. ANMERKUNGEN Dateinameneintrage konnen mittels readdir(3) aus einem Verzeichnis-Stream gelesen werden. Der zugrundeliegende Dateideskriptor des Verzeichnis-Datenstroms kann mit dirfd(3) abgefragt werden. Die Funktion opendir() setzt dem Schalter >>close-on-exec<< fur den Dateideskriptor, der DIR * zugrundeliegt. Die Funktion fopendir() lasst die Einstellung des Schalter >>close-on-exec<< fur den Dateideskriptor dd unverandert. POSIX.1-200x spezifiziert nicht, ob ein erfolgreicher Aufruf von fdopendir() den Schalter >>close-on-exec<< fur den Dateideskriptor dd setzt. SIEHE AUCH open(2), closedir(3), dirfd(3), readdir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Markus Kaufmann und Chris Leick erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.8 2. Mai 2024 opendir(3)