1INSTALLATION
2============
3
4Dependencies
5------------------
6ppm is provided along with OpenLDAP sources. By default, it is available into contrib/slapd-modules.
7 - make sure both OpenLDAP sources and ppm are available for building.
8 - install cracklib development files if you want to test passwords against cracklib
9 - install pandoc if you want to build the man page
10
11
12Build
13-----
14Enter contrib/slapd-modules/ppm directory
15
16You can optionally customize some variables if you don't want the default ones:
17- prefix: prefix of the path where ppm is to be installed (defaults to /usr/local)
18- ldap_subdir: OpenLDAP specific subdirectory for modules and configurations (defaults to  openldap )
19- moduledir: where the ppm module is to be deployed (defaults to $prefix/$libexecdir/$ldap_subdir)
20- etcdir: used to compose default sysconfdir location (defaults to $prefix/etc)
21- sysconfdir: where the ppm example policy is to be deployed (defaults to $prefix/$etcdir/$ldap_subdir)
22- LDAP_SRC: path to OpenLDAP source directory
23- Options in OPTS variable:
24    CONFIG_FILE: (DEPRECATED) path to a ppm configuration file (see PPM_READ_FILE in ppm.h)
25        note: ppm configuration now lies into pwdCheckModuleArg password policy attribute
26              provided example file is only helpful as an example or for testing
27    CRACKLIB: if defined, link against cracklib
28    DEBUG: If defined, ppm logs its actions with syslog
29
30
31To build ppm, simply run these commands:
32(based upon the default prefix /usr/local of OpenLDAP)
33
34```
35make clean
36make
37make test
38make doc
39make install
40```
41
42Here is an illustrative example showing how to overload some options:
43
44```
45make clean
46make LDAP_SRC=../../.. prefix=/usr/local libdir=/usr/local/lib
47make test LDAP_SRC=../../..
48make doc prefix=/usr/local
49make install prefix=/usr/local libdir=/usr/local/lib
50```
51
52