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

ftello64(3) Guardian Native C Library Calls Reference Manual
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 native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
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.
2−110 Hewlett-Packard Company 527192-007