TELLDIR(3)

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