[src/trunk]: src/lib/libc/stdio Draw attention to the fact that the created f...

[aymeric <aymeric%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/77d0fde12fa7
branches:  trunk
changeset: 511611:77d0fde12fa7
user:      aymeric <aymeric%NetBSD.org@localhost>
date:      Fri Jun 22 20:09:05 2001 +0000

description:
Draw attention to the fact that the created file/dir may not be readable
or writable due to a weird umask.

diffstat:

 lib/libc/stdio/mktemp.3 |  11 +++++++++--
 1 files changed, 9 insertions(+), 2 deletions(-)

diffs (32 lines):

diff -r 1b540c979b2e -r 77d0fde12fa7 lib/libc/stdio/mktemp.3
--- a/lib/libc/stdio/mktemp.3   Fri Jun 22 16:40:51 2001 +0000
+++ b/lib/libc/stdio/mktemp.3   Fri Jun 22 20:09:05 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mktemp.3,v 1.13 1998/07/28 17:11:12 mycroft Exp $
+.\"    $NetBSD: mktemp.3,v 1.14 2001/06/22 20:09:05 aymeric Exp $
 .\"
 .\" Copyright (c) 1989, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -93,6 +93,12 @@
 is similar to
 .Fn mkstemp ,
 but it creates a mode 0700 directory instead and returns the path.
+.Pp
+Please note that the permissions of the file or directory being created are
+subject to the restrictions imposed by the
+.Xr umask 2
+system call. It may thus happen that the created file is unreadable and/or
+unwritable.
 .Sh RETURN VALUES
 The
 .Fn mktemp
@@ -156,7 +162,8 @@
 .Xr chmod 2 ,
 .Xr getpid 2 ,
 .Xr open 2 ,
-.Xr stat 2
+.Xr stat 2 ,
+.Xr umask 2
 .Sh HISTORY
 A
 .Fn mktemp