tell(3c) [sunos man page]

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.10							    28 Jan 1998 							  tell(3C)

ftell(3C)						   Standard C Library Functions 						 ftell(3C)

NAME

       ftell, ftello - return a file offset in a stream

SYNOPSIS

       #include <stdio.h>

       long ftell(FILE *stream);

       off_t ftello(FILE *stream);

DESCRIPTION

       The ftell() function obtains the current value of the file-position indicator for the stream pointed to by stream. The ftello() function is
       identical to ftell() except for the return type.

RETURN VALUES

       Upon successful completion, the ftell() and ftello() functions return the current value of the file-position indicator for the stream  mea-
       sured in bytes from the beginning of the file. Otherwise, they return -1 and sets errno to indicate the error.

ERRORS

       The ftell() and ftello() functions will fail if:

       EBADF	       The file descriptor underlying stream is not an open file descriptor.

       ESPIPE	       The file descriptor underlying stream is associated with a pipe, a FIFO, or a socket.

       The ftell() function will fail if:

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

       The ftello() function will fail if:

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

USAGE

       The ftello() function has a transitional interface for 64-bit file offsets.  See lf64(5).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       lseek(2), fopen(3C), fseek(3C), attributes(5), , standards(5), lf64(5)

SunOS 5.10							    24 Jul 2002 							 ftell(3C)