Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

fstat(2) OSS System Calls Reference Manual
st_ctime Status change time.
Values for OSS objects are listed next. 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
Pipe or FIFO Time of the last file status change
AF_INET or AF_INET6 socket Value maintained in the socket data struc-
ture
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 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 unique minor device number for each 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 function
calls.
The st_ctime and st_atime fields for Guardian regular disk files (except for EDIT files) are
updated by OSS function calls, not by Guardian procedure calls.
The time fields for /G, /G/vol, and /G/vol/subvol always contain the current time.
The mapping between Guardian files and their corresponding file types described in the st_mode
field is listed next:
3−30 Hewlett-Packard Company 527186-023