require -t flag for command line timeout value
[unix-history] / usr / src / usr.bin / lock / lock.1
CommitLineData
fcc2be53
KB
1.\" Copyright (c) 1987 The Regents of the University of California.
2.\" All rights reserved.
f5fe5f05 3.\"
fcc2be53
KB
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%
f5fe5f05 17.\"
00e6148f 18.TH LOCK 1 ""
f5fe5f05
KM
19.UC
20.SH NAME
21lock \- reserve a terminal
22.SH SYNOPSIS
23.B lock
00e6148f 24[
d1fa89aa
KB
25.B -p
26] [
fcc2be53 27.B -t timeout
00e6148f
KM
28]
29.br
f5fe5f05 30.SH DESCRIPTION
d1fa89aa
KB
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
fcc2be53 37but it may be changed with the \fI-t\fP option where \fItimeout\fP is the
d1fa89aa
KB
38time limit in minutes. The \fI-p\fP option has \fIlock\fP use the user's
39standard password instead of requesting another one.