Open System Services System Calls Reference Manual (G06.25+, H06.03+)

lstat(2) OSS System Calls Reference Manual
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 lstat() function can be used by a Guardian process when the process has been compiled
using the #define _XOPEN_SOURCE_EXTENDED 1
feature test macro or an equivalent com-
piler command option.
The lstat() 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 allo-
cated for the root directory and the current working directory. These file numbers cannot
be closed 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 cumu-
lative.
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 the following 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 the following is too long:
• The pathname pointed to by the path parameter
4−20 Hewlett-Packard Company 527186-003