opendir(3)                 Library Functions Manual                 opendir(3)

BEZEICHNUNG
       opendir - ein Verzeichnis offnen

BIBLIOTHEK
       Standard-C-Bibliothek (libc, -lc)

UBERSICHT
       #include <sys/types.h>
       #include <dirent.h>

       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
       <markus.kaufmann@gmx.de> und Chris Leick <c.leick@vollbio.de> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       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
       <debian-l10n-german@lists.debian.org>.

Linux man-pages 6.06           31. Oktober 2023                     opendir(3)