$Id: README,v 1.8 2003/02/19 22:52:06 peterw Exp $
This is a bsd auth module for authenticating users off an LDAP server. It was
written by Peter Werner <peterw@ifost.org.au>. 

James R. Phillips <jamesp@webdaemons.org> wrote the man page and provided
invaluble advice.

Markus Friedl <Markus_Friedl@genua.de> sent changes to make it work on BSD/OS
and Microsoft Active Directory as well as some general improvements

Some other people who have made contributions include:

Shaun O'Meara
Francis Potter 
Sebastian Stark
Chris Maxwell

It requires the OpenLDAP libraries installed, these are available in the
OpenBSD ports tree. If you install the OpenLDAP server or just the clients
these will be installed.

As of version 3.3, login_ldap no longer installs setuid root, if this causes
problems, please let me (Peter Werner) know. It is believed the suid bit is
not required to be set, but local settings may require it.

It should work with any LDAP server. It is know to work with the following
servers:

OpenLDAP 2.0.x 
OpenLDAP 2.1.x
Active Directory

If you use it successfully with a different LDAP server please mail  
peterw@ifost.org.au so i can update the list in this file and at
http://www.ifost.org.au/~peterw/

Kerberos and SASL support is not present, mainly due to issues with the
underlying libraries.

please see the INSTALL section below for directions of installation

Please visit http://www.ifost.org.au.
For general questions mail peterw@ifost.org.au
For information on commercial support please mail gregb@ifost.org.au

INSTALL
-------

# make
# make install
# man login_ldap
# more /usr/local/share/login_ldap/login_ldap.conf

- Peter Werner <peterw@ifost.org.au> 27/6/02
