opensolaris man page for tell

tell(3C)						   Standard C Library Functions 						  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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       lseek(2), attributes(5)

SunOS 5.11							    28 Jan 1998 							  tell(3C)