Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

ftello(3) Guardian Native C 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−108 Hewlett-Packard Company 527192-007