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

System Functions (f - i) fstat64(2)
NAME
fstat64 - Provides information about an open file
LIBRARY
G-series native OSS processes: system library
H-series and J-series OSS processes: implicit libraries
32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/yputdll
SYNOPSIS
#include <sys/types.h> /* optional except for POSIX.1 */
#include <sys/stat.h>
int fstat64(
int filedes,
struct stat64 *buffer);
PARAMETERS
filedes Specifies an open file descriptor obtained from a successful call to the accept(),
creat(), creat64(),dup(), dup2(), fcntl(), open(), open64(), pipe(), socket(),
or socketpair() function.
When the function is thread-aware, specifies an open file descriptor obtained
from a successful call to the creat(), creat64(), dup(), open(), open64(),
pipe( ), socket(),orsocketpair() function, or the thread-aware accept(),
dup2( ),orfcntl( ) function.
buffer Points to a stat64 structure, into which information is placed about the file. The
stat64 structure is described in the sys/stat.h header file.
DESCRIPTION
The fstat64() function is similar to the fstat() function except that, in addition to supporting
smaller files, the fstat64( ) function supports OSS files larger than approximately 2 gigabytes.
An application can explicitly call this function you compile the application using the #define
_LARGEFILE64_SOURCE 1 feature test macro or an equivalent compiler command option.
An application call to fstat() 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 fstat64() function obtains information about the open file associated with the filedes parame-
ter.
527186-023 Hewlett-Packard Company 3−35