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(7) for descriptions of the following attributes:


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

SEE ALSO

lseek(2), attributes(7)

January 28, 1998 TELL(3C)