Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionstmpfile(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(5).

SEE ALSO

 

unlink(2), fopen(3C), tmpnam(3C), lf64(5)


SunOS 5.9Go To TopLast Changed 28 Jan 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.