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

stat(2) OSS System Calls Reference Manual
Guardian permissions are mapped as listed:
• A Guardian network or any user permission is mapped to an OSS other
permission.
• A Guardian community or group user permission is mapped to an OSS
group permission.
• A Guardian user or owner permission is mapped to an OSS owner per-
mission.
• A Guardian super ID permission is an OSS super ID permission.
• Guardian read permission is mapped to OSS read permission.
• Guardian write permission is mapped to OSS write permission.
• Guardian execute permission is mapped to OSS execute permission.
• Guardian purge permission is ignored.
Users are not allowed read access to Guardian processes.
OSS file permissions are divided into three groups (owner, group, and other) of
three permission bits each (read, write, and execute). Note that the OSS permis-
sion bits do not distinguish between remote and local users as Guardian security
does; local and remote users are treated alike.
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. 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 cumulative.
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.
7−166 Hewlett-Packard Company 527186-003