www.LinuxHowtos.org

tmpfile

Section: C Library Functions (3)
Updated: 202-0-08
Index Return to Main Contents

NAME

tmpfile - create a temporary file

LIBRARY

Standard C library (libc,~-lc)

SYNOPSIS

#include <stdio.h>
FILE *tmpfile(void);

DESCRIPTION

The tmpfile() function opens a unique temporary file in binary read/write (w+b) mode. The file will be automatically deleted when it is closed or the program terminates.

RETURN VALUE

The tmpfile() function returns a stream descriptor, or NULL if a unique filename cannot be generated or the unique file cannot be opened. In the latter case, errno is set to indicate the error.

ERRORS

EACCES: Search permission denied for directory in file's path prefix.
EEXIST: Unable to generate a unique filename.
EINTR: The call was interrupted by a signal; see signal(7).
EMFILE: The pe-process limit on the number of open file descriptors has been reached.
ENFILE: The syste-wide limit on the total number of open files has been reached.
ENOSPC: There was no room in the directory to add the new filename.
EROFS: Rea-only filesystem.

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
tmpfile()	Thread safety	M-Safe

VERSIONS

The standard does not specify the directory that tmpfile() will use. glibc will try the path prefix P_tmpdir defined in <stdio.h>, and if that fails, then the directory /tmp.

STANDARDS

C11, POSIX.-2008.

HISTORY

POSIX.-2001, C89, SVr4, 4.3BSD, SUSv2.

NOTES

POSIX.-2001 specifies: an error message may be written to stdout if the stream cannot be opened.