Guardian Procedure Calls Reference Manual

count
output
INT .EXT:ref:1
is the number of characters occupied by the name if a valid name is found. If error 13 is
returned in error, count contains the number of characters examined when the name was
determined to be invalid. To know that the entire input string constitutes a valid name, you
should verify that count is equal to length. See Example.
kind
output
INT .EXT:ref:1
identifies the class of name that was found. Possible values are:
File name (that is, the name of an entity).0
File-name pattern. This value can be returned only if options.<15> is equal to 1. If the input is a name
as well as a file-name pattern (that is, it does not contain an asterisk or question mark), FILENAME_SCAN_
classifies it as a name and not a pattern.
1
DEFINE name.2
entity-level
output
INT .EXT:ref:1
identifies the class of entity represented by the supplied name based on its syntax. This value
corresponds to the "level" of the rightmost name section that appears. Possible values are:
Node name.-1
Name of device or process without qualifiers.0
Name of device or process with entity-level qualifiers.>0
Note that a disk file name always has an entity-level greater than 0 (1 if it is a temporary
file; 2 if it is a permanent file). The value returned is not affected by whether name sections to
the left are implied (that is, defaulted).
A DEFINE name always yields a value of 0.
options
input
INT:value
specifies options. The bits, when equal to 1, have these meanings:
Reserved (specify 0).<0:13>
Specifies that a subvolume name be accepted as valid input.<14>
Specifies that a file-name pattern be accepted as valid input.<15>
The default value is 0.
592 Guardian Procedure Calls (F)