Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

fopen64_oss(3) Guardian Native C Library Calls Ref
erence Manual
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 native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
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:
2−34 Hewlett-Packard Company 527192-007