Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (e - f) ftello64(3)
NAME
ftello64 - 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>
off64_t ftello64(
FILE ∗∗stream);
PARAMETERS
stream Specifies the I/O stream.
DESCRIPTION
The ftello64( ) function is identical to the ftell( ) function except that its return value is of type
off64_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.
An application call to ftell( ) or to ftello( ) is automatically mapped to this function when you
compile the application using the #define _FILE_OFFSET_BITS 64 feature test macro or an
equivalent compiler command option.
The ftello64( ) 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 ftello64( ) 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 to that file, you must open a
stream by calling:
• fopen64_guardian( ), freopen64_guardian( ), or a similar function from any process
• fopen64( ), freopen64(), 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 ftello64( )
function obtains a file position value as if an equivalent call were being made to the edftell( )
function.
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
• fopen64( ), freopen64(), or a similar function from a process executing in the OSS
environment
When the stream references a Guardian EDIT file using an OSS connection, calls to the
ftello64( ) function are implemented using the lseek64() function. For information about the
lseek64( ) function, see the lseek64(2) reference page.
527187-017 Hewlett-Packard Company 2−193