BEZEICHNUNG

       telldir - liefert die aktuelle Position in einem Verzeichnis

ÜBERSICHT

       #include <dirent.h>

       long telldir(DIR *dirp);

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

       telldir(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE

BESCHREIBUNG

       Die  Funktion telldir() liefert die aktuelle Position innerhalb des Directory-Streams (der
       Folge der Verzeichniseinträge) dirp 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 entsprechend gesetzt.

FEHLER

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

ATTRIBUTE

   Multithreading (see pthreads(7))
       The telldir()  function is thread-safe.

KONFORM ZU

       4.3BSD, POSIX.1-2001.

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 early filesystems, the value returned by telldir()  was a simple file offset  within  a
       directory.  Modern  filesystems  use  tree or hash structures, rather than flat tables, to
       represent directories. On such filesystems, the value returned  by  telldir()   (and  used
       internally  by  readdir(3))   is a "cookie" that is used by the implementation to derive a
       position within a directory. Application programs should treat this strictly as an  opaque
       value, making no assumptions about its contents.

SIEHE AUCH

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

KOLOPHON

       This  page  is  part  of release 3.54 of the Linux man-pages project. A description of the
       project,    and    information    about    reporting    bugs,    can    be    found     at
       http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die    deutsche    Übersetzung    dieser   Handbuchseite   wurde   von   Markus   Kaufmann
       <markus.kaufmann@gmx.de> und Martin Eberhard Schauer <Martin.E.Schauer@gmx.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>.

                                        2. September 2013                              TELLDIR(3)