]> git.sur5r.net Git - openldap/blob - servers/slapd/proto-slap.h
Add copyright notice and a few comments here and there
[openldap] / servers / slapd / proto-slap.h
1 /*
2  * Copyright 1998-1999 The OpenLDAP Foundation, All Rights Reserved.
3  * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
4  */
5 #ifndef _PROTO_SLAP
6 #define _PROTO_SLAP
7
8 #include <ldap_cdefs.h>
9
10 LDAP_BEGIN_DECL
11
12 /*
13  * acl.c
14  */
15
16 int access_allowed LDAP_P(( Backend *be, Connection *conn,
17         Operation *op, Entry *e,
18         char *attr, struct berval *val, int access ));
19
20 AccessControl * acl_get_applicable LDAP_P(( Backend *be,
21         Operation *op, Entry *e,
22         char *attr, int nmatches, regmatch_t *matches ));
23
24 int acl_access_allowed LDAP_P((
25         AccessControl *a, Backend *be, Connection *conn, Entry *e,
26         struct berval *val, Operation *op, int  access, char *edn,
27         regmatch_t *matches ));
28
29 int acl_check_modlist LDAP_P(( Backend *be,
30         Connection *conn,
31         Operation *op,
32         Entry *e,
33         LDAPModList *ml ));
34
35 /*
36  * aclparse.c
37  */
38
39 void parse_acl LDAP_P(( Backend *be, char *fname, int lineno, int argc, char **argv ));
40 char * access2str LDAP_P(( int access ));
41 int str2access LDAP_P(( char *str ));
42
43 /*
44  * attr.c
45  */
46
47 void attr_free LDAP_P(( Attribute *a ));
48 Attribute *attr_dup LDAP_P(( Attribute *a ));
49 char * attr_normalize LDAP_P(( char *s ));
50 int attr_merge_fast LDAP_P(( Entry *e, char *type, struct berval **vals, int  nvals,
51         int  naddvals, int  *maxvals, Attribute ***a ));
52 int attr_merge LDAP_P(( Entry *e, char *type, struct berval **vals ));
53 Attribute * attr_find LDAP_P(( Attribute *a, char *type ));
54 int attr_delete LDAP_P(( Attribute **attrs, char *type ));
55 int attr_syntax LDAP_P(( char *type ));
56 void attr_syntax_config LDAP_P(( char *fname, int lineno, int argc, char **argv ));
57 AttributeType * at_find LDAP_P(( const char *name ));
58 int at_find_in_list LDAP_P(( AttributeType *sat, AttributeType **list ));
59 int at_append_to_list LDAP_P(( AttributeType *sat, AttributeType ***listp ));
60 int at_delete_from_list LDAP_P(( int pos, AttributeType ***listp ));
61 int at_fake_if_needed LDAP_P(( char *name ));
62 int at_schema_info LDAP_P(( Entry *e ));
63 int at_add LDAP_P(( LDAP_ATTRIBUTE_TYPE *at, const char **err ));
64 char * at_canonical_name LDAP_P(( char * a_type ));
65
66 void attrs_free LDAP_P(( Attribute *a ));
67 Attribute *attrs_dup LDAP_P(( Attribute *a ));
68
69 /*
70  * ava.c
71  */
72
73 int get_ava LDAP_P(( BerElement *ber, Ava *ava ));
74 void ava_free LDAP_P(( Ava *ava, int freeit ));
75
76 /*
77  * backend.c
78  */
79
80 int backend_init LDAP_P((void));
81 int backend_add LDAP_P((BackendInfo *aBackendInfo));
82 int backend_startup LDAP_P((int dbnum));
83 int backend_shutdown LDAP_P((int dbnum));
84 int backend_destroy LDAP_P((void));
85
86 BackendInfo * backend_info LDAP_P(( char *type ));
87 BackendDB * backend_db_init LDAP_P(( char *type ));
88
89 BackendDB * select_backend LDAP_P(( char * dn ));
90
91 int be_issuffix LDAP_P(( Backend *be, char *suffix ));
92 int be_isroot LDAP_P(( Backend *be, char *ndn ));
93 int be_isroot_pw LDAP_P(( Backend *be, char *ndn, struct berval *cred ));
94 char* be_root_dn LDAP_P(( Backend *be ));
95 int be_entry_release_rw LDAP_P(( Backend *be, Entry *e, int rw ));
96 #define be_entry_release_r( be, e ) be_entry_release_rw( be, e, 0 )
97 #define be_entry_release_w( be, e ) be_entry_release_rw( be, e, 1 )
98
99
100 extern int      backend_unbind LDAP_P((Connection *conn, Operation *op));
101
102 extern int      backend_connection_init LDAP_P((Connection *conn));
103 extern int      backend_connection_destroy LDAP_P((Connection *conn));
104
105 extern int      backend_group LDAP_P((Backend *be,
106         Entry *target,
107         char *gr_ndn, char *op_ndn,
108         char *objectclassValue, char *groupattrName));
109
110 #ifdef SLAPD_SCHEMA_DN
111 /* temporary extern for temporary routine*/
112 extern Attribute *backend_subschemasubentry( Backend * );
113 #endif
114
115
116 /*
117  * ch_malloc.c
118  */
119
120 void * ch_malloc LDAP_P(( ber_len_t size ));
121 void * ch_realloc LDAP_P(( void *block, ber_len_t size ));
122 void * ch_calloc LDAP_P(( ber_len_t nelem, ber_len_t size ));
123 char * ch_strdup LDAP_P(( const char *string ));
124 void   ch_free LDAP_P(( void * ));
125 #define free ch_free
126
127 /*
128  * charray.c
129  */
130
131 void charray_add LDAP_P(( char ***a, char *s ));
132 void charray_merge LDAP_P(( char ***a, char **s ));
133 void charray_free LDAP_P(( char **array ));
134 int charray_inlist LDAP_P(( char **a, char *s ));
135 char ** charray_dup LDAP_P(( char **a ));
136 char ** str2charray LDAP_P(( char *str, char *brkstr ));
137 char * charray2str LDAP_P(( char **a ));
138
139 /*
140  * controls.c
141  */
142 int get_ctrls LDAP_P((
143         Connection *co,
144         Operation *op,
145         int senderrors ));
146
147 int get_manageDSAit LDAP_P(( Operation *op ));
148
149 /*
150  * config.c
151  */
152
153 int read_config LDAP_P(( char *fname ));
154
155 /*
156  * connection.c
157  */
158 int connections_init LDAP_P((void));
159 int connections_shutdown LDAP_P((void));
160 int connections_destroy LDAP_P((void));
161 int connections_timeout_idle LDAP_P((time_t));
162
163 long connection_init LDAP_P((
164         ber_socket_t s,
165         const char* url,
166         const char* dnsname,
167         const char* peername,
168         const char* sockname,
169         int use_tls ));
170
171 void connection_closing LDAP_P(( Connection *c ));
172 int connection_state_closing LDAP_P(( Connection *c ));
173 char *connection_state2str LDAP_P(( int state ));
174
175 int connection_write LDAP_P((ber_socket_t s));
176 int connection_read LDAP_P((ber_socket_t s));
177
178 unsigned long connections_nextid(void);
179
180 Connection* connection_first LDAP_P((ber_socket_t *));
181 Connection* connection_next LDAP_P((Connection *, ber_socket_t *));
182 void connection_done LDAP_P((Connection *));
183
184 /*
185  * dn.c
186  */
187
188 char * dn_normalize LDAP_P(( char *dn ));
189 char * dn_normalize_case LDAP_P(( char *dn ));
190 char * dn_parent LDAP_P(( Backend *be, char *dn ));
191 char * dn_rdn LDAP_P(( Backend *be, char *dn ));
192 int dn_issuffix LDAP_P(( char *dn, char *suffix ));
193 #ifdef DNS_DN
194 int dn_type LDAP_P(( char *dn ));
195 #endif
196 char * str2upper LDAP_P(( char *str ));
197 char * str2lower LDAP_P(( char *str ));
198 int rdn_validate LDAP_P(( const char* str ));
199 char * rdn_attr_value LDAP_P(( char * rdn ));
200 char * rdn_attr_type LDAP_P(( char * rdn ));
201 void build_new_dn LDAP_P(( char ** new_dn, char *e_dn, char * p_dn,
202                            char * newrdn ));
203 /*
204  * entry.c
205  */
206
207 Entry * str2entry LDAP_P(( char *s ));
208 char * entry2str LDAP_P(( Entry *e, int *len, int printid ));
209 void entry_free LDAP_P(( Entry *e ));
210
211 int entry_cmp LDAP_P(( Entry *a, Entry *b ));
212 int entry_dn_cmp LDAP_P(( Entry *a, Entry *b ));
213 int entry_id_cmp LDAP_P(( Entry *a, Entry *b ));
214
215 /*
216  * filter.c
217  */
218
219 int get_filter LDAP_P(( Connection *conn, BerElement *ber, Filter **filt, char **fstr ));
220 void filter_free LDAP_P(( Filter *f ));
221 void filter_print LDAP_P(( Filter *f ));
222
223 /*
224  * filterentry.c
225  */
226
227 int test_filter LDAP_P(( Backend *be, Connection *conn, Operation *op, Entry *e,
228         Filter  *f ));
229
230 /*
231  * lock.c
232  */
233
234 FILE * lock_fopen LDAP_P(( char *fname, char *type, FILE **lfp ));
235 int lock_fclose LDAP_P(( FILE *fp, FILE *lfp ));
236
237 /*
238  * module.c
239  */
240
241 #ifdef SLAPD_MODULES
242 int load_module LDAP_P(( const char* file_name, int argc, char *argv[] ));
243 #endif /* SLAPD_MODULES */
244
245 /*
246  * monitor.c
247  */
248 extern char *supportedExtensions[];
249 extern char *supportedControls[];
250
251 void monitor_info LDAP_P((
252         Connection *conn,
253         Operation *op,
254         char ** attrs,
255         int attrsonly ));
256
257 /*
258  * operation.c
259  */
260
261 void slap_op_free LDAP_P(( Operation *op ));
262 Operation * slap_op_alloc LDAP_P((
263         BerElement *ber, ber_int_t msgid,
264         ber_tag_t tag, ber_int_t id ));
265
266 int slap_op_add LDAP_P(( Operation **olist, Operation *op ));
267 int slap_op_remove LDAP_P(( Operation **olist, Operation *op ));
268 Operation * slap_op_pop LDAP_P(( Operation **olist ));
269
270 /*
271  * phonetic.c
272  */
273
274 char * first_word LDAP_P(( char *s ));
275 char * next_word LDAP_P(( char *s ));
276 char * word_dup LDAP_P(( char *w ));
277 char * phonetic LDAP_P(( char *s ));
278
279 /*
280  * repl.c
281  */
282
283 void replog LDAP_P(( Backend *be, Operation *op, char *dn, void *change ));
284
285 /*
286  * result.c
287  */
288
289 struct berval **get_entry_referrals LDAP_P((
290         Backend *be, Connection *conn, Operation *op,
291         Entry *e ));
292
293 void send_ldap_result LDAP_P((
294         Connection *conn, Operation *op,
295         int err, char *matched, char *text,
296         struct berval **refs,
297         LDAPControl **ctrls ));
298
299 void send_ldap_disconnect LDAP_P((
300         Connection *conn, Operation *op,
301         int err, char *text ));
302
303 void send_search_result LDAP_P((
304         Connection *conn, Operation *op,
305         int err, char *matched, char *text,
306         struct berval **refs,
307         LDAPControl **ctrls,
308         int nentries ));
309
310 int send_search_reference LDAP_P((
311         Backend *be, Connection *conn, Operation *op,
312         Entry *e, struct berval **refs, int scope,
313         LDAPControl **ctrls,
314         struct berval ***v2refs ));
315
316 int send_search_entry LDAP_P((
317         Backend *be, Connection *conn, Operation *op,
318         Entry *e, char **attrs, int attrsonly,
319         LDAPControl **ctrls ));
320
321 int str2result LDAP_P(( char *s,
322         int *code, char **matched, char **info ));
323
324 /*
325  * sasl.c
326  */
327 extern char **supportedSASLMechanisms;
328
329 int sasl_init(void);
330 int sasl_destroy(void);
331
332 /*
333  * schema.c
334  */
335
336 int oc_schema_check LDAP_P(( Entry *e ));
337 int oc_check_operational_attr LDAP_P(( char *type ));
338 int oc_check_usermod_attr LDAP_P(( char *type ));
339 int oc_check_no_usermod_attr LDAP_P(( char *type ));
340 ObjectClass *oc_find LDAP_P((const char *ocname));
341 int oc_add LDAP_P((LDAP_OBJECT_CLASS *oc, const char **err));
342 Syntax *syn_find LDAP_P((const char *synname));
343 int syn_add LDAP_P((LDAP_SYNTAX *syn, slap_syntax_check_func *check, const char **err));
344 MatchingRule *mr_find LDAP_P((const char *mrname));
345 int mr_add LDAP_P((LDAP_MATCHING_RULE *mr, slap_mr_normalize_func *normalize, slap_mr_compare_func *compare, const char **err));
346 void schema_info LDAP_P((Connection *conn, Operation *op, char **attrs, int attrsonly));
347 int schema_init LDAP_P((void));
348
349 int is_entry_objectclass LDAP_P(( Entry *, char* objectclass ));
350 #define is_entry_alias(e)               is_entry_objectclass((e), "ALIAS")
351 #define is_entry_referral(e)    is_entry_objectclass((e), "REFERRAL")
352
353
354 /*
355  * schemaparse.c
356  */
357
358 void parse_oc_old LDAP_P(( Backend *be, char *fname, int lineno, int argc, char **argv ));
359 void parse_oc LDAP_P(( char *fname, int lineno, char *line ));
360 void parse_at LDAP_P(( char *fname, int lineno, char *line ));
361 char *scherr2str LDAP_P((int code));
362 /*
363  * str2filter.c
364  */
365
366 Filter * str2filter LDAP_P(( char *str ));
367
368 /*
369  * suffixalias.c
370  */
371 char *suffix_alias LDAP_P(( Backend *be, char *ndn ));
372
373 /*
374  * value.c
375  */
376
377 int value_add_fast LDAP_P(( struct berval ***vals, struct berval **addvals, int nvals,
378         int naddvals, int *maxvals ));
379 int value_add LDAP_P(( struct berval ***vals, struct berval **addvals ));
380 void value_normalize LDAP_P(( char *s, int syntax ));
381 int value_cmp LDAP_P(( struct berval *v1, struct berval *v2, int syntax,
382         int normalize ));
383 int value_find LDAP_P(( struct berval **vals, struct berval *v, int syntax,
384         int normalize ));
385
386 /*
387  * user.c
388  */
389 #if defined(HAVE_PWD_H) && defined(HAVE_GRP_H)
390 void slap_init_user LDAP_P(( char *username, char *groupname ));
391 #endif
392
393 /*
394  * Other...
395  */
396
397 extern struct berval **default_referral;
398 extern char             *replogfile;
399 extern const char Versionstr[];
400 extern int              active_threads;
401 extern int              defsize;
402 extern int              deftime;
403 extern int              g_argc;
404 extern int              global_default_access;
405 extern int              global_lastmod;
406 extern int              global_idletimeout;
407 extern int              global_schemacheck;
408 extern char             *global_realm;
409 extern int              lber_debug;
410 extern int              ldap_syslog;
411
412 extern ldap_pvt_thread_mutex_t  num_sent_mutex;
413 extern long             num_bytes_sent;
414 extern long             num_pdu_sent;
415 extern long             num_entries_sent;
416 extern long             num_refs_sent;
417
418 extern ldap_pvt_thread_mutex_t  num_ops_mutex;
419 extern long             num_ops_completed;
420 extern long             num_ops_initiated;
421
422 extern char   *slapd_pid_file;
423 extern char   *slapd_args_file;
424 extern char             **g_argv;
425 extern time_t   starttime;
426
427 time_t slap_get_time LDAP_P((void));
428
429 extern ldap_pvt_thread_mutex_t  active_threads_mutex;
430 extern ldap_pvt_thread_cond_t   active_threads_cond;
431
432 extern ldap_pvt_thread_mutex_t  entry2str_mutex;
433 extern ldap_pvt_thread_mutex_t  replog_mutex;
434
435 #ifdef SLAPD_CRYPT
436 extern ldap_pvt_thread_mutex_t  crypt_mutex;
437 #endif
438 extern ldap_pvt_thread_mutex_t  gmtime_mutex;
439
440 extern AccessControl *global_acl;
441
442 int     slap_init LDAP_P((int mode, char* name));
443 int     slap_startup LDAP_P((int dbnum));
444 int     slap_shutdown LDAP_P((int dbnum));
445 int     slap_destroy LDAP_P((void));
446
447 struct sockaddr_in;
448
449 extern int      slapd_daemon_init( char *urls, int port, int tls_port );
450 extern int      slapd_daemon_destroy(void);
451 extern int      slapd_daemon(void);
452
453 extern void slapd_set_write LDAP_P((ber_socket_t s, int wake));
454 extern void slapd_clr_write LDAP_P((ber_socket_t s, int wake));
455 extern void slapd_set_read LDAP_P((ber_socket_t s, int wake));
456 extern void slapd_clr_read LDAP_P((ber_socket_t s, int wake));
457
458 extern void slapd_remove LDAP_P((ber_socket_t s, int wake));
459
460 extern void     slap_set_shutdown LDAP_P((int sig));
461 extern void     slap_do_nothing   LDAP_P((int sig));
462
463 extern void     config_info LDAP_P((
464         Connection *conn,
465         Operation *op,
466         char ** attrs,
467         int attrsonly ));
468
469 extern void     root_dse_info LDAP_P((
470         Connection *conn,
471         Operation *op,
472         char ** attrs,
473         int attrsonly ));
474
475 extern int      do_abandon LDAP_P((Connection *conn, Operation *op));
476 extern int      do_add LDAP_P((Connection *conn, Operation *op));
477 extern int      do_bind LDAP_P((Connection *conn, Operation *op));
478 extern int      do_compare LDAP_P((Connection *conn, Operation *op));
479 extern int      do_delete LDAP_P((Connection *conn, Operation *op));
480 extern int      do_modify LDAP_P((Connection *conn, Operation *op));
481 extern int      do_modrdn LDAP_P((Connection *conn, Operation *op));
482 extern int      do_search LDAP_P((Connection *conn, Operation *op));
483 extern int      do_unbind LDAP_P((Connection *conn, Operation *op));
484 extern int      do_extended LDAP_P((Connection *conn, Operation *op));
485
486
487 extern ber_socket_t dtblsize;
488
489 LDAP_END_DECL
490
491 #endif /* _proto_slap */
492