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

tmpfile64_guardian(3) OSS Library Calls Reference Manual
NAME
tmpfile64_guardian - Creates a temporary file (Guardian tmpfile64( ) 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 *tmpfile64(void);
FILE *tmpfile64_guardian(void);
DESCRIPTION
This function is similar to the ftmpfile_guardian( ) function except that, in addition to support-
ing smaller files, the tmpfile64_guardian( ) function supports Guardian files that have an offset
maximum larger than 4 gigabytes (Guardian Format 2 files).
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 tmpfile_guardian( ) 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 tmpfile64( ) Guardian function and tmpfile64_guardian( ) function create a temporary file
and return its FILE pointer. The file is opened for update. The temporary file is automatically
deleted when the process using it terminates.
The temporary file is a Format 2 type 180 C binary file, opened for ANSI I/O, and with binary
update access ("wb+").
These functions are identical in the Guardian environment. Unless otherwise noted, this refer-
ence page uses tmpfile64( ) to refer to both the tmpfile64( ) Guardian function and
tmpfile64_guardian( ) function.
Interoperability Variants
The C run-time library supports two variants of the tmpfile64( ) function: tmpfile64_oss( ) and
tmpfile64_guardian( ). The variants support the unique file-naming conventions and structures
of the OSS and Guardian file systems, respectively.
Explicit calls to the tmpfile64_oss( ) and tmpfile64_guardian( ) variants in source code are only
made when the behavior of one environment is desired from the other environment.
tmpfile64_oss( ) is functionally identical to the tmpfile64( ) function of the OSS environment. It
is the same as setting systype oss at compile time. systype oss is the default setting for
c89 in the OSS environment.
tmpfile64_guardian( ) is functionally identical to the tmpfile64( ) function of the Guardian
environment. It is the same as setting systype guardian at compile time. systype guar-
dian is the default setting for the C and C++ compilers in the Guardian environment.
To use the tmpfile64_oss( ) or tmpfile64_guardian( ) functions, specify the
_TANDEM_SOURCE feature test macro.
7−40 Hewlett-Packard Company 527187-017