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

creat(2) OSS System Calls Reference Manual
• 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 the Guardian file id created, it will be Format 1, odd, unstructured, and file code
180.
• The file is given access permissions compatible with the standard security permissions
for the Guardian creator access ID (CAID) of the calling process.
During creat() function 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.
Accessing Files in Restricted-Access Filesets
When accessing a file in a restricted-access fileset, the super ID (255,255 in the Guardian
environment, 65535 in the OSS environment) is restricted by the same file permissions and
owner privileges as any other user ID: It has no special privileges unless the executable file
started by the super ID has the PRIVSETID file privilege. In this case, the process started by the
super ID can switch to another ID and then access files in restricted-access filesets as that ID.
Executable files that have the PRIVSOARFOPEN privilege and that are started by a member of
the Safeguard SECURITY-OSS-ADMINISTRATOR (SOA) group have the appropriate privilege
to use this function on any file in a restricted-access fileset. However, Network File System
(NFS) clients are not granted SOA group privileges, even if these clients are accessing the sys-
tem with a user ID that is a member of the SOA security group.
For more information about restricted-access filesets and file privileges, see the Open System Ser-
vices Management and Operations Guide.
Use From the Guardian Environment
A call to the creat() 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 creat() 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−46 Hewlett-Packard Company 527186-023