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

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 with the following 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 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.
The lstat64() 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 the following meanings and content:
st_dev OSS device identifier for a fileset.
Values for local OSS objects are listed in the following table.
Values for local Guardian objects are described in Use on Guar-
dian Objects, and values for remote Guardian or OSS objects
are described in Use on Remote Objects, later in this reference
page.
527186-007 Hewlett-Packard Company 4−39