Guardian Procedure Calls Reference Manual

pathlen
output
INT .EXT:ref:1
returns the actual length in bytes of the pathname parameter, including the terminating null
character.
options
input
INT:value
specifies options for the filename parameter:
Reserved (specify 0).<0:12>
If the caller has appropriate privileges, specifies that pathname is an absolute pathname with
respect to the system root.
1<13>
Specifies that pathname is an absolute pathname with respect to the current root of the process.0
Specifies that pathname always includes the system name in the form /E/system/path.1<14>
Specifies that pathname includes system names only for remote pathnames; that is, local
pathnames do not start with “/E.”
0
Specifies that a subvolume name be accepted as valid input.1<15>
Specifies that a the input must be a file name.0
The default value is 0.
index
input, output
INT .EXT:ref:1
specifies the index of the link to the named file to be returned in pathname. Specifying a value
of -1 finds only the first accessible path. Specifying a value of 0 starts a search for all possible
pathnames.
index returns the index to the next pathname to the file. A value of -1 on return indicates that
pathname contains the last (or only) name for the file.
The default value is -1.
Returned Value
INT
A file-system error code that indicates the outcome of the call:
No error.0
The pathname buffer is too small to contain the resulting name.563
filename specifies a Guardian name for an OSS file that either does not exist or has been unlinked but is
still open by some process. The corresponding OSS errno value is ENOENT.
4002
The fileset that corresponds to the supplied Guardian name for an OSS file is not mounted. The corresponding
OSS errno value is ENXIO.
4006
The caller does not have search access to one of the directories within all of the resulting pathnames. The
corresponding OSS errno value is EACCESS.
4013
A parameter has an invalid address. The corresponding OSS errno value is EFAULT.4014
One of these conditions has occurred:4014
• options is specified and options.<0:12> does not contain all zeros.
• filename is not a valid file or subvolume name.
FILENAME_TO_PATHNAME_ Procedure 597