TMPFILE(3C) Standard C Library Functions TMPFILE(3C)
NAME
tmpfile - create a temporary file
SYNOPSIS
#include <stdio.h>
FILE *tmpfile(
void);
DESCRIPTION
The
tmpfile() function creates a temporary file and opens a
corresponding stream. The file will automatically be deleted when
all references to the file are closed. The file is opened as in
fopen(3C) for update (
w+).
The largest value that can be represented correctly in an object of
type
off_t will be established as the offset maximum in the open file
description.
RETURN VALUES
Upon successful completion,
tmpfile() 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.
ERRORS
The
tmpfile() function will fail if:
EINTR A signal was caught during the execution of
tmpfile().
EMFILE There are
OPEN_MAX file descriptors currently open in the
calling process.
ENFILE The maximum allowable number of files is currently open in
the system.
ENOSPC The directory or file system which would contain the new
file cannot be expanded.
The
tmpfile() function may fail if:
EMFILE There are
FOPEN_MAX streams currently open in the calling
process.
ENOMEM Insufficient storage space is available.
USAGE
The stream refers to a file which is unlinked. If the process is
killed in the period between file creation and unlinking, a permanent
file may be left behind.
The
tmpfile() function has a transitional interface for 64-bit file
offsets. See
lf64(7).
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
SEE ALSO
unlink(2),
fopen(3C),
mkstemp(3C),
mktemp(3C),
tmpnam(3C),
lf64(7),
standards(7) August 4, 2003 TMPFILE(3C)