MPE/iX Intrinsics Reference Manual (32650-90875)

174 Chapter5
Command Definitions (FCONTROL - FLOCK)
FFILEINFO
80 CA HFS syntax filename.
This itemnum returns a null-terminated POSIX-syntax system absolute
pathname for the file or directory referenced by filenum . On input the first four
bytes of this buffer are interpreted as a 32-bit unsigned integer specifying the
maximum buffer size in bytes. This maximum buffer size does not include the
four bytes used to represent this size. On output the first four bytes of the buffer
represent the pathname length excluding the null-terminator as an unsigned
integer. The pathname is returned in the bytes following the pathname length.
Bytes beyond the null-terminator should be considered undefined. If the
maximum buffer length is incorrect on input, variables allocated near the buffer
may be overwritten or a bounds violation may occur. A zero pathname length is
returned for unnamed new files and when an error occurs. Zero is the mininum
buffer length on input for this itemnum .
Format of the buffer on input:
byte #1 #2 #3 #4 | #1 ... #N
+----+----+----+----+----+ ... +----+
| maximum | |
| length = N | |
+----+----+----+----+----+ ... +----+
Format of the buffer on output:
byte #1 #2 #3 #4 | #1 ... #L ... #N
+----+----+----+----+----+ ... +----+ ...
+----+
| length = | / | | \0 | | |
|(L-1) ||||||
+----+----+----+----+----+ ... +----+ ...
+----+
81 U32 The current number of hard links to the file.
82 I32 Time of last file access in clock format. The bit assignments are:
Bits 0 to 7 hours
Bits 8 to 15 minutes
Bits 16 to 23 seconds
Bits 24 to 31 tenths of seconds
83 I32 Time of last file status change in clock format (See item 82 for a description of
clock format).
Table 5-2. FFILEINFO Itemnum/Item Values
Itemnu
m
Item
Type
Item Description