Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)
System Functions (k - m) lstat64(2)
The file information is written to the area specified by the buffer parameter, which is a pointer to
a stat64 structure. For J06.11 and later J-series RVUs and H06.22 and later H-series RVUs, the
stat64 structure uses this definition from the sys/stat.h header file:
struct stat64 {
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:7;
unsigned int st_fileprivs:8; /* File privileges */
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 J06.10 and earlier J-series RVUs and H06.21 and earlier H-series RVUs, the stat64 structure
uses this definition from the sys/stat.h header file:
struct stat64 {
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 symbolic links to local OSS objects, the st_mode and st_size fields are valid and the other
fields in the structure are undefined. For symbolic links that resolve to files in /E, the st_dev,
st_ino, st_atime, st_mtime, and st_ctime fields are defined as described in this reference page.
For files other than a symbolic link, the lstat64() function sets the st_size field of the stat64
structure to the length in characters of the absolute pathname resulting from the resolution of the
name pointed to by path. For a symbolic link, the lstat64() function sets the st_size field of the
stat64 structure to the length in characters of the link name used as the pathname pointed to by
path (not including the null terminator).
The lstat64( ) function also sets the st_mode field to indicate the file type.
527186-023 Hewlett-Packard Company 4−39