TELLDIR(3C) Standard C Library Functions TELLDIR(3C)

NAME


telldir - current location of a named directory stream

SYNOPSIS


#include <dirent.h>

long int telldir(DIR *dirp);


DESCRIPTION


The telldir() function obtains the current location associated with the
directory stream specified by dirp.


If the most recent operation on the directory stream was a seekdir(3C),
the directory position returned from the telldir() is the same as that
supplied as a loc argument for seekdir().

RETURN VALUES


Upon successful completion, telldir() returns the current location of the
specified directory stream.

ERRORS


The telldir() function will fail if:

EOVERFLOW
The current location of the directory cannot be stored in an
object of type long.


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO


opendir(3C), readdir(3C), seekdir(3C), attributes(7), standards(7)

illumos August 14, 2002 TELLDIR(3C)