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.

OpenLDAP 2.6.9+dfsg-2ubuntu1                       2024/11/26                                    SLAPD.PLUGIN(5)