NAME

       slapd.plugin - plugin configuration for slapd, the stand-alone LDAP daemon

SYNOPSIS

       /etc/ldap/slapd.conf

DESCRIPTION

       The  slapd.conf(5)  file  contains configuration information for the slapd(8) daemon. This
       configuration file is also used by the SLAPD tools slapadd(8), slapcat(8),  slapmodify(8),
       and slapindex(8).

       The  slapd.conf  file  consists  of a series of global configuration options that apply to
       slapd as a whole (including all backends), followed  by  zero  or  more  database  backend
       definitions that contain information specific to a backend instance.

       The general format of slapd.conf is as follows:

           # comment - these options apply to every database
           <global configuration options>
           # first database definition & configuration options
           database    <backend 1 type>
           <configuration options specific to backend 1>
           # subsequent database definitions & configuration options
           ...

       If  slapd  is  compiled  with  --enable-slapi, support for plugins according to Netscape's
       Directory Server Plug-Ins.  Version 4 of the  API  is  currently  implemented,  with  some
       extensions from version 5.

       Both global and database specific data may contain plugin information.  Plugins associated
       with a specific database are called before  global  plugins.   This  manpage  details  the
       slapd(8) configuration statements that affect the loading of SLAPI plugins.

       Arguments that should be replaced by actual text are shown in brackets <>.

       The structure of the plugin directives is

       plugin <type> <lib_path> <init_function> [<arguments>]
              Load a plugin of the specified type for the current database.

       The  <type>  can  be one of preoperation, that is executed before processing the operation
       for the specified database, postoperation, that is executed after the  operation  for  the
       specified database has been processed, extendedop, that is used when executing an extended
       operation, or object.  The latter is used for miscellaneous types such  as  ACL,  computed
       attribute and search filter rewriter plugins.

       The  <libpath>  argument  specifies  the path to the plugin loadable object; if a relative
       path is given, the object is looked  for  according  to  the  underlying  dynamic  loading
       package (libtool's ltdl is used).

       The <init_function> argument specifies what symbol must be called when the plugin is first
       loaded.  This function should register the  functions  provided  by  the  plugin  for  the
       desired  operations. It should be noted that it is this init function, not the plugin type
       specified as the first argument, that determines when and for what operations  the  plugin
       will be invoked.  The optional <arguments> list is passed to the init function.

       pluginlog <file>
              Specify an alternative path for the plugin log file (default is /var/errors).

       modulepath <pathspec>
              This  statement  sets  the  module  load path for dynamically loadable backends, as
              described in slapd.conf(5); however, since both the dynamically  loadable  backends
              and  the  SLAPI  plugins use the same underlying library (libtool's ltdl) its value
              also affects the plugin search path.  In general the search path is made of  colon-
              separated paths; usually the user-defined path is searched first; then the value of
              the LTDL_LIBRARY_PATH environment variable,  if  defined,  is  used;  finally,  the
              system-specific  dynamic  load  path  is  attempted (e.g. on Linux the value of the
              environment variable LD_LIBRARY_PATH).  Please carefully read the documentation  of
              ltdl because its behavior is very platform dependent.

FILES

       /etc/ldap/slapd.conf
              default slapd configuration file

       /var/errors
              default plugin log file

SEE ALSO

       slapd(8),

       "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)

ACKNOWLEDGEMENTS

       OpenLDAP    Software    is    developed   and   maintained   by   The   OpenLDAP   Project
       <http://www.openldap.org/>.  OpenLDAP Software is derived from the University of  Michigan
       LDAP 3.3 Release.