TELL(3C)TELL(3C)NAME
tell, tell64 - return the read/write file pointer
SYNOPSIS
#include <unistd.h>
off_t tell (int filedes);
off64_t tell64 (int filedes);
DESCRIPTION
filedes is a file descriptor returned from a creat, open, dup, fcntl,
pipe, or ioctl, system call. tell and tell64 return the file pointer
associated with filedes.
The two differ in that tell returns an off_t and tell64 returns an
off64_t. The 64-bit offset returned by tell64 is useful for 32 bit
applications working with 64 bit files. This is because the 32 bit
offset returned by tell might not be large enough to represent the
current file offset.
tell(filedes) is equivalent to:
lseek(filedes, 0, SEEK_CUR).
tell64(filedes) is equivalent to:
lseek64(filedes, 0, SEEK_CUR).
SEE ALSOlseek(2), lseek64(2)DIAGNOSTICS
On success, tell and tell64 return the current pointer location, as
measured in bytes from the beginning of the file.
tell and tell64 fail if one or more of the following are true:
EBADF fildes is not an open file descriptor.
ESPIPE fildes is associated with a pipe or fifo.
Page 1
