Open System Services System Calls Reference Manual (G06.28+, H06.05+)
System Functions (s and S) stat(2)
Use on Remote Objects
The content of the st_dev field of the stat structure is unique for each node in /E because each of
these is a separate fileset. Values for directories within /E are the same as described for objects
on the local HP NonStop node.
The S_ISEXPANDOBJECT macro can indicate whether an object in the /E directory is on a
remote HP NonStop node when the st_dev field is passed to the macro. The value of the macro
is TRUE if the object is on a remote HP NonStop node and FALSE otherwise.
Use From the Guardian Environment
The stat() function belongs to a set of functions that have these 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 stat() 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 is too long:
— The pathname pointed to by the path parameter
527186-007 Hewlett-Packard Company 7−389