git.sur5r.net Git - openldap/blob - servers/slapd/slapi/proto-slapi.h

   1 /* $OpenLDAP$ */
   2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
   3  *
   4  * Copyright 2002-2004 The OpenLDAP Foundation.
   5  * Portions Copyright 1997,2002-2003 IBM Corporation.
   6  * All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted only as authorized by the OpenLDAP
  10  * Public License.
  11  *
  12  * A copy of this license is available in the file LICENSE in the
  13  * top-level directory of the distribution or, alternatively, at
  14  * <http://www.OpenLDAP.org/license.html>.
  15  */
  16 /* ACKNOWLEDGEMENTS:
  17  * This work was initially developed by IBM Corporation for use in
  18  * IBM products and subsequently ported to OpenLDAP Software by
  19  * Steve Omrani.  Additional significant contributors include:
  20  *   Luke Howard
  21  */
  22
  23 #ifndef _PROTO_SLAPI_H
  24 #define _PROTO_SLAPI_H
  25
  26 LDAP_BEGIN_DECL
  27
  28 /*
  29  * Was: slapi_utils.h
  30  */
  31
  32 extern int slapi_log_error( int severity, char *subsystem, char *fmt, ... );
  33 extern Slapi_Entry *slapi_str2entry( char *s, int flags );
  34 extern char *slapi_entry2str( Slapi_Entry *e, int *len );
  35 extern int slapi_entry_attr_merge( Slapi_Entry *e, char *type, struct berval **vals );
  36 extern int slapi_entry_attr_find( Slapi_Entry *e, char *type, Slapi_Attr **attr );
  37 extern char *slapi_entry_attr_get_charptr( const Slapi_Entry *e, const char *type );
  38 extern int slapi_entry_attr_delete( Slapi_Entry *e, char *type );
  39 extern int slapi_entry_attr_get_int( const Slapi_Entry *e, const char *type );
  40 extern int slapi_entry_attr_get_long( const Slapi_Entry *e, const char *type );
  41 extern int slapi_entry_attr_get_uint( const Slapi_Entry *e, const char *type );
  42 extern int slapi_entry_attr_get_ulong( const Slapi_Entry *e, const char *type );
  43 extern int slapi_entry_attr_hasvalue( Slapi_Entry *e, const char *type, const char *value );
  44 extern int slapi_entry_attr_merge_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
  45 extern void slapi_entry_attr_set_charptr(Slapi_Entry* e, const char *type, const char *value);
  46 extern void slapi_entry_attr_set_int( Slapi_Entry* e, const char *type, int l);
  47 extern void slapi_entry_attr_set_uint( Slapi_Entry* e, const char *type, unsigned int l);
  48 extern void slapi_entry_attr_set_long(Slapi_Entry* e, const char *type, long l);
  49 extern void slapi_entry_attr_set_ulong(Slapi_Entry* e, const char *type, unsigned long l);
  50 extern int slapi_is_rootdse( const char *dn );
  51 extern int slapi_entry_has_children(const Slapi_Entry *e);
  52
  53 extern int slapi_entry_attr_merge_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
  54 extern int slapi_entry_add_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
  55 extern int slapi_entry_add_valueset(Slapi_Entry *e, const char *type, Slapi_ValueSet *vs);
  56 extern int slapi_entry_delete_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
  57 extern int slapi_entry_merge_values_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
  58 extern int slapi_entry_attr_replace_sv( Slapi_Entry *e, const char *type, Slapi_Value **vals );
  59 extern int slapi_entry_add_value(Slapi_Entry *e, const char *type, const Slapi_Value *value);
  60 extern int slapi_entry_add_string(Slapi_Entry *e, const char *type, const char *value);
  61 extern int slapi_entry_delete_string(Slapi_Entry *e, const char *type, const char *value);
  62 extern int slapi_entry_first_attr( const Slapi_Entry *e, Slapi_Attr **attr );
  63 extern int slapi_entry_next_attr( const Slapi_Entry *e, Slapi_Attr *prevattr, Slapi_Attr **attr );
  64 extern char *slapi_entry_get_dn( Slapi_Entry *e );
  65 extern int slapi_x_entry_get_id( Slapi_Entry *e );
  66 extern void slapi_entry_set_dn( Slapi_Entry *e, char *dn );
  67 extern Slapi_Entry *slapi_entry_dup( Slapi_Entry *e );
  68 extern Slapi_Entry *slapi_entry_alloc();
  69 extern void slapi_entry_free( Slapi_Entry *e );
  70 extern int slapi_attr_get_values( Slapi_Attr *attr, struct berval ***vals );
  71
  72 /* DS 5.x SLAPI */
  73 extern int slapi_access_allowed( Slapi_PBlock *pb, Slapi_Entry *e, char *attr,
  74                 struct berval *val, int access );
  75 extern int slapi_acl_check_mods( Slapi_PBlock *pb, Slapi_Entry *e, LDAPMod **mods,
  76                 char **errbuf );
  77 extern Slapi_Attr *slapi_attr_new( void );
  78 extern Slapi_Attr *slapi_attr_init( Slapi_Attr *a, const char *type );
  79 extern void slapi_attr_free( Slapi_Attr **a );
  80 extern Slapi_Attr *slapi_attr_dup( const Slapi_Attr *attr );
  81 extern int slapi_attr_add_value( Slapi_Attr *a, const Slapi_Value *v );
  82 extern int slapi_attr_type2plugin( const char *type, void **pi );
  83 extern int slapi_attr_get_type( const Slapi_Attr *attr, char **type );
  84 extern int slapi_attr_get_oid_copy( const Slapi_Attr *attr, char **oidp );
  85 extern int slapi_attr_get_flags( const Slapi_Attr *attr, unsigned long *flags );
  86 extern int slapi_attr_flag_is_set( const Slapi_Attr *attr, unsigned long flag );
  87 extern int slapi_attr_value_cmp( const Slapi_Attr *attr, const struct berval *v1,
  88                 const struct berval *v2 );
  89 extern int slapi_attr_value_find( const Slapi_Attr *a, struct berval *v );
  90 #if 0
  91 #define SLAPI_TYPE_CMP_EXACT    0
  92 #define SLAPI_TYPE_CMP_BASE     1
  93 #define SLAPI_TYPE_CMP_SUBTYPE  2
  94 #endif
  95 extern int slapi_attr_type_cmp( const char *t1, const char *t2, int opt );
  96 extern int slapi_attr_types_equivalent( const char *t1, const char *t2 );
  97 extern int slapi_attr_first_value( Slapi_Attr *a, Slapi_Value **v );
  98 extern int slapi_attr_next_value( Slapi_Attr *a, int hint, Slapi_Value **v );
  99 extern int slapi_attr_get_numvalues( const Slapi_Attr *a, int *numValues );
 100 extern int slapi_attr_get_valueset( const Slapi_Attr *a, Slapi_ValueSet **vs );
 101 extern int slapi_attr_get_bervals_copy( Slapi_Attr *a, struct berval ***vals );
 102 extern char *slapi_attr_syntax_normalize( const char *s );
 103
 104 extern Slapi_Value *slapi_value_new( void );
 105 extern Slapi_Value *slapi_value_new_berval(const struct berval *bval);
 106 extern Slapi_Value *slapi_value_new_value(const Slapi_Value *v);
 107 extern Slapi_Value *slapi_value_new_string(const char *s);
 108 extern Slapi_Value *slapi_value_init(Slapi_Value *v);
 109 extern Slapi_Value *slapi_value_init_berval(Slapi_Value *v, struct berval *bval);
 110 extern Slapi_Value *slapi_value_init_string(Slapi_Value *v,const char *s);
 111 extern Slapi_Value *slapi_value_dup(const Slapi_Value *v);
 112 extern void slapi_value_free(Slapi_Value **value);
 113 extern const struct berval *slapi_value_get_berval( const Slapi_Value *value );
 114 extern Slapi_Value *slapi_value_set_berval( Slapi_Value *value, const struct berval *bval );
 115 extern Slapi_Value *slapi_value_set_value( Slapi_Value *value, const Slapi_Value *vfrom);
 116 extern Slapi_Value *slapi_value_set( Slapi_Value *value, void *val, unsigned long len);
 117 extern int slapi_value_set_string(Slapi_Value *value, const char *strVal);
 118 extern int slapi_value_set_int(Slapi_Value *value, int intVal);
 119 extern const char*slapi_value_get_string(const Slapi_Value *value);
 120 extern int slapi_value_get_int(const Slapi_Value *value);
 121 extern unsigned int slapi_value_get_uint(const Slapi_Value *value);
 122 extern long slapi_value_get_long(const Slapi_Value *value);
 123 extern unsigned long slapi_value_get_ulong(const Slapi_Value *value);
 124 extern size_t slapi_value_get_length(const Slapi_Value *value);
 125 extern int slapi_value_compare(const Slapi_Attr *a,const Slapi_Value *v1,const Slapi_Value *v2);
 126
 127 extern Slapi_ValueSet *slapi_valueset_new( void );
 128 extern void slapi_valueset_free(Slapi_ValueSet *vs);
 129 extern void slapi_valueset_init(Slapi_ValueSet *vs);
 130 extern void slapi_valueset_done(Slapi_ValueSet *vs);
 131 extern void slapi_valueset_add_value(Slapi_ValueSet *vs, const Slapi_Value *addval);
 132 extern int slapi_valueset_first_value( Slapi_ValueSet *vs, Slapi_Value **v );
 133 extern int slapi_valueset_next_value( Slapi_ValueSet *vs, int index, Slapi_Value **v);
 134 extern int slapi_valueset_count( const Slapi_ValueSet *vs);
 135 extern void slapi_valueset_set_valueset(Slapi_ValueSet *vs1, const Slapi_ValueSet *vs2);
 136
 137 extern Slapi_Mutex *slapi_new_mutex( void );
 138 extern void slapi_destroy_mutex( Slapi_Mutex *mutex );
 139 extern void slapi_lock_mutex( Slapi_Mutex *mutex );
 140 extern int slapi_unlock_mutex( Slapi_Mutex *mutex );
 141 extern Slapi_CondVar *slapi_new_condvar( Slapi_Mutex *mutex );
 142 extern void slapi_destroy_condvar( Slapi_CondVar *cvar );
 143 extern int slapi_wait_condvar( Slapi_CondVar *cvar, struct timeval *timeout );
 144 extern int slapi_notify_condvar( Slapi_CondVar *cvar, int notify_all );
 145
 146 extern char *slapi_ch_malloc( unsigned long size );
 147 extern void slapi_ch_free( void **ptr );
 148 extern void slapi_ch_free_string( char **s );
 149 extern char *slapi_ch_calloc( unsigned long nelem, unsigned long size );
 150 extern char *slapi_ch_realloc( char *block, unsigned long size );
 151 extern char *slapi_ch_strdup( char *s );
 152 extern void slapi_ch_array_free( char **arrayp );
 153 extern struct berval *slapi_ch_bvdup(const struct berval *v);
 154 extern struct berval **slapi_ch_bvecdup(const struct berval **v);
 155
 156 /*
 157  * FIXME: these two were missing, but widely used in a couple of .c files
 158  */
 159 extern size_t slapi_strlen(char *s );
 160 #define slapi_ch_stlen(s)       slapi_strlen(s)
 161 /*
 162  * end of FIXME
 163  */
 164 extern char *slapi_dn_normalize( char *dn );
 165 extern char *slapi_dn_normalize_case( char *dn );
 166 extern char * slapi_esc_dn_normalize( char *dn );
 167 extern char * slapi_esc_dn_normalize_case( char *dn );
 168 extern int slapi_dn_isroot( Slapi_PBlock *pb, char *dn );
 169 extern int slapi_dn_issuffix( char *dn, char *suffix );
 170 char *slapi_dn_beparent( Slapi_PBlock *pb, const char *dn );
 171 char *slapi_dn_parent( const char *dn );
 172 int slapi_dn_isparent( const char *parentdn, const char *childdn );
 173 extern char *slapi_dn_ignore_case( char *dn );
 174 extern char *slapi_get_hostname();
 175 extern void slapi_register_supported_saslmechanism( char *mechanism );
 176 extern void slapi_send_ldap_result( Slapi_PBlock *pb, int err,
 177         char *matched, char *text, int nentries, struct berval **urls );
 178 extern int slapi_send_ldap_extended_response(Connection *conn, Operation *op,
 179                         int errornum, char *respName, struct berval *response);
 180 extern int slapi_send_ldap_search_entry( Slapi_PBlock *pb, Slapi_Entry *e,
 181                         LDAPControl **ectrls, char **attrs, int attrsonly );
 182 extern int slapi_send_ldap_search_reference( Slapi_PBlock *pb, Slapi_Entry *e,
 183         struct berval **references, LDAPControl **ectrls, struct berval **v2refs );
 184
 185 extern void slapi_register_supported_control(char *controloid,
 186                                         unsigned long controlops);
 187 extern int slapi_get_supported_controls(char ***ctrloidsp, unsigned long **ctrlopsp);
 188 extern int slapi_control_present( LDAPControl **controls, char *oid,
 189                                 struct berval **val, int *iscritical);
 190 extern LDAPControl *slapi_dup_control(LDAPControl *control);
 191 extern void slapi_register_supported_saslmechanism(char *mechanism);
 192 extern char **slapi_get_supported_saslmechanisms();
 193 extern char **slapi_get_supported_extended_ops(void);
 194 extern int checkControlHonored(LDAPControl **controls, char *pControlOid,
 195                                 unsigned long operation, int *isHonored );
 196 extern void slapi_broadcast_be(int funcType, Slapi_PBlock *pPB);
 197 extern Slapi_Filter *slapi_str2filter( char *str );
 198 extern Slapi_Filter *slapi_filter_dup( Slapi_Filter *f );
 199 extern void slapi_filter_free( Slapi_Filter *f, int recurse );
 200 extern int slapi_filter_get_choice( Slapi_Filter *f);
 201 extern int slapi_filter_get_ava( Slapi_Filter *f, char **type, struct berval **bval );
 202 extern Slapi_Filter *slapi_filter_list_first( Slapi_Filter *f );
 203 extern Slapi_Filter *slapi_filter_list_next( Slapi_Filter *f, Slapi_Filter *fprev );
 204 extern int slapi_filter_get_attribute_type( Slapi_Filter *f, char **type );
 205 extern int slapi_filter_get_subfilt( Slapi_Filter *f, char **type, char **initial,
 206         char ***any, char **final );
 207 extern Slapi_Filter *slapi_filter_join( int ftype, Slapi_Filter *f1, Slapi_Filter *f2);
 208 extern int slapi_x_filter_append( int choice, Slapi_Filter **pContainingFilter,
 209         Slapi_Filter **pNextFilter, Slapi_Filter *filterToAppend );
 210 extern int slapi_filter_test( Slapi_PBlock *pb, Slapi_Entry *e, Slapi_Filter *f,
 211         int verify_access );
 212 extern int slapi_filter_apply( Slapi_Filter *f, FILTER_APPLY_FN fn, void *arg, int *error_code );
 213 extern int slapi_filter_test_simple( Slapi_Entry *e, Slapi_Filter *f);
 214 extern void slapi_free_search_results_internal(Slapi_PBlock *pb);
 215 extern int slapi_is_connection_ssl(Slapi_PBlock *pPB, int *isSSL);
 216 extern int slapi_get_client_port(Slapi_PBlock *pPB, int *fromPort);
 217 extern int slapi_get_num_be(char *type);
 218 extern unsigned long slapi_timer_current_time();
 219 extern unsigned long slapi_timer_get_time(char *label);
 220 extern void slapi_timer_elapsed_time(char *label,unsigned long start);
 221 extern int slapi_audit_init_header( Connection *conn, Operation *op,
 222                 Audit_record **arp, void **audit_op_str,
 223                 int audit_op, int audit_ext_op, int audit_op_str_len);
 224 extern int slapi_audit_send_record( Slapi_PBlock *pb, Connection *conn,
 225                                                 Operation *op, int rc);
 226
 227 extern int slapi_int_pblock_set_operation( Slapi_PBlock *pb, Operation *op );
 228
 229 extern LDAPMod **slapi_int_modifications2ldapmods(Modifications **);
 230 extern Modifications *slapi_int_ldapmods2modifications(LDAPMod **);
 231 extern void slapi_int_free_ldapmods(LDAPMod **);
 232
 233 extern int slapi_compute_add_evaluator(slapi_compute_callback_t function);
 234 extern int slapi_compute_add_search_rewriter(slapi_search_rewrite_callback_t function);
 235 extern int compute_rewrite_search_filter(Slapi_PBlock *pb);
 236 extern int compute_evaluator(computed_attr_context *c, char *type, Slapi_Entry *e, slapi_compute_output_t outputfn);
 237 extern int slapi_int_compute_output_ber(computed_attr_context *c, Slapi_Attr *a, Slapi_Entry *e);
 238 extern int slapi_x_compute_get_pblock(computed_attr_context *c, Slapi_PBlock **pb);
 239
 240 extern int slapi_int_access_allowed(Operation *op, Entry *entry, AttributeDescription *desc, struct berval *val, slap_access_t access, AccessControlState *state);
 241
 242 extern ldap_pvt_thread_mutex_t  slapi_hn_mutex;
 243 extern ldap_pvt_thread_mutex_t  slapi_time_mutex;
 244 extern ldap_pvt_thread_mutex_t  slapi_printmessage_mutex;
 245 extern char                     *slapi_log_file;
 246 extern int                      slapi_log_level;
 247
 248
 249 /*
 250  * Was: slapi_pblock.h
 251  */
 252
 253 extern Slapi_PBlock *slapi_pblock_new( void );
 254 extern void slapi_pblock_destroy( Slapi_PBlock* );
 255 extern int slapi_pblock_get( Slapi_PBlock *pb, int arg, void *value );
 256 extern int slapi_pblock_set( Slapi_PBlock *pb, int arg, void *value );
 257 extern void slapi_pblock_check_params( Slapi_PBlock *pb, int flag );
 258 extern int slapi_pblock_delete_param( Slapi_PBlock *p, int param );
 259 extern void slapi_pblock_clear( Slapi_PBlock *pb );
 260
 261 /*
 262  * OpenLDAP extensions
 263  */
 264 extern int slapi_int_pblock_get_first( Backend *be, Slapi_PBlock **pb );
 265 extern int slapi_int_pblock_get_next( Slapi_PBlock **pb );
 266
 267
 268 /*
 269  * Was: plugin.h
 270  */
 271
 272 extern int slapi_int_register_plugin(Backend *be, Slapi_PBlock *pPB);
 273 extern int slapi_int_call_plugins(Backend *be, int funcType, Slapi_PBlock * pPB);
 274 extern int slapi_int_get_plugins(Backend *be, int functype, SLAPI_FUNC **ppFuncPtrs);
 275 extern int slapi_int_register_extop(Backend *pBE, ExtendedOp **opList, Slapi_PBlock *pPB);
 276 extern int slapi_int_get_extop_plugin(struct berval  *reqoid, SLAPI_FUNC *pFuncAddr );
 277 extern int slapi_int_read_config(Backend *be, const char *fname, int lineno,
 278                 int argc, char **argv );
 279 extern int slapi_int_initialize(void);
 280
 281
 282 /*
 283  * Was: slapi_ops.h
 284  */
 285
 286 extern Slapi_PBlock *slapi_search_internal( char *base, int scope, char *filter,
 287                 LDAPControl **controls, char **attrs, int attrsonly );
 288 extern Slapi_PBlock *slapi_modify_internal( char *dn, LDAPMod **mods,
 289         LDAPControl **controls, int log_change );
 290 extern Slapi_PBlock *slapi_add_entry_internal( Slapi_Entry * e,
 291                 LDAPControl **controls, int log_change );
 292 extern Slapi_PBlock *slapi_add_internal( char * dn, LDAPMod **attrs,
 293                 LDAPControl **controls, int log_changes );
 294 extern Slapi_PBlock *slapi_add_entry_internal( Slapi_Entry * e,
 295                 LDAPControl **controls, int log_change );
 296 extern Slapi_PBlock *slapi_delete_internal( char * dn,  LDAPControl **controls,
 297                 int log_change );
 298 extern Slapi_PBlock *slapi_modrdn_internal( char * olddn, char * newrdn,
 299                 int deloldrdn, LDAPControl **controls, int log_change);
 300 extern char **slapi_get_supported_extended_ops(void);
 301 extern struct berval *slapi_int_get_supported_extop( int );
 302 Connection *slapi_int_init_connection(char *DN, int OpType);
 303
 304 /*
 305  * Was: slapi_cl.h
 306  */
 307
 308 extern void slapi_register_changelog_suffix(char *suffix);
 309 extern char **slapi_get_changelog_suffixes();
 310 extern void slapi_update_changelog_counters(long curNum, long numEntries);
 311 extern char *slapi_get_cl_firstNum();
 312 extern char *slapi_get_cl_lastNum();
 313 extern int slapi_add_to_changelog(Slapi_Entry *ent, char *suffix,
 314                 char *chNum, Operation* op);
 315 extern int slapi_delete_changelog(char *dn, char *suffix,
 316                 char *chNum, Operation* op);
 317 extern int slapi_modify_changelog(char *dn, LDAPMod *mods,char *suffix,
 318                 char *chNum, Operation* op);
 319 extern int slapi_modifyrdn_changelog(char *olddn, char *newRdn, int delRdn,
 320                 char *suffix, char *chNum, Operation* op);
 321 extern Backend * slapi_cl_get_be(char *dn);
 322
 323 int slapi_int_init_object_extensions(void);
 324 int slapi_int_free_object_extensions(int objecttype, void *object);
 325 int slapi_int_create_object_extensions(int objecttype, void *object);
 326 int slapi_int_clear_object_extensions(int objecttype, void *object);
 327
 328 LDAP_END_DECL
 329
 330 #endif /* _PROTO_SLAPI_H */
 331