git.sur5r.net Git - openldap/blob - servers/slapd/back-ldap/back-ldap.h

   1 /* back-ldap.h - ldap backend header file */
   2 /* $OpenLDAP$ */
   3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
   4  *
   5  * Copyright 1999-2007 The OpenLDAP Foundation.
   6  * Portions Copyright 2000-2003 Pierangelo Masarati.
   7  * Portions Copyright 1999-2003 Howard Chu.
   8  * All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted only as authorized by the OpenLDAP
  12  * Public License.
  13  *
  14  * A copy of this license is available in the file LICENSE in the
  15  * top-level directory of the distribution or, alternatively, at
  16  * <http://www.OpenLDAP.org/license.html>.
  17  */
  18 /* ACKNOWLEDGEMENTS:
  19  * This work was initially developed by the Howard Chu for inclusion
  20  * in OpenLDAP Software and subsequently enhanced by Pierangelo
  21  * Masarati.
  22  */
  23
  24 #ifndef SLAPD_LDAP_H
  25 #define SLAPD_LDAP_H
  26
  27 LDAP_BEGIN_DECL
  28
  29 struct ldapinfo_t;
  30
  31 enum {
  32         /* even numbers are connection types */
  33         LDAP_BACK_PCONN_FIRST = 0,
  34         LDAP_BACK_PCONN_ROOTDN = LDAP_BACK_PCONN_FIRST,
  35         LDAP_BACK_PCONN_ANON = 2,
  36         LDAP_BACK_PCONN_BIND = 4,
  37
  38         /* add the TLS bit */
  39         LDAP_BACK_PCONN_TLS = 0x1U,
  40
  41         LDAP_BACK_PCONN_ROOTDN_TLS = (LDAP_BACK_PCONN_ROOTDN|LDAP_BACK_PCONN_TLS),
  42         LDAP_BACK_PCONN_ANON_TLS = (LDAP_BACK_PCONN_ANON|LDAP_BACK_PCONN_TLS),
  43         LDAP_BACK_PCONN_BIND_TLS = (LDAP_BACK_PCONN_BIND|LDAP_BACK_PCONN_TLS),
  44
  45         LDAP_BACK_PCONN_LAST
  46 };
  47
  48 typedef struct ldapconn_t {
  49         Connection              *lc_conn;
  50 #define LDAP_BACK_CONN2PRIV(lc)         ((unsigned long)(lc)->lc_conn)
  51 #define LDAP_BACK_PCONN_ISPRIV(lc)      ((void *)(lc)->lc_conn >= (void *)LDAP_BACK_PCONN_FIRST \
  52                                                 && (void *)(lc)->lc_conn < (void *)LDAP_BACK_PCONN_LAST)
  53 #define LDAP_BACK_PCONN_ISROOTDN(lc)    (LDAP_BACK_PCONN_ISPRIV((lc)) \
  54                                                 && (LDAP_BACK_CONN2PRIV((lc)) < LDAP_BACK_PCONN_ANON))
  55 #define LDAP_BACK_PCONN_ISANON(lc)      (LDAP_BACK_PCONN_ISPRIV((lc)) \
  56                                                 && (LDAP_BACK_CONN2PRIV((lc)) < LDAP_BACK_PCONN_BIND) \
  57                                                 && (LDAP_BACK_CONN2PRIV((lc)) >= LDAP_BACK_PCONN_ANON))
  58 #define LDAP_BACK_PCONN_ISBIND(lc)      (LDAP_BACK_PCONN_ISPRIV((lc)) \
  59                                                 && (LDAP_BACK_CONN2PRIV((lc)) >= LDAP_BACK_PCONN_BIND))
  60 #define LDAP_BACK_PCONN_ISTLS(lc)       (LDAP_BACK_PCONN_ISPRIV((lc)) \
  61                                                 && (LDAP_BACK_CONN2PRIV((lc)) & LDAP_BACK_PCONN_TLS))
  62 #define LDAP_BACK_PCONN_ID(lc)          (LDAP_BACK_PCONN_ISPRIV((lc)) ? \
  63                                                 ( -1 - (long)(lc)->lc_conn ) : (lc)->lc_conn->c_connid )
  64 #ifdef HAVE_TLS
  65 #define LDAP_BACK_PCONN_ROOTDN_SET(lc, op) \
  66         ((lc)->lc_conn = (void *)((op)->o_conn->c_is_tls ? (void *) LDAP_BACK_PCONN_ROOTDN_TLS : (void *) LDAP_BACK_PCONN_ROOTDN))
  67 #define LDAP_BACK_PCONN_ANON_SET(lc, op) \
  68         ((lc)->lc_conn = (void *)((op)->o_conn->c_is_tls ? (void *) LDAP_BACK_PCONN_ANON_TLS : (void *) LDAP_BACK_PCONN_ANON))
  69 #define LDAP_BACK_PCONN_BIND_SET(lc, op) \
  70         ((lc)->lc_conn = (void *)((op)->o_conn->c_is_tls ? (void *) LDAP_BACK_PCONN_BIND_TLS : (void *) LDAP_BACK_PCONN_BIND))
  71 #else /* ! HAVE_TLS */
  72 #define LDAP_BACK_PCONN_ROOTDN_SET(lc, op) \
  73         ((lc)->lc_conn = (void *)LDAP_BACK_PCONN_ROOTDN)
  74 #define LDAP_BACK_PCONN_ANON_SET(lc, op) \
  75         ((lc)->lc_conn = (void *)LDAP_BACK_PCONN_ANON)
  76 #define LDAP_BACK_PCONN_BIND_SET(lc, op) \
  77         ((lc)->lc_conn = (void *)LDAP_BACK_PCONN_BIND)
  78 #endif /* ! HAVE_TLS */
  79 #define LDAP_BACK_PCONN_SET(lc, op) \
  80         (BER_BVISEMPTY(&(op)->o_ndn) ? \
  81                 LDAP_BACK_PCONN_ANON_SET((lc), (op)) : LDAP_BACK_PCONN_ROOTDN_SET((lc), (op)))
  82
  83         LDAP                    *lc_ld;
  84         struct berval           lc_cred;
  85         struct berval           lc_bound_ndn;
  86         struct berval           lc_local_ndn;
  87         unsigned                lc_lcflags;
  88 #define LDAP_BACK_CONN_ISSET_F(fp,f)    (*(fp) & (f))
  89 #define LDAP_BACK_CONN_SET_F(fp,f)      (*(fp) |= (f))
  90 #define LDAP_BACK_CONN_CLEAR_F(fp,f)    (*(fp) &= ~(f))
  91 #define LDAP_BACK_CONN_CPY_F(fp,f,mfp) \
  92         do { \
  93                 if ( ((f) & *(mfp)) == (f) ) { \
  94                         *(fp) |= (f); \
  95                 } else { \
  96                         *(fp) &= ~(f); \
  97                 } \
  98         } while ( 0 )
  99
 100 #define LDAP_BACK_CONN_ISSET(lc,f)      LDAP_BACK_CONN_ISSET_F(&(lc)->lc_lcflags, (f))
 101 #define LDAP_BACK_CONN_SET(lc,f)        LDAP_BACK_CONN_SET_F(&(lc)->lc_lcflags, (f))
 102 #define LDAP_BACK_CONN_CLEAR(lc,f)      LDAP_BACK_CONN_CLEAR_F(&(lc)->lc_lcflags, (f))
 103 #define LDAP_BACK_CONN_CPY(lc,f,mlc)    LDAP_BACK_CONN_CPY_F(&(lc)->lc_lcflags, (f), &(mlc)->lc_lcflags)
 104
 105 /* 0xFFF00000U are reserved for back-meta */
 106
 107 #define LDAP_BACK_FCONN_ISBOUND (0x00000001U)
 108 #define LDAP_BACK_FCONN_ISANON  (0x00000002U)
 109 #define LDAP_BACK_FCONN_ISBMASK (LDAP_BACK_FCONN_ISBOUND|LDAP_BACK_FCONN_ISANON)
 110 #define LDAP_BACK_FCONN_ISPRIV  (0x00000004U)
 111 #define LDAP_BACK_FCONN_ISTLS   (0x00000008U)
 112 #define LDAP_BACK_FCONN_BINDING (0x00000010U)
 113 #define LDAP_BACK_FCONN_TAINTED (0x00000020U)
 114 #define LDAP_BACK_FCONN_ABANDON (0x00000040U)
 115 #define LDAP_BACK_FCONN_ISIDASR (0x00000080U)
 116 #define LDAP_BACK_FCONN_CACHED  (0x00000100U)
 117
 118 #define LDAP_BACK_CONN_ISBOUND(lc)              LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_ISBOUND)
 119 #define LDAP_BACK_CONN_ISBOUND_SET(lc)          LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_ISBOUND)
 120 #define LDAP_BACK_CONN_ISBOUND_CLEAR(lc)        LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_ISBMASK)
 121 #define LDAP_BACK_CONN_ISBOUND_CPY(lc, mlc)     LDAP_BACK_CONN_CPY((lc), LDAP_BACK_FCONN_ISBOUND, (mlc))
 122 #define LDAP_BACK_CONN_ISANON(lc)               LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_ISANON)
 123 #define LDAP_BACK_CONN_ISANON_SET(lc)           LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_ISANON)
 124 #define LDAP_BACK_CONN_ISANON_CLEAR(lc)         LDAP_BACK_CONN_ISBOUND_CLEAR((lc))
 125 #define LDAP_BACK_CONN_ISANON_CPY(lc, mlc)      LDAP_BACK_CONN_CPY((lc), LDAP_BACK_FCONN_ISANON, (mlc))
 126 #define LDAP_BACK_CONN_ISPRIV(lc)               LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_ISPRIV)
 127 #define LDAP_BACK_CONN_ISPRIV_SET(lc)           LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_ISPRIV)
 128 #define LDAP_BACK_CONN_ISPRIV_CLEAR(lc)         LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_ISPRIV)
 129 #define LDAP_BACK_CONN_ISPRIV_CPY(lc, mlc)      LDAP_BACK_CONN_CPY((lc), LDAP_BACK_FCONN_ISPRIV, (mlc))
 130 #define LDAP_BACK_CONN_ISTLS(lc)                LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_ISTLS)
 131 #define LDAP_BACK_CONN_ISTLS_SET(lc)            LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_ISTLS)
 132 #define LDAP_BACK_CONN_ISTLS_CLEAR(lc)          LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_ISTLS)
 133 #define LDAP_BACK_CONN_ISTLS_CPY(lc, mlc)       LDAP_BACK_CONN_CPY((lc), LDAP_BACK_FCONN_ISTLS, (mlc))
 134 #define LDAP_BACK_CONN_BINDING(lc)              LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_BINDING)
 135 #define LDAP_BACK_CONN_BINDING_SET(lc)          LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_BINDING)
 136 #define LDAP_BACK_CONN_BINDING_CLEAR(lc)        LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_BINDING)
 137 #define LDAP_BACK_CONN_TAINTED(lc)              LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_TAINTED)
 138 #define LDAP_BACK_CONN_TAINTED_SET(lc)          LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_TAINTED)
 139 #define LDAP_BACK_CONN_TAINTED_CLEAR(lc)        LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_TAINTED)
 140 #define LDAP_BACK_CONN_ABANDON(lc)              LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_ABANDON)
 141 #define LDAP_BACK_CONN_ABANDON_SET(lc)          LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_ABANDON)
 142 #define LDAP_BACK_CONN_ABANDON_CLEAR(lc)        LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_ABANDON)
 143 #define LDAP_BACK_CONN_ISIDASSERT(lc)           LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_ISIDASR)
 144 #define LDAP_BACK_CONN_ISIDASSERT_SET(lc)       LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_ISIDASR)
 145 #define LDAP_BACK_CONN_ISIDASSERT_CLEAR(lc)     LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_ISIDASR)
 146 #define LDAP_BACK_CONN_ISIDASSERT_CPY(lc, mlc)  LDAP_BACK_CONN_CPY((lc), LDAP_BACK_FCONN_ISIDASR, (mlc))
 147 #define LDAP_BACK_CONN_CACHED(lc)               LDAP_BACK_CONN_ISSET((lc), LDAP_BACK_FCONN_CACHED)
 148 #define LDAP_BACK_CONN_CACHED_SET(lc)           LDAP_BACK_CONN_SET((lc), LDAP_BACK_FCONN_CACHED)
 149 #define LDAP_BACK_CONN_CACHED_CLEAR(lc)         LDAP_BACK_CONN_CLEAR((lc), LDAP_BACK_FCONN_CACHED)
 150
 151         unsigned                lc_refcnt;
 152         unsigned                lc_flags;
 153         time_t                  lc_create_time;
 154         time_t                  lc_time;
 155
 156         LDAP_TAILQ_ENTRY(ldapconn_t)    lc_q;
 157 } ldapconn_t;
 158
 159 typedef struct ldap_avl_info_t {
 160         ldap_pvt_thread_mutex_t         lai_mutex;
 161         Avlnode                         *lai_tree;
 162 } ldap_avl_info_t;
 163
 164 typedef struct slap_retry_info_t {
 165         time_t          *ri_interval;
 166         int             *ri_num;
 167         int             ri_idx;
 168         int             ri_count;
 169         time_t          ri_last;
 170
 171 #define SLAP_RETRYNUM_FOREVER   (-1)            /* retry forever */
 172 #define SLAP_RETRYNUM_TAIL      (-2)            /* end of retrynum array */
 173 #define SLAP_RETRYNUM_VALID(n)  ((n) >= SLAP_RETRYNUM_FOREVER)  /* valid retrynum */
 174 #define SLAP_RETRYNUM_FINITE(n) ((n) > SLAP_RETRYNUM_FOREVER)   /* not forever */
 175 } slap_retry_info_t;
 176
 177 /*
 178  * identity assertion modes
 179  */
 180 typedef enum {
 181         LDAP_BACK_IDASSERT_LEGACY = 1,
 182         LDAP_BACK_IDASSERT_NOASSERT,
 183         LDAP_BACK_IDASSERT_ANONYMOUS,
 184         LDAP_BACK_IDASSERT_SELF,
 185         LDAP_BACK_IDASSERT_OTHERDN,
 186         LDAP_BACK_IDASSERT_OTHERID
 187 } slap_idassert_mode_t;
 188
 189 /* ID assert stuff */
 190 typedef struct slap_idassert_t {
 191         slap_idassert_mode_t    si_mode;
 192 #define li_idassert_mode        li_idassert.si_mode
 193
 194         slap_bindconf   si_bc;
 195 #define li_idassert_authcID     li_idassert.si_bc.sb_authcId
 196 #define li_idassert_authcDN     li_idassert.si_bc.sb_binddn
 197 #define li_idassert_passwd      li_idassert.si_bc.sb_cred
 198 #define li_idassert_authzID     li_idassert.si_bc.sb_authzId
 199 #define li_idassert_authmethod  li_idassert.si_bc.sb_method
 200 #define li_idassert_sasl_mech   li_idassert.si_bc.sb_saslmech
 201 #define li_idassert_sasl_realm  li_idassert.si_bc.sb_realm
 202 #define li_idassert_secprops    li_idassert.si_bc.sb_secprops
 203 #define li_idassert_tls         li_idassert.si_bc.sb_tls
 204
 205         unsigned        si_flags;
 206 #define LDAP_BACK_AUTH_NONE                             (0x00U)
 207 #define LDAP_BACK_AUTH_NATIVE_AUTHZ                     (0x01U)
 208 #define LDAP_BACK_AUTH_OVERRIDE                         (0x02U)
 209 #define LDAP_BACK_AUTH_PRESCRIPTIVE                     (0x04U)
 210 #define LDAP_BACK_AUTH_OBSOLETE_PROXY_AUTHZ             (0x08U)
 211 #define LDAP_BACK_AUTH_OBSOLETE_ENCODING_WORKAROUND     (0x10U)
 212 #define LDAP_BACK_AUTH_AUTHZ_ALL                        (0x20U)
 213 #define li_idassert_flags       li_idassert.si_flags
 214
 215         BerVarray       si_authz;
 216 #define li_idassert_authz       li_idassert.si_authz
 217 } slap_idassert_t;
 218
 219 /*
 220  * Hook to allow mucking with ldapinfo_t when quarantine is over
 221  */
 222 typedef int (*ldap_back_quarantine_f)( struct ldapinfo_t *, void * );
 223
 224 typedef struct ldapinfo_t {
 225         /* li_uri: the string that goes into ldap_initialize()
 226          * TODO: use li_acl.sb_uri instead */
 227         char                    *li_uri;
 228         /* li_bvuri: an array of each single URI that is equivalent;
 229          * to be checked for the presence of a certain item */
 230         BerVarray               li_bvuri;
 231         ldap_pvt_thread_mutex_t li_uri_mutex;
 232
 233         LDAP_REBIND_PROC        *li_rebind_f;
 234         void                    *li_urllist_p;
 235
 236         slap_bindconf           li_acl;
 237 #define li_acl_authcID          li_acl.sb_authcId
 238 #define li_acl_authcDN          li_acl.sb_binddn
 239 #define li_acl_passwd           li_acl.sb_cred
 240 #define li_acl_authzID          li_acl.sb_authzId
 241 #define li_acl_authmethod       li_acl.sb_method
 242 #define li_acl_sasl_mech        li_acl.sb_saslmech
 243 #define li_acl_sasl_realm       li_acl.sb_realm
 244 #define li_acl_secprops         li_acl.sb_secprops
 245
 246         /* ID assert stuff */
 247         slap_idassert_t         li_idassert;
 248         /* end of ID assert stuff */
 249
 250         int                     li_nretries;
 251 #define LDAP_BACK_RETRY_UNDEFINED       (-2)
 252 #define LDAP_BACK_RETRY_FOREVER         (-1)
 253 #define LDAP_BACK_RETRY_NEVER           (0)
 254 #define LDAP_BACK_RETRY_DEFAULT         (3)
 255
 256         unsigned                li_flags;
 257
 258 /* 0xFFF00000U are reserved for back-meta */
 259
 260 #define LDAP_BACK_F_NONE                (0x00000000U)
 261 #define LDAP_BACK_F_SAVECRED            (0x00000001U)
 262 #define LDAP_BACK_F_USE_TLS             (0x00000002U)
 263 #define LDAP_BACK_F_PROPAGATE_TLS       (0x00000004U)
 264 #define LDAP_BACK_F_TLS_CRITICAL        (0x00000008U)
 265 #define LDAP_BACK_F_TLS_LDAPS           (0x00000010U)
 266
 267 #define LDAP_BACK_F_TLS_USE_MASK        (LDAP_BACK_F_USE_TLS|LDAP_BACK_F_TLS_CRITICAL)
 268 #define LDAP_BACK_F_TLS_PROPAGATE_MASK  (LDAP_BACK_F_PROPAGATE_TLS|LDAP_BACK_F_TLS_CRITICAL)
 269 #define LDAP_BACK_F_TLS_MASK            (LDAP_BACK_F_TLS_USE_MASK|LDAP_BACK_F_TLS_PROPAGATE_MASK|LDAP_BACK_F_TLS_LDAPS)
 270 #define LDAP_BACK_F_CHASE_REFERRALS     (0x00000020U)
 271 #define LDAP_BACK_F_PROXY_WHOAMI        (0x00000040U)
 272
 273 #define LDAP_BACK_F_T_F                 (0x00000080U)
 274 #define LDAP_BACK_F_T_F_DISCOVER        (0x00000100U)
 275 #define LDAP_BACK_F_T_F_MASK            (LDAP_BACK_F_T_F)
 276 #define LDAP_BACK_F_T_F_MASK2           (LDAP_BACK_F_T_F_MASK|LDAP_BACK_F_T_F_DISCOVER)
 277
 278 #define LDAP_BACK_F_MONITOR             (0x00000200U)
 279 #define LDAP_BACK_F_SINGLECONN          (0x00000400U)
 280 #define LDAP_BACK_F_USE_TEMPORARIES     (0x00000800U)
 281
 282 #define LDAP_BACK_F_ISOPEN              (0x00001000U)
 283
 284 #define LDAP_BACK_F_CANCEL_ABANDON      (0x00000000U)
 285 #define LDAP_BACK_F_CANCEL_IGNORE       (0x00002000U)
 286 #define LDAP_BACK_F_CANCEL_EXOP         (0x00004000U)
 287 #define LDAP_BACK_F_CANCEL_EXOP_DISCOVER        (0x00008000U)
 288 #define LDAP_BACK_F_CANCEL_MASK         (LDAP_BACK_F_CANCEL_IGNORE|LDAP_BACK_F_CANCEL_EXOP)
 289 #define LDAP_BACK_F_CANCEL_MASK2        (LDAP_BACK_F_CANCEL_MASK|LDAP_BACK_F_CANCEL_EXOP_DISCOVER)
 290
 291 #define LDAP_BACK_F_QUARANTINE          (0x00010000U)
 292
 293 #define LDAP_BACK_ISSET_F(ff,f)         ( ( (ff) & (f) ) == (f) )
 294 #define LDAP_BACK_ISMASK_F(ff,m,f)      ( ( (ff) & (m) ) == (f) )
 295
 296 #define LDAP_BACK_ISSET(li,f)           LDAP_BACK_ISSET_F( (li)->li_flags, (f) )
 297 #define LDAP_BACK_ISMASK(li,m,f)        LDAP_BACK_ISMASK_F( (li)->li_flags, (m), (f) )
 298
 299 #define LDAP_BACK_SAVECRED(li)          LDAP_BACK_ISSET( (li), LDAP_BACK_F_SAVECRED )
 300 #define LDAP_BACK_USE_TLS(li)           LDAP_BACK_ISSET( (li), LDAP_BACK_F_USE_TLS )
 301 #define LDAP_BACK_PROPAGATE_TLS(li)     LDAP_BACK_ISSET( (li), LDAP_BACK_F_PROPAGATE_TLS )
 302 #define LDAP_BACK_TLS_CRITICAL(li)      LDAP_BACK_ISSET( (li), LDAP_BACK_F_TLS_CRITICAL )
 303 #define LDAP_BACK_CHASE_REFERRALS(li)   LDAP_BACK_ISSET( (li), LDAP_BACK_F_CHASE_REFERRALS )
 304 #define LDAP_BACK_PROXY_WHOAMI(li)      LDAP_BACK_ISSET( (li), LDAP_BACK_F_PROXY_WHOAMI )
 305
 306 #define LDAP_BACK_USE_TLS_F(ff)         LDAP_BACK_ISSET_F( (ff), LDAP_BACK_F_USE_TLS )
 307 #define LDAP_BACK_PROPAGATE_TLS_F(ff)   LDAP_BACK_ISSET_F( (ff), LDAP_BACK_F_PROPAGATE_TLS )
 308 #define LDAP_BACK_TLS_CRITICAL_F(ff)    LDAP_BACK_ISSET_F( (ff), LDAP_BACK_F_TLS_CRITICAL )
 309
 310 #define LDAP_BACK_T_F(li)               LDAP_BACK_ISMASK( (li), LDAP_BACK_F_T_F_MASK, LDAP_BACK_F_T_F )
 311 #define LDAP_BACK_T_F_DISCOVER(li)      LDAP_BACK_ISMASK( (li), LDAP_BACK_F_T_F_MASK2, LDAP_BACK_F_T_F_DISCOVER )
 312
 313 #define LDAP_BACK_MONITOR(li)           LDAP_BACK_ISSET( (li), LDAP_BACK_F_MONITOR )
 314 #define LDAP_BACK_SINGLECONN(li)        LDAP_BACK_ISSET( (li), LDAP_BACK_F_SINGLECONN )
 315 #define LDAP_BACK_USE_TEMPORARIES(li)   LDAP_BACK_ISSET( (li), LDAP_BACK_F_USE_TEMPORARIES)
 316
 317 #define LDAP_BACK_ISOPEN(li)            LDAP_BACK_ISSET( (li), LDAP_BACK_F_ISOPEN )
 318
 319 #define LDAP_BACK_ABANDON(li)           LDAP_BACK_ISMASK( (li), LDAP_BACK_F_CANCEL_MASK, LDAP_BACK_F_CANCEL_ABANDON )
 320 #define LDAP_BACK_IGNORE(li)            LDAP_BACK_ISMASK( (li), LDAP_BACK_F_CANCEL_MASK, LDAP_BACK_F_CANCEL_IGNORE )
 321 #define LDAP_BACK_CANCEL(li)            LDAP_BACK_ISMASK( (li), LDAP_BACK_F_CANCEL_MASK, LDAP_BACK_F_CANCEL_EXOP )
 322 #define LDAP_BACK_CANCEL_DISCOVER(li)   LDAP_BACK_ISMASK( (li), LDAP_BACK_F_CANCEL_MASK2, LDAP_BACK_F_CANCEL_EXOP_DISCOVER )
 323
 324 #define LDAP_BACK_QUARANTINE(li)        LDAP_BACK_ISSET( (li), LDAP_BACK_F_QUARANTINE )
 325
 326         int                     li_version;
 327
 328         /* cached connections;
 329          * special conns are in tailq rather than in tree */
 330         ldap_avl_info_t         li_conninfo;
 331         struct {
 332                 int                                             lic_num;
 333                 LDAP_TAILQ_HEAD(lc_conn_priv_q, ldapconn_t)     lic_priv;
 334         }                       li_conn_priv[ LDAP_BACK_PCONN_LAST ];
 335         int                     li_conn_priv_max;
 336 #define LDAP_BACK_CONN_PRIV_MIN         (1)
 337 #define LDAP_BACK_CONN_PRIV_MAX         (256)
 338         /* must be between LDAP_BACK_CONN_PRIV_MIN
 339          * and LDAP_BACK_CONN_PRIV_MAX ! */
 340 #define LDAP_BACK_CONN_PRIV_DEFAULT     (16)
 341
 342         sig_atomic_t            li_isquarantined;
 343 #define LDAP_BACK_FQ_NO         (0)
 344 #define LDAP_BACK_FQ_YES        (1)
 345 #define LDAP_BACK_FQ_RETRYING   (2)
 346
 347         slap_retry_info_t       li_quarantine;
 348         ldap_pvt_thread_mutex_t li_quarantine_mutex;
 349         ldap_back_quarantine_f  li_quarantine_f;
 350         void                    *li_quarantine_p;
 351
 352         time_t                  li_network_timeout;
 353         time_t                  li_conn_ttl;
 354         time_t                  li_idle_timeout;
 355         time_t                  li_timeout[ SLAP_OP_LAST ];
 356 } ldapinfo_t;
 357
 358 typedef enum ldap_back_send_t {
 359         LDAP_BACK_DONTSEND              = 0x00,
 360         LDAP_BACK_SENDOK                = 0x01,
 361         LDAP_BACK_SENDERR               = 0x02,
 362         LDAP_BACK_SENDRESULT            = (LDAP_BACK_SENDOK|LDAP_BACK_SENDERR),
 363         LDAP_BACK_BINDING               = 0x04,
 364
 365         LDAP_BACK_BIND_DONTSEND         = (LDAP_BACK_BINDING),
 366         LDAP_BACK_BIND_SOK              = (LDAP_BACK_BINDING|LDAP_BACK_SENDOK),
 367         LDAP_BACK_BIND_SERR             = (LDAP_BACK_BINDING|LDAP_BACK_SENDERR),
 368         LDAP_BACK_BIND_SRES             = (LDAP_BACK_BINDING|LDAP_BACK_SENDRESULT),
 369
 370         LDAP_BACK_RETRYING              = 0x08,
 371         LDAP_BACK_RETRY_DONTSEND        = (LDAP_BACK_RETRYING),
 372         LDAP_BACK_RETRY_SOK             = (LDAP_BACK_RETRYING|LDAP_BACK_SENDOK),
 373         LDAP_BACK_RETRY_SERR            = (LDAP_BACK_RETRYING|LDAP_BACK_SENDERR),
 374         LDAP_BACK_RETRY_SRES            = (LDAP_BACK_RETRYING|LDAP_BACK_SENDRESULT),
 375
 376         LDAP_BACK_GETCONN               = 0x10
 377 } ldap_back_send_t;
 378
 379 /* define to use asynchronous StartTLS */
 380 #define SLAP_STARTTLS_ASYNCHRONOUS
 381
 382 /* timeout to use when calling ldap_result() */
 383 #define LDAP_BACK_RESULT_TIMEOUT        (0)
 384 #define LDAP_BACK_RESULT_UTIMEOUT       (100000)
 385 #define LDAP_BACK_TV_SET(tv) \
 386         do { \
 387                 (tv)->tv_sec = LDAP_BACK_RESULT_TIMEOUT; \
 388                 (tv)->tv_usec = LDAP_BACK_RESULT_UTIMEOUT; \
 389         } while ( 0 )
 390
 391 #ifndef LDAP_BACK_PRINT_CONNTREE
 392 #define LDAP_BACK_PRINT_CONNTREE 0
 393 #endif /* !LDAP_BACK_PRINT_CONNTREE */
 394
 395 LDAP_END_DECL
 396
 397 #include "proto-ldap.h"
 398
 399 #endif /* SLAPD_LDAP_H */