Open System Services System Calls Reference Manual (G06.28+, H06.05+)

lstat64(2) OSS System Calls Reference Manual
Use From the Guardian Environment
A Guardian process can use thee lstat() function when you use the #define
_XOPEN_SOURCE_EXTENDED 1
feature test macro or an equivalent compiler command
option to compile the process.
The lstat64() function belongs to a set of functions that have the following effects when the first
of them is called from the Guardian environment:
• Two Guardian file system file numbers (not necessarily the next two
available) are allocated for the root directory and the current working
directory. You cannot close these file numbers by calling the Guardian
FILE_CLOSE_ procedure.
• 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 cumulative.
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 lstat64( ) 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
4−46 Hewlett-Packard Company 527186-007