pamad - PAM authentication daemon

				Version 0.2

				2002-Mar-20


	Copyright (c) 2002 Thomas Liske. All rights reserved.
	This program is free software; you can redistribute it and/or
	modify it under the terms stated in the GNU Gerneral Public
	Lincense as published by the Free Software Foundation;
	either version 2, or (at your option) any later version.
	Please note that this program is distributed in the hope
	that it will be useful, but WITHOUT ANY WARRANTY; without
	even the implied warranty of MERCHANTABILITY or FITNESS
	FOR A PARTICULAR PURPOSE. See the GNU General Public
	License for more details.


DESCRIPTION
===========

This is a simple perl daemon which opens a unix-domain socket and waits
for connections. When a client connects he should write a PAM service
name, a user name and the users password to the socket (each followed
by a single newline). Clients could be a PHP script (or even every
other script language which provides unix-domain sockets support)
which needs a simple authentication w/o having native PAM support.

PREREQUISITES
=============

Before you can use pamad you need to have the perl package
Authen::PAM from Nikolay Pelov installed. You will find it
at http://www.cs.kuleuven.ac.be/~pelov/pam/ or at the CPAN
directory. The daemon was build around version 0.13 of
Authen::PAM.
At this time, I only have tested it on SuSE Linux 6.4 and
Debian GNU/Linux 3.0!

GET THE DAEMON
==============

Download it from this site:

Fri Mar 22 2002 v0.2 - pamad-0.2.tar.gz
Wed Mar 20 2002 v0.1 - pamad-0.1.tar.gz

INSTALLING THE DAEMON
=====================

Assuming you have the Authen::PAM mobule installed and running,
you only need to copy the pamad in you favorit directory (I suggest
using /usr/local/sbin/). The default configuration should meet
your demands, else you should copy the default config file pamad.conf
to /etc/ and edit it (if you want to rename or move it elsewhere,
you could use the parameter '-c config_file' when executing pamad so
it will find it). You also should create a directory for the
unix-domain socket file, default is /var/pamad/.
Finally you should make pamad started and stopped automaticly by
adding a runlevel script to /etc/init.d/ and some symlinks to some
runlevel directories - this depends on your linux distribution, maybe
you should take a look at whose documentation.

USING THE CLIENT
================

There is a PHP3 example (the client I wrote pamad for). Remember it is
a bad thing to enter sensible passwords (like root's) at your browser!

KNOWN PROBLEMS
==============

None at this time.

AUTHOR
======

  Thomas Liske <Thomas.Liske@web.de>