BEZEICHNUNG

       dirfd - Verzeichnisdatenstromdeskriptor erhalten

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

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

       int dirfd(DIR *Verzz);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       dirfd():
           /* Seit Glibc 2.10: */ _POSIX_C_SOURCE >= 200809L
               || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

       Die  Funktion  dirfd() liefert den Dateideskriptor zurück, der dem Verzeichnisdatenstrom Verzz zugeordnet
       ist.

       Dieser Dateideskriptor wird intern durch  den  Verzeichnisdatenstrom  verwandt.  Daher  ist  er  nur  für
       Funktionen  interessant,  die  nicht  von  der Dateiposition abhängen oder diese ändern, wie fstat(2) und
       fchdir(2). Er wird automatisch geschlossen, wenn closedir(3) aufgerufen wird.

RÜCKGABEWERT

       Im Erfolgsfall liefert dirfd() einen Dateideskriptor (eine nichtnegative Ganzzahl) zurück. Im  Fehlerfall
       wird -1 zurückgeliefert und errno gesetzt, um den Fehler anzugeben.

FEHLER

       POSIX.1-2008   spezifiziert   zwei   Fehler,   von   denen  keiner  durch  die  aktuelle  Implementierung
       zurückgeliefert wird.

       EINVAL Verzz bezieht sich nicht auf einen gültigen Verzeichnisdatenstrom.

       ENOTSUP
              Die Implementierung unterstützt die Zuordnung eines Dateideskriptors zu einem Verzeichnis nicht.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │ Schnittstelle                                                     │ Attribut              │ Wert      │
       ├───────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │ dirfd()                                                           │ Multithread-Fähigkeit │ MT-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       POSIX.1-2008.

GESCHICHTE

       4.3BSD-Reno (nicht in 4.2BSD).

SIEHE AUCH

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

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.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 die
       Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                          dirfd(3)