Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (f) ftello(3)
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
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.
527192-018 Hewlett-Packard Company 2−149