Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

VLOCK-MAIN(8)		   Linux Programmer's Manual		 VLOCK-MAIN(8)

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 argu‐
       ment 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 pass‐
	      word 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  mes‐
	      sage.

       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 time‐
	      out 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 time‐
	      out 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>

Linux				 28 July 2007			 VLOCK-MAIN(8)

Vote for polarhome