packages icon
xsecure is a console-locker that, when used with xfishtank,
metamorphosizes the user's screen into a veritable aquarium, in their
absence.

It may also be used as a simple locker, all by itself.

                          ....................

xsecure is a X client that has evolved through the mists of time
(dating back to when X10 was leading-edge technology (which, if I
recall correctly, was around the Silurian Period)) as a program
that simply grabs the keyboard and waits for the user to type-in the
password before restoring keyboard control back to normal.

However, if xsecure is given a process-id (like that of xfishtank) on
the command-line, it magically causes the aquarium-window to raise
itself and cover all the other windows, and then lock the keyboard and
mouse. When an acceptable password in entered, the aquarium lowers
itself behind all the other windows and continues to run.

Now, before you use xsecure with xfishtank, you have to make sure
that you are running the correct version of xfishtank.  I couldn't
get xfishtank to toggle mapping with the sigvec() system-call (OK I
admit it, I'm not *that* brilliant) so I used the signal() system-
call instead, (which is (more) portable and therefore correct), and
that certainly worked!

You need version of xfishtank that is patched to use signal(), to be
able to successfully lock your screen; the patch is provided.

Xt, the X Toolkit, is needed to build xsecure. xsecure was developed
under SunOS 4.1.1 running X11R4. It has been tested with X11R6 and
SunOS 4.1.1.

Eric Bina <ebina@ncsa.uiuc.edu>, was gracious enough to test xsecure
on Decstations, SGIs, and RS6000s (please thank him).

                          ....................

BUILDING THE DISTRIBUTION

The distribution contains:  
	Imakefile         Guess 
	Makefile          Guess again
	README            This masterpiece of prose
	xfish-patch       the patch for xfishtank
	xl                Shell script that automates the locking process
		              (understand what it does before using it!)
	xsecure.c         The source of all that is good
    xsecure.man       The man-page, obviously

After unpacking the distribution, type...

    xmkmf             to generate a Makefile (if you have imake installed), 
                      otherwise edit the supplied Makefile.

    make              builds the executable: xsecure.

                          ....................

PATCHING XFISHTANK

cd to the directory containing xfishtank source-code, then type:

	patch <xfish-patch

then type:

	make

Install the new version of xfishtank:

	make install

                          ....................


xsecure Release 2.1 Copyright 1994, Luis Fernandes <elf@ee.ryerson.ca>

Permission to enjoy, copy, hack, and distribute this software and its
documentation for any purpose, except for sale, and without fee is
hereby granted, provided that the above copyright notice appear in all
copies and that both that copyright notice and this permission notice
appear in supporting documentation.

This application is presented as is without any implied or written
warranty.