require -t flag for command line timeout value

[unix-history] / usr / src / usr.bin / lock / lock.1

diff --git a/usr/src/usr.bin/lock/lock.1 b/usr/src/usr.bin/lock/lock.1
index 905bd62..c4ac6a0 100644 (file)
--- a/usr/src/usr.bin/lock/lock.1
+++ b/usr/src/usr.bin/lock/lock.1
@@ -1,23 +1,39 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1987 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)lock.1      4.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

 .\"
 .\"

-.TH LOCK 1 2/24/79
+.\"    @(#)lock.1      6.4 (Berkeley) %G%
+.\"
+.TH LOCK 1 ""

 .UC
 .SH NAME
 lock \- reserve a terminal
 .SH SYNOPSIS
 .B lock
 .UC
 .SH NAME
 lock \- reserve a terminal
 .SH SYNOPSIS
 .B lock

+[
+.B -p
+] [
+.B -t timeout
+]
+.br

 .SH DESCRIPTION
 .SH DESCRIPTION

-.I Lock
-requests a password from the user, then prints "LOCKED" on
-the terminal and refuses to relinquish the terminal until
-the password is repeated.  If the user forgets the password,
-he has no other recourse but to login elsewhere and kill
-the lock process.
-.SH AUTHOR
-Kurt Shoens
-.SH BUGS
-Should timeout after 15 minutes.
+\fILock\fP requests a password from the user, reads it again for verification
+and then it will normally not relinquish the terminal until the password is
+repeated.  There are three other conditions under which it will terminate: it
+accepts the password for root as an alternative to the one given by the
+user, it will timeout after some interval of time, and it may be killed by
+somebody with the appropriate permission. The default time limit is 15 minutes
+but it may be changed with the \fI-t\fP option where \fItimeout\fP is the
+time limit in minutes.  The \fI-p\fP option has \fIlock\fP use the user's
+standard password instead of requesting another one.