git.sur5r.net Git - openldap/blob - libraries/libldap/ldap-int.h

   1 /*  ldap-int.h - defines & prototypes internal to the LDAP library */
   2 /* $OpenLDAP$ */
   3 /*
   4  * Copyright 1998-2003 The OpenLDAP Foundation, All Rights Reserved.
   5  * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
   6  */
   7 /*  Portions
   8  *  Copyright (c) 1995 Regents of the University of Michigan.
   9  *  All rights reserved.
  10  */
  11
  12 #ifndef _LDAP_INT_H
  13 #define _LDAP_INT_H 1
  14
  15 #ifdef LDAP_R_COMPILE
  16 #define LDAP_THREAD_SAFE 1
  17 #endif
  18
  19 #include "../liblber/lber-int.h"
  20
  21 #ifdef LDAP_R_COMPILE
  22 #include <ldap_pvt_thread.h>
  23 #endif
  24
  25 #ifdef HAVE_CYRUS_SASL
  26         /* the need for this should be removed */
  27 #ifdef HAVE_SASL_SASL_H
  28 #include <sasl/sasl.h>
  29 #else
  30 #include <sasl.h>
  31 #endif
  32
  33 #define SASL_MAX_BUFF_SIZE      65536
  34 #define SASL_MIN_BUFF_SIZE      4096
  35 #endif
  36
  37 /*
  38  * Support needed if the library is running in the kernel
  39  */
  40 #if LDAP_INT_IN_KERNEL
  41         /*
  42          * Platform specific function to return a pointer to the
  43          * process-specific global options.
  44          *
  45          * This function should perform the following functions:
  46          *  Allocate and initialize a global options struct on a per process basis
  47          *  Use callers process identifier to return its global options struct
  48          *  Note: Deallocate structure when the process exits
  49          */
  50 #       define LDAP_INT_GLOBAL_OPT() ldap_int_global_opt()
  51    struct ldapoptions *ldap_int_global_opt(void);
  52 #else
  53 #       define LDAP_INT_GLOBAL_OPT() (&ldap_int_global_options)
  54 #endif
  55
  56 #define ldap_debug      ((LDAP_INT_GLOBAL_OPT())->ldo_debug)
  57
  58 #include "ldap_log.h"
  59
  60 #undef Debug
  61 #define Debug( level, fmt, arg1, arg2, arg3 ) \
  62         do { if ( ldap_debug & level ) \
  63         ldap_log_printf( NULL, (level), (fmt), (arg1), (arg2), (arg3) ); \
  64         } while ( 0 )
  65
  66 #define LDAP_Debug( subsystem, level, fmt, arg1, arg2, arg3 )\
  67         ldap_log_printf( NULL, (level), (fmt), (arg1), (arg2), (arg3) )
  68
  69 #include "ldap.h"
  70
  71 #include "ldap_pvt.h"
  72
  73 LDAP_BEGIN_DECL
  74
  75 #define LDAP_URL_PREFIX         "ldap://"
  76 #define LDAP_URL_PREFIX_LEN     (sizeof(LDAP_URL_PREFIX)-1)
  77 #define LDAPS_URL_PREFIX                "ldaps://"
  78 #define LDAPS_URL_PREFIX_LEN    (sizeof(LDAPS_URL_PREFIX)-1)
  79 #define LDAPI_URL_PREFIX        "ldapi://"
  80 #define LDAPI_URL_PREFIX_LEN    (sizeof(LDAPI_URL_PREFIX)-1)
  81 #ifdef LDAP_CONNECTIONLESS
  82 #define LDAPC_URL_PREFIX        "cldap://"
  83 #define LDAPC_URL_PREFIX_LEN    (sizeof(LDAPC_URL_PREFIX)-1)
  84 #endif
  85 #define LDAP_URL_URLCOLON               "URL:"
  86 #define LDAP_URL_URLCOLON_LEN   (sizeof(LDAP_URL_URLCOLON)-1)
  87
  88 #define LDAP_REF_STR            "Referral:\n"
  89 #define LDAP_REF_STR_LEN        (sizeof(LDAP_REF_STR)-1)
  90 #define LDAP_LDAP_REF_STR       LDAP_URL_PREFIX
  91 #define LDAP_LDAP_REF_STR_LEN   LDAP_URL_PREFIX_LEN
  92
  93 #define LDAP_DEFAULT_REFHOPLIMIT 5
  94
  95 #define LDAP_BOOL_REFERRALS             0
  96 #define LDAP_BOOL_RESTART               1
  97 #define LDAP_BOOL_TLS                   3
  98
  99 #define LDAP_BOOLEANS   unsigned long
 100 #define LDAP_BOOL(n)    (1 << (n))
 101 #define LDAP_BOOL_GET(lo, bool) \
 102         ((lo)->ldo_booleans & LDAP_BOOL(bool) ? -1 : 0)
 103 #define LDAP_BOOL_SET(lo, bool) ((lo)->ldo_booleans |= LDAP_BOOL(bool))
 104 #define LDAP_BOOL_CLR(lo, bool) ((lo)->ldo_booleans &= ~LDAP_BOOL(bool))
 105 #define LDAP_BOOL_ZERO(lo) ((lo)->ldo_booleans = 0)
 106
 107 /*
 108  * This structure represents both ldap messages and ldap responses.
 109  * These are really the same, except in the case of search responses,
 110  * where a response has multiple messages.
 111  */
 112
 113 struct ldapmsg {
 114         ber_int_t               lm_msgid;       /* the message id */
 115         ber_tag_t               lm_msgtype;     /* the message type */
 116         BerElement      *lm_ber;        /* the ber encoded message contents */
 117         struct ldapmsg  *lm_chain;      /* for search - next msg in the resp */
 118         struct ldapmsg  *lm_next;       /* next response */
 119         time_t  lm_time;        /* used to maintain cache */
 120 };
 121
 122 /*
 123  * structure representing get/set'able options
 124  * which have global defaults.
 125  */
 126 struct ldapoptions {
 127         short ldo_valid;
 128 #define LDAP_UNINITIALIZED      0x0
 129 #define LDAP_INITIALIZED        0x1
 130 #define LDAP_VALID_SESSION      0x2
 131         int   ldo_debug;
 132 #ifdef LDAP_CONNECTIONLESS
 133 #define LDAP_IS_UDP(ld)         ((ld)->ld_options.ldo_is_udp)
 134         void*                   ldo_peer;       /* struct sockaddr* */
 135         char*                   ldo_cldapdn;
 136         int                     ldo_is_udp;
 137 #endif
 138
 139         /* per API call timeout */
 140         struct timeval          *ldo_tm_api;
 141         struct timeval          *ldo_tm_net;
 142
 143         ber_int_t               ldo_version;
 144         ber_int_t               ldo_deref;
 145         ber_int_t               ldo_timelimit;
 146         ber_int_t               ldo_sizelimit;
 147
 148 #ifdef HAVE_TLS
 149         int                     ldo_tls_mode;
 150 #endif
 151
 152         LDAPURLDesc *ldo_defludp;
 153         int             ldo_defport;
 154         char*   ldo_defbase;
 155         char*   ldo_defbinddn;  /* bind dn */
 156
 157 #ifdef HAVE_CYRUS_SASL
 158         char*   ldo_def_sasl_mech;              /* SASL Mechanism(s) */
 159         char*   ldo_def_sasl_realm;             /* SASL realm */
 160         char*   ldo_def_sasl_authcid;   /* SASL authentication identity */
 161         char*   ldo_def_sasl_authzid;   /* SASL authorization identity */
 162
 163         /* SASL Security Properties */
 164         struct sasl_security_properties ldo_sasl_secprops;
 165 #endif
 166
 167         int             ldo_refhoplimit;        /* limit on referral nesting */
 168
 169         /* LDAPv3 server and client controls */
 170         LDAPControl     **ldo_sctrls;
 171         LDAPControl **ldo_cctrls;
 172
 173         /* LDAP rebind callback function */
 174         LDAP_REBIND_PROC *ldo_rebind_proc;
 175         void *ldo_rebind_params;
 176
 177         LDAP_BOOLEANS ldo_booleans;     /* boolean options */
 178 };
 179
 180
 181 /*
 182  * structure for representing an LDAP server connection
 183  */
 184 typedef struct ldap_conn {
 185         Sockbuf         *lconn_sb;
 186 #ifdef HAVE_TLS
 187         /* tls context */
 188         void            *lconn_tls_ctx;
 189 #endif
 190 #ifdef HAVE_CYRUS_SASL
 191         void            *lconn_sasl_authctx;    /* context for bind */
 192         void            *lconn_sasl_sockctx;    /* for security layer */
 193 #endif
 194         int                     lconn_refcnt;
 195         time_t          lconn_lastused; /* time */
 196         int                     lconn_rebind_inprogress;        /* set if rebind in progress */
 197         char            ***lconn_rebind_queue;          /* used if rebind in progress */
 198         int                     lconn_status;
 199 #define LDAP_CONNST_NEEDSOCKET          1
 200 #define LDAP_CONNST_CONNECTING          2
 201 #define LDAP_CONNST_CONNECTED           3
 202         LDAPURLDesc             *lconn_server;
 203 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND
 204         char                    *lconn_krbinstance;
 205 #endif
 206         BerElement              *lconn_ber;     /* ber receiving on this conn. */
 207
 208         struct ldap_conn *lconn_next;
 209 } LDAPConn;
 210
 211
 212 /*
 213  * structure used to track outstanding requests
 214  */
 215 typedef struct ldapreq {
 216         ber_int_t               lr_msgid;       /* the message id */
 217         int             lr_status;      /* status of request */
 218 #define LDAP_REQST_COMPLETED    0
 219 #define LDAP_REQST_INPROGRESS   1
 220 #define LDAP_REQST_CHASINGREFS  2
 221 #define LDAP_REQST_NOTCONNECTED 3
 222 #define LDAP_REQST_WRITING      4
 223         int             lr_outrefcnt;   /* count of outstanding referrals */
 224         ber_int_t               lr_origid;      /* original request's message id */
 225         int             lr_parentcnt;   /* count of parent requests */
 226         ber_tag_t               lr_res_msgtype; /* result message type */
 227         ber_int_t               lr_res_errno;   /* result LDAP errno */
 228         char            *lr_res_error;  /* result error string */
 229         char            *lr_res_matched;/* result matched DN string */
 230         BerElement      *lr_ber;        /* ber encoded request contents */
 231         LDAPConn        *lr_conn;       /* connection used to send request */
 232         struct ldapreq  *lr_parent;     /* request that spawned this referral */
 233         struct ldapreq  *lr_child;      /* first child request */
 234         struct ldapreq  *lr_refnext;    /* next referral spawned */
 235         struct ldapreq  *lr_prev;       /* previous request */
 236         struct ldapreq  *lr_next;       /* next request */
 237 } LDAPRequest;
 238
 239 /*
 240  * structure for client cache
 241  */
 242 #define LDAP_CACHE_BUCKETS      31      /* cache hash table size */
 243 typedef struct ldapcache {
 244         LDAPMessage     *lc_buckets[LDAP_CACHE_BUCKETS];/* hash table */
 245         LDAPMessage     *lc_requests;                   /* unfulfilled reqs */
 246         long            lc_timeout;                     /* request timeout */
 247         ber_len_t               lc_maxmem;                      /* memory to use */
 248         ber_len_t               lc_memused;                     /* memory in use */
 249         int             lc_enabled;                     /* enabled? */
 250         unsigned long   lc_options;                     /* options */
 251 #define LDAP_CACHE_OPT_CACHENOERRS      0x00000001
 252 #define LDAP_CACHE_OPT_CACHEALLERRS     0x00000002
 253 }  LDAPCache;
 254
 255 /*
 256  * structure containing referral request info for rebind procedure
 257  */
 258 typedef struct ldapreqinfo {
 259         ber_len_t       ri_msgid;
 260         int                     ri_request;
 261         char            *ri_url;
 262 } LDAPreqinfo;
 263
 264 /*
 265  * structure representing an ldap connection
 266  */
 267
 268 struct ldap {
 269         Sockbuf         *ld_sb;         /* socket descriptor & buffer */
 270
 271         struct ldapoptions ld_options;
 272
 273 #define ld_valid                ld_options.ldo_valid
 274 #define ld_debug                ld_options.ldo_debug
 275
 276 #define ld_deref                ld_options.ldo_deref
 277 #define ld_timelimit    ld_options.ldo_timelimit
 278 #define ld_sizelimit    ld_options.ldo_sizelimit
 279
 280 #define ld_defbinddn    ld_options.ldo_defbinddn
 281 #define ld_defbase              ld_options.ldo_defbase
 282 #define ld_defhost              ld_options.ldo_defhost
 283 #define ld_defport              ld_options.ldo_defport
 284
 285 #define ld_refhoplimit  ld_options.ldo_refhoplimit
 286
 287 #define ld_sctrls               ld_options.ldo_sctrls
 288 #define ld_cctrls               ld_options.ldo_cctrls
 289 #define ld_rebind_proc  ld_options.ldo_rebind_proc
 290 #define ld_rebind_params        ld_options.ldo_rebind_params
 291
 292 #define ld_version              ld_options.ldo_version
 293
 294         unsigned short  ld_lberoptions;
 295
 296         ber_int_t       ld_errno;
 297         char    *ld_error;
 298         char    *ld_matched;
 299         char    **ld_referrals;
 300         ber_len_t               ld_msgid;
 301
 302         /* do not mess with these */
 303         LDAPRequest     *ld_requests;   /* list of outstanding requests */
 304         LDAPMessage     *ld_responses;  /* list of outstanding responses */
 305
 306 #ifdef LDAP_R_COMPILE
 307         ldap_pvt_thread_mutex_t ld_req_mutex;
 308         ldap_pvt_thread_mutex_t ld_res_mutex;
 309 #endif
 310
 311         ber_int_t               *ld_abandoned;  /* array of abandoned requests */
 312
 313         LDAPCache       *ld_cache;      /* non-null if cache is initialized */
 314
 315         /* do not mess with the rest though */
 316
 317         LDAPConn        *ld_defconn;    /* default connection */
 318         LDAPConn        *ld_conns;      /* list of server connections */
 319         void            *ld_selectinfo; /* platform specifics for select */
 320 };
 321 #define LDAP_VALID(ld)  ( (ld)->ld_valid == LDAP_VALID_SESSION )
 322
 323 #ifdef LDAP_R_COMPILE
 324 LDAP_V ( ldap_pvt_thread_mutex_t ) ldap_int_resolv_mutex;
 325
 326 #ifdef HAVE_CYRUS_SASL
 327 LDAP_V( ldap_pvt_thread_mutex_t ) ldap_int_sasl_mutex;
 328 #endif
 329 #endif
 330
 331 #ifdef LDAP_R_COMPILE
 332 #define LDAP_NEXT_MSGID(ld, id) \
 333         ldap_pvt_thread_mutex_lock( &(ld)->ld_req_mutex ); \
 334         id = ++(ld)->ld_msgid; \
 335         ldap_pvt_thread_mutex_unlock( &(ld)->ld_req_mutex )
 336 #else
 337 #define LDAP_NEXT_MSGID(ld, id) id = ++(ld)->ld_msgid
 338 #endif
 339
 340 /*
 341  * in init.c
 342  */
 343
 344 LDAP_V ( struct ldapoptions ) ldap_int_global_options;
 345
 346 LDAP_F ( void ) ldap_int_initialize LDAP_P((struct ldapoptions *, int *));
 347 LDAP_F ( void ) ldap_int_initialize_global_options LDAP_P((
 348         struct ldapoptions *, int *));
 349
 350 /* memory.c */
 351         /* simple macros to realloc for now */
 352 #define LDAP_MALLOC(s)          (ber_memalloc_x((s),NULL))
 353 #define LDAP_CALLOC(n,s)        (ber_memcalloc_x((n),(s),NULL))
 354 #define LDAP_REALLOC(p,s)       (ber_memrealloc_x((p),(s),NULL))
 355 #define LDAP_FREE(p)            (ber_memfree_x((p),NULL))
 356 #define LDAP_VFREE(v)           (ber_memvfree_x((void **)(v),NULL))
 357 #define LDAP_STRDUP(s)          (ber_strdup_x((s),NULL))
 358 #define LDAP_STRNDUP(s,l)       (ber_strndup_x((s),(l),NULL))
 359
 360 #define LDAP_MALLOCX(s,x)       (ber_memalloc_x((s),(x)))
 361 #define LDAP_CALLOCX(n,s,x)     (ber_memcalloc_x((n),(s),(x)))
 362 #define LDAP_REALLOCX(p,s,x)    (ber_memrealloc_x((p),(s),(x)))
 363 #define LDAP_FREEX(p,x)         (ber_memfree_x((p),(x)))
 364 #define LDAP_VFREEX(v,x)        (ber_memvfree_x((void **)(v),(x)))
 365 #define LDAP_STRDUPX(s,x)       (ber_strdup_x((s),(x)))
 366 #define LDAP_STRNDUPX(s,l,x)    (ber_strndup_x((s),(l),(x)))
 367
 368 /*
 369  * in error.c
 370  */
 371 LDAP_F (void) ldap_int_error_init( void );
 372
 373 /*
 374  * in unit-int.c
 375  */
 376 LDAP_F (void) ldap_int_utils_init LDAP_P(( void ));
 377
 378
 379 /*
 380  * in print.c
 381  */
 382 LDAP_F (int) ldap_log_printf LDAP_P((LDAP *ld, int level, const char *fmt, ...)) LDAP_GCCATTR((format(printf, 3, 4)));
 383
 384 /*
 385  * in cache.c
 386  */
 387 LDAP_F (void) ldap_add_request_to_cache LDAP_P(( LDAP *ld, ber_tag_t msgtype,
 388         BerElement *request ));
 389 LDAP_F (void) ldap_add_result_to_cache LDAP_P(( LDAP *ld, LDAPMessage *result ));
 390 LDAP_F (int) ldap_check_cache LDAP_P(( LDAP *ld, ber_tag_t msgtype, BerElement *request ));
 391
 392 /*
 393  * in controls.c
 394  */
 395 LDAP_F (int) ldap_int_get_controls LDAP_P((
 396         BerElement *be,
 397         LDAPControl ***ctrlsp));
 398
 399 LDAP_F (int) ldap_int_put_controls LDAP_P((
 400         LDAP *ld,
 401         LDAPControl *const *ctrls,
 402         BerElement *ber ));
 403
 404 LDAP_F (int) ldap_int_client_controls LDAP_P((
 405         LDAP *ld,
 406         LDAPControl **ctrlp ));
 407
 408 /*
 409  * in dsparse.c
 410  */
 411 LDAP_F (int) ldap_int_next_line_tokens LDAP_P(( char **bufp, ber_len_t *blenp, char ***toksp ));
 412
 413 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND
 414 /*
 415  * in kerberos.c
 416  */
 417 LDAP_F (char *) ldap_get_kerberosv4_credentials LDAP_P((
 418         LDAP *ld,
 419         LDAP_CONST char *who,
 420         LDAP_CONST char *service,
 421         ber_len_t *len ));
 422
 423 #endif /* LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND */
 424
 425
 426 /*
 427  * in open.c
 428  */
 429 LDAP_F (int) ldap_open_defconn( LDAP *ld );
 430 LDAP_F (int) ldap_int_open_connection( LDAP *ld,
 431         LDAPConn *conn, LDAPURLDesc *srvlist, int async );
 432
 433 /*
 434  * in os-ip.c
 435  */
 436 LDAP_V (int) ldap_int_tblsize;
 437 LDAP_F (int) ldap_int_timeval_dup( struct timeval **dest,
 438         const struct timeval *tm );
 439 LDAP_F (int) ldap_connect_to_host( LDAP *ld, Sockbuf *sb,
 440         int proto, const char *host, int port, int async );
 441
 442 #if defined(LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND) || \
 443         defined(HAVE_TLS) || defined(HAVE_CYRUS_SASL)
 444 LDAP_V (char *) ldap_int_hostname;
 445 LDAP_F (char *) ldap_host_connected_to( Sockbuf *sb,
 446         const char *host );
 447 #endif
 448
 449 LDAP_F (void) ldap_int_ip_init( void );
 450 LDAP_F (int) ldap_int_select( LDAP *ld, struct timeval *timeout );
 451 LDAP_F (void *) ldap_new_select_info( void );
 452 LDAP_F (void) ldap_free_select_info( void *sip );
 453 LDAP_F (void) ldap_mark_select_write( LDAP *ld, Sockbuf *sb );
 454 LDAP_F (void) ldap_mark_select_read( LDAP *ld, Sockbuf *sb );
 455 LDAP_F (void) ldap_mark_select_clear( LDAP *ld, Sockbuf *sb );
 456 LDAP_F (int) ldap_is_read_ready( LDAP *ld, Sockbuf *sb );
 457 LDAP_F (int) ldap_is_write_ready( LDAP *ld, Sockbuf *sb );
 458
 459 /*
 460  * in os-local.c
 461  */
 462 #ifdef LDAP_PF_LOCAL
 463 LDAP_F (int) ldap_connect_to_path( LDAP *ld, Sockbuf *sb,
 464         const char *path, int async );
 465 #endif /* LDAP_PF_LOCAL */
 466
 467 /*
 468  * in request.c
 469  */
 470 LDAP_F (ber_int_t) ldap_send_initial_request( LDAP *ld, ber_tag_t msgtype,
 471         const char *dn, BerElement *ber, ber_int_t msgid );
 472 LDAP_F (BerElement *) ldap_alloc_ber_with_options( LDAP *ld );
 473 LDAP_F (void) ldap_set_ber_options( LDAP *ld, BerElement *ber );
 474
 475 LDAP_F (int) ldap_send_server_request( LDAP *ld, BerElement *ber, ber_int_t msgid, LDAPRequest *parentreq, LDAPURLDesc *srvlist, LDAPConn *lc, LDAPreqinfo *bind );
 476 LDAP_F (LDAPConn *) ldap_new_connection( LDAP *ld, LDAPURLDesc *srvlist, int use_ldsb, int connect, LDAPreqinfo *bind );
 477 LDAP_F (LDAPRequest *) ldap_find_request_by_msgid( LDAP *ld, ber_int_t msgid );
 478 LDAP_F (void) ldap_free_request( LDAP *ld, LDAPRequest *lr );
 479 LDAP_F (void) ldap_free_connection( LDAP *ld, LDAPConn *lc, int force, int unbind );
 480 LDAP_F (void) ldap_dump_connection( LDAP *ld, LDAPConn *lconns, int all );
 481 LDAP_F (void) ldap_dump_requests_and_responses( LDAP *ld );
 482 LDAP_F (int) ldap_chase_referrals( LDAP *ld, LDAPRequest *lr,
 483         char **errstrp, int sref, int *hadrefp );
 484 LDAP_F (int) ldap_chase_v3referrals( LDAP *ld, LDAPRequest *lr,
 485         char **refs, int sref, char **referralsp, int *hadrefp );
 486 LDAP_F (int) ldap_append_referral( LDAP *ld, char **referralsp, char *s );
 487 LDAP_F (int) ldap_int_flush_request( LDAP *ld, LDAPRequest *lr );
 488
 489 /*
 490  * in result.c:
 491  */
 492 LDAP_F (char *) ldap_int_msgtype2str( ber_tag_t tag );
 493
 494 /*
 495  * in search.c
 496  */
 497 LDAP_F (BerElement *) ldap_build_search_req LDAP_P((
 498         LDAP *ld,
 499         const char *base,
 500         ber_int_t scope,
 501         const char *filter,
 502         char **attrs,
 503         ber_int_t attrsonly,
 504         LDAPControl **sctrls,
 505         LDAPControl **cctrls,
 506         ber_int_t timelimit,
 507         ber_int_t sizelimit,
 508         ber_int_t *msgidp));
 509
 510
 511 /*
 512  * in unbind.c
 513  */
 514 LDAP_F (int) ldap_ld_free LDAP_P((
 515         LDAP *ld,
 516         int close,
 517         LDAPControl **sctrls,
 518         LDAPControl **cctrls ));
 519
 520 LDAP_F (int) ldap_send_unbind LDAP_P((
 521         LDAP *ld,
 522         Sockbuf *sb,
 523         LDAPControl **sctrls,
 524         LDAPControl **cctrls ));
 525
 526 /*
 527  * in url.c
 528  */
 529 LDAP_F (LDAPURLDesc *) ldap_url_dup LDAP_P((
 530         LDAPURLDesc *ludp ));
 531
 532 LDAP_F (LDAPURLDesc *) ldap_url_duplist LDAP_P((
 533         LDAPURLDesc *ludlist ));
 534
 535 LDAP_F (int) ldap_url_parselist LDAP_P((
 536         LDAPURLDesc **ludlist,
 537         const char *url ));
 538
 539 LDAP_F (int) ldap_url_parselist_ext LDAP_P((
 540         LDAPURLDesc **ludlist,
 541         const char *url,
 542         const char *sep ));
 543
 544 LDAP_F (int) ldap_url_parsehosts LDAP_P((
 545         LDAPURLDesc **ludlist,
 546         const char *hosts,
 547         int port ));
 548
 549 LDAP_F (char *) ldap_url_list2hosts LDAP_P((
 550         LDAPURLDesc *ludlist ));
 551
 552 LDAP_F (char *) ldap_url_list2urls LDAP_P((
 553         LDAPURLDesc *ludlist ));
 554
 555 LDAP_F (void) ldap_free_urllist LDAP_P((
 556         LDAPURLDesc *ludlist ));
 557
 558 /*
 559  * in cyrus.c
 560  */
 561
 562 LDAP_F (int) ldap_int_sasl_init LDAP_P(( void ));
 563
 564 LDAP_F (int) ldap_int_sasl_open LDAP_P((
 565         LDAP *ld, LDAPConn *conn,
 566         const char* host ));
 567 LDAP_F (int) ldap_int_sasl_close LDAP_P(( LDAP *ld, LDAPConn *conn ));
 568
 569 LDAP_F (int) ldap_int_sasl_external LDAP_P((
 570         LDAP *ld, LDAPConn *conn,
 571         const char* authid, ber_len_t ssf ));
 572
 573 LDAP_F (int) ldap_int_sasl_get_option LDAP_P(( LDAP *ld,
 574         int option, void *arg ));
 575 LDAP_F (int) ldap_int_sasl_set_option LDAP_P(( LDAP *ld,
 576         int option, void *arg ));
 577 LDAP_F (int) ldap_int_sasl_config LDAP_P(( struct ldapoptions *lo,
 578         int option, const char *arg ));
 579
 580 LDAP_F (int) ldap_int_sasl_bind LDAP_P((
 581         LDAP *ld,
 582         const char *,
 583         const char *,
 584         LDAPControl **, LDAPControl **,
 585
 586         /* should be passed in client controls */
 587         unsigned flags,
 588         LDAP_SASL_INTERACT_PROC *interact,
 589         void *defaults ));
 590
 591 /* in schema.c */
 592 LDAP_F (char *) ldap_int_parse_numericoid LDAP_P((
 593         const char **sp,
 594         int *code,
 595         const int flags ));
 596
 597 /*
 598  * in tls.c
 599  */
 600 LDAP_F (int) ldap_int_tls_config LDAP_P(( LDAP *ld,
 601         int option, const char *arg ));
 602
 603 LDAP_F (int) ldap_int_tls_start LDAP_P(( LDAP *ld,
 604         LDAPConn *conn, LDAPURLDesc *srv ));
 605
 606 /*
 607  *      in getvalues.c
 608  */
 609 LDAP_F (char **) ldap_value_dup LDAP_P((
 610         char *const *vals ));
 611
 612 LDAP_END_DECL
 613
 614 #endif /* _LDAP_INT_H */