##
# $Id: README,v 1.4 1996/05/11 08:16:46 morgan Exp $
##
# $Log: README,v $
# Revision 1.4  1996/05/11 08:16:46  morgan
# added info about the new app rlogind
#
# Revision 1.3  1996/05/02 04:38:07  morgan
# removed test and vpass from make (source is still included) since they
# did not conform to any known standard!
# Added 'su' and 'passwd' suid0 programs.. Caution with respect to the
# security of any system you install these on!
#
# Revision 1.2  1996/04/14 18:26:15  morgan
# updated.. for xsh and su
#
# Revision 1.1  1996/03/10 19:12:26  morgan
# Initial revision
#
##

(now we are getting networked apps, be careful to try and test on a
securely isolated system!)

N=5 <-- blank xsh su passwd rlogind

Following a 'make install' (which should be done as root) in the
parent directory this directory will contain $N binaries. The source
for these programs is in ../apps and ../examples. They are various
short programs to use and otherwise test-drive the Linux-PAM
libraries/modules with.

Some of these programs grant no privileges, but they give an idea of
how well the modules are working.

blank is new as of Linux-PAM-0.21. If you are writing/modifying an
application it might be a place to start...

xsh is new as of Linux-PAM-0.31, it is identical to blank, but invokes
/bin/sh if the user is authenticated.

su (which comes with Linux-PAM-0.32) is a reasonably robust Linux-PAM
'su' program, to work it must be installed setuid root (this is
accomplished by the 'make install' command) ['su' is basically
completely finished, please email any bugs to me or the list if you
find any in this application. It is likely to find its way into a
public release!]

passwd (updated as of -0.33) is hopefully robust, but since 0.32 it
has become marginally incompatable with all of the existing
modules.. alas, such is the nature of progress!

rlogind (new with .33 -- courtesy of Al Longyear) as with everything
please test it--definitely alpha.

Best wishes

Andrew
(morgan@physics.ucla.edu)
