opensolaris man page for telldir

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(5) 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(5), standards(5)

SunOS 5.11							    14 Aug 2002 						       telldir(3C)