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  associ-
     ated 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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|

SEE ALSO

     opendir(3C), readdir(3C), seekdir(3C), attributes(5)