Open System Services System Calls Reference Manual (G06.25+, H06.03+)

lstat(2) OSS System Calls Reference Manual
pointed to by path. For a symbolic link, the lstat() function sets the st_size field of the stat struc-
ture to the length in characters of the link name used as the pathname pointed to by path (not
including the null terminator).
The lstat() function also sets the st_mode field to indicate the file type.
The lstat() function updates any time-related fields associated with the file before writing into
the stat structure, unless it is a read-only fileset. Time-related fields are not updated for read-only
OSS filesets.
The fields in the stat 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 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 in the following table. Values for Guardian
objects are described in Use on Guardian Objects, later in this reference page.
For Contains
Regular file File serial number (unique)
Directory File serial number (unique)
FIFO File serial number (unique)
AF_UNIX socket File serial number of the socket file
(unique)
/dev/null File serial number (unique)
/dev/tty File serial number (unique)
The st_ino value for all node entries in /E (including the entry for the logical
link from the local node name to the root fileset on the local node) is the value
for the root fileset on the corresponding node. If normal conventions are fol-
lowed, this value is always 0 (zero), so entries in /E appear to be nonunique.
Values for objects on remote nodes are unique only among the values for objects
within the same fileset on that node.
4−14 Hewlett-Packard Company 527186-003