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(3S) 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 tmpfile(). 

EMFILE OPEN_MAX file descriptors are 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 FOPEN_MAX streams are 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. 

tmpfile() has an explicit 64-bit equivalent.  See interface64(5). 

SEE ALSO

unlink(2), fopen(3S), tmpnam(3S), interface64(5)

SunOS 5.6  —  Last change: 12 Sep 1996