Home | History | Annotate | Line # | Download | only in back-mdb
proto-mdb.h revision 1.3
      1 /*	$NetBSD: proto-mdb.h,v 1.3 2021/08/14 16:15:00 christos Exp $	*/
      2 
      3 /* $OpenLDAP$ */
      4 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
      5  *
      6  * Copyright 2000-2021 The OpenLDAP Foundation.
      7  * All rights reserved.
      8  *
      9  * Redistribution and use in source and binary forms, with or without
     10  * modification, are permitted only as authorized by the OpenLDAP
     11  * Public License.
     12  *
     13  * A copy of this license is available in the file LICENSE in the
     14  * top-level directory of the distribution or, alternatively, at
     15  * <http://www.OpenLDAP.org/license.html>.
     16  */
     17 
     18 #ifndef _PROTO_MDB_H
     19 #define _PROTO_MDB_H
     20 
     21 LDAP_BEGIN_DECL
     22 
     23 #define MDB_UCTYPE	"MDB"
     24 
     25 /*
     26  * attr.c
     27  */
     28 
     29 AttrInfo *mdb_attr_mask( struct mdb_info *mdb,
     30 	AttributeDescription *desc );
     31 
     32 void mdb_attr_flush( struct mdb_info *mdb );
     33 
     34 int mdb_attr_slot( struct mdb_info *mdb,
     35 	AttributeDescription *desc, int *insert );
     36 
     37 int mdb_attr_dbs_open( BackendDB *be, MDB_txn *txn, struct config_reply_s *cr );
     38 void mdb_attr_dbs_close( struct mdb_info *mdb );
     39 
     40 int mdb_attr_index_config LDAP_P(( struct mdb_info *mdb,
     41 	const char *fname, int lineno,
     42 	int argc, char **argv, struct config_reply_s *cr ));
     43 
     44 void mdb_attr_index_unparse LDAP_P(( struct mdb_info *mdb, BerVarray *bva ));
     45 void mdb_attr_index_destroy LDAP_P(( struct mdb_info *mdb ));
     46 void mdb_attr_index_free LDAP_P(( struct mdb_info *mdb,
     47 	AttributeDescription *ad ));
     48 
     49 int mdb_attr_multi_config LDAP_P(( struct mdb_info *mdb,
     50 	const char *fname, int lineno,
     51 	int argc, char **argv, struct config_reply_s *cr ));
     52 
     53 void mdb_attr_multi_unparse LDAP_P(( struct mdb_info *mdb, BerVarray *bva ));
     54 
     55 void mdb_attr_multi_thresh LDAP_P(( struct mdb_info *mdb, AttributeDescription *ad,
     56 	unsigned *hi, unsigned *lo ));
     57 
     58 void mdb_attr_info_free( AttrInfo *ai );
     59 
     60 int mdb_ad_read( struct mdb_info *mdb, MDB_txn *txn );
     61 int mdb_ad_get( struct mdb_info *mdb, MDB_txn *txn, AttributeDescription *ad );
     62 void mdb_ad_unwind( struct mdb_info *mdb, int prev_ads );
     63 
     64 /*
     65  * config.c
     66  */
     67 
     68 int mdb_back_init_cf( BackendInfo *bi );
     69 
     70 /*
     71  * dn2entry.c
     72  */
     73 
     74 int mdb_dn2entry LDAP_P(( Operation *op, MDB_txn *tid, MDB_cursor *mc,
     75 	struct berval *dn, Entry **e, ID *nsubs, int matched ));
     76 
     77 /*
     78  * dn2id.c
     79  */
     80 
     81 int mdb_dn2id(
     82 	Operation *op,
     83 	MDB_txn *txn,
     84 	MDB_cursor *mc,
     85 	struct berval *ndn,
     86 	ID *id,
     87 	ID *nsubs,
     88 	struct berval *matched,
     89 	struct berval *nmatched );
     90 
     91 int mdb_dn2id_add(
     92 	Operation *op,
     93 	MDB_cursor *mcp,
     94 	MDB_cursor *mcd,
     95 	ID pid,
     96 	ID nsubs,
     97 	int upsub,
     98 	Entry *e );
     99 
    100 int mdb_dn2id_delete(
    101 	Operation *op,
    102 	MDB_cursor *mc,
    103 	ID id,
    104 	ID nsubs );
    105 
    106 int mdb_dn2id_children(
    107 	Operation *op,
    108 	MDB_txn *tid,
    109 	Entry *e );
    110 
    111 int mdb_dn2sups (
    112 	Operation *op,
    113 	MDB_txn *tid,
    114 	struct berval *dn,
    115 	ID *sups
    116 	);
    117 
    118 int mdb_dn2idl(
    119 	Operation *op,
    120 	MDB_txn *txn,
    121 	struct berval *ndn,
    122 	ID eid,
    123 	ID *ids,
    124 	ID *stack );
    125 
    126 int mdb_dn2id_parent(
    127 	Operation *op,
    128 	MDB_txn *txn,
    129 	ID eid,
    130 	ID *idp );
    131 
    132 int mdb_id2name(
    133 	Operation *op,
    134 	MDB_txn *txn,
    135 	MDB_cursor **cursp,
    136 	ID eid,
    137 	struct berval *name,
    138 	struct berval *nname);
    139 
    140 int mdb_idscope(
    141 	Operation *op,
    142 	MDB_txn *txn,
    143 	ID base,
    144 	ID *ids,
    145 	ID *res );
    146 
    147 struct IdScopes;
    148 
    149 int mdb_idscopes(
    150 	Operation *op,
    151 	struct IdScopes *isc );
    152 
    153 int mdb_idscopechk(
    154 	Operation *op,
    155 	struct IdScopes *isc );
    156 
    157 int mdb_dn2id_walk(
    158 	Operation *op,
    159 	struct IdScopes *isc );
    160 
    161 void mdb_dn2id_wrestore(
    162 	Operation *op,
    163 	struct IdScopes *isc );
    164 
    165 MDB_cmp_func mdb_dup_compare;
    166 
    167 /*
    168  * filterentry.c
    169  */
    170 
    171 int mdb_filter_candidates(
    172 	Operation *op,
    173 	MDB_txn *txn,
    174 	Filter	*f,
    175 	ID *ids,
    176 	ID *tmp,
    177 	ID *stack );
    178 
    179 /*
    180  * id2entry.c
    181  */
    182 
    183 MDB_cmp_func mdb_id2v_compare;
    184 MDB_cmp_func mdb_id2v_dupsort;
    185 
    186 int mdb_id2entry_add(
    187 	Operation *op,
    188 	MDB_txn *tid,
    189 	MDB_cursor *mc,
    190 	Entry *e );
    191 
    192 int mdb_id2entry_update(
    193 	Operation *op,
    194 	MDB_txn *tid,
    195 	MDB_cursor *mc,
    196 	Entry *e );
    197 
    198 int mdb_id2entry_delete(
    199 	BackendDB *be,
    200 	MDB_txn *tid,
    201 	Entry *e);
    202 
    203 int mdb_id2entry(
    204 	Operation *op,
    205 	MDB_cursor *mc,
    206 	ID id,
    207 	Entry **e);
    208 
    209 int mdb_id2edata(
    210 	Operation *op,
    211 	MDB_cursor *mc,
    212 	ID id,
    213 	MDB_val *data);
    214 
    215 int mdb_entry_return( Operation *op, Entry *e );
    216 BI_entry_release_rw mdb_entry_release;
    217 BI_entry_get_rw mdb_entry_get;
    218 BI_op_txn mdb_txn;
    219 
    220 int mdb_entry_decode( Operation *op, MDB_txn *txn, MDB_val *data, ID id, Entry **e );
    221 
    222 void mdb_reader_flush( MDB_env *env );
    223 int mdb_opinfo_get( Operation *op, struct mdb_info *mdb, int rdonly, mdb_op_info **moi );
    224 
    225 int mdb_mval_put(Operation *op, MDB_cursor *mc, ID id, Attribute *a);
    226 int mdb_mval_del(Operation *op, MDB_cursor *mc, ID id, Attribute *a);
    227 
    228 /*
    229  * idl.c
    230  */
    231 
    232 unsigned mdb_idl_search( ID *ids, ID id );
    233 
    234 int mdb_idl_fetch_key(
    235 	BackendDB	*be,
    236 	MDB_txn		*txn,
    237 	MDB_dbi		dbi,
    238 	MDB_val		*key,
    239 	ID			*ids,
    240 	MDB_cursor	**saved_cursor,
    241 	int                     get_flag );
    242 
    243 int mdb_idl_insert( ID *ids, ID id );
    244 
    245 typedef int (mdb_idl_keyfunc)(
    246 	BackendDB *be,
    247 	MDB_cursor *mc,
    248 	struct berval *key,
    249 	ID id );
    250 
    251 mdb_idl_keyfunc mdb_idl_insert_keys;
    252 mdb_idl_keyfunc mdb_idl_delete_keys;
    253 
    254 int
    255 mdb_idl_intersection(
    256 	ID *a,
    257 	ID *b );
    258 
    259 int
    260 mdb_idl_union(
    261 	ID *a,
    262 	ID *b );
    263 
    264 ID mdb_idl_first( ID *ids, ID *cursor );
    265 ID mdb_idl_next( ID *ids, ID *cursor );
    266 
    267 void mdb_idl_sort( ID *ids, ID *tmp );
    268 int mdb_idl_append( ID *a, ID *b );
    269 int mdb_idl_append_one( ID *ids, ID id );
    270 
    271 
    272 /*
    273  * index.c
    274  */
    275 
    276 extern AttrInfo *
    277 mdb_index_mask LDAP_P((
    278 	Backend *be,
    279 	AttributeDescription *desc,
    280 	struct berval *name ));
    281 
    282 extern int
    283 mdb_index_param LDAP_P((
    284 	Backend *be,
    285 	AttributeDescription *desc,
    286 	int ftype,
    287 	MDB_dbi *dbi,
    288 	slap_mask_t *mask,
    289 	struct berval *prefix ));
    290 
    291 extern int
    292 mdb_index_values LDAP_P((
    293 	Operation *op,
    294 	MDB_txn *txn,
    295 	AttributeDescription *desc,
    296 	BerVarray vals,
    297 	ID id,
    298 	int opid ));
    299 
    300 extern int
    301 mdb_index_recset LDAP_P((
    302 	struct mdb_info *mdb,
    303 	Attribute *a,
    304 	AttributeType *type,
    305 	struct berval *tags,
    306 	IndexRec *ir ));
    307 
    308 extern int
    309 mdb_index_recrun LDAP_P((
    310 	Operation *op,
    311 	MDB_txn *txn,
    312 	struct mdb_info *mdb,
    313 	IndexRec *ir,
    314 	ID id,
    315 	int base ));
    316 
    317 int mdb_index_entry LDAP_P(( Operation *op, MDB_txn *t, int r, Entry *e ));
    318 
    319 #define mdb_index_entry_add(op,t,e) \
    320 	mdb_index_entry((op),(t),SLAP_INDEX_ADD_OP,(e))
    321 #define mdb_index_entry_del(op,t,e) \
    322 	mdb_index_entry((op),(t),SLAP_INDEX_DELETE_OP,(e))
    323 
    324 /*
    325  * key.c
    326  */
    327 
    328 extern int
    329 mdb_key_read(
    330     Backend	*be,
    331 	MDB_txn *txn,
    332 	MDB_dbi dbi,
    333     struct berval *k,
    334 	ID *ids,
    335     MDB_cursor **saved_cursor,
    336         int get_flags );
    337 
    338 /*
    339  * nextid.c
    340  */
    341 
    342 int mdb_next_id( BackendDB *be, MDB_cursor *mc, ID *id );
    343 
    344 /*
    345  * modify.c
    346  */
    347 
    348 int mdb_modify_internal(
    349 	Operation *op,
    350 	MDB_txn *tid,
    351 	Modifications *modlist,
    352 	Entry *e,
    353 	const char **text,
    354 	char *textbuf,
    355 	size_t textlen );
    356 
    357 /*
    358  * monitor.c
    359  */
    360 
    361 int mdb_monitor_db_init( BackendDB *be );
    362 int mdb_monitor_db_open( BackendDB *be );
    363 int mdb_monitor_db_close( BackendDB *be );
    364 int mdb_monitor_db_destroy( BackendDB *be );
    365 
    366 #ifdef MDB_MONITOR_IDX
    367 int
    368 mdb_monitor_idx_add(
    369 	struct mdb_info		*mdb,
    370 	AttributeDescription	*desc,
    371 	slap_mask_t		type );
    372 #endif /* MDB_MONITOR_IDX */
    373 
    374 /*
    375  * former external.h
    376  */
    377 
    378 extern BI_init				mdb_back_initialize;
    379 
    380 extern BI_db_config			mdb_db_config;
    381 
    382 extern BI_op_add			mdb_add;
    383 extern BI_op_bind			mdb_bind;
    384 extern BI_op_compare			mdb_compare;
    385 extern BI_op_delete			mdb_delete;
    386 extern BI_op_modify			mdb_modify;
    387 extern BI_op_modrdn			mdb_modrdn;
    388 extern BI_op_search			mdb_search;
    389 extern BI_op_extended			mdb_extended;
    390 
    391 extern BI_chk_referrals			mdb_referrals;
    392 
    393 extern BI_operational			mdb_operational;
    394 
    395 extern BI_has_subordinates 		mdb_hasSubordinates;
    396 
    397 /* tools.c */
    398 extern BI_tool_entry_open		mdb_tool_entry_open;
    399 extern BI_tool_entry_close		mdb_tool_entry_close;
    400 extern BI_tool_entry_first_x		mdb_tool_entry_first_x;
    401 extern BI_tool_entry_next		mdb_tool_entry_next;
    402 extern BI_tool_entry_get		mdb_tool_entry_get;
    403 extern BI_tool_entry_put		mdb_tool_entry_put;
    404 extern BI_tool_entry_reindex		mdb_tool_entry_reindex;
    405 extern BI_tool_dn2id_get		mdb_tool_dn2id_get;
    406 extern BI_tool_entry_modify		mdb_tool_entry_modify;
    407 extern BI_tool_entry_delete		mdb_tool_entry_delete;
    408 
    409 extern mdb_idl_keyfunc mdb_tool_idl_add;
    410 
    411 LDAP_END_DECL
    412 
    413 #endif /* _PROTO_MDB_H */
    414