home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | NOTES | SEE ALSO | COLOPHON


TMPFILE(3)                    Linux Programmer's Manual                    TMPFILE(3)

NAME         top

       tmpfile - create a temporary file

SYNOPSIS         top

       #include <stdio.h>

       FILE *tmpfile(void);

DESCRIPTION         top

       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         top

       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         top

       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.

       EMFILE Too many file descriptors in use by the process.

       ENFILE Too many files open in the system.

       ENOSPC There was no room in the directory to add the new filename.

       EROFS  Read-only file system.

CONFORMING TO         top

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

NOTES         top

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

       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 the
       directory /tmp.

SEE ALSO         top

       exit(3), mkstemp(3), mktemp(3), tempnam(3), tmpnam(3)

COLOPHON         top

       This page is part of release 3.23 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

                                      2008-07-14                           TMPFILE(3)