vlock-main - lock current virtual console
vlock-main is part of vlock(1), the Virtual Console locking
program for Linux. It locks the current session and will only exit if the
current user can authenticate themselves. The root user will also be able to
unlock the session, unless disabled at compile time. The command line
arguments specify plugins that should be loaded by vlock-main. See
vlock-plugins(5) for more information.
If plugin support is disabled at compile time, the only supported
argument is "all".
The following environment variables can be used to change the
behavior of vlock-main:
USER
- If this variable is when vlock-main is run as root (uid 0) vlock locks the
screen as this user instead of root. The root password will still be able
to unlock the session, unless disabled at compile time.
VLOCK_ALL_MESSAGE
- If this variable is set and all consoles are locked its contents will be
used as the locking message instead of the default message.
VLOCK_CURRENT_MESSAGE
- If this variable is set and only the current consoles is locked its
contents will be used as the locking message instead of the default
message.
VLOCK_MESSAGE
- If this variable is set its contents will be used as the locking message
instead of the default. This overrides the former two variables.
VLOCK_TIMEOUT
- Set this variable to specify the timeout (in seconds) after which the
screen saver plugins (if any) will be invoked. If this variable is unset
or set to an invalid value or 0 no timeout is used. See vlock-plugins(5)
for more information about plugins.
VLOCK_PROMPT_TIMEOUT
- Set this variable to specify the amount of time (in seconds) you will have
to enter your password at the password prompt. If this variable is unset
or set to an invalid value or 0 no timeout is used. Warning: If
this value is too low, you may not be able to unlock your session.
Several signals are ignored. vlock-main will try to exit
cleanly if SIGTERM is received.
Frank Benkstein <frank-vlock@benkstein.net>