Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document mkdtemp(3).

This commit is contained in:
mycroft 1998-07-27 16:41:40 +00:00
parent 90cb894b40
commit 0bbc075c20
2 changed files with 37 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
lib/libc/stdio/Makefile.inc
View File

@ -1,5 +1,5 @@
# from: @(#)Makefile.inc 5.7 (Berkeley) 6/27/91
# $NetBSD: Makefile.inc,v 1.15 1998/07/27 16:13:01 mycroft Exp $
# $NetBSD: Makefile.inc,v 1.16 1998/07/27 16:41:40 mycroft Exp $
# stdio sources
.PATH: ${.CURDIR}/stdio
@ -32,7 +32,7 @@ MLINKS+=fread.3 fwrite.3
MLINKS+=fseek.3 fgetpos.3 fseek.3 fsetpos.3 fseek.3 ftell.3 fseek.3 rewind.3
MLINKS+=funopen.3 fropen.3 funopen.3 fwopen.3
MLINKS+=getc.3 fgetc.3 getc.3 getchar.3 getc.3 getw.3
MLINKS+=mktemp.3 mkstemp.3
MLINKS+=mktemp.3 mkdtemp.3 mktemp.3 mkstemp.3
MLINKS+=printf.3 fprintf.3 printf.3 snprintf.3 printf.3 sprintf.3 \
printf.3 vfprintf.3 printf.3 vprintf.3 printf.3 vsnprintf.3 \
printf.3 vsprintf.3

45
lib/libc/stdio/mktemp.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: mktemp.3,v 1.11 1998/06/08 12:41:42 lukem Exp $
.\" $NetBSD: mktemp.3,v 1.12 1998/07/27 16:41:40 mycroft Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -38,8 +38,9 @@
.Os
.Sh NAME
.Nm mktemp ,
.Nm mkstemp
.Nd make temporary file name (unique)
.Nm mkstemp ,
.Nm mkdtemp
.Nd make unique temporary file or directory name
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
@ -48,6 +49,8 @@
.Fn mktemp "char *template"
.Ft int
.Fn mkstemp "char *template"
.Ft char *
.Fn mkdtemp "char *template"
.Sh DESCRIPTION
The
.Fn mktemp
@ -83,11 +86,20 @@ makes the same replacement to the template and creates the template file,
mode 0600, returning a file descriptor opened for reading and writing.
This avoids the race between testing for a file's existence and opening it
for use.
.Pp
The
.Fn mkdtemp
function
is similar to
.Fn mkstemp ,
but it creates a mode 0700 directory instead and returns the path.
.Sh RETURN VALUES
The
.Fn mktemp
function
returns a pointer to the template on success and
and
.Fn mkdtemp
functions
return a pointer to the template on success and
.Dv NULL
on failure.
The
@ -98,9 +110,10 @@ If either call fails an error code is placed in the global variable
.Va errno .
.Sh ERRORS
The
.Fn mktemp
and
.Fn mktemp ,
.Fn mkstemp
and
.Fn mkdtemp
functions
may set
.Va errno
@ -111,9 +124,10 @@ The pathname portion of the template is not an existing directory.
.El
.Pp
The
.Fn mktemp
and
.Fn mktemp ,
.Fn mkstemp
and
.Fn mkdtemp
functions
may also set
.Va errno
@ -129,6 +143,15 @@ may also set
to any value specified by the
.Xr open 2
function.
.Pp
The
.Fn mkdtemp
function
may also set
.Va errno
to any value specified by the
.Xr mkdir 2
function.
.Sh SEE ALSO
.Xr chmod 2 ,
.Xr getpid 2 ,
@ -146,6 +169,8 @@ should generally be avoided, as a hostile process can exploit a race
condition in the time between the generation of a temporary filename by
.Fn mktemp
and the invoker's use of the temporary name.
A link-time warning will be issued to advise the use of
A link-time warning will be issued advising the use of
.Fn mkstemp
or
.Fn mkdtemp
instead.