TELL(3C)							      TELL(3C)

NAME    [Toc]    [Back]

     tell, tell64 - return the read/write file pointer

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     off_t tell	(int filedes);

     off64_t tell64 (int filedes);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     lseek(2), lseek64(2)

DIAGNOSTICS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111