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 ALSO
     lseek(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.