--- 		     LOCKVC 3.00 (c) 1994,1995,1997 by Matthias Straub 	   --- 
--- 		     this package was released under GPL	  	   ---
---		     see COPYING for details				   ---

	0. Introduction
	1. Installation
	2. Usage
	3. Changes
	4. Goals
	5. Problems
	6. Known Bugs
	7. Thanks


0. INTRODUCTION
	
	You're familiar with the situation:
	You leave your computer alone to get a bottle of the world's most
	famous soft drink, and when you come back, your terminal's taken,
	your data's lost, your resources destroyed, and the system's
	admin is asking you about those postings you've made on
	alt.binaries.pictures.erotica.
	Now it is too late to be sorry. You should have known better:
	This happened a thousand times before.
	Until now...

	LockVC is a  console-locking-program  combined  with  some
	nifty  vga-screensavers. The version at this date (Nov 97)
	is 3.0.  Executing LockVC on a virtual console brings up a
	randomly  chosen vga-screensaver (that doesn't really save
	your screen, though).  To select a screensaver, run lockvc
	-help for a complete list.

	All virtual consoles get locked, i.e. you cannot change to
	another VC and you can't stop the program by pressing any key-combos 
	(apart from ctrl-alt-delete, if not disabled by your admin).
	You can only exit the program by entering your system-password.
	Root's password will also terminate lockvc.
	The amount of time, that the VCs can be locked may be limited by
	your system's admin, this will be displayed on executing lockvc.
	If you fail to exit lockvc within this time, lockvc will
	terminate all your processes and log you out.
	
	Svgalib is required on your system and lockvc  has  to  be
	run  with  root-privileges.  Only  standard  vga-modes are
	used. This should work on any reasonable machine.

1. INSTALLATION

	+ This package comes with an ELF-executable. If you don't trust me,
	  you can type 'make' to compile and link the source.
	  If you want shadow-password support, take a look at the makefile.
	
	+ Get yourself root privileges and run 'make install'.
	  lockvc will be placed in '/usr/local/bin' unless 
	  stated differently in the makefile.
	
	+ If you want to limit the time the console can be locked by your
	  users, create '/etc/maxlock' and write the number of minutes
	  after which a user gets kicked out into the first line.
	  (see the sample maxlock-file)

	+ add an alias like ' alias lockstars="lockvc stars 1000 8" '
	  to your global profile to set the default values for your machine.

2. USAGE

	+ see 'lockvc -help' for that.

 
3. CHANGES in version 1.6

	+ About 60% faster starfield-routine than in the previous
	  version. Therefor new default-values 500 9.
	
	+ Double-buffering for less flickering.
	
	+ lockvc now uses the user's system password as key.

	+ Option for root to limit the allowed time the console
	  can be locked by regular users.
   
   CHANGES in version 1.7
 
	+ some minor bugs removed

	+ Shadow-password option added by Ed Beaumont

   CHANGES in version 1.8

	+ double-length shadow-passwords and
	  passwords including spaces now work

	+ faster on 386, 486 due to integer math
	  derived from a patch by Jeff Epler
	  
   CHANGES in version 1.9
   
        + renamed uname -> uName, because uname is used in ELF 
	  include-files. 

   CHANGES in version 2.01b

	+ post-termination-console-echo-screw-up fixed
 
   CHANGES in version 3.0

	+ All new. All better. Turned to a modular concept that
	  allowed to include all available vga-routines into
	  one executable.

	+ Added a 'Fire'-saver and a 'Fudge'-kinda-wobbling-picture-saver


4. GOALS for upcoming versions
	
	+ getting rid of the kernel-standard-screenblanker
	  and letting lockvc be the screensaver instead.
	
	+ additional screensavers to avoid boredom.

	+ leave some cpu-time to the rest of the system

5. PROBLEMS

	If for any reason lockvc refuses to terminate on a valid 
	password or key, you can still login remotely and kill 
	the lockvc-process, or reboot your system.


6. KNOWN BUGS

	eats up all cpu-time :(

7. THANKS go to 

	Harm Hanemaayer and Tommy Frandsen, the implementors of (s)vgalib
	who provided us with a great graphics-library.

	Lars Johannsen for his support.

	Ed Beaumont <morlok@abyss.apana.org.au> for the shadow-password
	routines and the man-page.

	<unknown> for the Linux-Shark-Picture (in the fudge-saver)

   Additional thanks for patches and bugfixes go to:

	Jeff Obik Epler <jepler@herbie.unl.edu>  
	Janusz Zamecki <janusz@sprocket.ict.pwr.wroc.pl>
	Sam <slouken@virtbrew.water.ca.gov>    
	Andreas Kies <andi@andiunx.m.isar.de> 
	Jeong-Ho Lee <jhlee@math.wisc.edu>
	Marc Merlin <merlin@efrei.fr>

--

Matthias Straub, s_straub@ira.uka.de
Universitaet Karlsruhe, Germany
