Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (f) fopen64_oss(3)
NAME
fopen64_oss - Opens a stream (OSS fopen64( ) function)
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <stdio.h>
FILE ∗∗fopen64(
const char ∗∗path,
const char ∗∗mode);
FILE ∗∗fopen64_oss(
const char ∗∗path,
const char ∗∗mode);
PARAMETERS
path Points to a character string that contains the name of the file to be opened. If the
final component of the path parameter specifies a symbolic link, the link is
traversed and pathname resolution continues.
mode Points to a character string that controls whether the file is opened for reading
(r), writing (w), or appending (a) and whether the file is opened for updating (+).
If the parent directory of the created file does not have default OSS access con-
trol 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 contains the new directory. See
"ACL Inheritance" in the acl(5) reference page..
DESCRIPTION
This function is similar to the fopen_oss( ) function except that, in addition to supporting smaller
files, the fopen64_oss() function supports OSS files that have an offset maximum larger than 2
gigabytes.
An application can explicitly call this function when you compile the application using the
#define _LARGEFILE64_SOURCE 1 feature test macro or an equivalent compiler command
option.
An application call to fopen_oss( ) is automatically mapped to this function when you compile
the application using the #define _FILE_OFFSET_BITS 64 feature test macro or an equivalent
compiler command option.
The fopen64( ) OSS function and fopen64_oss() function open the file named by the path param-
eter and associate a stream with it, returning a pointer to the FILE structure of this stream.
These functions are identical in the OSS environment. Unless otherwise noted, this reference
page uses fopen64() to refer to both the fopen64( ) OSS function and fopen64_oss() function.
The mode parameter controls the access allowed to the stream. It can have one of these values:
527192-018 Hewlett-Packard Company 2−69