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

open64(2) OSS System Calls Reference Manual
(CAID) of the calling process.
During open64() processing, all access permissions are checked. This includes Guardian
environment checks by Guardian standard security mechanisms (and by the Safeguard product)
for Guardian disk file and process access.
Use From the Guardian Environment
A call to the open64() function in the Guardian environment requires an OSS pathname and
returns an OSS file-system file descriptor, regardless of the file system containing the file.
The open64() 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 allo-
cated 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 cumu-
lative.
RETURN VALUES
Upon successful completion, the function returns the file descriptor, a nonnegative integer. Oth-
erwise, the value -1 is returned, and errno is set to indicate the error.
ERRORS
If any of these conditions occurs, the function sets errno to the corresponding value:
[EACCES] One of these conditions exists:
• Search permission is denied on a component of the pathname prefix.
• The type of access specified by the oflag parameter is denied for the
named file.
• The file does not exist, and write permission is denied for the parent
directory.
• The O_TRUNC flag is specified, and write permission is denied.
• The process attempted to open a Guardian subvolume with a reserved
name beginning with ZYQ or a file within such a subvolume.
• The process attempted to open a static Telserv window that is not yet
connected.
[EEXIST] The O_CREAT and O_EXCL flags are set, and the named file exists.
[EFAULT] The path parameter is an invalid address.
[EFILEBAD] One of these conditions exists:
• The function call attempted to open a Guardian EDIT file, but the struc-
ture of the file is bad.
5−20 Hewlett-Packard Company 527186-007