vlock-plugins(5) [suse man page]

VLOCK-PLUGINS(5)					     Linux Programmer's Manual						  VLOCK-PLUGINS(5)

NAME

       vlock-plugins - plugin support for vlock

DESCRIPTION

       If  vlock-main(8)  is  compiled with plugin support its default features are very limited: it can only lock the current session and ask for
       authenticiaton.	However it is possible to extend this functions through plugins.  These plugins are loaded when vlock-main starts and  can
       provide hooks that are called at certain points during the lifetime of the vlock-main process.

DEFAULT PLUGINS

       The following plugins are provided when installing vlock with default options:

       all

	      This plugin locks all sessions by disabling console switching.  It is also loaded when giving the -a,--all option to vlock(1).

       new

	      This  plugin  switches to a new virtual console before disabling console switching through the "all" plugin.  It is also loaded when
	      giving the -n,--new option to vlock(1).

       nosysrq

	      Linux only.  This plugin disables the Linux SysRQ mechanism before the console switching is locked by the "all" plugin.  It is  also
	      loaded when giving the -s,--disable-sysrq option to vlock(1).

ADDITIONAL PLUGINS

       The following plugins are only available if explicitely selected at build time:

       caca

	      This plugin runs a random libcaca screensaver when the screen is locked.

WRITING PLUGINS

       For information about writing plugins see the PLUGINS file in the vlock source distribution.

SEE ALSO

       vlock(1), vlock-main(8)

AUTHORS

       Frank Benkstein <frank-vlock@benkstein.net>

Linux								 10 November 2007						  VLOCK-PLUGINS(5)

VLOCK(1)						      General Commands Manual							  VLOCK(1)

NAME

       vlock - Virtual Console lock program

SYNOPSIS

       vlock

       vlock [ -a,--all ] [ -c,--current ] [ -h,--help ] [ -v,--version ]

DESCRIPTION

       vlock  is  a  program  to lock one or more sessions on the Linux console.  This is especially useful for Linux machines which have multiple
       users with access to the console.  One user may lock his or her session(s) while still allowing other users to use the system on other vir-
       tual consoles.  If desired, the entire console may be locked and virtual console switching disabled.

       By  default,  only  the	current  VC  (virtual  console)  is locked.  With the -a,-all option all VCs are locked.  The locked VCs cannot be
       unlocked without the invoker's password.  And, for the paranoid, vlock makes it a trying experience for those attempting to guess the pass-
       word, so unauthorized access to session(s) is highly unlikely.

       Please  note  that  it  is entirely possible to completely lock yourself out of the console with the -a,--all option if you cannot remember
       your password!  Unless you are able to kill vlock by logging in remotely via a serial terminal or network, a hard reset is the only  method
       of ``unlocking'' the display.

       vlock  works  for  console sessions primarily.  However, there is support for trying to lock non-console sessions as well, but that support
       has not been well tested.

OPTIONS

       -a,--all

	      Lock all console sessions and disable VC switching.

       -c,--current

	      Lock the current session (this is the default).

       -h,--help

	      Print a brief help message.

       -v,--version

	      Print the version number of vlock.

AUTHOR

       Michael K. Johnson <johnsonm@redhat.com>

Linux User's Manual						    16 May 1996 							  VLOCK(1)