aboutsummaryrefslogtreecommitdiff
path: root/man/man3/mktemp.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/man3/mktemp.3')
-rw-r--r--man/man3/mktemp.340
1 files changed, 40 insertions, 0 deletions
diff --git a/man/man3/mktemp.3 b/man/man3/mktemp.3
new file mode 100644
index 00000000..7ad6660e
--- /dev/null
+++ b/man/man3/mktemp.3
@@ -0,0 +1,40 @@
+.TH MKTEMP 3
+.SH NAME
+mktemp \- make a unique file name
+.SH SYNOPSIS
+.B #include <u.h>
+.br
+.B #include <libc.h>
+.PP
+.nf
+.B
+char* mktemp(char *template)
+.fi
+.SH DESCRIPTION
+.I Mktemp
+replaces
+.I template
+by a unique file name, and returns the
+address of the template.
+The template should look like a file name with eleven trailing
+.LR X s.
+The
+.LR X s
+are replaced by a letter followed by the current process id.
+Letters from
+.L a
+to
+.L z
+are tried until a name that can be accessed
+(see
+.IR access (2))
+is generated.
+If no such name can be generated,
+.I mktemp
+returns
+\f5"/"\f1 .
+.SH SOURCE
+.B /sys/src/libc/port/mktemp.c
+.SH "SEE ALSO"
+.IR getpid (2),
+.IR access (2)