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

System Functions (s and S) stat64(2)
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];
};
For a regular file, the stat64() function sets the st_size field of the stat64 structure to the length
of the file and sets the st_mode field to indicate the file type. For a symbolic link, the stat64()
function returns information about the file at the end of the link; no information about the link is
returned. (For information about the link, use the lstat64( ) function.)
The stat64() function updates any time-related fields associated with the file before writing into
the stat64 structure, unless it is a read-only fileset. Time-related fields are not updated for read-
only OSS filesets.
The fields in the stat64 structure have these meanings and content:
st_dev OSS device identifier for a fileset.
Values for local OSS objects are listed next. Values for local
Guardian objects are described in Use on Guardian Objects,
and values for remote Guardian or OSS objects are described in
Use on Remote Objects, later in this reference page.
For Contains
Regular file ID of device containing directory entry
Directory ID of device containing directory
FIFO ID of special fileset for pipes
AF_UNIX socket ID of device containing the fileset in which
the socket file was created
/dev/null ID of device containing directory entry
/dev/tty ID of device containing directory entry
st_ino File serial number (inode number). The file serial number and
OSS device identifier uniquely identify a regular OSS file within
an OSS fileset.
Values for OSS objects are listed next. Values for Guardian
objects are described in Use on Guardian Objects, later in this
reference page.
527186-007 Hewlett-Packard Company 7−393