]> git.sur5r.net Git - openldap/blob - include/slapi-plugin.h
Add slapi_dup_control().
[openldap] / include / slapi-plugin.h
1 /*
2  * Copyright 1998-2003 The OpenLDAP Foundation, All Rights Reserved.
3  * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
4  */
5 /*
6  * (C) Copyright IBM Corp. 1997,2002
7  * Redistribution and use in source and binary forms are permitted
8  * provided that this notice is preserved and that due credit is
9  * given to IBM Corporation. This software is provided ``as is''
10  * without express or implied warranty.
11  */
12
13 #ifndef _SLAPI_PLUGIN_H
14 #define _SLAPI_PLUGIN_H
15
16 #include <ldap.h>
17
18 typedef struct slapi_pblock     Slapi_PBlock;
19 typedef struct slapi_entry      Slapi_Entry;
20 typedef struct slapi_attr       Slapi_Attr;
21 typedef struct slapi_value      Slapi_Value;
22 typedef struct slapi_valueset   Slapi_ValueSet;
23 typedef struct slapi_filter     Slapi_Filter;
24
25 /* pblock routines */
26 int slapi_pblock_get( Slapi_PBlock *pb, int arg, void *value );
27 int slapi_pblock_set( Slapi_PBlock *pb, int arg, void *value );
28 Slapi_PBlock *slapi_pblock_new();
29 void slapi_pblock_destroy( Slapi_PBlock* );
30
31 /* entry/attr/dn routines */
32 Slapi_Entry *slapi_str2entry( char *s, int flags );
33 char *slapi_entry2str( Slapi_Entry *e, int *len );
34 char *slapi_entry_get_dn( Slapi_Entry *e );
35 int slapi_x_entry_get_id( Slapi_Entry *e );
36 void slapi_entry_set_dn( Slapi_Entry *e, char *dn );
37 Slapi_Entry *slapi_entry_dup( Slapi_Entry *e );
38 int slapi_entry_attr_delete( Slapi_Entry *e, char *type );
39 Slapi_Entry *slapi_entry_alloc();
40 void slapi_entry_free( Slapi_Entry *e );
41 int slapi_entry_attr_merge( Slapi_Entry *e, char *type, struct berval **vals );
42 int slapi_entry_attr_find( Slapi_Entry *e, char *type, Slapi_Attr **attr );
43 char *slapi_entry_attr_get_charptr( const Slapi_Entry *e, const char *type );
44 int slapi_entry_attr_get_int( const Slapi_Entry *e, const char *type );
45 int slapi_entry_attr_get_long( const Slapi_Entry *e, const char *type );
46 int slapi_entry_attr_get_uint( const Slapi_Entry *e, const char *type );
47 int slapi_entry_attr_get_ulong( const Slapi_Entry *e, const char *type );
48 int slapi_attr_get_values( Slapi_Attr *attr, struct berval ***vals );
49 char *slapi_dn_normalize( char *dn );
50 char *slapi_dn_normalize_case( char *dn );
51 int slapi_dn_issuffix( char *dn, char *suffix );
52 char *slapi_dn_ignore_case( char *dn );
53
54 /* DS 5.x SLAPI */
55 int slapi_access_allowed( Slapi_PBlock *pb, Slapi_Entry *e, char *attr, struct berval *val, int access );
56 int slapi_acl_check_mods( Slapi_PBlock *pb, Slapi_Entry *e, LDAPMod **mods, char **errbuf );
57 Slapi_Attr *slapi_attr_new( void );
58 Slapi_Attr *slapi_attr_init( Slapi_Attr *a, const char *type );
59 void slapi_attr_free( Slapi_Attr **a );
60 Slapi_Attr *slapi_attr_dup( const Slapi_Attr *attr );
61 int slapi_attr_add_value( Slapi_Attr *a, const Slapi_Value *v );
62 int slapi_attr_type2plugin( const char *type, void **pi );
63 int slapi_attr_get_type( const Slapi_Attr *attr, char **type );
64 int slapi_attr_get_oid_copy( const Slapi_Attr *attr, char **oidp );
65 int slapi_attr_get_flags( const Slapi_Attr *attr, unsigned long *flags );
66 int slapi_attr_flag_is_set( const Slapi_Attr *attr, unsigned long flag );
67 int slapi_attr_value_cmp( const Slapi_Attr *attr, const struct berval *v1, const struct berval *v2 );
68 int slapi_attr_value_find( const Slapi_Attr *a, struct berval *v );
69 #define SLAPI_TYPE_CMP_EXACT    0
70 #define SLAPI_TYPE_CMP_BASE     1
71 #define SLAPI_TYPE_CMP_SUBTYPE  2
72 int slapi_attr_type_cmp( const char *t1, const char *t2, int opt );
73 int slapi_attr_types_equivalent( const char *t1, const char *t2 );
74 int slapi_attr_first_value( Slapi_Attr *a, Slapi_Value **v );
75 int slapi_attr_next_value( Slapi_Attr *a, int hint, Slapi_Value **v );
76 int slapi_attr_get_numvalues( const Slapi_Attr *a, int *numValues );
77 int slapi_attr_get_valueset( const Slapi_Attr *a, Slapi_ValueSet **vs );
78 int slapi_attr_get_bervals_copy( Slapi_Attr *a, struct berval ***vals );
79 int slapi_entry_attr_hasvalue( Slapi_Entry *e, const char *type, const char *value );
80 int slapi_entry_attr_merge_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
81 void slapi_entry_attr_set_charptr(Slapi_Entry* e, const char *type, const char *value);
82 void slapi_entry_attr_set_int( Slapi_Entry* e, const char *type, int l);
83 void slapi_entry_attr_set_uint( Slapi_Entry* e, const char *type, unsigned int l);
84 void slapi_entry_attr_set_long(Slapi_Entry* e, const char *type, long l);
85 void slapi_entry_attr_set_ulong(Slapi_Entry* e, const char *type, unsigned long l);
86 int slapi_is_rootdse( const char *dn );
87 int slapi_entry_attr_merge_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
88 int slapi_entry_add_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
89 int slapi_entry_add_valueset(Slapi_Entry *e, const char *type, Slapi_ValueSet *vs);
90 int slapi_entry_delete_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
91 int slapi_entry_merge_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
92 int slapi_entry_attr_replace_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
93 int slapi_entry_add_value(Slapi_Entry *e, const char *type, const Slapi_Value *value);
94 int slapi_entry_add_string(Slapi_Entry *e, const char *type, const char *value);
95 int slapi_entry_delete_string(Slapi_Entry *e, const char *type, const char *value);
96 int slapi_entry_first_attr( const Slapi_Entry *e, Slapi_Attr **attr );
97 int slapi_entry_next_attr( const Slapi_Entry *e, Slapi_Attr *prevattr, Slapi_Attr **attr );
98 char *slapi_attr_syntax_normalize( const char *s );
99
100 Slapi_Value *slapi_value_new( void );
101 Slapi_Value *slapi_value_new_berval(const struct berval *bval);
102 Slapi_Value *slapi_value_new_value(const Slapi_Value *v);
103 Slapi_Value *slapi_value_new_string(const char *s);
104 Slapi_Value *slapi_value_init(Slapi_Value *v);
105 Slapi_Value *slapi_value_init_berval(Slapi_Value *v, struct berval *bval);
106 Slapi_Value *slapi_value_init_string(Slapi_Value *v,const char *s);
107 Slapi_Value *slapi_value_dup(const Slapi_Value *v);
108 void slapi_value_free(Slapi_Value **value);
109 const struct berval *slapi_value_get_berval( const Slapi_Value *value );
110 Slapi_Value *slapi_value_set_berval( Slapi_Value *value, const struct berval *bval );
111 Slapi_Value *slapi_value_set_value( Slapi_Value *value, const Slapi_Value *vfrom);
112 Slapi_Value *slapi_value_set( Slapi_Value *value, void *val, unsigned long len);
113 int slapi_value_set_string(Slapi_Value *value, const char *strVal);
114 int slapi_value_set_int(Slapi_Value *value, int intVal);
115 const char*slapi_value_get_string(const Slapi_Value *value);
116 int slapi_value_get_int(const Slapi_Value *value); 
117 unsigned int slapi_value_get_uint(const Slapi_Value *value); 
118 long slapi_value_get_long(const Slapi_Value *value); 
119 unsigned long slapi_value_get_ulong(const Slapi_Value *value); 
120 size_t slapi_value_get_length(const Slapi_Value *value);
121 int slapi_value_compare(const Slapi_Attr *a,const Slapi_Value *v1,const Slapi_Value *v2);
122
123 Slapi_ValueSet *slapi_valueset_new( void );
124 void slapi_valueset_free(Slapi_ValueSet *vs);
125 void slapi_valueset_init(Slapi_ValueSet *vs);
126 void slapi_valueset_done(Slapi_ValueSet *vs);
127 void slapi_valueset_add_value(Slapi_ValueSet *vs, const Slapi_Value *addval);
128 int slapi_valueset_first_value( Slapi_ValueSet *vs, Slapi_Value **v );
129 int slapi_valueset_next_value( Slapi_ValueSet *vs, int index, Slapi_Value **v);
130 int slapi_valueset_count( const Slapi_ValueSet *vs);
131 void slapi_valueset_set_valueset(Slapi_ValueSet *vs1, const Slapi_ValueSet *vs2);
132
133 typedef struct slapi_mutex      Slapi_Mutex;
134 typedef struct slapi_condvar    Slapi_CondVar;
135 Slapi_Mutex *slapi_new_mutex( void );
136 void slapi_destroy_mutex( Slapi_Mutex *mutex );
137 void slapi_lock_mutex( Slapi_Mutex *mutex );
138 int slapi_unlock_mutex( Slapi_Mutex *mutex );
139 Slapi_CondVar *slapi_new_condvar( Slapi_Mutex *mutex );
140 void slapi_destroy_condvar( Slapi_CondVar *cvar );
141 int slapi_wait_condvar( Slapi_CondVar *cvar, struct timeval *timeout );
142 int slapi_notify_condvar( Slapi_CondVar *cvar, int notify_all );
143
144 char *slapi_ch_malloc( unsigned long size );
145 void slapi_ch_free( void **ptr );
146 void slapi_ch_free_string( char **ptr );
147 char *slapi_ch_calloc( unsigned long nelem, unsigned long size );
148 char *slapi_ch_realloc( char *block, unsigned long size );
149 char *slapi_ch_strdup( char *s );
150 void slapi_ch_array_free( char **arrayp );
151 struct berval *slapi_ch_bvdup(const struct berval *v);
152 struct berval **slapi_ch_bvecdup(const struct berval **v);
153
154 /* LDAP V3 routines */
155 int slapi_control_present( LDAPControl **controls, char *oid,
156         struct berval **val, int *iscritical);
157 void slapi_register_supported_control(char *controloid,
158         unsigned long controlops);
159 #define SLAPI_OPERATION_BIND            0x00000001L
160 #define SLAPI_OPERATION_UNBIND          0x00000002L
161 #define SLAPI_OPERATION_SEARCH          0x00000004L
162 #define SLAPI_OPERATION_MODIFY          0x00000008L
163 #define SLAPI_OPERATION_ADD             0x00000010L
164 #define SLAPI_OPERATION_DELETE          0x00000020L
165 #define SLAPI_OPERATION_MODDN           0x00000040L
166 #define SLAPI_OPERATION_MODRDN          SLAPI_OPERATION_MODDN
167 #define SLAPI_OPERATION_COMPARE         0x00000080L
168 #define SLAPI_OPERATION_ABANDON         0x00000100L
169 #define SLAPI_OPERATION_EXTENDED        0x00000200L
170 #define SLAPI_OPERATION_ANY             0xFFFFFFFFL
171 #define SLAPI_OPERATION_NONE            0x00000000L
172 int slapi_get_supported_controls(char ***ctrloidsp, unsigned long **ctrlopsp);
173 LDAPControl *slapi_dup_control(LDAPControl *ctrl);
174 void slapi_register_supported_saslmechanism(char *mechanism);
175 char **slapi_get_supported_saslmechanisms();
176 char **slapi_get_supported_extended_ops(void);
177
178
179 /* send ldap result back */
180 void slapi_send_ldap_result( Slapi_PBlock *pb, int err, char *matched,
181         char *text, int nentries, struct berval **urls );
182 int slapi_send_ldap_search_entry( Slapi_PBlock *pb, Slapi_Entry *e,
183         LDAPControl **ectrls, char **attrs, int attrsonly );
184
185 /* filter routines */
186 Slapi_Filter *slapi_str2filter( char *str );
187 Slapi_Filter *slapi_filter_dup( Slapi_Filter *f );
188 void slapi_filter_free( Slapi_Filter *f, int recurse );
189 int slapi_filter_get_choice( Slapi_Filter *f);
190 int slapi_filter_get_ava( Slapi_Filter *f, char **type, struct berval **bval );
191 Slapi_Filter *slapi_filter_list_first( Slapi_Filter *f );
192 Slapi_Filter *slapi_filter_list_next( Slapi_Filter *f, Slapi_Filter *fprev );
193 int slapi_filter_get_attribute_type( Slapi_Filter *f, char **type ); 
194 int slapi_filter_get_subfilt( Slapi_Filter *f, char **type, char **initial,
195         char ***any, char **final );
196 Slapi_Filter *slapi_filter_join( int ftype, Slapi_Filter *f1, Slapi_Filter *f2);
197 int slapi_filter_test( Slapi_PBlock *pb, Slapi_Entry *e, Slapi_Filter *f,
198         int verify_access );
199 int slapi_filter_test_simple( Slapi_Entry *e, Slapi_Filter *f );
200 typedef int (*FILTER_APPLY_FN)( Slapi_Filter *f, void *arg );
201 int slapi_filter_apply( Slapi_Filter *f, FILTER_APPLY_FN fn, void *arg, int *error_code );
202 #define SLAPI_FILTER_SCAN_STOP                  -1 /* set by callback */
203 #define SLAPI_FILTER_SCAN_ERROR                 -2 /* set by callback */
204 #define SLAPI_FILTER_SCAN_NOMORE                0 /* set by callback */
205 #define SLAPI_FILTER_SCAN_CONTINUE              1 /* set by callback */
206 #define SLAPI_FILTER_UNKNOWN_FILTER_TYPE        2 /* set by slapi_filter_apply() */
207
208 /* internal add/delete/search/modify routines */
209 Slapi_PBlock *slapi_search_internal( char *base, int scope, char *filter, 
210         LDAPControl **controls, char **attrs, int attrsonly );
211 Slapi_PBlock *slapi_modify_internal( char *dn, LDAPMod **mods,
212         LDAPControl **controls, int log_change );
213 Slapi_PBlock *slapi_add_internal( char * dn, LDAPMod **attrs,
214         LDAPControl **controls, int log_changes );
215 Slapi_PBlock *slapi_add_entry_internal( Slapi_Entry * e,
216         LDAPControl **controls, int log_change );
217 Slapi_PBlock *slapi_delete_internal( char * dn,  LDAPControl **controls,
218         int log_change );
219 Slapi_PBlock *slapi_modrdn_internal( char * olddn, char * newrdn,
220         int deloldrdn, LDAPControl **controls,
221         int log_change );
222 #if 0
223 Slapi_PBlock *slapi_modrdn_internal( char * olddn, char * newrdn,
224         char *newParent, int deloldrdn, LDAPControl **controls,
225         int log_change );
226 #endif
227 void slapi_free_search_results_internal(Slapi_PBlock *pb);
228
229 /* connection related routines */
230 int slapi_is_connection_ssl(Slapi_PBlock *pPB, int *isSSL);
231 int slapi_get_client_port(Slapi_PBlock *pPB, int *fromPort);
232
233 /* computed attributes */
234 typedef struct _computed_attr_context computed_attr_context;
235 typedef int (*slapi_compute_output_t)(computed_attr_context *c, Slapi_Attr *a, Slapi_Entry *e);
236 typedef int (*slapi_compute_callback_t)(computed_attr_context *c, char *type, Slapi_Entry *e, slapi_compute_output_t outputfn);
237 typedef int (*slapi_search_rewrite_callback_t)(Slapi_PBlock *pb);
238 int slapi_compute_add_evaluator(slapi_compute_callback_t function);
239 int slapi_compute_add_search_rewriter(slapi_search_rewrite_callback_t function);
240 int compute_rewrite_search_filter(Slapi_PBlock *pb);
241 int compute_evaluator(computed_attr_context *c, char *type, Slapi_Entry *e, slapi_compute_output_t outputfn);
242 int slapi_x_compute_get_pblock(computed_attr_context *c, Slapi_PBlock **pb);
243
244 /* parameters currently supported */
245
246 /*
247  * Attribute flags returned by slapi_attr_get_flags()
248  */
249 #define SLAPI_ATTR_FLAG_SINGLE          0x0001
250 #define SLAPI_ATTR_FLAG_OPATTR          0x0002
251 #define SLAPI_ATTR_FLAG_READONLY        0x0004
252 #define SLAPI_ATTR_FLAG_STD_ATTR        SLAPI_ATTR_FLAG_READONLY
253 #define SLAPI_ATTR_FLAG_OBSOLETE        0x0040
254 #define SLAPI_ATTR_FLAG_COLLECTIVE      0x0080
255 #define SLAPI_ATTR_FLAG_NOUSERMOD       0x0100
256
257 /*
258  * ACL levels
259  */
260 #define SLAPI_ACL_COMPARE       0x01
261 #define SLAPI_ACL_SEARCH        0x02
262 #define SLAPI_ACL_READ          0x04
263 #define SLAPI_ACL_WRITE         0x08
264 #define SLAPI_ACL_DELETE        0x10    
265 #define SLAPI_ACL_ADD           0x20
266 #define SLAPI_ACL_SELF          0x40
267 #define SLAPI_ACL_PROXY         0x80
268 #define SLAPI_ACL_ALL           0x7f
269
270 /* plugin types supported */
271
272 #define SLAPI_PLUGIN_DATABASE           1
273 #define SLAPI_PLUGIN_EXTENDEDOP         2
274 #define SLAPI_PLUGIN_PREOPERATION       3
275 #define SLAPI_PLUGIN_POSTOPERATION      4
276 #define SLAPI_PLUGIN_MATCHINGRULE       5
277 #define SLAPI_PLUGIN_SYNTAX             6
278 #define SLAPI_PLUGIN_AUDIT              7   
279
280 /* misc params */
281
282 #define SLAPI_BACKEND                           130
283 #define SLAPI_CONNECTION                        131
284 #define SLAPI_OPERATION                         132
285 #define SLAPI_REQUESTOR_ISROOT                  133
286 #define SLAPI_BE_MONITORDN                      134
287 #define SLAPI_BE_TYPE                           135
288 #define SLAPI_BE_READONLY                       136
289 #define SLAPI_BE_LASTMOD                        137
290 #define SLAPI_CONN_ID                           139
291
292 /* operation params */
293 #define SLAPI_OPINITIATED_TIME                  140
294 #define SLAPI_REQUESTOR_DN                      141
295 #define SLAPI_REQUESTOR_ISUPDATEDN              142
296
297 /* connection  structure params*/
298 #define SLAPI_CONN_DN                           143
299 #define SLAPI_CONN_AUTHTYPE                     144
300 #define SLAPI_CONN_CLIENTIP                     145
301 #define SLAPI_CONN_SERVERIP                     146
302 /* OpenLDAP extensions */
303 #define SLAPI_X_CONN_CLIENTPATH                 1300
304 #define SLAPI_X_CONN_SERVERPATH                 1301
305 #define SLAPI_X_CONN_IS_UDP                     1302
306
307 /*  Authentication types */
308 #define SLAPD_AUTH_NONE   "none"
309 #define SLAPD_AUTH_SIMPLE "simple"
310 #define SLAPD_AUTH_SSL    "SSL"
311 #define SLAPD_AUTH_SASL   "SASL " 
312
313 /* plugin configuration parmams */
314 #define SLAPI_PLUGIN                            3
315 #define SLAPI_PLUGIN_PRIVATE                    4
316 #define SLAPI_PLUGIN_TYPE                       5
317 #define SLAPI_PLUGIN_ARGV                       6
318 #define SLAPI_PLUGIN_ARGC                       7
319 #define SLAPI_PLUGIN_VERSION                    8
320 #define SLAPI_PLUGIN_OPRETURN                   9
321 #define SLAPI_PLUGIN_OBJECT                     10
322 #define SLAPI_PLUGIN_DESTROY_FN                 11
323 #define SLAPI_PLUGIN_DESCRIPTION                12
324
325 /* internal opreations params */
326 #define SLAPI_PLUGIN_INTOP_RESULT               15
327 #define SLAPI_PLUGIN_INTOP_SEARCH_ENTRIES       16
328 #define SLAPI_PLUGIN_INTOP_SEARCH_REFERRALS     17
329
330 /* function pointer params for backends */
331 #define SLAPI_PLUGIN_DB_BIND_FN                 200
332 #define SLAPI_PLUGIN_DB_UNBIND_FN               201
333 #define SLAPI_PLUGIN_DB_SEARCH_FN               202
334 #define SLAPI_PLUGIN_DB_COMPARE_FN              203
335 #define SLAPI_PLUGIN_DB_MODIFY_FN               204
336 #define SLAPI_PLUGIN_DB_MODRDN_FN               205
337 #define SLAPI_PLUGIN_DB_ADD_FN                  206
338 #define SLAPI_PLUGIN_DB_DELETE_FN               207
339 #define SLAPI_PLUGIN_DB_ABANDON_FN              208
340 #define SLAPI_PLUGIN_DB_CONFIG_FN               209
341 #define SLAPI_PLUGIN_CLOSE_FN                   210
342 #define SLAPI_PLUGIN_DB_FLUSH_FN                211
343 #define SLAPI_PLUGIN_START_FN                   212
344 #define SLAPI_PLUGIN_DB_SEQ_FN                  213
345 #define SLAPI_PLUGIN_DB_ENTRY_FN                214
346 #define SLAPI_PLUGIN_DB_REFERRAL_FN             215
347 #define SLAPI_PLUGIN_DB_RESULT_FN               216
348 #define SLAPI_PLUGIN_DB_LDIF2DB_FN              217
349 #define SLAPI_PLUGIN_DB_DB2LDIF_FN              218
350 #define SLAPI_PLUGIN_DB_BEGIN_FN                219
351 #define SLAPI_PLUGIN_DB_COMMIT_FN               220
352 #define SLAPI_PLUGIN_DB_ABORT_FN                221
353 #define SLAPI_PLUGIN_DB_ARCHIVE2DB_FN           222
354 #define SLAPI_PLUGIN_DB_DB2ARCHIVE_FN           223
355 #define SLAPI_PLUGIN_DB_NEXT_SEARCH_ENTRY_FN    224
356 #define SLAPI_PLUGIN_DB_FREE_RESULT_SET_FN      225
357 #define SLAPI_PLUGIN_DB_SIZE_FN                 226
358 #define SLAPI_PLUGIN_DB_TEST_FN                 227
359
360
361 /*  functions pointers for LDAP V3 extended ops */
362 #define SLAPI_PLUGIN_EXT_OP_FN                  300
363 #define SLAPI_PLUGIN_EXT_OP_OIDLIST             301
364
365 /* functions for preoperation functions */
366 #define SLAPI_PLUGIN_PRE_BIND_FN                401
367 #define SLAPI_PLUGIN_PRE_UNBIND_FN              402
368 #define SLAPI_PLUGIN_PRE_SEARCH_FN              403
369 #define SLAPI_PLUGIN_PRE_COMPARE_FN             404
370 #define SLAPI_PLUGIN_PRE_MODIFY_FN              405
371 #define SLAPI_PLUGIN_PRE_MODRDN_FN              406
372 #define SLAPI_PLUGIN_PRE_ADD_FN                 407
373 #define SLAPI_PLUGIN_PRE_DELETE_FN              408
374 #define SLAPI_PLUGIN_PRE_ABANDON_FN             409
375 #define SLAPI_PLUGIN_PRE_ENTRY_FN               410
376 #define SLAPI_PLUGIN_PRE_REFERRAL_FN            411
377 #define SLAPI_PLUGIN_PRE_RESULT_FN              412
378
379 /*  functions for postoperation functions*/
380 #define SLAPI_PLUGIN_POST_BIND_FN               501
381 #define SLAPI_PLUGIN_POST_UNBIND_FN             502
382 #define SLAPI_PLUGIN_POST_SEARCH_FN             503
383 #define SLAPI_PLUGIN_POST_COMPARE_FN            504
384 #define SLAPI_PLUGIN_POST_MODIFY_FN             505
385 #define SLAPI_PLUGIN_POST_MODRDN_FN             506
386 #define SLAPI_PLUGIN_POST_ADD_FN                507
387 #define SLAPI_PLUGIN_POST_DELETE_FN             508
388 #define SLAPI_PLUGIN_POST_ABANDON_FN            509
389 #define SLAPI_PLUGIN_POST_ENTRY_FN              510
390 #define SLAPI_PLUGIN_POST_REFERRAL_FN           511
391 #define SLAPI_PLUGIN_POST_RESULT_FN             512
392
393 #define SLAPI_OPERATION_TYPE                    590
394
395 #define SLAPI_PLUGIN_MR_FILTER_CREATE_FN        600
396 #define SLAPI_PLUGIN_MR_INDEXER_CREATE_FN       601
397 #define SLAPI_PLUGIN_MR_FILTER_MATCH_FN         602
398 #define SLAPI_PLUGIN_MR_FILTER_INDEX_FN         603
399 #define SLAPI_PLUGIN_MR_FILTER_RESET_FN         604
400 #define SLAPI_PLUGIN_MR_INDEX_FN                605
401 #define SLAPI_PLUGIN_MR_OID                     610
402 #define SLAPI_PLUGIN_MR_TYPE                    611
403 #define SLAPI_PLUGIN_MR_VALUE                   612
404 #define SLAPI_PLUGIN_MR_VALUES                  613
405 #define SLAPI_PLUGIN_MR_KEYS                    614
406 #define SLAPI_PLUGIN_MR_FILTER_REUSABLE         615
407 #define SLAPI_PLUGIN_MR_QUERY_OPERATOR          616
408 #define SLAPI_PLUGIN_MR_USAGE                   617
409
410 #define SLAPI_MATCHINGRULE_NAME                 1
411 #define SLAPI_MATCHINGRULE_OID                  2
412 #define SLAPI_MATCHINGRULE_DESC                 3
413 #define SLAPI_MATCHINGRULE_SYNTAX               4
414 #define SLAPI_MATCHINGRULE_OBSOLETE             5
415
416 #define SLAPI_OP_LESS                                   1
417 #define SLAPI_OP_LESS_OR_EQUAL                          2
418 #define SLAPI_OP_EQUAL                                  3
419 #define SLAPI_OP_GREATER_OR_EQUAL                       4
420 #define SLAPI_OP_GREATER                                5
421 #define SLAPI_OP_SUBSTRING                              6
422
423 #define SLAPI_PLUGIN_MR_USAGE_INDEX             0
424 #define SLAPI_PLUGIN_MR_USAGE_SORT              1
425
426 #define SLAPI_PLUGIN_SYNTAX_FILTER_AVA          700
427 #define SLAPI_PLUGIN_SYNTAX_FILTER_SUB          701
428 #define SLAPI_PLUGIN_SYNTAX_VALUES2KEYS         702
429 #define SLAPI_PLUGIN_SYNTAX_ASSERTION2KEYS_AVA  703
430 #define SLAPI_PLUGIN_SYNTAX_ASSERTION2KEYS_SUB  704
431 #define SLAPI_PLUGIN_SYNTAX_NAMES               705
432 #define SLAPI_PLUGIN_SYNTAX_OID                 706
433 #define SLAPI_PLUGIN_SYNTAX_FLAGS               707
434 #define SLAPI_PLUGIN_SYNTAX_COMPARE             708
435
436 #define SLAPI_PLUGIN_SYNTAX_FLAG_ORKEYS                 1
437 #define SLAPI_PLUGIN_SYNTAX_FLAG_ORDERING               2
438
439 #define SLAPI_OPERATION_AUTHTYPE                741
440 #define SLAPI_OPERATION_ID                      742
441 #define SLAPI_CONN_CERT                         743
442 #define SLAPI_CONN_AUTHMETHOD                   746
443
444 #define SLAPI_RESULT_CODE                       881
445 #define SLAPI_RESULT_TEXT                       882
446 #define SLAPI_RESULT_MATCHED                    883
447
448 /* audit plugin defines */
449 #define SLAPI_PLUGIN_AUDIT_DATA                1100
450 #define SLAPI_PLUGIN_AUDIT_FN                  1101
451
452 /* managedsait control */
453 #define SLAPI_MANAGEDSAIT                       1000
454
455 /* config stuff */
456 #define SLAPI_CONFIG_FILENAME                   40
457 #define SLAPI_CONFIG_LINENO                     41
458 #define SLAPI_CONFIG_ARGC                       42
459 #define SLAPI_CONFIG_ARGV                       43
460
461 /*  operational params */
462 #define SLAPI_TARGET_DN                         50
463 #define SLAPI_REQCONTROLS                       51
464
465 /* server LDAPv3 controls  */
466 #define SLAPI_RESCONTROLS                       55
467 #define SLAPI_ADD_RESCONTROL                    56      
468
469 /* add params */
470 #define SLAPI_ADD_TARGET                        SLAPI_TARGET_DN
471 #define SLAPI_ADD_ENTRY                         60
472
473 /* bind params */
474 #define SLAPI_BIND_TARGET                       SLAPI_TARGET_DN
475 #define SLAPI_BIND_METHOD                       70
476 #define SLAPI_BIND_CREDENTIALS                  71      
477 #define SLAPI_BIND_SASLMECHANISM                72      
478 #define SLAPI_BIND_RET_SASLCREDS                73      
479
480 /* compare params */
481 #define SLAPI_COMPARE_TARGET                    SLAPI_TARGET_DN
482 #define SLAPI_COMPARE_TYPE                      80
483 #define SLAPI_COMPARE_VALUE                     81
484
485 /* delete params */
486 #define SLAPI_DELETE_TARGET                     SLAPI_TARGET_DN
487
488 /* modify params */
489 #define SLAPI_MODIFY_TARGET                     SLAPI_TARGET_DN
490 #define SLAPI_MODIFY_MODS                       90
491
492 /* modrdn params */
493 #define SLAPI_MODRDN_TARGET                     SLAPI_TARGET_DN
494 #define SLAPI_MODRDN_NEWRDN                     100
495 #define SLAPI_MODRDN_DELOLDRDN                  101
496 #define SLAPI_MODRDN_NEWSUPERIOR                102     /* v3 only */
497
498 /* search params */
499 #define SLAPI_SEARCH_TARGET                     SLAPI_TARGET_DN
500 #define SLAPI_SEARCH_SCOPE                      110
501 #define SLAPI_SEARCH_DEREF                      111
502 #define SLAPI_SEARCH_SIZELIMIT                  112
503 #define SLAPI_SEARCH_TIMELIMIT                  113
504 #define SLAPI_SEARCH_FILTER                     114
505 #define SLAPI_SEARCH_STRFILTER                  115
506 #define SLAPI_SEARCH_ATTRS                      116
507 #define SLAPI_SEARCH_ATTRSONLY                  117
508
509 /* abandon params */
510 #define SLAPI_ABANDON_MSGID                     120
511
512 /* extended operation params */
513 #define SLAPI_EXT_OP_REQ_OID                    160
514 #define SLAPI_EXT_OP_REQ_VALUE          161     
515
516 /* extended operation return codes */
517 #define SLAPI_EXT_OP_RET_OID                    162     
518 #define SLAPI_EXT_OP_RET_VALUE          163     
519
520 #define SLAPI_PLUGIN_EXTENDED_SENT_RESULT       -1
521
522 #define SLAPI_BIND_SUCCESS              0
523 #define SLAPI_BIND_FAIL                 2
524 #define SLAPI_BIND_ANONYMOUS            3
525
526 /* Search result params */
527 #define SLAPI_SEARCH_RESULT_SET                 193
528 #define SLAPI_SEARCH_RESULT_ENTRY               194
529 #define SLAPI_NENTRIES                          195
530 #define SLAPI_SEARCH_REFERRALS                  196
531
532 /* filter types */
533 #ifndef LDAP_FILTER_AND
534 #define LDAP_FILTER_AND         0xa0L
535 #endif
536 #ifndef LDAP_FILTER_OR
537 #define LDAP_FILTER_OR          0xa1L
538 #endif
539 #ifndef LDAP_FILTER_NOT
540 #define LDAP_FILTER_NOT         0xa2L
541 #endif
542 #ifndef LDAP_FILTER_EQUALITY
543 #define LDAP_FILTER_EQUALITY    0xa3L
544 #endif
545 #ifndef LDAP_FILTER_SUBSTRINGS
546 #define LDAP_FILTER_SUBSTRINGS  0xa4L
547 #endif
548 #ifndef LDAP_FILTER_GE
549 #define LDAP_FILTER_GE          0xa5L
550 #endif
551 #ifndef LDAP_FILTER_LE
552 #define LDAP_FILTER_LE          0xa6L
553 #endif
554 #ifndef LDAP_FILTER_PRESENT
555 #define LDAP_FILTER_PRESENT     0x87L
556 #endif
557 #ifndef LDAP_FILTER_APPROX
558 #define LDAP_FILTER_APPROX      0xa8L
559 #endif
560 #ifndef LDAP_FILTER_EXT_MATCH
561 #define LDAP_FILTER_EXT_MATCH   0xa9L
562 #endif
563
564 int slapi_log_error( int severity, char *subsystem, char *fmt, ... );
565 #define SLAPI_LOG_FATAL                 0
566 #define SLAPI_LOG_TRACE                 1
567 #define SLAPI_LOG_PACKETS               2
568 #define SLAPI_LOG_ARGS                  3
569 #define SLAPI_LOG_CONNS                 4
570 #define SLAPI_LOG_BER                   5
571 #define SLAPI_LOG_FILTER                6
572 #define SLAPI_LOG_CONFIG                7
573 #define SLAPI_LOG_ACL                   8
574 #define SLAPI_LOG_SHELL                 9
575 #define SLAPI_LOG_PARSE                 10
576 #define SLAPI_LOG_HOUSE                 11
577 #define SLAPI_LOG_REPL                  12
578 #define SLAPI_LOG_CACHE                 13
579 #define SLAPI_LOG_PLUGIN                14
580 #define SLAPI_LOG_TIMING                15
581
582 #define SLAPI_PLUGIN_DESCRIPTION        12
583 typedef struct slapi_plugindesc {
584         char    *spd_id;
585         char    *spd_vendor;
586         char    *spd_version;
587         char    *spd_description;
588 } Slapi_PluginDesc;
589
590 #define SLAPI_PLUGIN_VERSION_01         "01"
591 #define SLAPI_PLUGIN_VERSION_02         "02"
592 #define SLAPI_PLUGIN_VERSION_03         "03"
593 #define SLAPI_PLUGIN_CURRENT_VERSION    SLAPI_PLUGIN_VERSION_03
594
595 #endif /* _SLAPI_PLUGIN_H */
596