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

System Functions (a - d) creat64(2)
NAME
creat64 - Creates a regular file in the OSS environment or rewrites an existing file
LIBRARY
G-series native Guardian processes: system library
G-series native OSS processes: system library
H-series native Guardian processes: implicit libraries
H-series OSS processes: implicit libraries
SYNOPSIS
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
int creat64(
const char *path,
mode_t mode);
PARAMETERS
path Points to the pathname of the file to be created or opened for writing.
You cannot specify /lost+found, /dev, /dev/tty, and /dev/null for this parameter.
Attempts to create these files cause the function call to fail with errno set to
[EINVAL].
If the path parameter refers to a symbolic link, the creat64() function opens the
file pointed to by the symbolic link.
mode Specifies the read, write, and execute permissions of the file and the file type
flags for the file.
If the file already exists, you must specify a valid value for this parameter, but
this parameter has no effect on the file (you cannot use this parameter to change
the permissions of the file).
The value of this parameter is constructed by logically ORing flags that are
defined in the sys/stat.h header file. If the parent directory of the created file |
does not have default OSS access control list (ACL) entries, the permissions for |
the new file are the bit-wise AND of this mode parameter with the complement |
of the process umask (see the umask(2) reference page). If the parent directory |
of the created file has default ACL entries, the permissions for the new file are |
affected by the value of this parameter but depend on both the support for OSS |
ACLs on the system on which this process is running and on the fileset that con- |
tains the new directory. See "ACL Inheritance" in the acl(5) reference page.
The file type flags are described in DESCRIPTION.
DESCRIPTION
The creat64() function is similar to the creat() function except that, in addition to supporting
smaller files, the creat64() function supports:
• OSS files larger than approximately 2 gigabytes, up to a limit of approximately 1 terabyte
(constrained by the space available on the disk volume)
• Both Guardian Format 1 and Guardian Format 2 files, up to the limit described in the
Open System Services Management and Operations Guide
An application can explicitly call this function when you use the #define
_LARGEFILE64_SOURCE 1 feature test macro or an equivalent compiler command option to
compile the application.
527186-007 Hewlett-Packard Company 1−45