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

lstat(2) OSS System Calls Reference Manual
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-023