Standard C Library Functions                          telldir(3C)



NAME
     telldir - current location of a named directory stream

SYNOPSIS
     #include 

     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.

ERORS
     The telldir() function will fail if:

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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Safe                        
    


SEE ALSO
     opendir(3C), readdir(3C), seekdir(3C), attributes(5),  stan-
     dards(5)







SunOS 5.11          Last change: 14 Aug 2002                    1