tell(3C)




NAME

     tell - return a file offset for a file descriptor


SYNOPSIS

     #include <unistd.h>

     off_t tell(int fd);


DESCRIPTION

     The tell() function obtains the current value of  the  file-
     position indicator for the file descriptor fd.


RETURN VALUES

     Upon successful completion, tell() returns the current value
     of the file-position indicator for fd measured in bytes from
     the beginning of the file.

     Otherwise, it returns -1 and  sets  errno  to  indicate  the
     error.


ERRORS

     The tell() function will fail if:

     EBADF The file descriptor fd is not an open file descriptor.

     EOVERFLOW
           The  current  file  offset   cannot   be   represented
           correctly in an object of type off_t.

     ESPIPE
           The file descriptor fd is associated with  a  pipe  or
           FIFO.


USAGE

     The tell() function is equivalent to lseek(fd, 0, SEEK_CUR).


ATTRIBUTES

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

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


SEE ALSO

     lseek(2), attributes(5)


Man(1) output converted with man2html