Home | History | Annotate | Line # | Download | only in include
      1 /*	$NetBSD: slapi-plugin.h,v 1.4 2025/09/05 21:16:19 christos Exp $	*/
      2 
      3 /* $OpenLDAP$ */
      4 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
      5  *
      6  * Copyright 1998-2024 The OpenLDAP Foundation.
      7  * Portions Copyright 1997,2002,2003 IBM Corporation.
      8  * All rights reserved.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted only as authorized by the OpenLDAP
     12  * Public License.
     13  *
     14  * A copy of this license is available in file LICENSE in the
     15  * top-level directory of the distribution or, alternatively, at
     16  * <http://www.OpenLDAP.org/license.html>.
     17  */
     18 
     19 /*
     20  * This header is used in development of SLAPI plugins for
     21  * OpenLDAP slapd(8) and other directory servers supporting
     22  * this interface.  Your portability mileage may vary.
     23  */
     24 
     25 #ifndef _SLAPI_PLUGIN_H
     26 #define _SLAPI_PLUGIN_H
     27 
     28 #include <ldap.h>
     29 
     30 typedef struct slapi_pblock		Slapi_PBlock;
     31 typedef struct slapi_entry		Slapi_Entry;
     32 typedef struct slapi_attr		Slapi_Attr;
     33 typedef struct slapi_value		Slapi_Value;
     34 typedef struct slapi_valueset		Slapi_ValueSet;
     35 typedef struct slapi_filter		Slapi_Filter;
     36 typedef struct BackendDB		Slapi_Backend;
     37 typedef struct Operation		Slapi_Operation;
     38 typedef struct Connection		Slapi_Connection;
     39 typedef struct slapi_dn			Slapi_DN;
     40 typedef struct slapi_rdn		Slapi_RDN;
     41 typedef struct slapi_mod		Slapi_Mod;
     42 typedef struct slapi_mods		Slapi_Mods;
     43 typedef struct slapi_componentid	Slapi_ComponentId;
     44 
     45 #define SLAPI_ATTR_UNIQUEID	"entryUUID"
     46 #define SLAPI_ATTR_OBJECTCLASS	"objectClass"
     47 
     48 /* pblock routines */
     49 int slapi_pblock_get( Slapi_PBlock *pb, int arg, void *value );
     50 int slapi_pblock_set( Slapi_PBlock *pb, int arg, void *value );
     51 Slapi_PBlock *slapi_pblock_new( void );
     52 void slapi_pblock_destroy( Slapi_PBlock *pb );
     53 
     54 /* entry/attr/dn routines */
     55 Slapi_Entry *slapi_str2entry( char *s, int flags );
     56 #define SLAPI_STR2ENTRY_REMOVEDUPVALS	1
     57 #define SLAPI_STR2ENTRY_ADDRDNVALS	2
     58 #define SLAPI_STR2ENTRY_BIGENTRY	4
     59 #define SLAPI_STR2ENTRY_TOMBSTONE_CHECK	8
     60 #define SLAPI_STR2ENTRY_IGNORE_STATE	16
     61 #define SLAPI_STR2ENTRY_INCLUDE_VERSION_STR	32
     62 #define SLAPI_STR2ENTRY_EXPAND_OBJECTCLASSES	64
     63 #define SLAPI_STR2ENTRY_NOT_WELL_FORMED_LDIF	128
     64 char *slapi_entry2str( Slapi_Entry *e, int *len );
     65 char *slapi_entry_get_dn( Slapi_Entry *e );
     66 int slapi_x_entry_get_id( Slapi_Entry *e );
     67 void slapi_entry_set_dn( Slapi_Entry *e, char *dn );
     68 Slapi_Entry *slapi_entry_dup( Slapi_Entry *e );
     69 int slapi_entry_attr_delete( Slapi_Entry *e, char *type );
     70 Slapi_Entry *slapi_entry_alloc();
     71 void slapi_entry_free( Slapi_Entry *e );
     72 int slapi_entry_attr_merge( Slapi_Entry *e, char *type, struct berval **vals );
     73 int slapi_entry_attr_find( Slapi_Entry *e, char *type, Slapi_Attr **attr );
     74 char *slapi_entry_attr_get_charptr( const Slapi_Entry *e, const char *type );
     75 int slapi_entry_attr_get_int( const Slapi_Entry *e, const char *type );
     76 long slapi_entry_attr_get_long( const Slapi_Entry *e, const char *type );
     77 unsigned int slapi_entry_attr_get_uint( const Slapi_Entry *e, const char *type );
     78 unsigned long slapi_entry_attr_get_ulong( const Slapi_Entry *e, const char *type );
     79 int slapi_attr_get_values( Slapi_Attr *attr, struct berval ***vals );
     80 char *slapi_dn_normalize( char *dn );
     81 char *slapi_dn_normalize_case( char *dn );
     82 int slapi_dn_issuffix( char *dn, char *suffix );
     83 char *slapi_dn_beparent( Slapi_PBlock *pb, const char *dn );
     84 int slapi_dn_isbesuffix( Slapi_PBlock *pb, char *dn );
     85 char *slapi_dn_parent( const char *dn );
     86 int slapi_dn_isparent( const char *parentdn, const char *childdn );
     87 char *slapi_dn_ignore_case( char *dn );
     88 int slapi_rdn2typeval( char *rdn, char **type, struct berval *bv );
     89 char *slapi_dn_plus_rdn(const char *dn, const char *rdn);
     90 
     91 /* DS 5.x SLAPI */
     92 int slapi_access_allowed( Slapi_PBlock *pb, Slapi_Entry *e, char *attr, struct berval *val, int access );
     93 int slapi_acl_check_mods( Slapi_PBlock *pb, Slapi_Entry *e, LDAPMod **mods, char **errbuf );
     94 Slapi_Attr *slapi_attr_new( void );
     95 Slapi_Attr *slapi_attr_init( Slapi_Attr *a, const char *type );
     96 void slapi_attr_free( Slapi_Attr **a );
     97 Slapi_Attr *slapi_attr_dup( const Slapi_Attr *attr );
     98 int slapi_attr_add_value( Slapi_Attr *a, const Slapi_Value *v );
     99 int slapi_attr_type2plugin( const char *type, void **pi );
    100 int slapi_attr_get_type( const Slapi_Attr *attr, char **type );
    101 int slapi_attr_get_oid_copy( const Slapi_Attr *attr, char **oidp );
    102 int slapi_attr_get_flags( const Slapi_Attr *attr, unsigned long *flags );
    103 int slapi_attr_flag_is_set( const Slapi_Attr *attr, unsigned long flag );
    104 int slapi_attr_value_cmp( const Slapi_Attr *attr, const struct berval *v1, const struct berval *v2 );
    105 int slapi_attr_value_find( const Slapi_Attr *a, struct berval *v );
    106 #define SLAPI_TYPE_CMP_EXACT	0
    107 #define SLAPI_TYPE_CMP_BASE	1
    108 #define SLAPI_TYPE_CMP_SUBTYPE	2
    109 int slapi_attr_type_cmp( const char *t1, const char *t2, int opt );
    110 int slapi_attr_types_equivalent( const char *t1, const char *t2 );
    111 int slapi_attr_first_value( Slapi_Attr *a, Slapi_Value **v );
    112 int slapi_attr_next_value( Slapi_Attr *a, int hint, Slapi_Value **v );
    113 int slapi_attr_get_numvalues( const Slapi_Attr *a, int *numValues );
    114 int slapi_attr_get_valueset( const Slapi_Attr *a, Slapi_ValueSet **vs );
    115 int slapi_attr_get_bervals_copy( Slapi_Attr *a, struct berval ***vals );
    116 int slapi_entry_attr_hasvalue( Slapi_Entry *e, const char *type, const char *value );
    117 int slapi_entry_attr_merge_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
    118 void slapi_entry_attr_set_charptr(Slapi_Entry* e, const char *type, const char *value);
    119 void slapi_entry_attr_set_int( Slapi_Entry* e, const char *type, int l);
    120 void slapi_entry_attr_set_uint( Slapi_Entry* e, const char *type, unsigned int l);
    121 void slapi_entry_attr_set_long(Slapi_Entry* e, const char *type, long l);
    122 void slapi_entry_attr_set_ulong(Slapi_Entry* e, const char *type, unsigned long l);
    123 int slapi_entry_has_children(const Slapi_Entry *e);
    124 size_t slapi_entry_size(Slapi_Entry *e);
    125 int slapi_is_rootdse( const char *dn );
    126 int slapi_entry_attr_merge_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
    127 int slapi_entry_add_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
    128 int slapi_entry_add_valueset(Slapi_Entry *e, const char *type, Slapi_ValueSet *vs);
    129 int slapi_entry_delete_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
    130 int slapi_entry_merge_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
    131 int slapi_entry_attr_replace_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
    132 int slapi_entry_add_value(Slapi_Entry *e, const char *type, const Slapi_Value *value);
    133 int slapi_entry_add_string(Slapi_Entry *e, const char *type, const char *value);
    134 int slapi_entry_delete_string(Slapi_Entry *e, const char *type, const char *value);
    135 int slapi_entry_first_attr( const Slapi_Entry *e, Slapi_Attr **attr );
    136 int slapi_entry_next_attr( const Slapi_Entry *e, Slapi_Attr *prevattr, Slapi_Attr **attr );
    137 const char *slapi_entry_get_uniqueid( const Slapi_Entry *e );
    138 void slapi_entry_set_uniqueid( Slapi_Entry *e, char *uniqueid );
    139 int slapi_entry_schema_check( Slapi_PBlock *pb, Slapi_Entry *e );
    140 int slapi_entry_rdn_values_present( const Slapi_Entry *e );
    141 int slapi_entry_add_rdn_values( Slapi_Entry *e );
    142 char *slapi_attr_syntax_normalize( const char *s );
    143 
    144 Slapi_Value *slapi_value_new( void );
    145 Slapi_Value *slapi_value_new_berval(const struct berval *bval);
    146 Slapi_Value *slapi_value_new_value(const Slapi_Value *v);
    147 Slapi_Value *slapi_value_new_string(const char *s);
    148 Slapi_Value *slapi_value_init(Slapi_Value *v);
    149 Slapi_Value *slapi_value_init_berval(Slapi_Value *v, struct berval *bval);
    150 Slapi_Value *slapi_value_init_string(Slapi_Value *v, const char *s);
    151 Slapi_Value *slapi_value_dup(const Slapi_Value *v);
    152 void slapi_value_free(Slapi_Value **value);
    153 const struct berval *slapi_value_get_berval( const Slapi_Value *value );
    154 Slapi_Value *slapi_value_set_berval( Slapi_Value *value, const struct berval *bval );
    155 Slapi_Value *slapi_value_set_value( Slapi_Value *value, const Slapi_Value *vfrom);
    156 Slapi_Value *slapi_value_set( Slapi_Value *value, void *val, unsigned long len);
    157 int slapi_value_set_string(Slapi_Value *value, const char *strVal);
    158 int slapi_value_set_int(Slapi_Value *value, int intVal);
    159 const char*slapi_value_get_string(const Slapi_Value *value);
    160 int slapi_value_get_int(const Slapi_Value *value);
    161 unsigned int slapi_value_get_uint(const Slapi_Value *value);
    162 long slapi_value_get_long(const Slapi_Value *value);
    163 unsigned long slapi_value_get_ulong(const Slapi_Value *value);
    164 size_t slapi_value_get_length(const Slapi_Value *value);
    165 int slapi_value_compare(const Slapi_Attr *a, const Slapi_Value *v1, const Slapi_Value *v2);
    166 
    167 Slapi_ValueSet *slapi_valueset_new( void );
    168 void slapi_valueset_free(Slapi_ValueSet *vs);
    169 void slapi_valueset_init(Slapi_ValueSet *vs);
    170 void slapi_valueset_done(Slapi_ValueSet *vs);
    171 void slapi_valueset_add_value(Slapi_ValueSet *vs, const Slapi_Value *addval);
    172 int slapi_valueset_first_value( Slapi_ValueSet *vs, Slapi_Value **v );
    173 int slapi_valueset_next_value( Slapi_ValueSet *vs, int index, Slapi_Value **v);
    174 int slapi_valueset_count( const Slapi_ValueSet *vs);
    175 void slapi_valueset_set_valueset(Slapi_ValueSet *vs1, const Slapi_ValueSet *vs2);
    176 
    177 /* DNs */
    178 Slapi_DN *slapi_sdn_new( void );
    179 Slapi_DN *slapi_sdn_new_dn_byval( const char *dn );
    180 Slapi_DN *slapi_sdn_new_ndn_byval( const char *ndn );
    181 Slapi_DN *slapi_sdn_new_dn_byref( const char *dn );
    182 Slapi_DN *slapi_sdn_new_ndn_byref( const char *ndn );
    183 Slapi_DN *slapi_sdn_new_dn_passin( const char *dn );
    184 Slapi_DN *slapi_sdn_set_dn_byval( Slapi_DN *sdn, const char *dn );
    185 Slapi_DN *slapi_sdn_set_dn_byref( Slapi_DN *sdn, const char *dn );
    186 Slapi_DN *slapi_sdn_set_dn_passin( Slapi_DN *sdn, const char *dn );
    187 Slapi_DN *slapi_sdn_set_ndn_byval( Slapi_DN *sdn, const char *ndn );
    188 Slapi_DN *slapi_sdn_set_ndn_byref( Slapi_DN *sdn, const char *ndn );
    189 void slapi_sdn_done( Slapi_DN *sdn );
    190 void slapi_sdn_free( Slapi_DN **sdn );
    191 const char * slapi_sdn_get_dn( const Slapi_DN *sdn );
    192 const char * slapi_sdn_get_ndn( const Slapi_DN *sdn );
    193 void slapi_sdn_get_parent( const Slapi_DN *sdn,Slapi_DN *sdn_parent );
    194 void slapi_sdn_get_backend_parent( const Slapi_DN *sdn, Slapi_DN *sdn_parent, const Slapi_Backend *backend );
    195 Slapi_DN * slapi_sdn_dup( const Slapi_DN *sdn );
    196 void slapi_sdn_copy( const Slapi_DN *from, Slapi_DN *to );
    197 int slapi_sdn_compare( const Slapi_DN *sdn1, const Slapi_DN *sdn2 );
    198 int slapi_sdn_isempty( const Slapi_DN *sdn );
    199 int slapi_sdn_issuffix(const Slapi_DN *sdn, const Slapi_DN *suffixsdn );
    200 int slapi_sdn_isparent( const Slapi_DN *parent, const Slapi_DN *child );
    201 int slapi_sdn_isgrandparent( const Slapi_DN *parent, const Slapi_DN *child );
    202 int slapi_sdn_get_ndn_len( const Slapi_DN *sdn );
    203 int slapi_sdn_scope_test( const Slapi_DN *dn, const Slapi_DN *base, int scope );
    204 void slapi_sdn_get_rdn( const Slapi_DN *sdn,Slapi_RDN *rdn );
    205 Slapi_DN *slapi_sdn_set_rdn( Slapi_DN *sdn, const Slapi_RDN *rdn );
    206 Slapi_DN *slapi_sdn_set_parent( Slapi_DN *sdn, const Slapi_DN *parentdn );
    207 int slapi_sdn_is_rdn_component( const Slapi_DN *rdn, const Slapi_Attr *a, const Slapi_Value *v );
    208 char * slapi_moddn_get_newdn( Slapi_DN *dn_olddn, char *newrdn, char *newsuperiordn );
    209 
    210 /* RDNs */
    211 Slapi_RDN *slapi_rdn_new( void );
    212 Slapi_RDN *slapi_rdn_new_dn( const char *dn );
    213 Slapi_RDN *slapi_rdn_new_sdn( const Slapi_DN *sdn );
    214 Slapi_RDN *slapi_rdn_new_rdn( const Slapi_RDN *fromrdn );
    215 void slapi_rdn_init( Slapi_RDN *rdn );
    216 void slapi_rdn_init_dn( Slapi_RDN *rdn, const char *dn );
    217 void slapi_rdn_init_sdn( Slapi_RDN *rdn, const Slapi_DN *sdn );
    218 void slapi_rdn_init_rdn( Slapi_RDN *rdn, const Slapi_RDN *fromrdn );
    219 void slapi_rdn_set_dn( Slapi_RDN *rdn, const char *dn );
    220 void slapi_rdn_set_sdn( Slapi_RDN *rdn, const Slapi_DN *sdn );
    221 void slapi_rdn_set_rdn( Slapi_RDN *rdn, const Slapi_RDN *fromrdn );
    222 void slapi_rdn_free( Slapi_RDN **rdn );
    223 void slapi_rdn_done( Slapi_RDN *rdn );
    224 int slapi_rdn_get_first( Slapi_RDN *rdn, char **type, char **value );
    225 int slapi_rdn_get_next( Slapi_RDN *rdn, int index, char **type, char **value );
    226 int slapi_rdn_get_index( Slapi_RDN *rdn, const char *type, const char *value, size_t length );
    227 int slapi_rdn_get_index_attr( Slapi_RDN *rdn, const char *type, char **value );
    228 int slapi_rdn_contains( Slapi_RDN *rdn, const char *type, const char *value,size_t length );
    229 int slapi_rdn_contains_attr( Slapi_RDN *rdn, const char *type, char **value );
    230 int slapi_rdn_add( Slapi_RDN *rdn, const char *type, const char *value );
    231 int slapi_rdn_remove_index( Slapi_RDN *rdn, int atindex );
    232 int slapi_rdn_remove( Slapi_RDN *rdn, const char *type, const char *value, size_t length );
    233 int slapi_rdn_remove_attr( Slapi_RDN *rdn, const char *type );
    234 int slapi_rdn_isempty( const Slapi_RDN *rdn );
    235 int slapi_rdn_get_num_components( Slapi_RDN *rdn );
    236 int slapi_rdn_compare( Slapi_RDN *rdn1, Slapi_RDN *rdn2 );
    237 const char *slapi_rdn_get_rdn( const Slapi_RDN *rdn );
    238 const char *slapi_rdn_get_nrdn( const Slapi_RDN *rdn );
    239 Slapi_DN *slapi_sdn_add_rdn( Slapi_DN *sdn, const Slapi_RDN *rdn );
    240 
    241 /* locks and synchronization */
    242 typedef struct slapi_mutex	Slapi_Mutex;
    243 typedef struct slapi_condvar	Slapi_CondVar;
    244 Slapi_Mutex *slapi_new_mutex( void );
    245 void slapi_destroy_mutex( Slapi_Mutex *mutex );
    246 void slapi_lock_mutex( Slapi_Mutex *mutex );
    247 int slapi_unlock_mutex( Slapi_Mutex *mutex );
    248 Slapi_CondVar *slapi_new_condvar( Slapi_Mutex *mutex );
    249 void slapi_destroy_condvar( Slapi_CondVar *cvar );
    250 int slapi_wait_condvar( Slapi_CondVar *cvar, struct timeval *timeout );
    251 int slapi_notify_condvar( Slapi_CondVar *cvar, int notify_all );
    252 
    253 /* thread-safe LDAP connections */
    254 LDAP *slapi_ldap_init( char *ldaphost, int ldapport, int secure, int shared );
    255 void slapi_ldap_unbind( LDAP *ld );
    256 
    257 char *slapi_ch_malloc( unsigned long size );
    258 void slapi_ch_free( void **ptr );
    259 void slapi_ch_free_string( char **ptr );
    260 char *slapi_ch_calloc( unsigned long nelem, unsigned long size );
    261 char *slapi_ch_realloc( char *block, unsigned long size );
    262 char *slapi_ch_strdup( const char *s );
    263 void slapi_ch_array_free( char **arrayp );
    264 struct berval *slapi_ch_bvdup(const struct berval *v);
    265 struct berval **slapi_ch_bvecdup(const struct berval **v);
    266 
    267 /* LDAP V3 routines */
    268 int slapi_control_present( LDAPControl **controls, char *oid,
    269 	struct berval **val, int *iscritical);
    270 void slapi_register_supported_control(char *controloid,
    271 	unsigned long controlops);
    272 #define SLAPI_OPERATION_BIND            0x00000001L
    273 #define SLAPI_OPERATION_UNBIND          0x00000002L
    274 #define SLAPI_OPERATION_SEARCH          0x00000004L
    275 #define SLAPI_OPERATION_MODIFY          0x00000008L
    276 #define SLAPI_OPERATION_ADD             0x00000010L
    277 #define SLAPI_OPERATION_DELETE          0x00000020L
    278 #define SLAPI_OPERATION_MODDN           0x00000040L
    279 #define SLAPI_OPERATION_MODRDN          SLAPI_OPERATION_MODDN
    280 #define SLAPI_OPERATION_COMPARE         0x00000080L
    281 #define SLAPI_OPERATION_ABANDON         0x00000100L
    282 #define SLAPI_OPERATION_EXTENDED        0x00000200L
    283 #define SLAPI_OPERATION_ANY             0xFFFFFFFFL
    284 #define SLAPI_OPERATION_NONE            0x00000000L
    285 int slapi_get_supported_controls(char ***ctrloidsp, unsigned long **ctrlopsp);
    286 LDAPControl *slapi_dup_control(LDAPControl *ctrl);
    287 void slapi_register_supported_saslmechanism(char *mechanism);
    288 char **slapi_get_supported_saslmechanisms();
    289 char **slapi_get_supported_extended_ops(void);
    290 
    291 /* operation */
    292 int slapi_op_abandoned( Slapi_PBlock *pb );
    293 unsigned long slapi_op_get_type(Slapi_Operation * op);
    294 void slapi_operation_set_flag(Slapi_Operation *op, unsigned long flag);
    295 void slapi_operation_clear_flag(Slapi_Operation *op, unsigned long flag);
    296 int slapi_operation_is_flag_set(Slapi_Operation *op, unsigned long flag);
    297 char *slapi_op_type_to_string(unsigned long type);
    298 
    299 /* send ldap result back */
    300 void slapi_send_ldap_result( Slapi_PBlock *pb, int err, char *matched,
    301 	char *text, int nentries, struct berval **urls );
    302 int slapi_send_ldap_search_entry( Slapi_PBlock *pb, Slapi_Entry *e,
    303 	LDAPControl **ectrls, char **attrs, int attrsonly );
    304 int slapi_send_ldap_search_reference( Slapi_PBlock *pb, Slapi_Entry *e,
    305 	struct berval **urls, LDAPControl **ectrls, struct berval **v2refs );
    306 
    307 /* filter routines */
    308 Slapi_Filter *slapi_str2filter( char *str );
    309 Slapi_Filter *slapi_filter_dup( Slapi_Filter *f );
    310 void slapi_filter_free( Slapi_Filter *f, int recurse );
    311 int slapi_filter_get_choice( Slapi_Filter *f);
    312 int slapi_filter_get_ava( Slapi_Filter *f, char **type, struct berval **bval );
    313 Slapi_Filter *slapi_filter_list_first( Slapi_Filter *f );
    314 Slapi_Filter *slapi_filter_list_next( Slapi_Filter *f, Slapi_Filter *fprev );
    315 int slapi_filter_get_attribute_type( Slapi_Filter *f, char **type );
    316 int slapi_x_filter_set_attribute_type( Slapi_Filter *f, const char *type );
    317 int slapi_filter_get_subfilt( Slapi_Filter *f, char **type, char **initial,
    318 	char ***any, char **final );
    319 Slapi_Filter *slapi_filter_join( int ftype, Slapi_Filter *f1, Slapi_Filter *f2);
    320 int slapi_x_filter_append( int choice, Slapi_Filter **pContainingFilter,
    321 	Slapi_Filter **pNextFilter, Slapi_Filter *filterToAppend );
    322 int slapi_filter_test( Slapi_PBlock *pb, Slapi_Entry *e, Slapi_Filter *f,
    323 	int verify_access );
    324 int slapi_filter_test_simple( Slapi_Entry *e, Slapi_Filter *f );
    325 typedef int (*FILTER_APPLY_FN)( Slapi_Filter *f, void *arg );
    326 int slapi_filter_apply( Slapi_Filter *f, FILTER_APPLY_FN fn, void *arg, int *error_code );
    327 #define SLAPI_FILTER_SCAN_STOP			-1 /* set by callback */
    328 #define SLAPI_FILTER_SCAN_ERROR			-2 /* set by callback */
    329 #define SLAPI_FILTER_SCAN_NOMORE		0 /* set by callback */
    330 #define SLAPI_FILTER_SCAN_CONTINUE		1 /* set by callback */
    331 #define SLAPI_FILTER_UNKNOWN_FILTER_TYPE	2 /* set by slapi_filter_apply() */
    332 
    333 /* internal add/delete/search/modify routines */
    334 Slapi_PBlock *slapi_search_internal( char *base, int scope, char *filter,
    335 	LDAPControl **controls, char **attrs, int attrsonly );
    336 Slapi_PBlock *slapi_modify_internal( char *dn, LDAPMod **mods,
    337         LDAPControl **controls, int log_change );
    338 Slapi_PBlock *slapi_add_internal( char * dn, LDAPMod **attrs,
    339 	LDAPControl **controls, int log_changes );
    340 Slapi_PBlock *slapi_add_entry_internal( Slapi_Entry * e,
    341 	LDAPControl **controls, int log_change );
    342 Slapi_PBlock *slapi_delete_internal( char * dn,  LDAPControl **controls,
    343 	int log_change );
    344 Slapi_PBlock *slapi_modrdn_internal( char * olddn, char * newrdn,
    345 	int deloldrdn, LDAPControl **controls,
    346 	int log_change );
    347 Slapi_PBlock *slapi_rename_internal( const char * olddn, const char *newrdn,
    348 	const char *newsuperior, int deloldrdn,
    349 	LDAPControl **controls, int log_change );
    350 void slapi_free_search_results_internal(Slapi_PBlock *pb);
    351 
    352 /* new internal add/delete/search/modify routines */
    353 typedef void (*plugin_result_callback)( int rc, void *callback_data );
    354 typedef int (*plugin_referral_entry_callback)( char * referral,
    355 	void *callback_data );
    356 typedef int (*plugin_search_entry_callback)( Slapi_Entry *e,
    357 	void *callback_data );
    358 void slapi_free_search_results_internal( Slapi_PBlock *pb );
    359 
    360 #define SLAPI_OP_FLAG_NEVER_CHAIN	0x0800
    361 
    362 int slapi_search_internal_pb( Slapi_PBlock *pb );
    363 int slapi_search_internal_callback_pb( Slapi_PBlock *pb, void *callback_data,
    364 	plugin_result_callback prc, plugin_search_entry_callback psec,
    365 	plugin_referral_entry_callback prec );
    366 int slapi_add_internal_pb( Slapi_PBlock *pb );
    367 int slapi_modify_internal_pb( Slapi_PBlock *pb );
    368 int slapi_modrdn_internal_pb( Slapi_PBlock *pb );
    369 int slapi_delete_internal_pb( Slapi_PBlock *pb );
    370 
    371 int slapi_seq_internal_callback_pb(Slapi_PBlock *pb, void *callback_data,
    372         plugin_result_callback res_callback,
    373         plugin_search_entry_callback srch_callback,
    374         plugin_referral_entry_callback ref_callback);
    375 
    376 void slapi_search_internal_set_pb( Slapi_PBlock *pb, const char *base,
    377 	int scope, const char *filter, char **attrs, int attrsonly,
    378 	LDAPControl **controls, const char *uniqueid,
    379 	Slapi_ComponentId *plugin_identity, int operation_flags );
    380 void slapi_add_entry_internal_set_pb( Slapi_PBlock *pb, Slapi_Entry *e,
    381 	LDAPControl **controls, Slapi_ComponentId *plugin_identity,
    382 	int operation_flags );
    383 int slapi_add_internal_set_pb( Slapi_PBlock *pb, const char *dn,
    384 	LDAPMod **attrs, LDAPControl **controls,
    385 	Slapi_ComponentId *plugin_identity, int operation_flags );
    386 void slapi_modify_internal_set_pb( Slapi_PBlock *pb, const char *dn,
    387 	LDAPMod **mods, LDAPControl **controls, const char *uniqueid,
    388 	Slapi_ComponentId *plugin_identity, int operation_flags );
    389 void slapi_rename_internal_set_pb( Slapi_PBlock *pb, const char *olddn,
    390 	const char *newrdn, const char *newsuperior, int deloldrdn,
    391 	LDAPControl **controls, const char *uniqueid,
    392 	Slapi_ComponentId *plugin_identity, int operation_flags );
    393 void slapi_delete_internal_set_pb( Slapi_PBlock *pb, const char *dn,
    394 	LDAPControl **controls, const char *uniqueid,
    395 	Slapi_ComponentId *plugin_identity, int operation_flags );
    396 void slapi_seq_internal_set_pb( Slapi_PBlock *pb, char *ibase, int type,
    397 	char *attrname, char *val, char **attrs, int attrsonly,
    398 	LDAPControl **controls, Slapi_ComponentId *plugin_identity,
    399 	int operation_flags );
    400 
    401 /* connection related routines */
    402 int slapi_is_connection_ssl(Slapi_PBlock *pPB, int *isSSL);
    403 int slapi_get_client_port(Slapi_PBlock *pPB, int *fromPort);
    404 int slapi_get_client_ip(Slapi_PBlock *pb, char **clientIP);
    405 void slapi_free_client_ip(char **clientIP);
    406 
    407 /* computed attributes */
    408 typedef struct _computed_attr_context computed_attr_context;
    409 typedef int (*slapi_compute_output_t)(computed_attr_context *c, Slapi_Attr *a, Slapi_Entry *e);
    410 typedef int (*slapi_compute_callback_t)(computed_attr_context *c, char *type, Slapi_Entry *e, slapi_compute_output_t outputfn);
    411 typedef int (*slapi_search_rewrite_callback_t)(Slapi_PBlock *pb);
    412 int slapi_compute_add_evaluator(slapi_compute_callback_t function);
    413 int slapi_compute_add_search_rewriter(slapi_search_rewrite_callback_t function);
    414 int compute_rewrite_search_filter(Slapi_PBlock *pb);
    415 int compute_evaluator(computed_attr_context *c, char *type, Slapi_Entry *e, slapi_compute_output_t outputfn);
    416 int slapi_x_compute_get_pblock(computed_attr_context *c, Slapi_PBlock **pb);
    417 
    418 /* backend routines */
    419 void slapi_be_set_readonly( Slapi_Backend *be, int readonly );
    420 int slapi_be_get_readonly( Slapi_Backend *be );
    421 const char *slapi_x_be_get_updatedn( Slapi_Backend *be );
    422 Slapi_Backend *slapi_be_select( const Slapi_DN *sdn );
    423 
    424 /* ACL plugins; only SLAPI_PLUGIN_ACL_ALLOW_ACCESS supported now */
    425 typedef int (*slapi_acl_callback_t)(Slapi_PBlock *pb,
    426 	Slapi_Entry *e,
    427 	const char *attr,
    428 	struct berval *berval,
    429 	int access,
    430 	void *state);
    431 
    432 /* object extensions */
    433 typedef void *(*slapi_extension_constructor_fnptr)(void *object, void *parent);
    434 
    435 typedef void (*slapi_extension_destructor_fnptr)(void *extension,
    436 	void *object, void *parent);
    437 
    438 int slapi_register_object_extension( const char *pluginname,
    439 	const char *objectname, slapi_extension_constructor_fnptr constructor,
    440 	slapi_extension_destructor_fnptr destructor, int *objecttype,
    441 	int *extensionhandle);
    442 
    443 #define SLAPI_EXT_CONNECTION    "Connection"
    444 #define SLAPI_EXT_OPERATION     "Operation"
    445 #define SLAPI_EXT_ENTRY         "Entry"
    446 #define SLAPI_EXT_MTNODE        "Mapping Tree Node"
    447 
    448 void *slapi_get_object_extension(int objecttype, void *object,
    449 	int extensionhandle);
    450 void slapi_set_object_extension(int objecttype, void *object,
    451 	int extensionhandle, void *extension);
    452 
    453 int slapi_x_backend_get_flags( const Slapi_Backend *be, unsigned long *flags );
    454 
    455 /* parameters currently supported */
    456 
    457 /*
    458  * Attribute flags returned by slapi_attr_get_flags()
    459  */
    460 #define SLAPI_ATTR_FLAG_SINGLE		0x0001
    461 #define SLAPI_ATTR_FLAG_OPATTR		0x0002
    462 #define SLAPI_ATTR_FLAG_READONLY	0x0004
    463 #define SLAPI_ATTR_FLAG_STD_ATTR	SLAPI_ATTR_FLAG_READONLY
    464 #define SLAPI_ATTR_FLAG_OBSOLETE	0x0040
    465 #define SLAPI_ATTR_FLAG_COLLECTIVE	0x0080
    466 #define SLAPI_ATTR_FLAG_NOUSERMOD	0x0100
    467 
    468 /*
    469  * Backend flags returned by slapi_x_backend_get_flags()
    470  */
    471 #define SLAPI_BACKEND_FLAG_NOLASTMOD		0x0001U
    472 #define SLAPI_BACKEND_FLAG_NO_SCHEMA_CHECK	0x0002U
    473 #define SLAPI_BACKEND_FLAG_GLUE_INSTANCE	0x0010U	/* a glue backend */
    474 #define SLAPI_BACKEND_FLAG_GLUE_SUBORDINATE	0x0020U	/* child of a glue hierarchy */
    475 #define SLAPI_BACKEND_FLAG_GLUE_LINKED		0x0040U	/* child is connected to parent */
    476 #define SLAPI_BACKEND_FLAG_OVERLAY		0x0080U	/* this db struct is an overlay */
    477 #define SLAPI_BACKEND_FLAG_GLOBAL_OVERLAY	0x0100U	/* this db struct is a global overlay */
    478 #define SLAPI_BACKEND_FLAG_SHADOW		0x8000U /* a shadow */
    479 #define SLAPI_BACKEND_FLAG_SYNC_SHADOW		0x1000U /* a sync shadow */
    480 #define SLAPI_BACKEND_FLAG_SLURP_SHADOW		0x2000U /* a slurp shadow */
    481 
    482 /*
    483  * ACL levels
    484  */
    485 #define SLAPI_ACL_COMPARE       0x01
    486 #define SLAPI_ACL_SEARCH        0x02
    487 #define SLAPI_ACL_READ          0x04
    488 #define SLAPI_ACL_WRITE         0x08
    489 #define SLAPI_ACL_DELETE        0x10
    490 #define SLAPI_ACL_ADD           0x20
    491 #define SLAPI_ACL_SELF          0x40
    492 #define SLAPI_ACL_PROXY         0x80
    493 #define SLAPI_ACL_ALL           0x7f
    494 
    495 /* plugin types supported */
    496 
    497 #define SLAPI_PLUGIN_DATABASE           1
    498 #define SLAPI_PLUGIN_EXTENDEDOP         2
    499 #define SLAPI_PLUGIN_PREOPERATION       3
    500 #define SLAPI_PLUGIN_POSTOPERATION      4
    501 #define SLAPI_PLUGIN_MATCHINGRULE       5
    502 #define SLAPI_PLUGIN_SYNTAX             6
    503 #define SLAPI_PLUGIN_AUDIT              7
    504 
    505 /* misc params */
    506 
    507 #define SLAPI_BACKEND				130
    508 #define SLAPI_CONNECTION			131
    509 #define SLAPI_OPERATION				132
    510 #define SLAPI_REQUESTOR_ISROOT			133
    511 #define SLAPI_BE_MONITORDN			134
    512 #define SLAPI_BE_TYPE           		135
    513 #define SLAPI_BE_READONLY       		136
    514 #define SLAPI_BE_LASTMOD       			137
    515 #define SLAPI_CONN_ID        			139
    516 
    517 /* operation params */
    518 #define SLAPI_OPINITIATED_TIME			140
    519 #define SLAPI_REQUESTOR_DN			141
    520 #define SLAPI_IS_REPLICATED_OPERATION		142
    521 #define SLAPI_REQUESTOR_ISUPDATEDN		SLAPI_IS_REPLICATED_OPERATION
    522 
    523 /* connection  structure params*/
    524 #define SLAPI_CONN_DN        			143
    525 #define SLAPI_CONN_AUTHTYPE    			144
    526 #define SLAPI_CONN_CLIENTIP			145
    527 #define SLAPI_CONN_SERVERIP			146
    528 /* OpenLDAP extensions */
    529 #define SLAPI_X_CONN_CLIENTPATH			1300
    530 #define SLAPI_X_CONN_SERVERPATH			1301
    531 #define SLAPI_X_CONN_IS_UDP			1302
    532 #define SLAPI_X_CONN_SSF			1303
    533 #define SLAPI_X_CONN_SASL_CONTEXT		1304
    534 #define SLAPI_X_OPERATION_DELETE_GLUE_PARENT	1305
    535 #define SLAPI_X_RELAX			1306
    536 #define SLAPI_X_MANAGEDIT			SLAPI_X_RELAX
    537 #define SLAPI_X_OPERATION_NO_SCHEMA_CHECK	1307
    538 #define SLAPI_X_ADD_STRUCTURAL_CLASS		1308
    539 #define SLAPI_X_OPERATION_NO_SUBORDINATE_GLUE	1309
    540 
    541 /*  Authentication types */
    542 #define SLAPD_AUTH_NONE   "none"
    543 #define SLAPD_AUTH_SIMPLE "simple"
    544 #define SLAPD_AUTH_SSL    "SSL"
    545 #define SLAPD_AUTH_SASL   "SASL "
    546 
    547 /* plugin configuration parmams */
    548 #define SLAPI_PLUGIN				3
    549 #define SLAPI_PLUGIN_PRIVATE			4
    550 #define SLAPI_PLUGIN_TYPE			5
    551 #define SLAPI_PLUGIN_ARGV			6
    552 #define SLAPI_PLUGIN_ARGC			7
    553 #define SLAPI_PLUGIN_VERSION			8
    554 #define SLAPI_PLUGIN_OPRETURN			9
    555 #define SLAPI_PLUGIN_OBJECT			10
    556 #define SLAPI_PLUGIN_DESTROY_FN			11
    557 #define SLAPI_PLUGIN_DESCRIPTION		12
    558 #define SLAPI_PLUGIN_IDENTITY			13
    559 
    560 /* internal operations params */
    561 #define SLAPI_PLUGIN_INTOP_RESULT		15
    562 #define SLAPI_PLUGIN_INTOP_SEARCH_ENTRIES	16
    563 #define SLAPI_PLUGIN_INTOP_SEARCH_REFERRALS	17
    564 
    565 /* transaction arguments */
    566 #define SLAPI_PARENT_TXN			190
    567 #define SLAPI_TXN				191
    568 
    569 /* function pointer params for backends */
    570 #define SLAPI_PLUGIN_DB_BIND_FN			200
    571 #define SLAPI_PLUGIN_DB_UNBIND_FN		201
    572 #define SLAPI_PLUGIN_DB_SEARCH_FN		202
    573 #define SLAPI_PLUGIN_DB_COMPARE_FN		203
    574 #define SLAPI_PLUGIN_DB_MODIFY_FN		204
    575 #define SLAPI_PLUGIN_DB_MODRDN_FN		205
    576 #define SLAPI_PLUGIN_DB_ADD_FN			206
    577 #define SLAPI_PLUGIN_DB_DELETE_FN		207
    578 #define SLAPI_PLUGIN_DB_ABANDON_FN		208
    579 #define SLAPI_PLUGIN_DB_CONFIG_FN		209
    580 #define SLAPI_PLUGIN_CLOSE_FN			210
    581 #define SLAPI_PLUGIN_DB_FLUSH_FN		211
    582 #define SLAPI_PLUGIN_START_FN			212
    583 #define SLAPI_PLUGIN_DB_SEQ_FN			213
    584 #define SLAPI_PLUGIN_DB_ENTRY_FN		214
    585 #define SLAPI_PLUGIN_DB_REFERRAL_FN		215
    586 #define SLAPI_PLUGIN_DB_RESULT_FN		216
    587 #define SLAPI_PLUGIN_DB_LDIF2DB_FN		217
    588 #define SLAPI_PLUGIN_DB_DB2LDIF_FN		218
    589 #define SLAPI_PLUGIN_DB_BEGIN_FN		219
    590 #define SLAPI_PLUGIN_DB_COMMIT_FN		220
    591 #define SLAPI_PLUGIN_DB_ABORT_FN		221
    592 #define SLAPI_PLUGIN_DB_ARCHIVE2DB_FN		222
    593 #define SLAPI_PLUGIN_DB_DB2ARCHIVE_FN		223
    594 #define SLAPI_PLUGIN_DB_NEXT_SEARCH_ENTRY_FN	224
    595 #define SLAPI_PLUGIN_DB_FREE_RESULT_SET_FN	225
    596 #define	SLAPI_PLUGIN_DB_SIZE_FN			226
    597 #define	SLAPI_PLUGIN_DB_TEST_FN			227
    598 
    599 
    600 /*  functions pointers for LDAP V3 extended ops */
    601 #define SLAPI_PLUGIN_EXT_OP_FN			300
    602 #define SLAPI_PLUGIN_EXT_OP_OIDLIST		301
    603 
    604 /* preoperation */
    605 #define SLAPI_PLUGIN_PRE_BIND_FN		401
    606 #define SLAPI_PLUGIN_PRE_UNBIND_FN		402
    607 #define SLAPI_PLUGIN_PRE_SEARCH_FN		403
    608 #define SLAPI_PLUGIN_PRE_COMPARE_FN		404
    609 #define SLAPI_PLUGIN_PRE_MODIFY_FN		405
    610 #define SLAPI_PLUGIN_PRE_MODRDN_FN		406
    611 #define SLAPI_PLUGIN_PRE_ADD_FN			407
    612 #define SLAPI_PLUGIN_PRE_DELETE_FN		408
    613 #define SLAPI_PLUGIN_PRE_ABANDON_FN		409
    614 #define SLAPI_PLUGIN_PRE_ENTRY_FN		410
    615 #define SLAPI_PLUGIN_PRE_REFERRAL_FN		411
    616 #define SLAPI_PLUGIN_PRE_RESULT_FN		412
    617 
    618 /* internal preoperation */
    619 #define SLAPI_PLUGIN_INTERNAL_PRE_ADD_FN	420
    620 #define SLAPI_PLUGIN_INTERNAL_PRE_MODIFY_FN	421
    621 #define SLAPI_PLUGIN_INTERNAL_PRE_MODRDN_FN	422
    622 #define SLAPI_PLUGIN_INTERNAL_PRE_DELETE_FN	423
    623 
    624 /* backend preoperation */
    625 #define SLAPI_PLUGIN_BE_PRE_ADD_FN		450
    626 #define SLAPI_PLUGIN_BE_PRE_MODIFY_FN		451
    627 #define SLAPI_PLUGIN_BE_PRE_MODRDN_FN		452
    628 #define SLAPI_PLUGIN_BE_PRE_DELETE_FN		453
    629 
    630 /* postoperation */
    631 #define SLAPI_PLUGIN_POST_BIND_FN		501
    632 #define SLAPI_PLUGIN_POST_UNBIND_FN		502
    633 #define SLAPI_PLUGIN_POST_SEARCH_FN		503
    634 #define SLAPI_PLUGIN_POST_COMPARE_FN		504
    635 #define SLAPI_PLUGIN_POST_MODIFY_FN		505
    636 #define SLAPI_PLUGIN_POST_MODRDN_FN		506
    637 #define SLAPI_PLUGIN_POST_ADD_FN		507
    638 #define SLAPI_PLUGIN_POST_DELETE_FN		508
    639 #define SLAPI_PLUGIN_POST_ABANDON_FN		509
    640 #define SLAPI_PLUGIN_POST_ENTRY_FN		510
    641 #define SLAPI_PLUGIN_POST_REFERRAL_FN		511
    642 #define SLAPI_PLUGIN_POST_RESULT_FN		512
    643 
    644 /* internal postoperation */
    645 #define SLAPI_PLUGIN_INTERNAL_POST_ADD_FN	520
    646 #define SLAPI_PLUGIN_INTERNAL_POST_MODIFY_FN	521
    647 #define SLAPI_PLUGIN_INTERNAL_POST_MODRDN_FN	522
    648 #define SLAPI_PLUGIN_INTERNAL_POST_DELETE_FN	523
    649 
    650 /* backend postoperation */
    651 #define SLAPI_PLUGIN_BE_POST_ADD_FN		550
    652 #define SLAPI_PLUGIN_BE_POST_MODIFY_FN		551
    653 #define SLAPI_PLUGIN_BE_POST_MODRDN_FN		552
    654 #define SLAPI_PLUGIN_BE_POST_DELETE_FN		553
    655 
    656 #define SLAPI_OPERATION_TYPE			590
    657 #define SLAPI_OPERATION_MSGID			591
    658 
    659 #define SLAPI_PLUGIN_MR_FILTER_CREATE_FN	600
    660 #define SLAPI_PLUGIN_MR_INDEXER_CREATE_FN	601
    661 #define SLAPI_PLUGIN_MR_FILTER_MATCH_FN		602
    662 #define SLAPI_PLUGIN_MR_FILTER_INDEX_FN		603
    663 #define SLAPI_PLUGIN_MR_FILTER_RESET_FN		604
    664 #define SLAPI_PLUGIN_MR_INDEX_FN		605
    665 #define SLAPI_PLUGIN_MR_OID			610
    666 #define SLAPI_PLUGIN_MR_TYPE			611
    667 #define SLAPI_PLUGIN_MR_VALUE			612
    668 #define SLAPI_PLUGIN_MR_VALUES			613
    669 #define SLAPI_PLUGIN_MR_KEYS			614
    670 #define SLAPI_PLUGIN_MR_FILTER_REUSABLE		615
    671 #define SLAPI_PLUGIN_MR_QUERY_OPERATOR		616
    672 #define SLAPI_PLUGIN_MR_USAGE			617
    673 
    674 #define SLAPI_MATCHINGRULE_NAME			1
    675 #define SLAPI_MATCHINGRULE_OID			2
    676 #define SLAPI_MATCHINGRULE_DESC			3
    677 #define SLAPI_MATCHINGRULE_SYNTAX		4
    678 #define SLAPI_MATCHINGRULE_OBSOLETE		5
    679 
    680 #define SLAPI_OP_LESS					1
    681 #define SLAPI_OP_LESS_OR_EQUAL				2
    682 #define SLAPI_OP_EQUAL					3
    683 #define SLAPI_OP_GREATER_OR_EQUAL			4
    684 #define SLAPI_OP_GREATER				5
    685 #define SLAPI_OP_SUBSTRING				6
    686 
    687 #define SLAPI_PLUGIN_MR_USAGE_INDEX		0
    688 #define SLAPI_PLUGIN_MR_USAGE_SORT		1
    689 
    690 #define SLAPI_PLUGIN_SYNTAX_FILTER_AVA		700
    691 #define SLAPI_PLUGIN_SYNTAX_FILTER_SUB		701
    692 #define SLAPI_PLUGIN_SYNTAX_VALUES2KEYS		702
    693 #define SLAPI_PLUGIN_SYNTAX_ASSERTION2KEYS_AVA	703
    694 #define SLAPI_PLUGIN_SYNTAX_ASSERTION2KEYS_SUB	704
    695 #define SLAPI_PLUGIN_SYNTAX_NAMES		705
    696 #define SLAPI_PLUGIN_SYNTAX_OID			706
    697 #define SLAPI_PLUGIN_SYNTAX_FLAGS		707
    698 #define SLAPI_PLUGIN_SYNTAX_COMPARE		708
    699 
    700 #define SLAPI_PLUGIN_SYNTAX_FLAG_ORKEYS			1
    701 #define SLAPI_PLUGIN_SYNTAX_FLAG_ORDERING		2
    702 
    703 #define SLAPI_PLUGIN_ACL_INIT			730
    704 #define SLAPI_PLUGIN_ACL_SYNTAX_CHECK		731
    705 #define SLAPI_PLUGIN_ACL_ALLOW_ACCESS		732
    706 #define SLAPI_PLUGIN_ACL_MODS_ALLOWED		733
    707 #define SLAPI_PLUGIN_ACL_MODS_UPDATE		734
    708 
    709 #define SLAPI_OPERATION_AUTHTYPE                741
    710 #define SLAPI_OPERATION_ID                      742
    711 #define SLAPI_CONN_CERT                         743
    712 #define SLAPI_CONN_AUTHMETHOD                   746
    713 #define SLAPI_IS_INTERNAL_OPERATION 		748
    714 
    715 #define SLAPI_RESULT_CODE                       881
    716 #define SLAPI_RESULT_TEXT                       882
    717 #define SLAPI_RESULT_MATCHED                    883
    718 
    719 /* managedsait control */
    720 #define SLAPI_MANAGEDSAIT       		1000
    721 
    722 /* audit plugin defines */
    723 #define SLAPI_PLUGIN_AUDIT_DATA                1100
    724 #define SLAPI_PLUGIN_AUDIT_FN                  1101
    725 
    726 /* backend_group extension */
    727 #define SLAPI_X_PLUGIN_PRE_GROUP_FN		1202
    728 #define SLAPI_X_PLUGIN_POST_GROUP_FN		1203
    729 
    730 #define SLAPI_X_GROUP_ENTRY			1250 /* group entry */
    731 #define SLAPI_X_GROUP_ATTRIBUTE			1251 /* member attribute */
    732 #define SLAPI_X_GROUP_OPERATION_DN		1252 /* asserted value */
    733 #define SLAPI_X_GROUP_TARGET_ENTRY		1253 /* target entry */
    734 
    735 /* internal preoperation extensions */
    736 #define SLAPI_PLUGIN_INTERNAL_PRE_BIND_FN	1260
    737 #define SLAPI_PLUGIN_INTERNAL_PRE_UNBIND_FN	1261
    738 #define SLAPI_PLUGIN_INTERNAL_PRE_SEARCH_FN	1262
    739 #define SLAPI_PLUGIN_INTERNAL_PRE_COMPARE_FN	1263
    740 #define SLAPI_PLUGIN_INTERNAL_PRE_ABANDON_FN	1264
    741 
    742 /* internal postoperation extensions */
    743 #define SLAPI_PLUGIN_INTERNAL_POST_BIND_FN	1270
    744 #define SLAPI_PLUGIN_INTERNAL_POST_UNBIND_FN	1271
    745 #define SLAPI_PLUGIN_INTERNAL_POST_SEARCH_FN	1272
    746 #define SLAPI_PLUGIN_INTERNAL_POST_COMPARE_FN	1273
    747 #define SLAPI_PLUGIN_INTERNAL_POST_ABANDON_FN	1274
    748 
    749 /* config stuff */
    750 #define SLAPI_CONFIG_FILENAME			40
    751 #define SLAPI_CONFIG_LINENO			41
    752 #define SLAPI_CONFIG_ARGC			42
    753 #define SLAPI_CONFIG_ARGV			43
    754 
    755 /*  operational params */
    756 #define SLAPI_TARGET_ADDRESS			48
    757 #define SLAPI_TARGET_UNIQUEID			49
    758 #define SLAPI_TARGET_DN				50
    759 
    760 /* server LDAPv3 controls  */
    761 #define SLAPI_REQCONTROLS			51
    762 #define SLAPI_RESCONTROLS			55
    763 #define SLAPI_ADD_RESCONTROL			56
    764 #define SLAPI_CONTROLS_ARG			58
    765 
    766 /* add params */
    767 #define SLAPI_ADD_TARGET			SLAPI_TARGET_DN
    768 #define SLAPI_ADD_ENTRY				60
    769 #define SLAPI_ADD_EXISTING_DN_ENTRY		61
    770 #define SLAPI_ADD_PARENT_ENTRY			62
    771 #define SLAPI_ADD_PARENT_UNIQUEID		63
    772 #define SLAPI_ADD_EXISTING_UNIQUEID_ENTRY	64
    773 
    774 /* bind params */
    775 #define SLAPI_BIND_TARGET			SLAPI_TARGET_DN
    776 #define SLAPI_BIND_METHOD			70
    777 #define SLAPI_BIND_CREDENTIALS			71
    778 #define SLAPI_BIND_SASLMECHANISM		72
    779 #define SLAPI_BIND_RET_SASLCREDS		73
    780 
    781 /* compare params */
    782 #define SLAPI_COMPARE_TARGET			SLAPI_TARGET_DN
    783 #define SLAPI_COMPARE_TYPE			80
    784 #define SLAPI_COMPARE_VALUE			81
    785 
    786 /* delete params */
    787 #define SLAPI_DELETE_TARGET			SLAPI_TARGET_DN
    788 #define SLAPI_DELETE_EXISTING_ENTRY		SLAPI_ADD_EXISTING_DN_ENTRY
    789 
    790 /* modify params */
    791 #define SLAPI_MODIFY_TARGET			SLAPI_TARGET_DN
    792 #define SLAPI_MODIFY_MODS			90
    793 #define SLAPI_MODIFY_EXISTING_ENTRY		SLAPI_ADD_EXISTING_DN_ENTRY
    794 
    795 /* modrdn params */
    796 #define SLAPI_MODRDN_TARGET			SLAPI_TARGET_DN
    797 #define SLAPI_MODRDN_NEWRDN			100
    798 #define SLAPI_MODRDN_DELOLDRDN			101
    799 #define SLAPI_MODRDN_NEWSUPERIOR		102	/* v3 only */
    800 #define SLAPI_MODRDN_EXISTING_ENTRY             SLAPI_ADD_EXISTING_DN_ENTRY
    801 #define SLAPI_MODRDN_PARENT_ENTRY		104
    802 #define SLAPI_MODRDN_NEWPARENT_ENTRY		105
    803 #define SLAPI_MODRDN_TARGET_ENTRY		106
    804 #define SLAPI_MODRDN_NEWSUPERIOR_ADDRESS	107
    805 
    806 /* search params */
    807 #define SLAPI_SEARCH_TARGET			SLAPI_TARGET_DN
    808 #define SLAPI_SEARCH_SCOPE			110
    809 #define SLAPI_SEARCH_DEREF			111
    810 #define SLAPI_SEARCH_SIZELIMIT			112
    811 #define SLAPI_SEARCH_TIMELIMIT			113
    812 #define SLAPI_SEARCH_FILTER			114
    813 #define SLAPI_SEARCH_STRFILTER			115
    814 #define SLAPI_SEARCH_ATTRS			116
    815 #define SLAPI_SEARCH_ATTRSONLY			117
    816 
    817 /* abandon params */
    818 #define SLAPI_ABANDON_MSGID			120
    819 
    820 /* extended operation params */
    821 #define SLAPI_EXT_OP_REQ_OID			160
    822 #define SLAPI_EXT_OP_REQ_VALUE		161
    823 
    824 /* extended operation return codes */
    825 #define SLAPI_EXT_OP_RET_OID			162
    826 #define SLAPI_EXT_OP_RET_VALUE		163
    827 
    828 #define SLAPI_PLUGIN_EXTENDED_SENT_RESULT	-1
    829 
    830 #define SLAPI_FAIL_DISKFULL		-2
    831 #define SLAPI_FAIL_GENERAL		-1
    832 #define SLAPI_PLUGIN_EXTENDED_NOT_HANDLED -2
    833 #define SLAPI_BIND_SUCCESS		0
    834 #define SLAPI_BIND_FAIL			2
    835 #define SLAPI_BIND_ANONYMOUS		3
    836 
    837 /* Search result params */
    838 #define SLAPI_SEARCH_RESULT_SET			193
    839 #define	SLAPI_SEARCH_RESULT_ENTRY		194
    840 #define	SLAPI_NENTRIES				195
    841 #define SLAPI_SEARCH_REFERRALS			196
    842 
    843 /* filter types */
    844 #ifndef LDAP_FILTER_AND
    845 #define LDAP_FILTER_AND         0xa0L
    846 #endif
    847 #ifndef LDAP_FILTER_OR
    848 #define LDAP_FILTER_OR          0xa1L
    849 #endif
    850 #ifndef LDAP_FILTER_NOT
    851 #define LDAP_FILTER_NOT         0xa2L
    852 #endif
    853 #ifndef LDAP_FILTER_EQUALITY
    854 #define LDAP_FILTER_EQUALITY    0xa3L
    855 #endif
    856 #ifndef LDAP_FILTER_SUBSTRINGS
    857 #define LDAP_FILTER_SUBSTRINGS  0xa4L
    858 #endif
    859 #ifndef LDAP_FILTER_GE
    860 #define LDAP_FILTER_GE          0xa5L
    861 #endif
    862 #ifndef LDAP_FILTER_LE
    863 #define LDAP_FILTER_LE          0xa6L
    864 #endif
    865 #ifndef LDAP_FILTER_PRESENT
    866 #define LDAP_FILTER_PRESENT     0x87L
    867 #endif
    868 #ifndef LDAP_FILTER_APPROX
    869 #define LDAP_FILTER_APPROX      0xa8L
    870 #endif
    871 #ifndef LDAP_FILTER_EXT_MATCH
    872 #define LDAP_FILTER_EXT_MATCH   0xa9L
    873 #endif
    874 
    875 int slapi_log_error( int severity, char *subsystem, char *fmt, ... );
    876 #define SLAPI_LOG_FATAL                 0
    877 #define SLAPI_LOG_TRACE                 1
    878 #define SLAPI_LOG_PACKETS               2
    879 #define SLAPI_LOG_ARGS                  3
    880 #define SLAPI_LOG_CONNS                 4
    881 #define SLAPI_LOG_BER                   5
    882 #define SLAPI_LOG_FILTER                6
    883 #define SLAPI_LOG_CONFIG                7
    884 #define SLAPI_LOG_ACL                   8
    885 #define SLAPI_LOG_SHELL                 9
    886 #define SLAPI_LOG_PARSE                 10
    887 #define SLAPI_LOG_HOUSE                 11
    888 #define SLAPI_LOG_REPL                  12
    889 #define SLAPI_LOG_CACHE                 13
    890 #define SLAPI_LOG_PLUGIN                14
    891 #define SLAPI_LOG_TIMING                15
    892 
    893 #define SLAPI_PLUGIN_DESCRIPTION	12
    894 typedef struct slapi_plugindesc {
    895         char    *spd_id;
    896         char    *spd_vendor;
    897         char    *spd_version;
    898         char    *spd_description;
    899 } Slapi_PluginDesc;
    900 
    901 #define SLAPI_PLUGIN_VERSION_01         "01"
    902 #define SLAPI_PLUGIN_VERSION_02         "02"
    903 #define SLAPI_PLUGIN_VERSION_03         "03"
    904 #define SLAPI_PLUGIN_CURRENT_VERSION    SLAPI_PLUGIN_VERSION_03
    905 
    906 #endif /* _SLAPI_PLUGIN_H */
    907 
    908