SLAPD-PERL(5) SLAPD-PERL(5)

NAME
       slapd-perl - Perl backend to slapd

SYNOPSIS
       /etc/openldap/slapd.conf

DESCRIPTION
       The  Perl  backend to ssllaappdd(8) works by embedding a ppeerrll(1) interpreter
       into ssllaappdd(8).  Any perl database section  of  the  configuration  file
       ssllaappdd..ccoonnff(5)  must  then  specify what Perl module to use.  SSllaappdd then
       creates a new Perl object that handles all the requests for  that  par-
       ticular instance of the backend.

       You will need to create a method for each one of the following actions:

         * new        # creates a new object,
         * search     # performs the ldap search,
         * compare    # does a compare,
         * modify     # modifies an entry,
         * add        # adds an entry to backend,
         * modrdn     # modifies an entry's rdn,
         * delete     # deletes an ldap entry,
         * config     # process unknown config file lines,
         * init       # called after backend is initialized.

       Unless otherwise specified, the methods return the  result  code  which
       will  be returned to the client.  Unimplemented actions can just return
       unwillingToPerform (53).

       nneeww    This method is called when the configuration file  encounters  a
              ppeerrllmmoodd  line.   The  module  in  that  line is then effectively
              `use'd into the perl interpreter, then the nneeww method is  called
              to  create  a  new object.  Note that multiple instances of that
              object may be instantiated, as with any perl  object.   The  nneeww
              method receives the class name as argument.

       sseeaarrcchh This method is called when a search request comes from a client.
              It arguments are as follows:
                * object reference
                * base DN
                * scope
                * alias deferencing policy
                * size limit
                * time limit
                * filter string
                * attributes only flag (1 for yes)
                * list of attributes to return (may be empty)

       Return value: (resultcode, ldif-entry, ldif-entry, ...)

       ccoommppaarree
              This method is called  when  a  compare  request  comes  from  a
              client.  Its arguments are as follows.
                * object reference
                * dn
                * attribute assertion string


       mmooddiiffyy This method is called when a modify request comes from a client.
              Its arguments are as follows.
                * object reference
                * dn
                * a list formatted as follows
                  ({ "ADD" | "DELETE" | "REPLACE" },
                   attributetype, value...)...


       aadddd    This method is called when a add request comes  from  a  client.
              Its arguments are as follows.
                * object reference
                * entry in string format


       mmooddrrddnn This method is called when a modrdn request comes from a client.
              Its arguments are as follows.
                * object reference
                * dn
                * new rdn
                * delete old dn flag (1 means yes)


       ddeelleettee This method is called when a delete request comes from a client.
              Its arguments are as follows.
                * object reference
                * dn


       ccoonnffiigg This  method  is called with unknown ssllaappdd..ccoonnff(5) configuration
              file lines.  Its arguments are as follows.
                * object reference
                * array of arguments on line

       Return value: nonzero if this is not a valid option.

       iinniitt   This method is called after backend is initialized.   Its  argu-
              ment is as follows.
                * object reference

       Return value: nonzero if initialization failed.

CCOONNFFIIGGUURRAATTIIOONN
       These  ssllaappdd..ccoonnff options apply to the PERL backend database.  That is,
       they must follow a "database perl" line and come before any  subsequent
       "backend" or "database" lines.  Other database options are described in
       the ssllaappdd..ccoonnff(5) manual page.

       ppeerrllMMoodduulleePPaatthh //ppaatthh//ttoo//lliibbss
              Add the path to the @INC variable.

       ppeerrllMMoodduullee MMooddNNaammee
              `Use' the module name ModName from ModName.pm

       ffiilltteerrSSeeaarrcchhRReessuullttss
              Search results are candidates that need to be filtered (with the
              filter  in the search request), rather than search results to be
              returned directly to the client.

EEXXAAMMPPLLEE
       There is an example Perl module `SampleLDAP'  in  the  slapd/back-perl/
       direcetory in the OpenLDAP source tree.

WWAARRNNIINNGG
       The  interface of this backend to the perl module MAY change.  Any sug-
       gestions would greatly be appreciated.

FILES       /etc/openldap/slapd.conf
              default slapd configuration file

SEE ALSO
       ssllaappdd..ccoonnff(5), ssllaappdd(8), ppeerrll(1).



OpenLDAP 2.2.19                   2004/11/26                     SLAPD-PERL(5)