Content-type: text/html Man page of tell

tell

Section: Standard C Library Functions (3C)
Updated: 28 Jan 1998
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

 

SEE ALSO

lseek(2), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
USAGE
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:25 GMT, October 02, 2010