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

tmpfile64_oss(3) Guardian Native C Library Calls Ref
erence Manual
NAME
tmpfile64_oss - Creates a temporary file (OSS 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_oss(void);
DESCRIPTION
This function is similar to the ftmpfile_oss() function except that, in addition to supporting
smaller files, the tmpfile64_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 tmpfile_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 tmpfile64() OSS function and tmpfile64_oss( ) function create a temporary file and return its
FILE pointer. The file has an offset maximum larger than 2 gigabytes. The file is opened for
update. The temporary file is automatically deleted when the process using it terminates.
These functions are identical in the OSS environment. Unless otherwise noted, this reference
page uses tmpfile64() to refer to both the tmpfile64() OSS function and tmpfile64_oss() func-
tion.
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.
RETURN VALUES
Upon successful completion, the tmpfile64() function returns a pointer to the stream of the file
that is created. Otherwise, it returns a null pointer, and sets errno to indicate the error.
7−16 Hewlett-Packard Company 527192-007