Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

ftello(3) OSS Library Calls Reference Manual
NAME
ftello - Reports the position of the file pointer of a stream
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <stdio.h>
off_t ftello(
FILE ∗∗stream);
PARAMETERS
stream Specifies the I/O stream.
DESCRIPTION
The ftello( ) function is identical to the ftell() function except that its return value is of type
off_t.
An application can explicitly call this function when you compile the application using the
#define _LARGEFILE64_SOURCE 1 feature test macro or an equivalent compiler command
option.
The ftello( ) function obtains the current value of the file position indicator for the specified
stream.
Information About Guardian EDIT Files
If called from a native process, the ftello() function can operate on Guardian EDIT files (type
101 files). The behavior of this function differs according to whether the file is opened with a
Guardian connection or with an OSS connection.
To operate on a Guardian EDIT file using a Guardian connection, you must open a stream by cal-
ling:
• fopen_guardian(), freopen_guardian(), or a similar function from any process
• fopen( ), freopen( ), or a similar function from a process executing in the Guardian
environment
When the stream references a Guardian EDIT file using a Guardian connection, the ftello() func-
tion obtains a file position value as if an equivalent call were being made to the edftell() func-
tion.
To operate on a Guardian EDIT file using an OSS connection, you must open a stream by calling:
• fopen_oss(), freopen_oss(), or a similar function from any process
• fopen( ), freopen( ), or a similar function from a process executing in the OSS environ-
ment
When the stream references a Guardian EDIT file using an OSS connection, calls to the ftello()
function are implemented using the lseek() function. For information about the lseek() function,
see the lseek(2) reference page.
2−136 Hewlett-Packard Company 527187-007