telldir(3)                 Library Functions Manual                 telldir(3)

BEZEICHNUNG
       telldir - liefert die aktuelle Position in einem Verzeichnis

BIBLIOTHEK
       Standard-C-Bibliothek (libc, -lc)

UBERSICHT
       #include <dirent.h>

       long telldir(DIR *Verzz);

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

       telldir():
           _XOPEN_SOURCE
              || /* Glibc >= 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 Verzeichniseintrage) Verzz zuruck.

RUCKGABEWERT
       Die Funktion telldir() liefert die aktuelle Position innerhalb des
       Directory-Streams zuruck. Bei einem Fehler wird -1 zuruckgegeben und
       errno gesetzt, um den Fehler anzuzeigen.

FEHLER
       EBADF  Unzulassiger Deskriptor fur den Verzeichnis-Stream Verzz.

ATTRIBUTE
       Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt
       verwandten Ausdrucke.

       +--------------------------------+-------------------------+-----------+
       |Schnittstelle                   | Attribut                | Wert      |
       +--------------------------------+-------------------------+-----------+
       |telldir()                       | Multithread-Fahigkeit   | MT-Sicher |
       +--------------------------------+-------------------------+-----------+
STANDARDS
       POSIX.1-2008.

GESCHICHTE
       POSIX.1-2001, 4.3BSD.

       Bis Glibc 2.1.1 war der Typ des Ruckgabewerts von telldir() off_t.
       POSIX.1-2001 fordert long. Dieser Typ wird seit Glibc 2.1.2 verwendet.

       In fruhen Dateisystemen war der von telldir() zuruckgegebene Wert eine
       einfache Dateiposition innerhalb eines Verzeichnisses. Moderne
       Dateisysteme verwenden Baum- oder Hash-Strukturen anstelle einfacher
       Tabellen, um Verzeichnisse zu reprasentieren. In solchen Dateisystemen
       ist der von telldir() zuruckgegebene (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 Schlusse bezuglich dessen Inhalts ziehen.

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

UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von Markus Kaufmann
       <markus.kaufmann@gmx.de>, Martin Eberhard Schauer
       <Martin.E.Schauer@gmx.de> und Mario Blattermann
       <mario.blaettermann@gmail.com> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
       ubernommen.

       Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
       schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer
       <debian-l10n-german@lists.debian.org>.

Linux man-pages 6.06           31. Oktober 2023                     telldir(3)