Building and installing

python-ldap is built and installed using the Python DistUtils installed along with your Python installation:

python setup.py build
python setup.py install

If you have more than one Python interpreter installed locally you should use the same one you plan to use python-ldap with.

See further instructions for using DistUtils here: http://docs.python.org/install/index.html

Prerequisites

The following software packages are required to be installed on the local system when building python-ldap:

Furthermore some sub-modules of ldap.controls and ldap.extop require pyasn1 and pyasn1_modules to be installed.

setup.cfg

The file setup.cfg allows to set some build and installation parameters for reflecting the local installation of required software packages. Only section [_ldap] is described here. More information about other sections can be found in the documentation of Python’s DistUtils.

library_dirs

Specifies in which directories to search for required libraries.

include_dirs

Specifies in which directories to search for include files of required libraries.

libs

A space-separated list of library names to link to (see Libs used).

extra_compile_args

Compiler options.

extra_objects

Libs used

ldap
ldap_r

The LDAP protocol library of OpenLDAP. ldap_r is the reentrant version and should be preferred.

lber

The BER encoder/decoder library of OpenLDAP.

sasl2

The Cyrus-SASL library if needed and present during build

ssl

The SSL/TLS library of OpenSSL if needed and present during build

crypto

The basic cryptographic library of OpenSSL if needed and present during build

Example

The following example is for a full-featured build (including SSL and SASL support) of python-ldap with OpenLDAP installed in a different prefix directory (here /opt/openldap-2.3) and SASL header files found in /usr/include/sasl. Debugging symbols are preserved with compile option -g.

[_ldap]
library_dirs = /opt/openldap-2.3/lib
include_dirs = /opt/openldap-2.3/include /usr/include/sasl

extra_compile_args = -g
extra_objects =

libs = ldap_r lber sasl2 ssl crypto

Table Of Contents

Previous topic

python-ldap Documentation

Next topic

ldap LDAP library interface module

This Page