The routine tries to get information about a specified file. If it succeeds, it returns the information in either IVAL or CVAL. If it fails, it sets STATUS to PSX__ERRNO and reports an error.

CALL PSX_STAT( PATH, ITEM, VALUE, STATUS )

PATH = CHARACTER $\ast$ ( $\ast$ ) (Given)

ITEM = CHARACTER $\ast$ ( $\ast$ ) (Given)

VALUE = INTEGER (Returned)

STATUS = INTEGER (Given and Returned)

The ITEM argument can take any of the following values:

• "UID" - user ID of owner.

• "GID" - group ID of owner.

• "SIZE" - total file size, in bytes.

• "ATIME" - time of last access.

• "CTIME" - time of last status change (e.g. file creation).

• "MTIME" - time of last modification.

The time values are returned as the number of ticks since an arbitrary point in the past. See PSX_TIME.