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
- zu wenig Speicher, um den Vorgang zu beenden
- ENOTDIR
- name ist kein Verzeichnis.
VERSIONEN¶
fdopendir() ist in Glibc seit Version 2.4 verfügbar.
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>.