]> git.sur5r.net Git - openldap/blob - include/ldap.h
VC++ Port: round 1
[openldap] / include / ldap.h
1 /*
2  * Copyright (c) 1990 Regents of the University of Michigan.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms are permitted
6  * provided that this notice is preserved and that due credit is given
7  * to the University of Michigan at Ann Arbor. The name of the University
8  * may not be used to endorse or promote products derived from this
9  * software without specific prior written permission. This software
10  * is provided ``as is'' without express or implied warranty.
11  */
12
13 #ifndef _LDAP_H
14 #define _LDAP_H
15
16 #include <ldap_cdefs.h>
17
18 LDAP_BEGIN_DECL
19
20 #define LDAP_PORT       389
21 #define LDAP_VERSION1   1
22 #define LDAP_VERSION2   2
23 #define LDAP_VERSION    LDAP_VERSION2
24
25 #define COMPAT20
26 #define COMPAT30
27 #if defined(COMPAT20) || defined(COMPAT30)
28 #define COMPAT
29 #endif
30
31 #define LDAP_MAX_ATTR_LEN       100
32
33 /* debugging stuff */
34 #ifdef LDAP_DEBUG
35 extern int      ldap_debug;
36 #ifdef LDAP_SYSLOG
37 extern int      ldap_syslog;
38 extern int      ldap_syslog_level;
39 #endif /* LDAP_SYSLOG */
40
41 #define LDAP_DEBUG_TRACE        0x001
42 #define LDAP_DEBUG_PACKETS      0x002
43 #define LDAP_DEBUG_ARGS         0x004
44 #define LDAP_DEBUG_CONNS        0x008
45 #define LDAP_DEBUG_BER          0x010
46 #define LDAP_DEBUG_FILTER       0x020
47 #define LDAP_DEBUG_CONFIG       0x040
48 #define LDAP_DEBUG_ACL          0x080
49 #define LDAP_DEBUG_STATS        0x100
50 #define LDAP_DEBUG_STATS2       0x200
51 #define LDAP_DEBUG_SHELL        0x400
52 #define LDAP_DEBUG_PARSE        0x800
53 #define LDAP_DEBUG_ANY          0xffff
54
55 /* this doesn't below as part of ldap.h */
56 #ifdef LDAP_SYSLOG
57 #define Debug( level, fmt, arg1, arg2, arg3 )   \
58         { \
59                 if ( ldap_debug & level ) \
60                         fprintf( stderr, fmt, arg1, arg2, arg3 ); \
61                 if ( ldap_syslog & level ) \
62                         syslog( ldap_syslog_level, fmt, arg1, arg2, arg3 ); \
63         }
64 #else /* LDAP_SYSLOG */
65 #ifndef WINSOCK
66 #define Debug( level, fmt, arg1, arg2, arg3 ) \
67                 if ( ldap_debug & level ) \
68                         fprintf( stderr, fmt, arg1, arg2, arg3 );
69 #else /* !WINSOCK */
70 extern void Debug( int level, char* fmt, ... );
71 #endif /* !WINSOCK */
72 #endif /* LDAP_SYSLOG */
73 #else /* LDAP_DEBUG */
74 #define Debug( level, fmt, arg1, arg2, arg3 )
75 #endif /* LDAP_DEBUG */
76
77 /* 
78  * specific LDAP instantiations of BER types we know about
79  */
80
81 /* general stuff */
82 #define LDAP_TAG_MESSAGE        0x30L   /* tag is 16 + constructed bit */
83 #define OLD_LDAP_TAG_MESSAGE    0x10L   /* forgot the constructed bit  */
84 #define LDAP_TAG_MSGID          0x02L
85
86 /* possible operations a client can invoke */
87 #define LDAP_REQ_BIND                   0x60L   /* application + constructed */
88 #define LDAP_REQ_UNBIND                 0x42L   /* application + primitive   */
89 #define LDAP_REQ_SEARCH                 0x63L   /* application + constructed */
90 #define LDAP_REQ_MODIFY                 0x66L   /* application + constructed */
91 #define LDAP_REQ_ADD                    0x68L   /* application + constructed */
92 #define LDAP_REQ_DELETE                 0x4aL   /* application + primitive   */
93 #define LDAP_REQ_MODRDN                 0x6cL   /* application + constructed */
94 #define LDAP_REQ_COMPARE                0x6eL   /* application + constructed */
95 #define LDAP_REQ_ABANDON                0x50L   /* application + primitive   */
96
97 /* version 3.0 compatibility stuff */
98 #define LDAP_REQ_UNBIND_30              0x62L
99 #define LDAP_REQ_DELETE_30              0x6aL
100 #define LDAP_REQ_ABANDON_30             0x70L
101
102 /* 
103  * old broken stuff for backwards compatibility - forgot application tag
104  * and constructed/primitive bit
105  */
106 #define OLD_LDAP_REQ_BIND               0x00L
107 #define OLD_LDAP_REQ_UNBIND             0x02L
108 #define OLD_LDAP_REQ_SEARCH             0x03L
109 #define OLD_LDAP_REQ_MODIFY             0x06L
110 #define OLD_LDAP_REQ_ADD                0x08L
111 #define OLD_LDAP_REQ_DELETE             0x0aL
112 #define OLD_LDAP_REQ_MODRDN             0x0cL
113 #define OLD_LDAP_REQ_COMPARE            0x0eL
114 #define OLD_LDAP_REQ_ABANDON            0x10L
115
116 /* possible result types a server can return */
117 #define LDAP_RES_BIND                   0x61L   /* application + constructed */
118 #define LDAP_RES_SEARCH_ENTRY           0x64L   /* application + constructed */
119 #define LDAP_RES_SEARCH_RESULT          0x65L   /* application + constructed */
120 #define LDAP_RES_MODIFY                 0x67L   /* application + constructed */
121 #define LDAP_RES_ADD                    0x69L   /* application + constructed */
122 #define LDAP_RES_DELETE                 0x6bL   /* application + constructed */
123 #define LDAP_RES_MODRDN                 0x6dL   /* application + constructed */
124 #define LDAP_RES_COMPARE                0x6fL   /* application + constructed */
125 #define LDAP_RES_ANY                    (-1L)
126
127 /* old broken stuff for backwards compatibility */
128 #define OLD_LDAP_RES_BIND               0x01L
129 #define OLD_LDAP_RES_SEARCH_ENTRY       0x04L
130 #define OLD_LDAP_RES_SEARCH_RESULT      0x05L
131 #define OLD_LDAP_RES_MODIFY             0x07L
132 #define OLD_LDAP_RES_ADD                0x09L
133 #define OLD_LDAP_RES_DELETE             0x0bL
134 #define OLD_LDAP_RES_MODRDN             0x0dL
135 #define OLD_LDAP_RES_COMPARE            0x0fL
136
137 /* authentication methods available */
138 #define LDAP_AUTH_NONE          0x00L   /* no authentication              */
139 #define LDAP_AUTH_SIMPLE        0x80L   /* context specific + primitive   */
140 #define LDAP_AUTH_KRBV4         0xffL   /* means do both of the following */
141 #define LDAP_AUTH_KRBV41        0x81L   /* context specific + primitive   */
142 #define LDAP_AUTH_KRBV42        0x82L   /* context specific + primitive   */
143
144 /* 3.0 compatibility auth methods */
145 #define LDAP_AUTH_SIMPLE_30     0xa0L   /* context specific + constructed */
146 #define LDAP_AUTH_KRBV41_30     0xa1L   /* context specific + constructed */
147 #define LDAP_AUTH_KRBV42_30     0xa2L   /* context specific + constructed */
148
149 /* old broken stuff */
150 #define OLD_LDAP_AUTH_SIMPLE    0x00L
151 #define OLD_LDAP_AUTH_KRBV4     0x01L
152 #define OLD_LDAP_AUTH_KRBV42    0x02L
153
154 /* filter types */
155 #define LDAP_FILTER_AND         0xa0L   /* context specific + constructed */
156 #define LDAP_FILTER_OR          0xa1L   /* context specific + constructed */
157 #define LDAP_FILTER_NOT         0xa2L   /* context specific + constructed */
158 #define LDAP_FILTER_EQUALITY    0xa3L   /* context specific + constructed */
159 #define LDAP_FILTER_SUBSTRINGS  0xa4L   /* context specific + constructed */
160 #define LDAP_FILTER_GE          0xa5L   /* context specific + constructed */
161 #define LDAP_FILTER_LE          0xa6L   /* context specific + constructed */
162 #define LDAP_FILTER_PRESENT     0x87L   /* context specific + primitive   */
163 #define LDAP_FILTER_APPROX      0xa8L   /* context specific + constructed */
164
165 /* 3.0 compatibility filter types */
166 #define LDAP_FILTER_PRESENT_30  0xa7L   /* context specific + constructed */
167
168 /* old broken stuff */
169 #define OLD_LDAP_FILTER_AND             0x00L
170 #define OLD_LDAP_FILTER_OR              0x01L
171 #define OLD_LDAP_FILTER_NOT             0x02L
172 #define OLD_LDAP_FILTER_EQUALITY        0x03L
173 #define OLD_LDAP_FILTER_SUBSTRINGS      0x04L
174 #define OLD_LDAP_FILTER_GE              0x05L
175 #define OLD_LDAP_FILTER_LE              0x06L
176 #define OLD_LDAP_FILTER_PRESENT         0x07L
177 #define OLD_LDAP_FILTER_APPROX          0x08L
178
179 /* substring filter component types */
180 #define LDAP_SUBSTRING_INITIAL  0x80L   /* context specific */
181 #define LDAP_SUBSTRING_ANY      0x81L   /* context specific */
182 #define LDAP_SUBSTRING_FINAL    0x82L   /* context specific */
183
184 /* 3.0 compatibility substring filter component types */
185 #define LDAP_SUBSTRING_INITIAL_30       0xa0L   /* context specific */
186 #define LDAP_SUBSTRING_ANY_30           0xa1L   /* context specific */
187 #define LDAP_SUBSTRING_FINAL_30         0xa2L   /* context specific */
188
189 /* old broken stuff */
190 #define OLD_LDAP_SUBSTRING_INITIAL      0x00L
191 #define OLD_LDAP_SUBSTRING_ANY          0x01L
192 #define OLD_LDAP_SUBSTRING_FINAL        0x02L
193
194 /* search scopes */
195 #define LDAP_SCOPE_BASE         0x00
196 #define LDAP_SCOPE_ONELEVEL     0x01
197 #define LDAP_SCOPE_SUBTREE      0x02
198
199 /* for modifications */
200 typedef struct ldapmod {
201         int             mod_op;
202 #define LDAP_MOD_ADD            0x00
203 #define LDAP_MOD_DELETE         0x01
204 #define LDAP_MOD_REPLACE        0x02
205 #define LDAP_MOD_BVALUES        0x80
206         char            *mod_type;
207         union {
208                 char            **modv_strvals;
209                 struct berval   **modv_bvals;
210         } mod_vals;
211 #define mod_values      mod_vals.modv_strvals
212 #define mod_bvalues     mod_vals.modv_bvals
213         struct ldapmod  *mod_next;
214 } LDAPMod;
215
216 /* 
217  * possible error codes we can return
218  */
219
220 #define LDAP_SUCCESS                    0x00
221 #define LDAP_OPERATIONS_ERROR           0x01
222 #define LDAP_PROTOCOL_ERROR             0x02
223 #define LDAP_TIMELIMIT_EXCEEDED         0x03
224 #define LDAP_SIZELIMIT_EXCEEDED         0x04
225 #define LDAP_COMPARE_FALSE              0x05
226 #define LDAP_COMPARE_TRUE               0x06
227 #define LDAP_STRONG_AUTH_NOT_SUPPORTED  0x07
228 #define LDAP_STRONG_AUTH_REQUIRED       0x08
229 #define LDAP_PARTIAL_RESULTS            0x09
230
231 #define LDAP_NO_SUCH_ATTRIBUTE          0x10
232 #define LDAP_UNDEFINED_TYPE             0x11
233 #define LDAP_INAPPROPRIATE_MATCHING     0x12
234 #define LDAP_CONSTRAINT_VIOLATION       0x13
235 #define LDAP_TYPE_OR_VALUE_EXISTS       0x14
236 #define LDAP_INVALID_SYNTAX             0x15
237
238 #define LDAP_NO_SUCH_OBJECT             0x20
239 #define LDAP_ALIAS_PROBLEM              0x21
240 #define LDAP_INVALID_DN_SYNTAX          0x22
241 #define LDAP_IS_LEAF                    0x23
242 #define LDAP_ALIAS_DEREF_PROBLEM        0x24
243
244 #define NAME_ERROR(n)   ((n & 0xf0) == 0x20)
245
246 #define LDAP_INAPPROPRIATE_AUTH         0x30
247 #define LDAP_INVALID_CREDENTIALS        0x31
248 #define LDAP_INSUFFICIENT_ACCESS        0x32
249 #define LDAP_BUSY                       0x33
250 #define LDAP_UNAVAILABLE                0x34
251 #define LDAP_UNWILLING_TO_PERFORM       0x35
252 #define LDAP_LOOP_DETECT                0x36
253
254 #define LDAP_NAMING_VIOLATION           0x40
255 #define LDAP_OBJECT_CLASS_VIOLATION     0x41
256 #define LDAP_NOT_ALLOWED_ON_NONLEAF     0x42
257 #define LDAP_NOT_ALLOWED_ON_RDN         0x43
258 #define LDAP_ALREADY_EXISTS             0x44
259 #define LDAP_NO_OBJECT_CLASS_MODS       0x45
260 #define LDAP_RESULTS_TOO_LARGE          0x46
261
262 #define LDAP_OTHER                      0x50
263 #define LDAP_SERVER_DOWN                0x51
264 #define LDAP_LOCAL_ERROR                0x52
265 #define LDAP_ENCODING_ERROR             0x53
266 #define LDAP_DECODING_ERROR             0x54
267 #define LDAP_TIMEOUT                    0x55
268 #define LDAP_AUTH_UNKNOWN               0x56
269 #define LDAP_FILTER_ERROR               0x57
270 #define LDAP_USER_CANCELLED             0x58
271 #define LDAP_PARAM_ERROR                0x59
272 #define LDAP_NO_MEMORY                  0x5a
273
274
275 /* default limit on nesting of referrals */
276 #define LDAP_DEFAULT_REFHOPLIMIT        5
277
278 /*
279  * This structure represents both ldap messages and ldap responses.
280  * These are really the same, except in the case of search responses,
281  * where a response has multiple messages.
282  */
283
284 typedef struct ldapmsg {
285         int             lm_msgid;       /* the message id */
286         int             lm_msgtype;     /* the message type */
287         BerElement      *lm_ber;        /* the ber encoded message contents */
288         struct ldapmsg  *lm_chain;      /* for search - next msg in the resp */
289         struct ldapmsg  *lm_next;       /* next response */
290         unsigned int    lm_time;        /* used to maintain cache */
291 } LDAPMessage;
292 #define NULLMSG ((LDAPMessage *) NULL)
293
294
295 #ifdef LDAP_REFERRALS
296 /*
297  * structure for tracking LDAP server host, ports, DNs, etc.
298  */
299 typedef struct ldap_server {
300         char                    *lsrv_host;
301         char                    *lsrv_dn;       /* if NULL, use default */
302         int                     lsrv_port;
303         struct ldap_server      *lsrv_next;
304 } LDAPServer;
305
306
307 /*
308  * structure for representing an LDAP server connection
309  */
310 typedef struct ldap_conn {
311         Sockbuf                 *lconn_sb;
312         int                     lconn_refcnt;
313         time_t          lconn_lastused; /* time */
314         int                     lconn_status;
315 #define LDAP_CONNST_NEEDSOCKET          1
316 #define LDAP_CONNST_CONNECTING          2
317 #define LDAP_CONNST_CONNECTED           3
318         LDAPServer              *lconn_server;
319         char                    *lconn_krbinstance;
320         struct ldap_conn        *lconn_next;
321 } LDAPConn;
322
323
324 /*
325  * structure used to track outstanding requests
326  */
327 typedef struct ldapreq {
328         int             lr_msgid;       /* the message id */
329         int             lr_status;      /* status of request */
330 #define LDAP_REQST_INPROGRESS   1
331 #define LDAP_REQST_CHASINGREFS  2
332 #define LDAP_REQST_NOTCONNECTED 3
333 #define LDAP_REQST_WRITING      4
334         int             lr_outrefcnt;   /* count of outstanding referrals */
335         int             lr_origid;      /* original request's message id */
336         int             lr_parentcnt;   /* count of parent requests */
337         int             lr_res_msgtype; /* result message type */
338         int             lr_res_errno;   /* result LDAP errno */
339         char            *lr_res_error;  /* result error string */
340         char            *lr_res_matched;/* result matched DN string */
341         BerElement      *lr_ber;        /* ber encoded request contents */
342         LDAPConn        *lr_conn;       /* connection used to send request */
343         struct ldapreq  *lr_parent;     /* request that spawned this referral */
344         struct ldapreq  *lr_refnext;    /* next referral spawned */
345         struct ldapreq  *lr_prev;       /* previous request */
346         struct ldapreq  *lr_next;       /* next request */
347 } LDAPRequest;
348 #endif /* LDAP_REFERRALS */
349
350
351 /*
352  * structure for client cache
353  */
354 #define LDAP_CACHE_BUCKETS      31      /* cache hash table size */
355 typedef struct ldapcache {
356         LDAPMessage     *lc_buckets[LDAP_CACHE_BUCKETS];/* hash table */
357         LDAPMessage     *lc_requests;                   /* unfulfilled reqs */
358         long            lc_timeout;                     /* request timeout */
359         long            lc_maxmem;                      /* memory to use */
360         long            lc_memused;                     /* memory in use */
361         int             lc_enabled;                     /* enabled? */
362         unsigned long   lc_options;                     /* options */
363 #define LDAP_CACHE_OPT_CACHENOERRS      0x00000001
364 #define LDAP_CACHE_OPT_CACHEALLERRS     0x00000002
365 }  LDAPCache;
366 #define NULLLDCACHE ((LDAPCache *)NULL)
367
368 /*
369  * structures for ldap getfilter routines
370  */
371
372 typedef struct ldap_filt_info {
373         char                    *lfi_filter;
374         char                    *lfi_desc;
375         int                     lfi_scope;      /* LDAP_SCOPE_BASE, etc */
376         int                     lfi_isexact;    /* exact match filter? */
377         struct ldap_filt_info   *lfi_next;
378 } LDAPFiltInfo;
379
380 typedef struct ldap_filt_list {
381     char                        *lfl_tag;
382     char                        *lfl_pattern;
383     char                        *lfl_delims;
384     LDAPFiltInfo                *lfl_ilist;
385     struct ldap_filt_list       *lfl_next;
386 } LDAPFiltList;
387
388
389 #define LDAP_FILT_MAXSIZ        1024
390
391 typedef struct ldap_filt_desc {
392         LDAPFiltList            *lfd_filtlist;
393         LDAPFiltInfo            *lfd_curfip;
394         LDAPFiltInfo            lfd_retfi;
395         char                    lfd_filter[ LDAP_FILT_MAXSIZ ];
396         char                    *lfd_curval;
397         char                    *lfd_curvalcopy;
398         char                    **lfd_curvalwords;
399         char                    *lfd_filtprefix;
400         char                    *lfd_filtsuffix;
401 } LDAPFiltDesc;
402
403
404 /*
405  * structure representing an ldap connection
406  */
407
408 typedef struct ldap {
409         Sockbuf         ld_sb;          /* socket descriptor & buffer */
410         char            *ld_host;
411         int             ld_version;
412         char            ld_lberoptions;
413         int             ld_deref;
414 #define LDAP_DEREF_NEVER        0
415 #define LDAP_DEREF_SEARCHING    1
416 #define LDAP_DEREF_FINDING      2
417 #define LDAP_DEREF_ALWAYS       3
418
419         int             ld_timelimit;
420         int             ld_sizelimit;
421 #define LDAP_NO_LIMIT           0
422
423         LDAPFiltDesc    *ld_filtd;      /* from getfilter for ufn searches */
424         char            *ld_ufnprefix;  /* for incomplete ufn's */
425
426         int             ld_errno;
427         char            *ld_error;
428         char            *ld_matched;
429         int             ld_msgid;
430
431         /* do not mess with these */
432 #ifdef LDAP_REFERRALS
433         LDAPRequest     *ld_requests;   /* list of outstanding requests */
434 #else /* LDAP_REFERRALS */
435         LDAPMessage     *ld_requests;   /* list of outstanding requests */
436 #endif /* LDAP_REFERRALS */
437         LDAPMessage     *ld_responses;  /* list of outstanding responses */
438         int             *ld_abandoned;  /* array of abandoned requests */
439         char            ld_attrbuffer[LDAP_MAX_ATTR_LEN];
440         LDAPCache       *ld_cache;      /* non-null if cache is initialized */
441         char            *ld_cldapdn;    /* DN used in connectionless search */
442
443         /* it is OK to change these next four values directly */
444         int             ld_cldaptries;  /* connectionless search retry count */
445         int             ld_cldaptimeout;/* time between retries */
446         int             ld_refhoplimit; /* limit on referral nesting */
447         unsigned long   ld_options;     /* boolean options */
448 #define LDAP_OPT_DNS            0x00000001      /* use DN & DNS */
449 #define LDAP_OPT_REFERRALS      0x00000002      /* chase referrals */
450 #define LDAP_OPT_RESTART        0x00000004      /* restart if EINTR occurs */
451
452         /* do not mess with the rest though */
453         char            *ld_defhost;    /* full name of default server */
454         int             ld_defport;     /* port of default server */
455         BERTranslateProc ld_lber_encode_translate_proc;
456         BERTranslateProc ld_lber_decode_translate_proc;
457 #ifdef LDAP_REFERRALS
458         LDAPConn        *ld_defconn;    /* default connection */
459         LDAPConn        *ld_conns;      /* list of server connections */
460         void            *ld_selectinfo; /* platform specifics for select */
461         int             (*ld_rebindproc)( struct ldap *ld, char **dnp,
462                                 char **passwdp, int *authmethodp, int freeit );
463                                 /* routine to get info needed for re-bind */
464 #endif /* LDAP_REFERRALS */
465 } LDAP;
466
467
468 /*
469  * structure for ldap friendly mapping routines
470  */
471
472 typedef struct friendly {
473         char    *f_unfriendly;
474         char    *f_friendly;
475 } FriendlyMap;
476
477
478 /*
479  * handy macro to check whether LDAP struct is set up for CLDAP or not
480  */
481 #define LDAP_IS_CLDAP( ld )     ( ld->ld_sb.sb_naddr > 0 )
482
483
484 /*
485  * types for ldap URL handling
486  */
487 typedef struct ldap_url_desc {
488     char        *lud_host;
489     int         lud_port;
490     char        *lud_dn;
491     char        **lud_attrs;
492     int         lud_scope;
493     char        *lud_filter;
494     char        *lud_string;    /* for internal use only */
495 } LDAPURLDesc;
496 #define NULLLDAPURLDESC ((LDAPURLDesc *)NULL)
497
498 #define LDAP_URL_ERR_NOTLDAP    1       /* URL doesn't begin with "ldap://" */
499 #define LDAP_URL_ERR_NODN       2       /* URL has no DN (required) */
500 #define LDAP_URL_ERR_BADSCOPE   3       /* URL scope string is invalid */
501 #define LDAP_URL_ERR_MEM        4       /* can't allocate memory space */
502
503 /*
504  * in abandon.c:
505  */
506 LDAP_F int ldap_abandon LDAP_P(( LDAP *ld, int msgid ));
507
508 /*
509  * in add.c:
510  */
511 LDAP_F int ldap_add LDAP_P(( LDAP *ld, char *dn, LDAPMod **attrs ));
512 LDAP_F int ldap_add_s LDAP_P(( LDAP *ld, char *dn, LDAPMod **attrs ));
513
514 /*
515  * in bind.c:
516  */
517 LDAP_F int ldap_bind LDAP_P(( LDAP *ld, char *who, char *passwd, int authmethod ));
518 LDAP_F int ldap_bind_s LDAP_P(( LDAP *ld, char *who, char *cred, int method ));
519 LDAP_F void ldap_set_rebind_proc LDAP_P(( LDAP *ld,
520         int (*rebindproc) LDAP_P(( LDAP *ld, char **dnp, char **passwdp, int *authmethodp, int freeit ))
521 ));
522
523 /*
524  * in sbind.c:
525  */
526 LDAP_F int ldap_simple_bind LDAP_P(( LDAP *ld, char *who, char *passwd ));
527 LDAP_F int ldap_simple_bind_s LDAP_P(( LDAP *ld, char *who, char *passwd ));
528
529 /*
530  * in kbind.c:
531  */
532 LDAP_F int ldap_kerberos_bind_s LDAP_P(( LDAP *ld, char *who ));
533 LDAP_F int ldap_kerberos_bind1 LDAP_P(( LDAP *ld, char *who ));
534 LDAP_F int ldap_kerberos_bind1_s LDAP_P(( LDAP *ld, char *who ));
535 LDAP_F int ldap_kerberos_bind2 LDAP_P(( LDAP *ld, char *who ));
536 LDAP_F int ldap_kerberos_bind2_s LDAP_P(( LDAP *ld, char *who ));
537  
538
539 /*
540  * in cache.c
541  */
542 LDAP_F int ldap_enable_cache LDAP_P(( LDAP *ld, long timeout, long maxmem ));
543 LDAP_F void ldap_disable_cache LDAP_P(( LDAP *ld ));
544 LDAP_F void ldap_set_cache_options LDAP_P(( LDAP *ld, unsigned long opts ));
545 LDAP_F void ldap_destroy_cache LDAP_P(( LDAP *ld ));
546 LDAP_F void ldap_flush_cache LDAP_P(( LDAP *ld ));
547 LDAP_F void ldap_uncache_entry LDAP_P(( LDAP *ld, char *dn ));
548 LDAP_F void ldap_uncache_request LDAP_P(( LDAP *ld, int msgid ));
549
550 /*
551  * in compare.c:
552  */
553 LDAP_F int ldap_compare LDAP_P(( LDAP *ld, char *dn, char *attr, char *value ));
554 LDAP_F int ldap_compare_s LDAP_P(( LDAP *ld, char *dn, char *attr, char *value ));
555
556 /*
557  * in delete.c:
558  */
559 LDAP_F int ldap_delete LDAP_P(( LDAP *ld, char *dn ));
560 LDAP_F int ldap_delete_s LDAP_P(( LDAP *ld, char *dn ));
561
562 /*
563  * in error.c:
564  */
565 LDAP_F int ldap_result2error LDAP_P(( LDAP *ld, LDAPMessage *r, int freeit ));
566 LDAP_F char *ldap_err2string LDAP_P(( int err ));
567 LDAP_F void ldap_perror LDAP_P(( LDAP *ld, char *s ));
568
569 /*
570  * in modify.c:
571  */
572 LDAP_F int ldap_modify LDAP_P(( LDAP *ld, char *dn, LDAPMod **mods ));
573 LDAP_F int ldap_modify_s LDAP_P(( LDAP *ld, char *dn, LDAPMod **mods ));
574
575 /*
576  * in modrdn.c:
577  */
578 LDAP_F int ldap_modrdn LDAP_P(( LDAP *ld, char *dn, char *newrdn ));
579 LDAP_F int ldap_modrdn_s LDAP_P(( LDAP *ld, char *dn, char *newrdn ));
580 LDAP_F int ldap_modrdn2 LDAP_P(( LDAP *ld, char *dn, char *newrdn,
581         int deleteoldrdn ));
582 LDAP_F int ldap_modrdn2_s LDAP_P(( LDAP *ld, char *dn, char *newrdn,
583         int deleteoldrdn));
584
585 /*
586  * in open.c:
587  */
588 LDAP_F LDAP *ldap_open LDAP_P(( char *host, int port ));
589 LDAP_F LDAP *ldap_init LDAP_P(( char *defhost, int defport ));
590
591 /*
592  * in getentry.c:
593  */
594 LDAP_F LDAPMessage *ldap_first_entry LDAP_P(( LDAP *ld, LDAPMessage *chain ));
595 LDAP_F LDAPMessage *ldap_next_entry LDAP_P(( LDAP *ld, LDAPMessage *entry ));
596 LDAP_F int ldap_count_entries LDAP_P(( LDAP *ld, LDAPMessage *chain ));
597
598 /*
599  * in addentry.c
600  */
601 LDAP_F LDAPMessage *ldap_delete_result_entry LDAP_P(( LDAPMessage **list,
602         LDAPMessage *e ));
603 LDAP_F void ldap_add_result_entry LDAP_P(( LDAPMessage **list, LDAPMessage *e ));
604
605 /*
606  * in getdn.c
607  */
608 LDAP_F char *ldap_get_dn LDAP_P(( LDAP *ld, LDAPMessage *entry ));
609 LDAP_F char *ldap_dn2ufn LDAP_P(( char *dn ));
610 LDAP_F char **ldap_explode_dn LDAP_P(( char *dn, int notypes ));
611 LDAP_F char **ldap_explode_dns LDAP_P(( char *dn ));
612 LDAP_F int ldap_is_dns_dn LDAP_P(( char *dn ));
613
614 /*
615  * in getattr.c
616  */
617 LDAP_F char *ldap_first_attribute LDAP_P(( LDAP *ld, LDAPMessage *entry,
618         BerElement **ber ));
619 LDAP_F char *ldap_next_attribute LDAP_P(( LDAP *ld, LDAPMessage *entry,
620         BerElement *ber ));
621
622 /*
623  * in getvalues.c
624  */
625 LDAP_F char **ldap_get_values LDAP_P(( LDAP *ld, LDAPMessage *entry, char *target ));
626 LDAP_F struct berval **ldap_get_values_len LDAP_P(( LDAP *ld, LDAPMessage *entry,
627         char *target ));
628 LDAP_F int ldap_count_values LDAP_P(( char **vals ));
629 LDAP_F int ldap_count_values_len LDAP_P(( struct berval **vals ));
630 LDAP_F void ldap_value_free LDAP_P(( char **vals ));
631 LDAP_F void ldap_value_free_len LDAP_P(( struct berval **vals ));
632
633 /*
634  * in result.c:
635  */
636 LDAP_F int ldap_result LDAP_P(( LDAP *ld, int msgid, int all,
637         LDAP_timeval_p timeout, LDAPMessage **result ));
638 LDAP_F int ldap_msgfree LDAP_P(( LDAPMessage *lm ));
639 LDAP_F int ldap_msgdelete LDAP_P(( LDAP *ld, int msgid ));
640
641 /*
642  * in search.c:
643  */
644 LDAP_F int ldap_search LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
645         char **attrs, int attrsonly ));
646 LDAP_F int ldap_search_s LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
647         char **attrs, int attrsonly, LDAPMessage **res ));
648 LDAP_F int ldap_search_st LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
649     char **attrs, int attrsonly, struct timeval *timeout, LDAPMessage **res ));
650
651 /*
652  * in ufn.c
653  */
654 LDAP_F int ldap_ufn_search_c LDAP_P(( LDAP *ld, char *ufn, char **attrs,
655         int attrsonly, LDAPMessage **res, int (*cancelproc)( void *cl ),
656         void *cancelparm ));
657 LDAP_F int ldap_ufn_search_ct LDAP_P(( LDAP *ld, char *ufn, char **attrs,
658         int attrsonly, LDAPMessage **res, int (*cancelproc)( void *cl ),
659         void *cancelparm, char *tag1, char *tag2, char *tag3 ));
660 LDAP_F int ldap_ufn_search_s LDAP_P(( LDAP *ld, char *ufn, char **attrs,
661         int attrsonly, LDAPMessage **res ));
662 LDAP_F LDAPFiltDesc *ldap_ufn_setfilter LDAP_P(( LDAP *ld, char *fname ));
663 LDAP_F void ldap_ufn_setprefix LDAP_P(( LDAP *ld, char *prefix ));
664 LDAP_F int ldap_ufn_timeout LDAP_P(( void *tvparam ));
665
666
667 /*
668  * in unbind.c
669  */
670 LDAP_F int ldap_unbind LDAP_P(( LDAP *ld ));
671 LDAP_F int ldap_unbind_s LDAP_P(( LDAP *ld ));
672
673
674 /*
675  * in getfilter.c
676  */
677 LDAP_F LDAPFiltDesc *ldap_init_getfilter LDAP_P(( char *fname ));
678 LDAP_F LDAPFiltDesc *ldap_init_getfilter_buf LDAP_P(( char *buf, long buflen ));
679 LDAP_F LDAPFiltInfo *ldap_getfirstfilter LDAP_P(( LDAPFiltDesc *lfdp, char *tagpat,
680         char *value ));
681 LDAP_F LDAPFiltInfo *ldap_getnextfilter LDAP_P(( LDAPFiltDesc *lfdp ));
682 LDAP_F void ldap_setfilteraffixes LDAP_P(( LDAPFiltDesc *lfdp, char *prefix, char *suffix ));
683 LDAP_F void ldap_build_filter LDAP_P(( char *buf, unsigned long buflen,
684         char *pattern, char *prefix, char *suffix, char *attr,
685         char *value, char **valwords ));
686
687 /*
688  * in free.c
689  */
690 LDAP_F void ldap_getfilter_free LDAP_P(( LDAPFiltDesc *lfdp ));
691 LDAP_F void ldap_mods_free LDAP_P(( LDAPMod **mods, int freemods ));
692
693 /*
694  * in friendly.c
695  */
696 LDAP_F char *ldap_friendly_name LDAP_P(( char *filename, char *uname,
697         FriendlyMap **map ));
698 LDAP_F void ldap_free_friendlymap LDAP_P(( FriendlyMap **map ));
699
700
701 /*
702  * in cldap.c
703  */
704 LDAP_F LDAP *cldap_open LDAP_P(( char *host, int port ));
705 LDAP_F void cldap_close LDAP_P(( LDAP *ld ));
706 LDAP_F int cldap_search_s LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
707         char **attrs, int attrsonly, LDAPMessage **res, char *logdn ));
708 LDAP_F void cldap_setretryinfo LDAP_P(( LDAP *ld, int tries, int timeout ));
709
710
711 /*
712  * in sort.c
713  */
714 LDAP_F int ldap_sort_entries LDAP_P(( LDAP *ld,
715         LDAPMessage **chain, char *attr, int (*cmp) () ));
716 LDAP_F int ldap_sort_values LDAP_P(( LDAP *ld,
717         char **vals, int (*cmp) LDAP_P((const void *, const void *)) ));
718 LDAP_F int ldap_sort_strcasecmp LDAP_P(( char **a, char **b ));
719
720
721 /*
722  * in url.c
723  */
724 LDAP_F int ldap_is_ldap_url LDAP_P(( char *url ));
725 LDAP_F int ldap_url_parse LDAP_P(( char *url, LDAPURLDesc **ludpp ));
726 LDAP_F void ldap_free_urldesc LDAP_P(( LDAPURLDesc *ludp ));
727 LDAP_F int ldap_url_search LDAP_P(( LDAP *ld, char *url, int attrsonly ));
728 LDAP_F int ldap_url_search_s LDAP_P(( LDAP *ld, char *url, int attrsonly,
729         LDAPMessage **res ));
730 LDAP_F int ldap_url_search_st LDAP_P(( LDAP *ld, char *url, int attrsonly,
731         struct timeval *timeout, LDAPMessage **res ));
732
733
734 /*
735  * in charset.c
736  */
737 LDAP_F void ldap_set_string_translators LDAP_P(( LDAP *ld,
738         BERTranslateProc encode_proc, BERTranslateProc decode_proc ));
739 LDAP_F int ldap_translate_from_t61 LDAP_P(( LDAP *ld, char **bufp,
740         unsigned long *lenp, int free_input ));
741 LDAP_F int ldap_translate_to_t61 LDAP_P(( LDAP *ld, char **bufp,
742         unsigned long *lenp, int free_input ));
743 LDAP_F void ldap_enable_translation LDAP_P(( LDAP *ld, LDAPMessage *entry,
744         int enable ));
745
746 LDAP_F int ldap_t61_to_8859 LDAP_P(( char **bufp, unsigned long *buflenp,
747         int free_input ));
748 LDAP_F int ldap_8859_to_t61 LDAP_P(( char **bufp, unsigned long *buflenp,
749         int free_input ));
750
751
752 /*
753  * in msdos/winsock/wsa.c
754  */
755 LDAP_F void ldap_memfree LDAP_P(( void *p ));
756
757 LDAP_END_DECL
758
759 #endif /* _LDAP_H */