bionic (8) vlock-main.8.gz

Provided by: vlock_2.2.2-8_amd64 bug

NAME

       vlock-main - lock current virtual console

SYNOPSIS

       vlock-main [plugins...]

DESCRIPTION

       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".

ENVIRONMENT VARIABLES

       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.

SIGNALS

       Several signals are ignored.  vlock-main will try to exit cleanly if SIGTERM is received.

SEE ALSO

       vlock(1), vlock-plugins(5)

AUTHORS

       Frank Benkstein <frank-vlock@benkstein.net>