tmpdir.c: Explain why we reject candidates, if we do.

[checkpath] / tmpdir.1

diff --git a/tmpdir.1 b/tmpdir.1
index 4b690ff..05030ba 100644 (file)
--- a/tmpdir.1
+++ b/tmpdir.1
@@ -1,16 +1,19 @@
+.\" -*-nroff-*-

 .TH tmpdir 1 "6 April 1999" "Local tools"
 .SH NAME
 tmpdir \- choose, or check a choice of, temporary directory
 .SH SYNOPSIS
 .B tmpdir
 .TH tmpdir 1 "6 April 1999" "Local tools"
 .SH NAME
 tmpdir \- choose, or check a choice of, temporary directory
 .SH SYNOPSIS
 .B tmpdir

-.RB [ \-bc ]
-.RB [ \-v
+.RB [ \-bcv ]
+.RB [ \-g
+.IR group ]
+.RB [ \-C

 .IR dir ]
 .SH USAGE
 The
 .B tmpdir
 program creates a secure place for temporary files to be stored, and
 .IR dir ]
 .SH USAGE
 The
 .B tmpdir
 program creates a secure place for temporary files to be stored, and

-outputs an assignment to the 
+outputs an assignment to the

 .B TMPDIR
 variable suitable for execution by a shell.
 .PP
 .B TMPDIR
 variable suitable for execution by a shell.
 .PP


@@ -28,10 +31,10 @@ The
 .B tmpdir
 program finds a secure place for temporary files, creating one if
 necessary.  The criteria it uses to choose a place are as follows:
 .B tmpdir
 program finds a secure place for temporary files, creating one if
 necessary.  The criteria it uses to choose a place are as follows:

-.IP 1.
+.IP "   1."

 The temporary directory must be owned by the user, and have mode 700
 (i.e., readable, writable and searchable only by the owner).
 The temporary directory must be owned by the user, and have mode 700
 (i.e., readable, writable and searchable only by the owner).

-.IP 2.
+.IP "   2."

 The path through the filesystem to the temporary directory must be
 secure against modifications by other malicious users.  See the
 .BR chkpath (1)
 The path through the filesystem to the temporary directory must be
 secure against modifications by other malicious users.  See the
 .BR chkpath (1)


@@ -60,7 +63,7 @@ fails too, then
 .B tmpdir
 gives up: if your home directory's not secure (or full) than a secure
 temporary directory is the least of your worries.
 .B tmpdir
 gives up: if your home directory's not secure (or full) than a secure
 temporary directory is the least of your worries.

-.SS OPTIONS
+.SS Options

 The following options are supported:
 .TP
 .B "\-b, \-\-bourne"
 The following options are supported:
 .TP
 .B "\-b, \-\-bourne"


@@ -70,7 +73,15 @@ examine the user's shell and decide which syntax to use based on that.
 .B "\-c, \-\-cshell"
 Output an assignment using C shell syntax.
 .TP
 .B "\-c, \-\-cshell"
 Output an assignment using C shell syntax.
 .TP

-.BI "\-v, --verify=" dir
+.BI "\-g, \-\-group " group
+Trust (the members of)
+.IR group :
+consider directories they can write to be safe.
+.TP
+.B "-v, \-\-verbose"
+Report problems to standard error.  Repeat for more verbosity.
+.TP
+.BI "\-C, --check " dir

 Don't try to find a temporary directory; just see whether
 .I dir
 is secure, and exit successfully if it is (and unsuccessfully if it
 Don't try to find a temporary directory; just see whether
 .I dir
 is secure, and exit successfully if it is (and unsuccessfully if it


@@ -79,6 +90,7 @@ isn't).
 None known.
 .SH SEE ALSO
 .BR chkpath (1),
 None known.
 .SH SEE ALSO
 .BR chkpath (1),

+.BR checkpath (3),

 .BR tmpnam (3),
 .BR tmpfile (3).
 .SH AUTHOR
 .BR tmpnam (3),
 .BR tmpfile (3).
 .SH AUTHOR