Open System Services System Calls Reference Manual (G06.28+, H06.05+)
lstat(2) OSS System Calls Reference Manual
• The current working directory is assigned from the VOLUME attribute of the Guardian
environment =_DEFAULTS DEFINE.
• The use of static memory by the process increases slightly.
These effects occur only when the first of the set of functions is called. The effects are not cumu-
lative.
NOTES
The OSS Network File System (NFS) cannot access files that have optional ACL entries. |
RETURN VALUES
Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned
and errno is set to indicate the error.
ERRORS
If any of these conditions occurs, the lstat() function sets errno to the corresponding value:
[EACCES] Search permission is denied for a component of the pathname pointed to by the
path parameter.
[EFAULT] Either the buffer parameter or the path parameter points to a location outside of
the allocated address space of the process.
[EFSBAD] The program attempted an operation involving a fileset with a corrupted fileset
catalog.
[EIO] An input or output error occurred. The device holding the file might be in the
down state, or both processors that provide access to the device might have
failed.
[ELOOP] Too many symbolic links were encountered in translating path.
[ENAMETOOLONG]
One of these names is too long:
• The pathname pointed to by the path parameter
• A component of the pathname pointed to by the path parameter
• The intermediate result of pathname resolution when a symbolic link is
part of the path parameter
You can call the pathconf( ) function to obtain the applicable limits.
[ENOENT] One of the following conditions exists:
• The file specified by the path parameter does not exist.
• path points to an empty string.
• The specified pathname cannot be mapped to a valid Guardian filename.
• The specified pathname points to the name of a Guardian process that is
not of subtype 30.
• The path parameter specifies a file on a remote HP NonStop node but
communication with the remote node has been lost.
4−36 Hewlett-Packard Company 527186-007