Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (n - p) open(2)
NOTES
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit OSS applications.
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.
• The function call attempted to open a Guardian EDIT file, but the cor-
rupted flag is set in the file label.
[EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt.
[EGUARDIANOPEN]
The function call attempted to open a Guardian EDIT file for write access or for
Guardian shared or exclusive exclusion access, but the file has already been
opened with a Guardian procedure call.
[EINTR] A signal was caught during the open operation. This value is returned only for
character special files (terminal devices) and for FIFO special files.
[EINVAL] One of these conditions exists:
• The call attempted to create a directory named lost+found in the root
directory of an OSS fileset, or it attempted to create a directory named
/dev, /dev/tty,or/dev/null in the root directory of the OSS file system.
527186-023 Hewlett-Packard Company 5−11