				pam_smb v1.9.8
				==============
What is pam_smb?
=--------------=

pam_smb is a PAM module/daemon which allows authentication of UNIX users using an NT server. This version should be considered stable, and is an advance on 2.0 release without nice docs.


What's New in this version -- 1.9.8
=---------------------------------------=

1.9.x is a continuation of the old 1.3.x trees but with better version control,
as the old 1.3.x trees got very hard to follow. The 1.9 version is roadmapped
to v2.0 which will contain proper caching, username mapping and multiple domain
support. It will use a samba username map also. 

The current release uses use the samba tdb code from Andrew Tridgell.

1.9.x unlike 1.3 doesn't require the use of the external database for
mapping, this code is internal now, all that is needed is a samba style 
username map.


GETTING + INSTALLATION + CONFIGURATION
=------------------------------------=
Please see the INSTALL file.

BUGS
=--=
There maybe some problems with the 1.9.x series, that will be fixed
before 2.0 is released, please see the BUGS file for details.

Where did pam_smb come from?
=--------------------------=

The module is a hacked together version of smblib-0.50, smb-NT-verify, the pam_unix_auth module, and changes made by myself to allow Domain logons and 
other stuff.

The original authors of many of the parts were:

Andrew Morgan <morgan@parc.power.net> -- the Linux PAM project person, and 
writer of the pam_unix_auth.c module.

Richard Sharpe <sharpe@nmesis.enet.dec.com> -- the author of smblib which I
have used a lot of directly.

Christopher Burke <c.burke@mindware.com.au> -- the author of smb-NT-valid
from which I took the validation routine.

The encryption routine and tdb database code is taken straight from samba and is copyright Andrew Tridgell (author of samba).

The username mapping code was written by Andrew Speer(aspeer@isolutions.com.au) for the original module only pam_smb, and I have tried to re-use as it for the client-server.

The caching idea came from David Jordan (david.jordan@webbins.co.uk), he
wrote code to make this work under the original pam_smb, I have taken his ideas
on board.

Thanks to mirko.dziadzka@systor.com for finding the guest problem,
I had no proper testing abilities here....

Is there any known bugs in pam_smb?
=---------------------------------=

In all version up to 1.1 there is a bug with login that when pam_smb is
used login can under some circumstances segfault --

This bug is now a bug in login.c a patch to login.c from util-linux
is available on the primary site for pam_smb.

Contact Information
=-----------------=
This software is released under the GPL as found in the COPYING file
enclosed.

Any Questions to the author at airlied@samba.org
	
Dave Airlie
http://www.skynet.ie/~airlied
