Configuration and Installation of qmail-ldapam
==============================================

LDAP REQUIREMENTS
-----------------

1. Check the installation of the OpenLDAP library on your system.
   Version 2.4 is required here (at least).
2. Check the location of the LDAP header files and the libldap.
3. The file conf-ldap is suited to cope with these settings; 
   some samples are provided therein.
   Under most Linux system, header files and the 
   libldap are found in the default path.
4. However, you may need to install the 
   'libldap2-dev' package (eg. for Debian).
   Check your OS!
5. If the libldap is outside the search-path of your system loader,
   you may need to provide this location in 
   conf-ld by means of the '-R path'.


HOW TO INSTALL (with slashpackage)
----------------------------------

- qmail-ldapam uses D.J.B's slashpackage convention:
  * untar the qmail-ldapam tar file under '/package'
  * Move to /package/mail/qmail-ldapam-V.R(.F)
  and go on with COMMON CONFIGURATION STEPS.


HOW TO INSTALL (without slashpackage)
-------------------------------------

- Untar the file qmail-ldapam-V.R(.F)
  typically at /usr/local/src.
- Move to the mail/qmail-ldapam-V.R(.F) directory.


COMMON CONFIGURATION STEPS
--------------------------

- Adjust 
  * conf-home 
  to point to your qmail home
  directory (typically /var/qmail).
- Adjust 
  * conf-qlibs 
  to point to the fehQlibs.
  Typically, they are provided as link:
  /usr/local/qlibs -> /usr/local/fehQlibs-XYZ.
- Modify 
  * conf-cc 
  to your needs (perhaps).
- Modify 
  * conf-ld
  If you use a custom OpenLDAP installation 
  the relocation option -R is needed.
- Adjust 
  * conf-ldap 
  according to your system settings. 
  If those are default, nothing need to be done.


EXECUTE INSTALLATION
--------------------

- As 'root' call 
  * package/install

Alternatively:

- Step-by-step (as root):
  * package/compile
  * package/man
  * package/upgrade

- If you want to inform me about the result, call
  * package/report


RESULT AND FURTHER SETTINGS
---------------------------

If you have executed
- package/install 
  the binary qmail-ldapam will be installed at:
  * (conf-home)/bin
  * /usr/local/bin

If you have executed
- package/upgrade,
  the binary qmail-ldapam will be installed at:
  * /usr/local/bin
  only.

Read
- man qmail-ldapam

You need to populate the file
- (conf-home)/control/ldapbind

with the settings of your LDAP servers for binding.


ADDITIONAL NOTES
----------------

- The modules md5c.s, sha1.c, sha256,
  hmac_md5.c and digest_md5.c are not used yet.
- In forthcoming version this may change.

Caution: There are dragons, living the the LDAP DIT.

Date: October, 3rd 2026 (feh)