Using KSAM/XL and KSAM 64 (32650-90886)

116 Chapter9
KSAM Intrinsics
FLABELINFO
37 U16 Logical device number
38 REC Terminated HFS-syntax system absolute pathname: Upon input, the
first four bytes are interpreted as a 32-bit unsigned integer specifying
the maximum available buffer size in bytes. This maximum available
buffer size does not include the four bytes used to represent this size.
Upon output, the first four bytes represent the pathname length
excluding the null terminator as a 32-bit unsigned integer. The
pathname is returned in bytes following the pathname length. Bytes
beyond the pathname terminator are undefined. If the maximum
available buffer size is incorrect upon input, variables allocated near
the buffer can be overwritten or a bounds violation could occur. A zero
pathname length is returned for unnamed new files and when an error
occurs. Zero is the minimum buffer length upon input for this itemnum .
39 U32 The current number of hard links to the file
40 I32 Time of last file access (clock format): The bit assignments are:
bits 0-7 = hours
bits 8-15 = minutes
bits 16-23 = seconds
bits 24-31 = tenths of seconds
41 I32 Time of last file status change (clock format): DFThe bit assignments
are:
bits 0-7 = hours
bits 8-15 = minutes
bits 16-23 = seconds
bits 24-31 = tenths of seconds
42 U16 Date of the last file status change (calendar format): The bit
assignments are:
bits 0-7 = year of century
bits 8-15 = day of the year
43 CA File owner (32 bytes): The full file owner name. Unused characters are
filled with blanks. A symbolic zero (ASCII 48 in decimal) is returned as
the file owner for root directories, accounts, and MPE groups created
prior to release 4.5.
44 I32 File owner identifier: The file owner identifier (UID). Zero is returned
as the file owner ID for root directories, MPE accounts, and MPE
groups created prior to release 4.5.
45 CA File group (32 bytes): The file group name. Unused characters are filled
with blanks. A symbolic zero (ASCII 48 in decimal) is returned as the
group for root directories where GIDs have not been explicitly assigned.
Table 9-5. FLABELINFO Itemnum/Item Values
Itemnum Mnemonic Item Description