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():

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

zu wenig Speicher, 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¶

Diese Seite ist Teil der Veröffentlichung 3.42 des Projekts Linux- man-pages. Eine Beschreibung des Projekts und Informationen, wie Fehler gemeldet werden können, finden sich unter 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>.