BEZEICHNUNG

       telldir - liefert die aktuelle Position in einem Verzeichnis

ÜBERSICHT

       #include <dirent.h>

       long telldir(DIR *Verzz);

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

       telldir():
           _XOPEN_SOURCE
              || /* Glibc seit 2.19: */ _DEFAULT_SOURCE
              || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

       Die  Funktion telldir() liefert die aktuelle Position innerhalb des Directory-Streams (der
       Folge der Verzeichniseinträge) Verzz zurück.

RÜCKGABEWERT

       Die Funktion telldir() liefert  die  aktuelle  Position  innerhalb  des  Directory-Streams
       zurück.  Bei  einem  Fehler  wird  -1  zurückgegeben  und  errno  gesetzt,  um  den Fehler
       anzuzeigen.

FEHLER

       EBADF  Unzulässiger Deskriptor für den Verzeichnis-Stream Verzz.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌───────────────────────────────────────────────────────┬───────────────────────┬─────────┐
       │Schnittstelle                                          │ Attribut              │ Wert    │
       ├───────────────────────────────────────────────────────┼───────────────────────┼─────────┤
       │telldir()                                              │ Multithread-Fähigkeit │ MT-Safe │
       └───────────────────────────────────────────────────────┴───────────────────────┴─────────┘

KONFORM ZU

       POSIX.1-2001, POSIX.1-2008, 4.3BSD.

ANMERKUNGEN

       In glibc bis Version 2.1.1 war der Typ des Rückgabewerts von telldir() off_t. POSIX.1-2001
       fordert long. Dieser Typ wird seit glibc 2.1.2 verwendet.

       In   frühen  Dateisystemen  war  der  von  telldir()  zurückgegebene  Wert  eine  einfache
       Dateiposition innerhalb eines Verzeichnisses. Moderne Dateisysteme  verwenden  Baum-  oder
       Hash-Strukturen  anstelle  einfacher  Tabellen,  um  Verzeichnisse  zu  repräsentieren. In
       solchen Dateisystemen ist der von telldir()  zurückgegebene  (und  intern  von  readdir(3)
       verwendete) Wert ein »Cookie«, welches in dieser Implementation zum Ermitteln der Position
       innerhalb eines Verzeichnisses verwendet wird. Anwendungsprogramme sollten dies strikt als
       verdeckten Wert betrachten und keine Schlüsse bezüglich dessen Inhalts ziehen.

SIEHE AUCH

       closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(3)

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  5.13  des  Projekts  Linux-man-pages. Eine
       Beschreibung des Projekts, Informationen, wie Fehler  gemeldet  werden  können  sowie  die
       aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die    deutsche    Übersetzung    dieser   Handbuchseite   wurde   von   Markus   Kaufmann
       <markus.kaufmann@gmx.de>, Martin  Eberhard  Schauer  <Martin.E.Schauer@gmx.de>  und  Mario
       Blättermann <mario.blaettermann@gmail.com> erstellt.

       Diese  Übersetzung  ist  Freie  Dokumentation;  lesen  Sie  die GNU General Public License
       Version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.

                                          22. März 2021                                TELLDIR(3)