Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ tell(3C) — SunOS 5.6

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

lseek(2)

attributes(5)

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.6  —  Last change: 22 Apr 1997

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026