LDAP Library Functions                      cldapsearchs(3LDAP)



NAME
     cldapsearchs - connectionless LDAP search

SYNOPSIS
     cc[ flag... ] file... -lldap[ library... ]
     #include 
     #include 

     int cldapsearchs(LDAP *ld, char *base, int scope, char *filter,
          char *attrs, int attrsonly, LDAPMessage **res, char *logdn);


DESCRIPTION
     The cldapsearchs() function performs an LDAP search  using
     the Connectionless LDAP (CLDAP) protocol.


     cldapsearchs() has parameters and  behavior  identical  to
     that of ldapsearchs(3LDAP), except for the addition of the
     logdn parameter.  logdn should contain a distinguished  name
     to be used only for logging purposed by the LDAP server.  It
     should be in the text format described by RFC 1779, A String
     Representation of Distinguished Names.

  Retransmission Algorithm
     cldapsearchs() operates  using  the  CLDAP  protocol  over
     udp(7P).  Since  UDP  is  a  non-reliable  protocol, a retry
     mechanism   is   used   to   increase    reliability.    The
     cldapsetretryinfo(3LDAP)  function  can  be used to set two
     retry parameters:  tries, a count of the number of times  to
     send  a  search request and timeout, an initial timeout that
     determines how long to wait for a response before re-trying.
     timeout  is  specified  seconds.  These values are stored in
     the ldcldaptries and ldcldaptimeout members of the ld LDAP
     structure,  and  the  default values set in ldapopen(3LDAP)
     are 4 and 3 respectively. The retransmission algorithm  used
     is:

     Step 1    Set  the  current   timeout   to   ldcldaptimeout
               seconds,  and  the  current LDAP server address to
               the   first   LDAP   server   found   during   the
               ldapopen(3LDAP) call.


     Step 2    Send the search request to the current LDAP server
               address.


     Step 3    Set  the  wait  timeout  to  the  current  timeout
               divided  by  the  number of server addresses found
               during ldapopen(3LDAP) or to one  second,  which-
               ever  is  larger.  Wait  at  most  that long for a



SunOS 5.11          Last change: 27 Jan 2002                    1






LDAP Library Functions                      cldapsearchs(3LDAP)



               response; if a response is  received,  STOP.  Note
               that  the  wait  timeout is always rounded down to
               the next lowest second.


     Step 4    Repeat steps 2 and 3 for each LDAP server address.


     Step 5    Set the current  timeout  to  twice  its  previous
               value  and  repeat  Steps 2 through 5 a maximum of
               tries times.


EXAMPLES
     Assume that the default values for tries and  timeout  of  4
     tries  and 3 seconds are used. Further, assume that a space-
     separated list of two hosts,  each  with  one  address,  was
     passed  to  cldapopen(3LDAP).  The pattern of requests sent
     will be (stopping as soon as a response is received):

         Time         Search Request Sent To:
          ]0               Host A try 1
          ]1  (0]3/2)      Host B try 1
          ]2  (1]3/2)      Host A try 2
          ]5  (2]6/2)      Host B try 2
          ]8  (5]6/2)      Host A try 3
          ]14 (8]12/2)     Host B try 3
          ]20 (14]12/2)    Host A try 4
          ]32 (20]24/2)    Host B try 4
          ]44 (20]24/2)    (give up - no response)


ERORS
     cldapsearchs() returns  LDAPSUCES if a search was  suc-
     cessful  and the appropriate LDAP error code otherwise.  See
     ldaperror(3LDAP) for more information.

ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:















SunOS 5.11          Last change: 27 Jan 2002                    2






LDAP Library Functions                      cldapsearchs(3LDAP)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
     Availability                 SUNWcsl (32-bit)            
                                  SUNWcslx (64-bit)           
     Interface Stability          Evolving                    
    


SEE ALSO
     ldap(3LDAP),    ldaperror(3LDAP),     ldapsearchs(3LDAP),
     cldapopen(3LDAP),                cldapsetretryinfo(3LDAP),
     cldapclose(3LDAP), attributes(5), udp(7P)











































SunOS 5.11          Last change: 27 Jan 2002                    3