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

creat64(2) OSS System Calls Reference Manual
• An attempt to open a subvolume with a reserved name beginning with "ZYQ" (for exam-
ple, /G/vol2/zyq00004) fails, and errno is set to the value of [EACCES].
• An attempt to open a file within a subvolume with a reserved name beginning with
"ZYQ" (for example, /G/vol2/zyq00004/z000002x) fails, and errno is set to the value of
[EACCES].
• If the file is not an EDIT file (that is, the file code is not 101), it is opened in shared
exclusion mode.
• If the file is an EDIT file and read-only access is specified, the file is opened in protected
exclusion mode in the Guardian environment.
• If the file is an EDIT file and write access is specified, the call fails, and errno is set to
the value [EINVAL].
• The maximum number of opens is reported by the sysconf() function as the upper limit
of opens per process. The actual limit depends on other factors, such as the size of the
process file segment (PFS) and the number of existing opens on directories or on files in
the Guardian environment.
• When a Guardian file is created, the file will be Format 2, odd, unstructured, and file code
180.
• If the open causes file creation, the file is given access permissions compatible with the
standard security permissions for the Guardian creator access ID (CAID) of the calling
process.
During creat64() function processing, all access permissions are checked. This includes Guar-
dian environment checks by Guardian standard security mechanisms (and by the Safeguard pro-
duct) for Guardian disk file and process access.
Use From the Guardian Environment
A call to the creat64() 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 creat64() 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. 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.
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.
1−54 Hewlett-Packard Company 527186-023