ldap-int.h 18.7 KB
Newer Older
Kurt Zeilenga's avatar
Kurt Zeilenga committed
1
/*  ldap-int.h - defines & prototypes internal to the LDAP library */
2
/* $OpenLDAP$ */
3
4
/* This work is part of OpenLDAP Software <http://www.openldap.org/>.
 *
Kurt Zeilenga's avatar
Kurt Zeilenga committed
5
 * Copyright 1998-2007 The OpenLDAP Foundation.
6
7
8
9
10
11
12
13
14
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted only as authorized by the OpenLDAP
 * Public License.
 *
 * A copy of this license is available in the file LICENSE in the
 * top-level directory of the distribution or, alternatively, at
 * <http://www.OpenLDAP.org/license.html>.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
15
 */
16
/*  Portions Copyright (c) 1995 Regents of the University of Michigan.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
17
18
19
 *  All rights reserved.
 */

20
21
#ifndef	_LDAP_INT_H
#define	_LDAP_INT_H 1
Kurt Zeilenga's avatar
Kurt Zeilenga committed
22

23
#ifdef LDAP_R_COMPILE
24
25
26
#define LDAP_THREAD_SAFE 1
#endif

27
#include "../liblber/lber-int.h"
28

29
30
31
32
#ifdef LDAP_R_COMPILE
#include <ldap_pvt_thread.h>
#endif

33
34
#ifdef HAVE_CYRUS_SASL
	/* the need for this should be removed */
Howard Chu's avatar
Howard Chu committed
35
#ifdef HAVE_SASL_SASL_H
36
37
#include <sasl/sasl.h>
#else
38
#include <sasl.h>
39
#endif
Kurt Zeilenga's avatar
Kurt Zeilenga committed
40
41
42

#define SASL_MAX_BUFF_SIZE	65536
#define SASL_MIN_BUFF_SIZE	4096
43
44
#endif

Kurt Zeilenga's avatar
Kurt Zeilenga committed
45
46
47
/* for struct timeval */
#include <ac/time.h>

48
#undef TV2MILLISEC
49
#define TV2MILLISEC(tv) (((tv)->tv_sec * 1000) + ((tv)->tv_usec/1000))
50

51
52
53
54
55
56
57
58
59
60
61
62
63
64
/* 
 * Support needed if the library is running in the kernel
 */
#if LDAP_INT_IN_KERNEL
	/* 
	 * Platform specific function to return a pointer to the
	 * process-specific global options. 
	 *
	 * This function should perform the following functions:
	 *  Allocate and initialize a global options struct on a per process basis
	 *  Use callers process identifier to return its global options struct
	 *  Note: Deallocate structure when the process exits
	 */
#	define LDAP_INT_GLOBAL_OPT() ldap_int_global_opt()
Kurt Zeilenga's avatar
Kurt Zeilenga committed
65
	struct ldapoptions *ldap_int_global_opt(void);
66
67
68
69
70
#else
#	define LDAP_INT_GLOBAL_OPT() (&ldap_int_global_options)
#endif

#define ldap_debug	((LDAP_INT_GLOBAL_OPT())->ldo_debug)
71
72
73

#include "ldap_log.h"

74
#undef Debug
75
76
77

#ifdef LDAP_DEBUG

78
#define Debug( level, fmt, arg1, arg2, arg3 ) \
Howard Chu's avatar
Howard Chu committed
79
80
81
	do { if ( ldap_debug & level ) \
	ldap_log_printf( NULL, (level), (fmt), (arg1), (arg2), (arg3) ); \
	} while ( 0 )
82

Gary Williams's avatar
Gary Williams committed
83
84
85
#define LDAP_Debug( subsystem, level, fmt, arg1, arg2, arg3 )\
	ldap_log_printf( NULL, (level), (fmt), (arg1), (arg2), (arg3) )

86
87
88
89
90
91
92
#else

#define Debug( level, fmt, arg1, arg2, arg3 )                 ((void)0)
#define LDAP_Debug( subsystem, level, fmt, arg1, arg2, arg3 ) ((void)0)

#endif /* LDAP_DEBUG */

Kurt Zeilenga's avatar
Kurt Zeilenga committed
93
#define LDAP_DEPRECATED 1
94
95
#include "ldap.h"

Bart Hartgers's avatar
   
Bart Hartgers committed
96
97
#include "ldap_pvt.h"

98
99
LDAP_BEGIN_DECL

Kurt Zeilenga's avatar
Kurt Zeilenga committed
100
#define LDAP_URL_PREFIX         "ldap://"
Pierangelo Masarati's avatar
Pierangelo Masarati committed
101
102
103
#define LDAP_URL_PREFIX_LEN     STRLENOF(LDAP_URL_PREFIX)
#define LDAPS_URL_PREFIX	"ldaps://"
#define LDAPS_URL_PREFIX_LEN	STRLENOF(LDAPS_URL_PREFIX)
104
#define LDAPI_URL_PREFIX	"ldapi://"
Pierangelo Masarati's avatar
Pierangelo Masarati committed
105
#define LDAPI_URL_PREFIX_LEN	STRLENOF(LDAPI_URL_PREFIX)
106
107
#ifdef LDAP_CONNECTIONLESS
#define LDAPC_URL_PREFIX	"cldap://"
Pierangelo Masarati's avatar
Pierangelo Masarati committed
108
#define LDAPC_URL_PREFIX_LEN	STRLENOF(LDAPC_URL_PREFIX)
109
#endif
Pierangelo Masarati's avatar
Pierangelo Masarati committed
110
111
#define LDAP_URL_URLCOLON	"URL:"
#define LDAP_URL_URLCOLON_LEN	STRLENOF(LDAP_URL_URLCOLON)
Kurt Zeilenga's avatar
Kurt Zeilenga committed
112

Kurt Zeilenga's avatar
Kurt Zeilenga committed
113
#define LDAP_REF_STR		"Referral:\n"
Pierangelo Masarati's avatar
Pierangelo Masarati committed
114
#define LDAP_REF_STR_LEN	STRLENOF(LDAP_REF_STR)
Kurt Zeilenga's avatar
Kurt Zeilenga committed
115
#define LDAP_LDAP_REF_STR	LDAP_URL_PREFIX
Kurt Zeilenga's avatar
Kurt Zeilenga committed
116
#define LDAP_LDAP_REF_STR_LEN	LDAP_URL_PREFIX_LEN
Kurt Zeilenga's avatar
Kurt Zeilenga committed
117

118
119
#define LDAP_DEFAULT_REFHOPLIMIT 5

120
121
#define LDAP_BOOL_REFERRALS		0
#define LDAP_BOOL_RESTART		1
Julio Sánchez Fernández's avatar
Julio Sánchez Fernández committed
122
#define LDAP_BOOL_TLS			3
123
#define	LDAP_BOOL_CONNECT_ASYNC		4
124

125
#define LDAP_BOOLEANS	unsigned long
126
#define LDAP_BOOL(n)	((LDAP_BOOLEANS)1 << (n))
Kurt Zeilenga's avatar
Kurt Zeilenga committed
127
128
#define LDAP_BOOL_GET(lo, bool)	\
	((lo)->ldo_booleans & LDAP_BOOL(bool) ? -1 : 0)
129
130
131
#define LDAP_BOOL_SET(lo, bool) ((lo)->ldo_booleans |= LDAP_BOOL(bool))
#define LDAP_BOOL_CLR(lo, bool) ((lo)->ldo_booleans &= ~LDAP_BOOL(bool))
#define LDAP_BOOL_ZERO(lo) ((lo)->ldo_booleans = 0)
132

133
134
135
136
137
138
/*
 * This structure represents both ldap messages and ldap responses.
 * These are really the same, except in the case of search responses,
 * where a response has multiple messages.
 */

139
struct ldapmsg {
140
141
	ber_int_t		lm_msgid;	/* the message id */
	ber_tag_t		lm_msgtype;	/* the message type */
142
143
	BerElement	*lm_ber;	/* the ber encoded message contents */
	struct ldapmsg	*lm_chain;	/* for search - next msg in the resp */
144
	struct ldapmsg	*lm_chain_tail;
145
	struct ldapmsg	*lm_next;	/* next response */
146
	time_t	lm_time;	/* used to maintain cache */
147
};
148

Howard Chu's avatar
Howard Chu committed
149
150
151
152
153
154
155
156
157
158
159
#ifdef HAVE_TLS
struct ldaptls {
	char		*lt_certfile;
	char		*lt_keyfile;
	char		*lt_dhfile;
	char		*lt_cacertfile;
	char		*lt_cacertdir;
	char		*lt_ciphersuite;
};
#endif

160
161
162
163
164
/*
 * structure representing get/set'able options
 * which have global defaults.
 */
struct ldapoptions {
165
166
167
168
	short ldo_valid;
#define LDAP_UNINITIALIZED	0x0
#define LDAP_INITIALIZED	0x1
#define LDAP_VALID_SESSION	0x2
Pierangelo Masarati's avatar
cleanup    
Pierangelo Masarati committed
169
#define LDAP_TRASHED_SESSION	0xFF
170
	int   ldo_debug;
171
#ifdef LDAP_CONNECTIONLESS
Howard Chu's avatar
Howard Chu committed
172
#define	LDAP_IS_UDP(ld)		((ld)->ld_options.ldo_is_udp)
173
174
	void*			ldo_peer;	/* struct sockaddr* */
	char*			ldo_cldapdn;
Howard Chu's avatar
Howard Chu committed
175
	int			ldo_is_udp;
176
#endif
177

178
	/* per API call timeout */
Howard Chu's avatar
Howard Chu committed
179
180
	struct timeval		ldo_tm_api;
	struct timeval		ldo_tm_net;
181

182
	ber_int_t		ldo_version;
183
184
185
	ber_int_t		ldo_deref;
	ber_int_t		ldo_timelimit;
	ber_int_t		ldo_sizelimit;
186

187
#ifdef HAVE_TLS
188
189
   	/* tls context */
   	void		*ldo_tls_ctx;
190
191
	LDAP_TLS_CONNECT_CB	*ldo_tls_connect_cb;
	void*			ldo_tls_connect_arg;
Howard Chu's avatar
Howard Chu committed
192
193
194
195
196
197
198
199
200
201
202
203
	struct ldaptls ldo_tls_info;
#define ldo_tls_certfile	ldo_tls_info.lt_certfile
#define ldo_tls_keyfile	ldo_tls_info.lt_keyfile
#define ldo_tls_dhfile	ldo_tls_info.lt_dhfile
#define ldo_tls_cacertfile	ldo_tls_info.lt_cacertfile
#define ldo_tls_cacertdir	ldo_tls_info.lt_cacertdir
#define ldo_tls_ciphersuite	ldo_tls_info.lt_ciphersuite
   	int			ldo_tls_mode;
   	int			ldo_tls_require_cert;
#ifdef HAVE_OPENSSL_CRL
   	int			ldo_tls_crlcheck;
#endif
204
205
#endif

206
	LDAPURLDesc *ldo_defludp;
207
	int		ldo_defport;
208
	char*	ldo_defbase;
209
210
211
212
213
214
215
216
217
218
219
	char*	ldo_defbinddn;	/* bind dn */

#ifdef HAVE_CYRUS_SASL
	char*	ldo_def_sasl_mech;		/* SASL Mechanism(s) */
	char*	ldo_def_sasl_realm;		/* SASL realm */
	char*	ldo_def_sasl_authcid;	/* SASL authentication identity */
	char*	ldo_def_sasl_authzid;	/* SASL authorization identity */

	/* SASL Security Properties */
	struct sasl_security_properties	ldo_sasl_secprops;
#endif
220

221
222
	int		ldo_refhoplimit;	/* limit on referral nesting */

223
	/* LDAPv3 server and client controls */
Kurt Zeilenga's avatar
Kurt Zeilenga committed
224
225
	LDAPControl	**ldo_sctrls;
	LDAPControl **ldo_cctrls;
Kurt Zeilenga's avatar
Kurt Zeilenga committed
226
227

	/* LDAP rebind callback function */
Kurt Zeilenga's avatar
Kurt Zeilenga committed
228
229
	LDAP_REBIND_PROC *ldo_rebind_proc;
	void *ldo_rebind_params;
230
231
	LDAP_NEXTREF_PROC *ldo_nextref_proc;
	void *ldo_nextref_params;
232
233
	LDAP_URLLIST_PROC *ldo_urllist_proc;
	void *ldo_urllist_params;
Julio Sánchez Fernández's avatar
Julio Sánchez Fernández committed
234

235
236
237
	LDAP_BOOLEANS ldo_booleans;	/* boolean options */
};

238

239
240
241
242
/*
 * structure for representing an LDAP server connection
 */
typedef struct ldap_conn {
243
	Sockbuf		*lconn_sb;
244
#ifdef HAVE_CYRUS_SASL
245
246
	void		*lconn_sasl_authctx;	/* context for bind */
	void		*lconn_sasl_sockctx;	/* for security layer */
247
#endif
248
	int			lconn_refcnt;
249
	time_t		lconn_created;	/* time */
250
	time_t		lconn_lastused;	/* time */
251
252
	int			lconn_rebind_inprogress;	/* set if rebind in progress */
	char		***lconn_rebind_queue;		/* used if rebind in progress */
253
254
255
256
	int			lconn_status;
#define LDAP_CONNST_NEEDSOCKET		1
#define LDAP_CONNST_CONNECTING		2
#define LDAP_CONNST_CONNECTED		3
257
	LDAPURLDesc		*lconn_server;
258
259
	BerElement		*lconn_ber;	/* ber receiving on this conn. */

260
	struct ldap_conn *lconn_next;
261
262
263
264
265
266
267
} LDAPConn;


/*
 * structure used to track outstanding requests
 */
typedef struct ldapreq {
268
	ber_int_t	lr_msgid;	/* the message id */
269
	int		lr_status;	/* status of request */
270
#define LDAP_REQST_COMPLETED	0
271
272
273
274
#define LDAP_REQST_INPROGRESS	1
#define LDAP_REQST_CHASINGREFS	2
#define LDAP_REQST_NOTCONNECTED	3
#define LDAP_REQST_WRITING	4
275
	int		lr_refcnt;	/* count of references */
276
	int		lr_outrefcnt;	/* count of outstanding referrals */
277
	int		lr_abandoned;	/* the request has been abandoned */
278
	ber_int_t	lr_origid;	/* original request's message id */
279
	int		lr_parentcnt;	/* count of parent requests */
280
281
	ber_tag_t	lr_res_msgtype;	/* result message type */
	ber_int_t	lr_res_errno;	/* result LDAP errno */
282
283
284
285
	char		*lr_res_error;	/* result error string */
	char		*lr_res_matched;/* result matched DN string */
	BerElement	*lr_ber;	/* ber encoded request contents */
	LDAPConn	*lr_conn;	/* connection used to send request */
286
	struct berval	lr_dn;		/* DN of request, in lr_ber */
287
	struct ldapreq	*lr_parent;	/* request that spawned this referral */
288
	struct ldapreq	*lr_child;	/* first child request */
289
290
291
292
293
294
295
296
297
298
299
300
301
	struct ldapreq	*lr_refnext;	/* next referral spawned */
	struct ldapreq	*lr_prev;	/* previous request */
	struct ldapreq	*lr_next;	/* next request */
} LDAPRequest;

/*
 * structure for client cache
 */
#define LDAP_CACHE_BUCKETS	31	/* cache hash table size */
typedef struct ldapcache {
	LDAPMessage	*lc_buckets[LDAP_CACHE_BUCKETS];/* hash table */
	LDAPMessage	*lc_requests;			/* unfulfilled reqs */
	long		lc_timeout;			/* request timeout */
302
303
	ber_len_t		lc_maxmem;			/* memory to use */
	ber_len_t		lc_memused;			/* memory in use */
304
305
306
307
308
309
	int		lc_enabled;			/* enabled? */
	unsigned long	lc_options;			/* options */
#define LDAP_CACHE_OPT_CACHENOERRS	0x00000001
#define LDAP_CACHE_OPT_CACHEALLERRS	0x00000002
}  LDAPCache;

310
311
312
313
314
315
316
317
318
/*
 * structure containing referral request info for rebind procedure
 */
typedef struct ldapreqinfo {
	ber_len_t	ri_msgid;
	int			ri_request;
	char 		*ri_url;
} LDAPreqinfo;

319
320
321
322
/*
 * structure representing an ldap connection
 */

323
struct ldap {
324
	Sockbuf		*ld_sb;		/* socket descriptor & buffer */
325
326
327

	struct ldapoptions ld_options;

328
329
330
#define ld_valid		ld_options.ldo_valid
#define ld_debug		ld_options.ldo_debug

331
332
333
334
#define ld_deref		ld_options.ldo_deref
#define ld_timelimit	ld_options.ldo_timelimit
#define ld_sizelimit	ld_options.ldo_sizelimit

335
#define ld_defbinddn	ld_options.ldo_defbinddn
336
337
338
339
#define ld_defbase		ld_options.ldo_defbase
#define ld_defhost		ld_options.ldo_defhost
#define ld_defport		ld_options.ldo_defport

340
341
#define ld_refhoplimit	ld_options.ldo_refhoplimit

Kurt Zeilenga's avatar
Kurt Zeilenga committed
342
343
#define ld_sctrls		ld_options.ldo_sctrls
#define ld_cctrls		ld_options.ldo_cctrls
344
#define ld_rebind_proc		ld_options.ldo_rebind_proc
Kurt Zeilenga's avatar
Kurt Zeilenga committed
345
#define ld_rebind_params	ld_options.ldo_rebind_params
346
347
#define ld_nextref_proc		ld_options.ldo_nextref_proc
#define ld_nextref_params	ld_options.ldo_nextref_params
348
349
#define ld_urllist_proc		ld_options.ldo_urllist_proc
#define ld_urllist_params	ld_options.ldo_urllist_params
Kurt Zeilenga's avatar
Kurt Zeilenga committed
350

351
352
#define ld_version		ld_options.ldo_version

353
	unsigned short	ld_lberoptions;
354

355
	ber_int_t	ld_errno;
356
357
	char	*ld_error;
	char	*ld_matched;
358
	char	**ld_referrals;
359
	ber_len_t		ld_msgid;
360
361
362
363

	/* do not mess with these */
	LDAPRequest	*ld_requests;	/* list of outstanding requests */
	LDAPMessage	*ld_responses;	/* list of outstanding responses */
Kurt Zeilenga's avatar
ldap.h:    
Kurt Zeilenga committed
364

365
#ifdef LDAP_R_COMPILE
366
	ldap_pvt_thread_mutex_t	ld_conn_mutex;
367
368
369
370
	ldap_pvt_thread_mutex_t	ld_req_mutex;
	ldap_pvt_thread_mutex_t	ld_res_mutex;
#endif

371
372
	ber_len_t	ld_nabandoned;
	ber_int_t	*ld_abandoned;	/* array of abandoned requests */
Kurt Zeilenga's avatar
ldap.h:    
Kurt Zeilenga committed
373

374
	LDAPCache	*ld_cache;	/* non-null if cache is initialized */
Kurt Zeilenga's avatar
ldap.h:    
Kurt Zeilenga committed
375

376
	/* do not mess with the rest though */
377

378
379
380
	LDAPConn	*ld_defconn;	/* default connection */
	LDAPConn	*ld_conns;	/* list of server connections */
	void		*ld_selectinfo;	/* platform specifics for select */
381
};
Pierangelo Masarati's avatar
cleanup    
Pierangelo Masarati committed
382
383
384
#define LDAP_VALID(ld)		( (ld)->ld_valid == LDAP_VALID_SESSION )
#define LDAP_TRASHED(ld)	( (ld)->ld_valid == LDAP_TRASHED_SESSION )
#define LDAP_TRASH(ld)		( (ld)->ld_valid = LDAP_TRASHED_SESSION )
385

Kurt Zeilenga's avatar
Kurt Zeilenga committed
386
#ifdef LDAP_R_COMPILE
387
LDAP_V ( ldap_pvt_thread_mutex_t ) ldap_int_resolv_mutex;
Kurt Zeilenga's avatar
Kurt Zeilenga committed
388
389
390
391
392

#ifdef HAVE_CYRUS_SASL
LDAP_V( ldap_pvt_thread_mutex_t ) ldap_int_sasl_mutex;
#endif
#endif
Luke Howard's avatar
   
Luke Howard committed
393

394
395
396
397
398
399
400
401
402
#ifdef LDAP_R_COMPILE
#define	LDAP_NEXT_MSGID(ld, id) \
	ldap_pvt_thread_mutex_lock( &(ld)->ld_req_mutex ); \
	id = ++(ld)->ld_msgid; \
	ldap_pvt_thread_mutex_unlock( &(ld)->ld_req_mutex )
#else
#define	LDAP_NEXT_MSGID(ld, id)	id = ++(ld)->ld_msgid
#endif

403
404
405
406
407
408
409
410
411
412
413
/*
 * in abandon.c
 */

LDAP_F (int)
ldap_int_bisect_find( ber_int_t *v, ber_len_t n, ber_int_t id, int *idxp );
LDAP_F (int)
ldap_int_bisect_insert( ber_int_t **vp, ber_len_t *np, int id, int idx );
LDAP_F (int)
ldap_int_bisect_delete( ber_int_t **vp, ber_len_t *np, int id, int idx );

414
415
416
/*
 * in init.c
 */
417

418
419
LDAP_V ( struct ldapoptions ) ldap_int_global_options;

420
421
LDAP_F ( void ) ldap_int_initialize LDAP_P((struct ldapoptions *, int *));
LDAP_F ( void ) ldap_int_initialize_global_options LDAP_P((
422
	struct ldapoptions *, int *));
423

424
425
/* memory.c */
	/* simple macros to realloc for now */
Howard Chu's avatar
Howard Chu committed
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
#define LDAP_MALLOC(s)		(ber_memalloc_x((s),NULL))
#define LDAP_CALLOC(n,s)	(ber_memcalloc_x((n),(s),NULL))
#define LDAP_REALLOC(p,s)	(ber_memrealloc_x((p),(s),NULL))
#define LDAP_FREE(p)		(ber_memfree_x((p),NULL))
#define LDAP_VFREE(v)		(ber_memvfree_x((void **)(v),NULL))
#define LDAP_STRDUP(s)		(ber_strdup_x((s),NULL))
#define LDAP_STRNDUP(s,l)	(ber_strndup_x((s),(l),NULL))

#define LDAP_MALLOCX(s,x)	(ber_memalloc_x((s),(x)))
#define LDAP_CALLOCX(n,s,x)	(ber_memcalloc_x((n),(s),(x)))
#define LDAP_REALLOCX(p,s,x)	(ber_memrealloc_x((p),(s),(x)))
#define LDAP_FREEX(p,x)		(ber_memfree_x((p),(x)))
#define LDAP_VFREEX(v,x)	(ber_memvfree_x((void **)(v),(x)))
#define LDAP_STRDUPX(s,x)	(ber_strdup_x((s),(x)))
#define LDAP_STRNDUPX(s,l,x)	(ber_strndup_x((s),(l),(x)))
441

442
443
444
/*
 * in error.c
 */
Howard Chu's avatar
Howard Chu committed
445
LDAP_F (void) ldap_int_error_init( void );
446

447
448
449
/*
 * in unit-int.c
 */
450
LDAP_F (void) ldap_int_utils_init LDAP_P(( void ));
451
452


453
454
455
/*
 * in print.c
 */
456
LDAP_F (int) ldap_log_printf LDAP_P((LDAP *ld, int level, const char *fmt, ...)) LDAP_GCCATTR((format(printf, 3, 4)));
457

Kurt Zeilenga's avatar
Kurt Zeilenga committed
458
459
460
/*
 * in cache.c
 */
461
LDAP_F (void) ldap_add_request_to_cache LDAP_P(( LDAP *ld, ber_tag_t msgtype,
Kurt Zeilenga's avatar
Kurt Zeilenga committed
462
        BerElement *request ));
463
464
LDAP_F (void) ldap_add_result_to_cache LDAP_P(( LDAP *ld, LDAPMessage *result ));
LDAP_F (int) ldap_check_cache LDAP_P(( LDAP *ld, ber_tag_t msgtype, BerElement *request ));
Kurt Zeilenga's avatar
Kurt Zeilenga committed
465

466
467
468
/*
 * in controls.c
 */
469
LDAP_F (int) ldap_int_put_controls LDAP_P((
Kurt Zeilenga's avatar
Kurt Zeilenga committed
470
	LDAP *ld,
471
	LDAPControl *const *ctrls,
Kurt Zeilenga's avatar
Kurt Zeilenga committed
472
	BerElement *ber ));
473

474
475
476
LDAP_F (int) ldap_int_client_controls LDAP_P((
	LDAP *ld,
	LDAPControl **ctrlp ));
477

Kurt Zeilenga's avatar
Kurt Zeilenga committed
478
/*
Kurt Zeilenga's avatar
Kurt Zeilenga committed
479
 * in dsparse.c
Kurt Zeilenga's avatar
Kurt Zeilenga committed
480
 */
Kurt Zeilenga's avatar
Kurt Zeilenga committed
481
482
LDAP_F (int) ldap_int_next_line_tokens LDAP_P(( char **bufp, ber_len_t *blenp, char ***toksp ));

Kurt Zeilenga's avatar
Kurt Zeilenga committed
483
484
485
486

/*
 * in open.c
 */
487
LDAP_F (int) ldap_open_defconn( LDAP *ld );
488
489
LDAP_F (int) ldap_int_open_connection( LDAP *ld,
	LDAPConn *conn, LDAPURLDesc *srvlist, int async );
Kurt Zeilenga's avatar
Kurt Zeilenga committed
490
491
492
493

/*
 * in os-ip.c
 */
494
#ifndef HAVE_POLL
Howard Chu's avatar
Howard Chu committed
495
LDAP_V (int) ldap_int_tblsize;
496
497
498
LDAP_F (void) ldap_int_ip_init( void );
#endif

499
500
LDAP_F (int) ldap_int_timeval_dup( struct timeval **dest,
	const struct timeval *tm );
501
LDAP_F (int) ldap_connect_to_host( LDAP *ld, Sockbuf *sb,
502
	int proto, const char *host, int port, int async );
503
504
LDAP_F (int) ldap_int_poll( LDAP *ld, ber_socket_t s,
	struct timeval *tvp );
Hallvard Furuseth's avatar
Hallvard Furuseth committed
505

506
#if defined(HAVE_TLS) || defined(HAVE_CYRUS_SASL)
507
LDAP_V (char *) ldap_int_hostname;
508
509
LDAP_F (char *) ldap_host_connected_to( Sockbuf *sb,
	const char *host );
510
#endif
Kurt Zeilenga's avatar
Kurt Zeilenga committed
511

Kurt Zeilenga's avatar
Kurt Zeilenga committed
512
LDAP_F (int) ldap_int_select( LDAP *ld, struct timeval *timeout );
513
514
515
516
517
518
519
LDAP_F (void *) ldap_new_select_info( void );
LDAP_F (void) ldap_free_select_info( void *sip );
LDAP_F (void) ldap_mark_select_write( LDAP *ld, Sockbuf *sb );
LDAP_F (void) ldap_mark_select_read( LDAP *ld, Sockbuf *sb );
LDAP_F (void) ldap_mark_select_clear( LDAP *ld, Sockbuf *sb );
LDAP_F (int) ldap_is_read_ready( LDAP *ld, Sockbuf *sb );
LDAP_F (int) ldap_is_write_ready( LDAP *ld, Sockbuf *sb );
Kurt Zeilenga's avatar
Kurt Zeilenga committed
520

521
522
523
/*
 * in os-local.c
 */
524
525
#ifdef LDAP_PF_LOCAL
LDAP_F (int) ldap_connect_to_path( LDAP *ld, Sockbuf *sb,
526
	const char *path, int async );
527
#endif /* LDAP_PF_LOCAL */
Kurt Zeilenga's avatar
Kurt Zeilenga committed
528
529
530
531

/*
 * in request.c
 */
532
LDAP_F (ber_int_t) ldap_send_initial_request( LDAP *ld, ber_tag_t msgtype,
533
	const char *dn, BerElement *ber, ber_int_t msgid );
534
535
536
LDAP_F (BerElement *) ldap_alloc_ber_with_options( LDAP *ld );
LDAP_F (void) ldap_set_ber_options( LDAP *ld, BerElement *ber );

537
538
LDAP_F (int) ldap_send_server_request( LDAP *ld, BerElement *ber, ber_int_t msgid, LDAPRequest *parentreq, LDAPURLDesc **srvlist, LDAPConn *lc, LDAPreqinfo *bind );
LDAP_F (LDAPConn *) ldap_new_connection( LDAP *ld, LDAPURLDesc **srvlist, int use_ldsb, int connect, LDAPreqinfo *bind );
539
LDAP_F (LDAPRequest *) ldap_find_request_by_msgid( LDAP *ld, ber_int_t msgid );
Pierangelo Masarati's avatar
Pierangelo Masarati committed
540
LDAP_F (void) ldap_return_request( LDAP *ld, LDAPRequest *lr, int freeit );
541
542
543
544
LDAP_F (void) ldap_free_request( LDAP *ld, LDAPRequest *lr );
LDAP_F (void) ldap_free_connection( LDAP *ld, LDAPConn *lc, int force, int unbind );
LDAP_F (void) ldap_dump_connection( LDAP *ld, LDAPConn *lconns, int all );
LDAP_F (void) ldap_dump_requests_and_responses( LDAP *ld );
545
546
547
548
LDAP_F (int) ldap_chase_referrals( LDAP *ld, LDAPRequest *lr,
	char **errstrp, int sref, int *hadrefp );
LDAP_F (int) ldap_chase_v3referrals( LDAP *ld, LDAPRequest *lr,
	char **refs, int sref, char **referralsp, int *hadrefp );
549
LDAP_F (int) ldap_append_referral( LDAP *ld, char **referralsp, char *s );
550
LDAP_F (int) ldap_int_flush_request( LDAP *ld, LDAPRequest *lr );
Kurt Zeilenga's avatar
Kurt Zeilenga committed
551

552
553
554
/*
 * in result.c:
 */
555
LDAP_F (const char *) ldap_int_msgtype2str( ber_tag_t tag );
Kurt Zeilenga's avatar
Kurt Zeilenga committed
556
557
558
559

/*
 * in search.c
 */
560
LDAP_F (BerElement *) ldap_build_search_req LDAP_P((
561
	LDAP *ld,
562
563
564
565
566
	const char *base,
	ber_int_t scope,
	const char *filter,
	char **attrs,
	ber_int_t attrsonly,
567
568
	LDAPControl **sctrls,
	LDAPControl **cctrls,
569
	ber_int_t timelimit,
570
571
	ber_int_t sizelimit,
	ber_int_t *msgidp));
Kurt Zeilenga's avatar
Kurt Zeilenga committed
572
573
574
575
576


/*
 * in unbind.c
 */
577
LDAP_F (int) ldap_ld_free LDAP_P((
Kurt Zeilenga's avatar
Kurt Zeilenga committed
578
579
580
581
582
	LDAP *ld,
	int close,
	LDAPControl **sctrls,
	LDAPControl **cctrls ));

583
LDAP_F (int) ldap_send_unbind LDAP_P((
Kurt Zeilenga's avatar
Kurt Zeilenga committed
584
585
586
587
	LDAP *ld,
	Sockbuf *sb,
	LDAPControl **sctrls,
	LDAPControl **cctrls ));
Kurt Zeilenga's avatar
Kurt Zeilenga committed
588

589
590
591
/*
 * in url.c
 */
592
LDAP_F (LDAPURLDesc *) ldap_url_dup LDAP_P((
593
594
	LDAPURLDesc *ludp ));

595
LDAP_F (LDAPURLDesc *) ldap_url_duplist LDAP_P((
596
597
	LDAPURLDesc *ludlist ));

598
LDAP_F (int) ldap_url_parselist LDAP_P((
599
600
601
	LDAPURLDesc **ludlist,
	const char *url ));

602
LDAP_F (int) ldap_url_parsehosts LDAP_P((
603
	LDAPURLDesc **ludlist,
Kurt Zeilenga's avatar
Kurt Zeilenga committed
604
605
	const char *hosts,
	int port ));
606

607
LDAP_F (char *) ldap_url_list2hosts LDAP_P((
608
609
	LDAPURLDesc *ludlist ));

610
611
612
/*
 * in cyrus.c
 */
Kurt Zeilenga's avatar
Kurt Zeilenga committed
613

614
615
616
617
LDAP_F (int) ldap_int_sasl_init LDAP_P(( void ));

LDAP_F (int) ldap_int_sasl_open LDAP_P((
	LDAP *ld, LDAPConn *conn,
618
	const char* host ));
619
620
LDAP_F (int) ldap_int_sasl_close LDAP_P(( LDAP *ld, LDAPConn *conn ));

Kurt Zeilenga's avatar
Kurt Zeilenga committed
621
LDAP_F (int) ldap_int_sasl_external LDAP_P((
622
623
	LDAP *ld, LDAPConn *conn,
	const char* authid, ber_len_t ssf ));
Kurt Zeilenga's avatar
Kurt Zeilenga committed
624

625
626
627
628
629
630
631
632
LDAP_F (int) ldap_int_sasl_get_option LDAP_P(( LDAP *ld,
	int option, void *arg ));
LDAP_F (int) ldap_int_sasl_set_option LDAP_P(( LDAP *ld,
	int option, void *arg ));
LDAP_F (int) ldap_int_sasl_config LDAP_P(( struct ldapoptions *lo,
	int option, const char *arg ));

LDAP_F (int) ldap_int_sasl_bind LDAP_P((
633
	LDAP *ld,
634
635
636
	const char *,
	const char *,
	LDAPControl **, LDAPControl **,
637
638
639

	/* should be passed in client controls */
	unsigned flags,
640
	LDAP_SASL_INTERACT_PROC *interact,
641
	void *defaults ));
642

643
644
645
646
647
/* in schema.c */
LDAP_F (char *) ldap_int_parse_numericoid LDAP_P((
	const char **sp,
	int *code,
	const int flags ));
Kurt Zeilenga's avatar
Kurt Zeilenga committed
648

649
650
651
/*
 * in tls.c
 */
652
653
LDAP_F (int) ldap_int_tls_config LDAP_P(( LDAP *ld,
	int option, const char *arg ));
654

655
LDAP_F (int) ldap_int_tls_start LDAP_P(( LDAP *ld,
656
	LDAPConn *conn, LDAPURLDesc *srv ));
657

Howard Chu's avatar
Howard Chu committed
658
659
LDAP_F (void) ldap_int_tls_destroy LDAP_P(( struct ldapoptions *lo ));

660
661
662
663
664
665
/*
 *	in getvalues.c
 */
LDAP_F (char **) ldap_value_dup LDAP_P((
	char *const *vals ));

Kurt Zeilenga's avatar
Kurt Zeilenga committed
666
LDAP_END_DECL
667
668

#endif /* _LDAP_INT_H */