Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for tell (opensolaris section 3c)

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)