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

Guardian Native C Library Calls (f) freopen(3)
NAME
freopen - Opens a stream
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
DESCRIPTION
The C run-time library supports two variants of the freopen( ) function: freopen_oss() and
freopen_guardian(). These variants support the unique file-naming conventions and structures
of the OSS and Guardian file systems, respectively. These variants support OSS files that have a
file offset maximum smaller than 2 gigabytes and Guardian files that have a file offset maximum
smaller than 4 gigabytes (Guardian Format 1 files).
For the TNS C runtime library only, the header file maps calls to freopen( ) to the variant that
matches the target compilation environment. The target environment is set with the systype
pragma.
Explicit calls to the freopen_oss() and freopen_guardian() variants in source code are only
made when the behavior of one environment is desired from the other environment.
For a description of the freopen( ) OSS function and the freopen_oss() function, see the
freopen_oss(3) reference page. For a description of the freopen() Guardian function and the
freopen_guardian() function, see the freopen_guardian(3) reference page. For a description of
equivalent functions that support OSS files that have a file offset maximum larger than 2 giga-
bytes and Guardian files that have a file offset maximum larger than 4 gigabytes (Guardian For-
mat 2 files), see the freopen64(3) reference page.
527192-018 Hewlett-Packard Company 2−109