xref: /freebsd/usr.bin/lock/lock.1 (revision f88e6136c3929ca6531bc4b33e559a8aa2fd6dcf)
19b50d902SRodney W. Grimes.\" Copyright (c) 1987, 1990, 1993
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
139b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
149b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
159b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
179b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
189b50d902SRodney W. Grimes.\"    without specific prior written permission.
199b50d902SRodney W. Grimes.\"
209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
239b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
309b50d902SRodney W. Grimes.\" SUCH DAMAGE.
319b50d902SRodney W. Grimes.\"
329b50d902SRodney W. Grimes.\"	@(#)lock.1	8.1 (Berkeley) 6/6/93
33c3aac50fSPeter Wemm.\" $FreeBSD$
349b50d902SRodney W. Grimes.\"
3516a8de73SDima Dorfman.Dd July 10, 2002
369b50d902SRodney W. Grimes.Dt LOCK 1
379b50d902SRodney W. Grimes.Os
389b50d902SRodney W. Grimes.Sh NAME
399b50d902SRodney W. Grimes.Nm lock
409b50d902SRodney W. Grimes.Nd reserve a terminal
419b50d902SRodney W. Grimes.Sh SYNOPSIS
428fe908efSRuslan Ermilov.Nm
4316a8de73SDima Dorfman.Op Fl npv
449b50d902SRodney W. Grimes.Op Fl t Ar timeout
459b50d902SRodney W. Grimes.Sh DESCRIPTION
46e8937ba0SPhilippe CharnierThe
47e8937ba0SPhilippe Charnier.Nm
48e8937ba0SPhilippe Charnierutility requests a password from the user, reads it again for verification
499b50d902SRodney W. Grimesand then will normally not relinquish the terminal until the password is
509b50d902SRodney W. Grimesrepeated.
519b50d902SRodney W. GrimesThere are two other conditions under which it will terminate: it
529b50d902SRodney W. Grimeswill timeout after some interval of time and it may be killed by someone
539b50d902SRodney W. Grimeswith the appropriate permission.
549b50d902SRodney W. Grimes.Pp
55f88e6136SPhilippe CharnierThe following options are available:
56f88e6136SPhilippe Charnier.Bl -tag -width indent
572280509cSOllivier Robert.It Fl n
582280509cSOllivier RobertDon't use a timeout value.  Terminal will be locked forever.
599b50d902SRodney W. Grimes.It Fl p
609b50d902SRodney W. GrimesA password is not requested, instead the user's current login password
619b50d902SRodney W. Grimesis used.
629b50d902SRodney W. Grimes.It Fl t Ar timeout
639b50d902SRodney W. GrimesThe time limit (default 15 minutes) is changed to
649b50d902SRodney W. Grimes.Ar timeout
659b50d902SRodney W. Grimesminutes.
6616a8de73SDima Dorfman.It Fl v
6716a8de73SDima DorfmanDisable switching virtual terminals while this terminal is locked.
6816a8de73SDima DorfmanThis option is implemented in a way similar to the
6916a8de73SDima Dorfman.Fl S
7016a8de73SDima Dorfmanoption of
7116a8de73SDima Dorfman.Xr vidcontrol 1 ,
72356168f5SMaxime Henrionand thus has the same restrictions.
73356168f5SMaxime HenrionIt is only available if the terminal in question is a
7416a8de73SDima Dorfman.Xr syscons 4
7516a8de73SDima Dorfmanvirtual terminal.
769b50d902SRodney W. Grimes.El
77356168f5SMaxime Henrion.Sh SEE ALSO
78356168f5SMaxime Henrion.Xr vidcontrol 1 ,
79356168f5SMaxime Henrion.Xr syscons 4
809b50d902SRodney W. Grimes.Sh HISTORY
819b50d902SRodney W. GrimesThe
828fe908efSRuslan Ermilov.Nm
839b50d902SRodney W. Grimescommand appeared in
849b50d902SRodney W. Grimes.Bx 3.0 .
85