Open System Services System Calls Reference Manual (G06.28+, H06.05+)

System Functions (f - i) fstat64(2)
NAME
fstat64 - Provides information about an open file
LIBRARY
G-series native OSS processes: system library
H-series OSS processes: implicit libraries
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.
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.
The file information is written to the area specified by the buffer parameter, which is a pointer to
a stat64 structure with this definition from the sys/stat.h header file:
struct stat {
dev_t st_dev;
ino64_t st_ino;
mode_t st_mode;
nlink_t st_nlink;
unsigned int st_acl:1; |
unsigned int __filler_1:15; |
uid_t st_uid;
gid_t st_gid;
dev_t st_rdev;
off64_t st_size;
time_t st_atime;
time_t st_mtime;
time_t st_ctime;
mode_t st_basemode; /* Permissions with original group perms */ |
int64_t reserved[3];
};
527186-007 Hewlett-Packard Company 3−31