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

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