summaryrefslogtreecommitdiffstats
path: root/man3/tempnam.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/tempnam.3')
-rw-r--r--man3/tempnam.325
1 files changed, 12 insertions, 13 deletions
diff --git a/man3/tempnam.3 b/man3/tempnam.3
index fd68643..e1b7380 100644
--- a/man3/tempnam.3
+++ b/man3/tempnam.3
@@ -3,7 +3,7 @@
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.TH tempnam 3 2023-07-20 "Linux man-pages 6.05.01"
+.TH tempnam 3 2023-10-31 "Linux man-pages 6.7"
.SH NAME
tempnam \- create a name for a temporary file
.SH LIBRARY
@@ -12,15 +12,15 @@ Standard C library
.SH SYNOPSIS
.nf
.B #include <stdio.h>
-.PP
+.P
.BI "char *tempnam(const char *" dir ", const char *" pfx );
.fi
-.PP
+.P
.RS -4
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.RE
-.PP
+.P
.BR tempnam ():
.nf
Since glibc 2.19:
@@ -35,7 +35,7 @@ Use
or
.BR tmpfile (3)
instead.
-.PP
+.P
The
.BR tempnam ()
function returns a pointer to a string that is a valid filename,
@@ -49,7 +49,7 @@ in case
is a non-NULL string of at most five bytes.
The directory prefix part of the pathname generated is required to
be "appropriate" (often that at least implies writable).
-.PP
+.P
Attempts to find an appropriate directory go through the following
steps:
.TP 3
@@ -73,7 +73,7 @@ is used when appropriate.
.TP
d)
Finally an implementation-defined directory may be used.
-.PP
+.P
The string returned by
.BR tempnam ()
is allocated using
@@ -105,7 +105,6 @@ T{
.BR tempnam ()
T} Thread safety MT-Safe env
.TE
-.sp 1
.SH STANDARDS
POSIX.1-2008.
.SH HISTORY
@@ -130,7 +129,7 @@ Or better yet, use
.BR mkstemp (3)
or
.BR tmpfile (3).
-.PP
+.P
SUSv2 does not mention the use of
.BR TMPDIR ;
glibc will use it only
@@ -138,12 +137,12 @@ when the program is not set-user-ID.
On SVr4, the directory used under \fBd)\fP is
.I /tmp
(and this is what glibc does).
-.PP
+.P
Because it dynamically allocates memory used to return the pathname,
.BR tempnam ()
is reentrant, and thus thread safe, unlike
.BR tmpnam (3).
-.PP
+.P
The
.BR tempnam ()
function generates a different string each time it is called,
@@ -156,11 +155,11 @@ If it is called more than
.B TMP_MAX
times,
the behavior is implementation defined.
-.PP
+.P
.BR tempnam ()
uses at most the first five bytes from
.IR pfx .
-.PP
+.P
The glibc implementation of
.BR tempnam ()
fails with the error