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

OSS Library Calls (e - f) freopen_oss(3)
NAME
freopen_oss - Opens a stream (OSS freopen( ) 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 ∗∗freopen(
const char ∗∗path,
const char ∗∗mode,
FILE ∗∗stream);
FILE ∗∗freopen_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
The freopen( ) OSS function and freopen_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 freopen( ) to refer to both the freopen( ) OSS function and freopen_oss() function.
The original stream is closed regardless of whether the open( ) function succeeds with the named
file. The freopen( ) function returns a pointer to the FILE structure associated with the stream
parameter. The freopen( ) function is typically used to attach the preopened streams associated
with stdin, stdout, and stderr to other files.
The mode parameter controls the access allowed to the stream. It can have one of the following
values:
527187-017 Hewlett-Packard Company 2−163