open.2: Document O_TMPFILE

O_TMPFILE is new in Linux 3.11

Signed-off-by: Andy Lutomirski <luto@amacapital.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Andy Lutomirski 2013-08-07 10:31:58 -07:00 committed by Michael Kerrisk
parent 1d3050c0dd
commit f2698a42d4
1 changed files with 30 additions and 2 deletions

View File

@ -126,6 +126,7 @@ are
.BR O_EXCL ,
.BR O_NOCTTY ,
.BR O_NOFOLLOW ,
.BR O_TMPFILE ,
.BR O_TRUNC ,
and
.BR O_TTY_INIT .
@ -226,11 +227,15 @@ described in
specifies the permissions to use in case a new file is created.
This argument must be supplied when
.B O_CREAT
or
.B O_TMPFILE
is specified in
.IR flags ;
if
if neither
.B O_CREAT
is not specified, then
nor
.B O_TMPFILE
is specified, then
.I mode
is ignored.
The effective permissions are modified by
@ -284,6 +289,29 @@ The following symbolic constants are provided for
00001 others have execute permission
.RE
.TP
.BR O_TMPFILE " (Since Linux 3.11)"
Create an unnamed temporary file. The pathname parameter specifies a
directory; an unnamed inode will be created in that directory's
filesystem. Anything written to the resulting file will be lost when
the last fd is closed, unless the file is given a name.
.RS
.PP
.B O_TMPFILE
must be specified with one of
.B O_RDWR
or
.B O_WRONLY
and, optionally,
.B O_EXCL.
If O_EXCL is not specified, then
.BR linkat (2)
can be used to link the temporary file into the filesystem, making it
permanent.
.PP
The mode parameter determines the inode's mode, as with
.B O_CREAT.
.RE
.TP
.BR O_DIRECT " (Since Linux 2.4.10)"
Try to minimize cache effects of the I/O to and from this file.
In general this will degrade performance, but it is useful in