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

Guardian Native C Library Calls (f) freopen64_oss(3)
NAME
freopen64_oss - Opens a stream (OSS freopen64( ) 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 ∗∗freopen64(
const char ∗∗path,
const char ∗∗mode,
FILE ∗∗stream);
FILE ∗∗freopen64_oss(
const char ∗∗path,
const char ∗∗mode,
FILE ∗∗stream);
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.
stream Specifies the input stream.
DESCRIPTION
This function is similar to the freopen_oss() function except that, in addition to supporting
smaller files, the freopen64_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 freopen_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 freopen64() OSS function and freopen64_oss() function substitute the named file in place
of the open stream.
These functions are identical in the OSS environment. Unless otherwise noted, this reference
page uses freopen64() to refer to both the freopen64() OSS function and freopen64_oss() func-
tion.
527192-007 Hewlett-Packard Company 2−77