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

stat(2) OSS System Calls Reference Manual
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 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 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 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.
When the path parameter points to the name of a Guardian process that is not a process of sub-
type 30, the stat() function call fails. The value -1 is returned, and errno is set to [ENOENT].
The stat() function always returns access modes of "d---------" when the path
parameter points to
a
Guardian subvolume that has a reserved name beginning with ZYQ. The other access modes
reported for files in /G vary according to the file type.
The next table shows the mapping between Guardian files and their corresponding file types
described in the st_mode field.
7−500 Hewlett-Packard Company 527186-023