This document tries to descrive the test in this directory. Most of these tests should be self-explanitory as they should be simple unit tests of the shipped modules (more unit tests are welcome). Since nss-pam-ldapd is meant for providing data from an LDAP server for some tests you should have an LDAP server and for even other tests you need to have nss-pam-ldapd installed (patches for using LD_PRELOAD or similar tricks instead are welcome). For this a test setup should be made (the tests are ignored if no such setup was detected). In my development environment I use a chroot jail with Debian. The instructions in this document assume a similar environment. TEST ENVIRONMENT ================ LDAP server configuration ------------------------- An LDAP server listening on ldap://localhost and ldapi:// is assumed. This is acomplished on Debian by the following line in /etc/default/slapd: SLAPD_SERVICES="ldap:/// ldaps:/// ldapi:///" Because there will be a lot of data in the database and to test paged results you need the following in /etc/ldap/slapd.conf: sizelimit size.prtotal=unlimited The LDAP server should be set up to service up the dc=test,dc=tld DN as base. A sample test.ldif file is also available. Note that this file is currently not shipped in the released tarballs because it is quite large. Load the file into your LDAP server so that it can be served. Most of the names in the database have been randomly generated based on a combination of name-lists that were found on the Internet. nsswitch.conf ------------- The /etc/nsswitch.conf file is expected to contain something like the following. All maps should be looked up through LDAP and some tests may expect the LDAP lookup to come after the files lookup. passwd: files ldap group: files ldap shadow: files ldap hosts: files ldap dns mdns networks: files ldap protocols: db files ldap services: db files ldap ethers: db files ldap rpc: db files ldap netgroup: files ldap aliases: files ldap nslcd.conf ---------- The /etc/nslcd.conf file is expected to be configured like the following. uid nslcd gid nslcd uri ldapi:/// base dc=test,dc=tld pagesize 100 timelimit 2 bind_timelimit 4 reconnect_sleeptime 4 reconnect_maxsleeptime 10 filter group (|(objectClass=posixGroup)(objectClass=groupOfUniqueNames)) OLD TESTS ========= There are also a lot of old test files in this directory. Those files are of the form test_.c. These files call the NSS module functions directly. These can probably all be removed and integrated into test_nsscmds.sh instead.