summaryrefslogtreecommitdiffstats
path: root/man3/tmpfile.3
blob: 2bacdb4c14c510ed60d17b1beb2803fa63987925 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\" May be distributed under the GNU General Public License
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 17:46:57 1993 by Rik Faith (faith@cs.unc.edu)
.TH TMPFILE 3  "April 3, 1993" "GNU" "Linux Programmer's Manual"
.SH NAME
tmpfile \- create a temporary file
.SH SYNOPSIS
.nf
.B #include <stdio.h>
.sp
.B FILE *tmpfile (void);
.fi
.SH DESCRIPTION
The \fBtmpfile()\fP function generates a unique temporary filename 
using the path prefix \fIP_tmpdir\fP defined in \fI<stdio.h>\fP.  
The temporary file is then opened in binary read/write (w+b) mode.
The file will be automatically deleted when it is closed or the
program terminates.
.SH "RETURN VALUE"
The \fBtmpfile()\fP function returns a stream descriptor, or NULL if
a unique filename cannot be generated or the unique file cannot be
opened.
.SH "ERRORS"
.TP 
.B EACCES
Search permission denied for directory in file's path prefix.
.TP
.B EEXIST
Unable to generate a unique filename.
.TP
.B EMFILE
Too many file descriptors in use by process.
.TP
.B ENFILE
Too many files open in system.
.TP
.B EROFS
Read-only filesystem.
.SH "CONFORMING TO"
SVID 3, POSIX, BSD 4.3, ISO 9899
.SH SEE ALSO
.BR mktemp "(3), " mkstemp "(3), " tmpnam "(3), " tempnam (3)