Guardian Procedure Calls Reference Manual

If cursor is present, then this is an output parameter. The name is left-justified and blank-filled
on output.
cursor
input, output
INT:ref:1
is a pointer to the attribute on input. On output, cursor points to the sequentially next attribute
that is to be read. To read the first attribute, set the cursor to 0.
To sequentially read all attributes, do not modify this parameter.
If both attribute-name and cursor are present, then cursor is used to identify the
attribute.
value-buf
output
STRING .EXT:ref:*
is the data array provided by the calling program to return the value of the attribute. The value
is in external form, suitable for display. If the value is a file name, it is fully qualified.
value-buf-len
input
INT:value
is the length of the array value-buf in bytes.
value-len
output
INT:ref:1
gives the actual size of the external representation for the value. If greater than
value-buf-len, then only value-buf-len bytes have been transferred and truncation
has occurred. An absent attribute is indicated by a length of -1.
read-mode
input
INT:value
is used with cursor. It indicates the search mode for the next parameter whose cursor value
is to be returned.
Search present attributes only.0
Search present plus required attributes that are not present.1
Search present plus required and optional attributes that are not present.2
If read-mode is not supplied, 0 is used.
info-word
output
INT:ref:1
info-word.<14:15> indicates the type of the attribute:
Optional0
Defaulted1
Required2
278 Guardian Procedure Calls (D-E)