BEZEICHNUNG

       telldir - liefert die aktuelle Position in einem Verzeichnis

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #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 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 │
       └───────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

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

ANMERKUNGEN

       Bis Glibc 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)

Ü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⟩.