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>.

GNU                                               20. Juni 2010                                       OPENDIR(3)