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

lstat(2) OSS System Calls Reference Manual
For Contains
Regular file Time of the last data modification
Directory Time of the last modification
FIFO Time of the last data modification
AF_UNIX socket Value retrieved from the inode
/dev/null Current time
/dev/tty Composite value of the times of all openers
of the file
For the /E entry of the local node, the value is the time of the most recent mount-
ing of the root fileset.
st_ctime Status change time.
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 Time of the last file status change
Directory Time of the last file status change
FIFO Time of the last file status change
AF_UNIX socket Value retrieved from the inode
/dev/null Current time
/dev/tty Composite value of the times of all openers
of the file
For the /E entry of the local node, the value is the time of the most recent mount-
ing of the root fileset.
Use on Guardian Objects
The lstat() function can be used like the stat() or fstat( ) function on files in /G, but symbolic
links cannot be created in /G.
The st_dev and st_ino fields of the stat structure do not uniquely identify Guardian files (files in
/G).
The st_dev field is unique for /G, for each disk volume, and for each Telserv process (or other
process of subdevice type 30), because each of these is a separate fileset.
The S_ISGUARDIANOBJECT macro can indicate whether an object is a Guardian object
when the st_dev field is passed to the macro. The value of the macro is TRUE if the object is a
Guardian object and FALSE otherwise.
The st_ino field is a nonunique encoding of the Guardian filename.
The st_rdev field contains a minor device number for each ptyn entry in /G/ztnt/, representing
each Telserv process subdevice.
The st_size field of an EDIT file (file code 101) is the actual (physical) end of file, not the number
of bytes in the file. For directories, st_size is set to 4096.
When an OSS function is called for a Guardian EDIT file, the st_mtime field is set to the last
modification time. The st_atime field indicates the last time the file was opened, and the
st_ctime field is set equal to st_mtime. No other time-related fields are updated by OSS func-
tions.
4−18 Hewlett-Packard Company 527186-003