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