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

lstat(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
You can use the lstat() function like the stat() or fstat() function on files in /G, but you cannot
create symbolic links 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.
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 lstat() function call fails. The value -1 is returned and errno is set to [ENOENT].
The lstat() 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 following table shows the mapping between Guardian files and their corresponding file types
described in the st_mode field.
4−34 Hewlett-Packard Company 527186-007