BEZEICHNUNG

       opendir - ein Verzeichnis öffnen

ÜBERSICHT

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

       DIR *opendir(const char *name);
       DIR *fdopendir(int fd);

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       fdopendir():
           Seit Glibc 2.10:
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Bis Glibc 2.10:
               _GNU_SOURCE

BESCHREIBUNG

       Die  Funktion  opendir()  öffnet  einen  Verzeichnis-Datenstrom  der  dem Verzeichnis name
       entspricht und liefert einen Zeiger auf den ersten Eintrag des Verzeichnisses zurück.

       Die Funktion fopendir() ähnelt opendir(), gibt aber eine Folge der Verzeichniseinträge für
       das  Verzeichnis zurück, auf das der Dateideskriptor fd verweist. Nach einem erfolgreichen
       Aufruf von fdopendir() wird fd intern von der Implementierung  benutzt  und  sollte  nicht
       anderweitig von der Anwendung benutzt werden.

RÜCKGABEWERT

       Die    Funktionen    opendir()    und   fdopendir()   liefern   einen   Zeiger   auf   den
       Verzeichnis-Datenstrom zurück. Bei einem Fehler wird  ein  NULL  zurückgegeben  und  errno
       entsprechend gesetzt.

FEHLER

       EACCES Zugriff verweigert

       EBADF  fd ist kein gültiger zum Lesen geöffneter Dateideskriptor.

       EMFILE Der Prozess benutzt zu viele Dateideskriptoren.

       ENFILE Auf dem System sind zurzeit zu viele Dateien geöffnet.

       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.

VERSIONEN

       fdopendir() ist in Glibc seit Version 2.4 verfügbar.

KONFORM ZU

       opendir()  ist auf SVr4 und 4.3BSD vorhanden und in POSIX.1-2001 spezifiziert. fdopendir()
       ist in POSIX.1-2008 spezifiziert.

ANMERKUNGEN

       Der  zugrundeliegende  Dateideskriptor  des  Verzeichnis-Datenstroms  kann  mit   dirfd(3)
       abgefragt werden.

       Die Funktion opendir() setzt dem Schalter »close-on-exec« für den Dateideskriptor, der DIR
       *  zugrundeliegt.  Die  Funktion   fopendir()   lässt   die   Einstellung   des   Schalter
       »close-on-exec«  für  den Dateideskriptor fd unverändert. POSIX.1-200x spezifiziert nicht,
       ob  ein  erfolgreicher  Aufruf  von  fdopendir()  den  Schalter  »close-on-exec«  für  den
       Dateideskriptor fd setzt.

SIEHE AUCH

       open(2),   closedir(3),   dirfd(3),   readdir(3),  rewinddir(3),  scandir(3),  seekdir(3),
       telldir(3)

KOLOPHON

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the
       project,     and    information    about    reporting    bugs,    can    be    found    at
       http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die   deutsche   Übersetzung   dieser   Handbuchseite   wurde    von    Markus    Kaufmann
       <markus.kaufmann@gmx.de> und Chris Leick <c.leick@vollbio.de> 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 <debian-l10n-german@lists.debian.org>.