require -t flag for command line timeout value
[unix-history] / usr / src / usr.bin / lock / lock.1
... / ...
CommitLineData
1.\" Copyright (c) 1987 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms are permitted
5.\" provided that the above copyright notice and this paragraph are
6.\" duplicated in all such forms and that any documentation,
7.\" advertising materials, and other materials related to such
8.\" distribution and use acknowledge that the software was developed
9.\" by the University of California, Berkeley. The name of the
10.\" University may not be used to endorse or promote products derived
11.\" from this software without specific prior written permission.
12.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
13.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
14.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
15.\"
16.\" @(#)lock.1 6.4 (Berkeley) %G%
17.\"
18.TH LOCK 1 ""
19.UC
20.SH NAME
21lock \- reserve a terminal
22.SH SYNOPSIS
23.B lock
24[
25.B -p
26] [
27.B -t timeout
28]
29.br
30.SH DESCRIPTION
31\fILock\fP requests a password from the user, reads it again for verification
32and then it will normally not relinquish the terminal until the password is
33repeated. There are three other conditions under which it will terminate: it
34accepts the password for root as an alternative to the one given by the
35user, it will timeout after some interval of time, and it may be killed by
36somebody with the appropriate permission. The default time limit is 15 minutes
37but it may be changed with the \fI-t\fP option where \fItimeout\fP is the
38time limit in minutes. The \fI-p\fP option has \fIlock\fP use the user's
39standard password instead of requesting another one.