shell_cmds-198.tar.gz

[apple/shell_cmds.git] / mktemp / mktemp.1

diff --git a/mktemp/mktemp.1 b/mktemp/mktemp.1
index e9822d34584729c33ea43cd49d1d04c878374da7..921ffa3c981ef93363b613ec8ef9629088e464b3 100644 (file)
--- a/mktemp/mktemp.1
+++ b/mktemp/mktemp.1
@@ -9,10 +9,6 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
@@ -30,7 +26,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\" From: $OpenBSD: mktemp.1,v 1.8 1998/03/19 06:13:37 millert Exp $
-.\" $FreeBSD: src/usr.bin/mktemp/mktemp.1,v 1.21 2006/09/29 15:20:46 ru Exp $
+.\" $FreeBSD$
 .\"
 .Dd December 30, 2005
 .Dt MKTEMP 1
@@ -77,6 +73,11 @@ will
 result in
 .Nm
 selecting 1 of 56800235584 (62 ** 6) possible file names.
+On case-insensitive file systems, the effective number of unique
+names is significantly less; given six
+.Ql X Ns s ,
+.Nm
+will instead select 1 of 2176782336 (36 ** 6) possible unique file names.
 .Pp
 If
 .Nm
@@ -93,16 +94,26 @@ option is given,
 will generate a template string based on the
 .Ar prefix
 and the
+.Dv _CS_DARWIN_USER_TEMP_DIR
+configuration variable if available.
+Fallback locations if
+.Dv _CS_DARWIN_USER_TEMP_DIR
+is not available are
 .Ev TMPDIR
-environment variable if set.
-The default location if
-.Ev TMPDIR
-is not set is
+and
 .Pa /tmp .
 Care should
 be taken to ensure that it is appropriate to use an environment variable
 potentially supplied by the user.
 .Pp
+If no arguments are passed or if only the
+.Fl d
+flag is passed
+.Nm
+behaves as if
+.Fl t Li tmp
+was supplied.
+.Pp
 Any number of temporary files may be created in a single invocation,
 including one based on the internal template resulting from the
 .Fl t
@@ -154,10 +165,7 @@ Use of this
 option is not encouraged.
 .El
 .Sh EXIT STATUS
-The
-.Nm
-utility
-exits 0 on success, and 1 if an error occurs.
+.Ex -std
 .Sh EXAMPLES
 The following
 .Xr sh 1
@@ -191,6 +199,7 @@ fi
 .Xr mkdtemp 3 ,
 .Xr mkstemp 3 ,
 .Xr mktemp 3 ,
+.Xr confstr 3 ,
 .Xr environ 7
 .Sh HISTORY
 A