Guardian Procedure Calls Reference Manual

length
output
INT .EXT:ref:1
returns the length in bytes of the fully qualified Guardian file name returned in filename.
If error returns 563 (buffer too small) due to filename being to small to contain the name,
length returns the actual length of the name.
info-flags
output
INT .EXT:ref:1
contains additional information about the file. info-flags is returned as a bit mask defined
as:
Reserved.<0:14>
The specified file is a Guardian file.= 1<15>
The specified file is an OSS file.= 0
Returned Value
INT
A file-system error code that indicates the outcome of the call:
No error.0
The buffer pointed to by filename is too small.563
No such pathname exists. The corresponding OSS errno value is ENOENT.4002
A prefix within pathname refers to an OSS fileset other than the root fileset that is not mounted. The
corresponding OSS errno value is ENXIO.
4006
Search permission is denied on a component of the pathname prefix. The corresponding OSS errno value
is EACCESS.
4013
A specified parameter has an invalid address. The corresponding OSS errno value is EFAULT.4014
A prefix within pathname refers to a file other than a directory. The corresponding OSS errno value is
ENOTDIR.
4022
pathname is invalid. The corresponding OSS errno value is EINVAL.4022
The pathname, a component of the pathname, or a symbolic link in the pathname is longer than PATH_MAX
characters. (PATH_MAX is a symbolic constant that is defined in the OSS limits.h header file.) For pathname
4131
syntax, see Appendix D: File Names and Process Identifiers. The corresponding OSS errno value is
ENAMETOOLONG.
The pathname or a component of the pathname has too many symbolic links to resolve the specified
pathname. The corresponding OSS errno value is ELOOP.
4200
The root fileset is not mounted. The corresponding OSS errno value is ENOROOT.4202
OSS is not installed or is not initialized. The corresponding OSS errno value is EOSSNOTRUNNING.4203
OSS Considerations
• If the file identified by pathname is in the Guardian name space (/G), then the file name is
syntactically changed to the Guardian format without checking whether the file exists. The
local pathname of a permanent Guardian disk file has the form
/G/volume/subvol/file-id which corresponds to the Guardian name
$volume.subvol.file-id. Similarly, the local pathname for a temporary Guardian disk
PATHNAME_TO_FILENAME_ Procedure 935