1 /* init.c - initialize mdb backend */
3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
5 * Copyright 2000-2017 The OpenLDAP Foundation.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted only as authorized by the OpenLDAP
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>.
20 #include <ac/string.h>
21 #include <ac/unistd.h>
22 #include <ac/stdlib.h>
30 static const struct berval mdmi_databases[] = {
39 mdb_id_compare( const MDB_val *a, const MDB_val *b )
41 return *(ID *)a->mv_data < *(ID *)b->mv_data ? -1 : *(ID *)a->mv_data > *(ID *)b->mv_data;
45 mdb_db_init( BackendDB *be, ConfigReply *cr )
50 Debug( LDAP_DEBUG_TRACE,
51 LDAP_XSTRING(mdb_db_init) ": Initializing mdb database\n",
54 /* allocate backend-database-specific stuff */
55 mdb = (struct mdb_info *) ch_calloc( 1, sizeof(struct mdb_info) );
57 /* DBEnv parameters */
58 mdb->mi_dbenv_home = ch_strdup( SLAPD_DEFAULT_DB_DIR );
59 mdb->mi_dbenv_flags = 0;
60 mdb->mi_dbenv_mode = SLAPD_DEFAULT_DB_MODE;
62 mdb->mi_search_stack_depth = DEFAULT_SEARCH_STACK_DEPTH;
63 mdb->mi_search_stack = NULL;
65 mdb->mi_mapsize = DEFAULT_MAPSIZE;
66 mdb->mi_rtxn_size = DEFAULT_RTXN_SIZE;
67 mdb->mi_multi_hi = UINT_MAX;
68 mdb->mi_multi_lo = UINT_MAX;
71 be->be_cf_ocs = be->bd_info->bi_cf_ocs;
73 #ifndef MDB_MULTIPLE_SUFFIXES
74 SLAP_DBFLAGS( be ) |= SLAP_DBFLAG_ONE_SUFFIX;
77 rc = mdb_monitor_db_init( be );
83 mdb_db_close( BackendDB *be, ConfigReply *cr );
86 mdb_db_open( BackendDB *be, ConfigReply *cr )
89 struct mdb_info *mdb = (struct mdb_info *) be->be_private;
95 if ( be->be_suffix == NULL ) {
96 Debug( LDAP_DEBUG_ANY,
97 LDAP_XSTRING(mdb_db_open) ": need suffix.\n",
102 Debug( LDAP_DEBUG_ARGS,
103 LDAP_XSTRING(mdb_db_open) ": \"%s\"\n",
104 be->be_suffix[0].bv_val, 0, 0 );
106 /* Check existence of dbenv_home. Any error means trouble */
107 rc = stat( mdb->mi_dbenv_home, &stat1 );
109 Debug( LDAP_DEBUG_ANY,
110 LDAP_XSTRING(mdb_db_open) ": database \"%s\": "
111 "cannot access database directory \"%s\" (%d).\n",
112 be->be_suffix[0].bv_val, mdb->mi_dbenv_home, errno );
116 /* mdb is always clean */
117 be->be_flags |= SLAP_DBFLAG_CLEAN;
119 rc = mdb_env_create( &mdb->mi_dbenv );
121 Debug( LDAP_DEBUG_ANY,
122 LDAP_XSTRING(mdb_db_open) ": database \"%s\": "
123 "mdb_env_create failed: %s (%d).\n",
124 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
128 if ( mdb->mi_readers ) {
129 rc = mdb_env_set_maxreaders( mdb->mi_dbenv, mdb->mi_readers );
131 Debug( LDAP_DEBUG_ANY,
132 LDAP_XSTRING(mdb_db_open) ": database \"%s\": "
133 "mdb_env_set_maxreaders failed: %s (%d).\n",
134 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
139 rc = mdb_env_set_mapsize( mdb->mi_dbenv, mdb->mi_mapsize );
141 Debug( LDAP_DEBUG_ANY,
142 LDAP_XSTRING(mdb_db_open) ": database \"%s\": "
143 "mdb_env_set_mapsize failed: %s (%d).\n",
144 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
148 rc = mdb_env_set_maxdbs( mdb->mi_dbenv, MDB_INDICES );
150 Debug( LDAP_DEBUG_ANY,
151 LDAP_XSTRING(mdb_db_open) ": database \"%s\": "
152 "mdb_env_set_maxdbs failed: %s (%d).\n",
153 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
158 strcpy( path, mdb->mi_dbenv_home );
162 dbhome = mdb->mi_dbenv_home;
165 Debug( LDAP_DEBUG_TRACE,
166 LDAP_XSTRING(mdb_db_open) ": database \"%s\": "
168 be->be_suffix[0].bv_val, mdb->mi_dbenv_home, 0);
170 flags = mdb->mi_dbenv_flags;
172 if ( slapMode & SLAP_TOOL_QUICK )
173 flags |= MDB_NOSYNC|MDB_WRITEMAP;
175 if ( slapMode & SLAP_TOOL_READONLY)
178 rc = mdb_env_open( mdb->mi_dbenv, dbhome,
179 flags, mdb->mi_dbenv_mode );
182 Debug( LDAP_DEBUG_ANY,
183 LDAP_XSTRING(mdb_db_open) ": database \"%s\" cannot be opened: %s (%d). "
184 "Restore from backup!\n",
185 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
189 rc = mdb_txn_begin( mdb->mi_dbenv, NULL, flags & MDB_RDONLY, &txn );
191 Debug( LDAP_DEBUG_ANY,
192 LDAP_XSTRING(mdb_db_open) ": database \"%s\" cannot be opened: %s (%d). "
193 "Restore from backup!\n",
194 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
198 /* open (and create) main databases */
199 for( i = 0; mdmi_databases[i].bv_val; i++ ) {
200 flags = MDB_INTEGERKEY;
201 if( i == MDB_ID2ENTRY ) {
202 if ( !(slapMode & (SLAP_TOOL_READMAIN|SLAP_TOOL_READONLY) ))
205 if ( i == MDB_DN2ID )
206 flags |= MDB_DUPSORT;
207 if ( i == MDB_ID2VAL )
208 flags ^= MDB_INTEGERKEY|MDB_DUPSORT;
209 if ( !(slapMode & SLAP_TOOL_READONLY) )
213 rc = mdb_dbi_open( txn,
214 mdmi_databases[i].bv_val,
219 snprintf( cr->msg, sizeof(cr->msg), "database \"%s\": "
220 "mdb_dbi_open(%s/%s) failed: %s (%d).",
221 be->be_suffix[0].bv_val,
222 mdb->mi_dbenv_home, mdmi_databases[i].bv_val,
223 mdb_strerror(rc), rc );
224 Debug( LDAP_DEBUG_ANY,
225 LDAP_XSTRING(mdb_db_open) ": %s\n",
230 if ( i == MDB_ID2ENTRY )
231 mdb_set_compare( txn, mdb->mi_dbis[i], mdb_id_compare );
232 else if ( i == MDB_ID2VAL ) {
233 mdb_set_compare( txn, mdb->mi_dbis[i], mdb_id2v_compare );
234 mdb_set_dupsort( txn, mdb->mi_dbis[i], mdb_id2v_dupsort );
235 } else if ( i == MDB_DN2ID ) {
238 mdb_set_dupsort( txn, mdb->mi_dbis[i], mdb_dup_compare );
239 /* check for old dn2id format */
240 rc = mdb_cursor_open( txn, mdb->mi_dbis[i], &mc );
241 /* first record is always ID 0 */
242 rc = mdb_cursor_get( mc, &key, &data, MDB_FIRST );
244 rc = mdb_cursor_get( mc, &key, &data, MDB_NEXT );
249 len = (ptr[0] & 0x7f) << 8 | ptr[1];
250 if (data.mv_size < 2*len + 4 + 2*sizeof(ID)) {
251 snprintf( cr->msg, sizeof(cr->msg),
252 "database \"%s\": DN index needs upgrade, "
253 "run \"slapindex entryDN\".",
254 be->be_suffix[0].bv_val );
255 Debug( LDAP_DEBUG_ANY,
256 LDAP_XSTRING(mdb_db_open) ": %s\n",
258 if ( !(slapMode & SLAP_TOOL_READMAIN ))
260 mdb->mi_flags |= MDB_NEED_UPGRADE;
264 mdb_cursor_close( mc );
265 if ( rc == LDAP_OTHER )
270 rc = mdb_ad_read( mdb, txn );
272 mdb_txn_abort( txn );
276 /* slapcat doesn't need indexes. avoid a failure if
277 * a configured index wasn't created yet.
279 if ( !(slapMode & SLAP_TOOL_READONLY) ) {
280 rc = mdb_attr_dbs_open( be, txn, cr );
282 mdb_txn_abort( txn );
287 rc = mdb_txn_commit(txn);
289 Debug( LDAP_DEBUG_ANY,
290 LDAP_XSTRING(mdb_db_open) ": database %s: "
291 "txn_commit failed: %s (%d)\n",
292 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
297 rc = mdb_monitor_db_open( be );
302 mdb->mi_flags |= MDB_IS_OPEN;
307 mdb_db_close( be, NULL );
312 mdb_db_close( BackendDB *be, ConfigReply *cr )
315 struct mdb_info *mdb = (struct mdb_info *) be->be_private;
317 /* monitor handling */
318 (void)mdb_monitor_db_close( be );
320 mdb->mi_flags &= ~MDB_IS_OPEN;
322 if( mdb->mi_dbenv ) {
323 mdb_reader_flush( mdb->mi_dbenv );
326 if ( mdb->mi_dbenv ) {
327 if ( mdb->mi_dbis[0] ) {
330 mdb_attr_dbs_close( mdb );
331 for ( i=0; i<MDB_NDB; i++ )
332 mdb_dbi_close( mdb->mi_dbenv, mdb->mi_dbis[i] );
334 /* force a sync, but not if we were ReadOnly,
335 * and not in Quick mode.
337 if (!(slapMode & (SLAP_TOOL_QUICK|SLAP_TOOL_READONLY))) {
338 rc = mdb_env_sync( mdb->mi_dbenv, 1 );
340 Debug( LDAP_DEBUG_ANY,
341 "mdb_db_close: database \"%s\": "
342 "mdb_env_sync failed: %s (%d).\n",
343 be->be_suffix[0].bv_val, mdb_strerror(rc), rc );
348 mdb_env_close( mdb->mi_dbenv );
349 mdb->mi_dbenv = NULL;
356 mdb_db_destroy( BackendDB *be, ConfigReply *cr )
358 struct mdb_info *mdb = (struct mdb_info *) be->be_private;
360 /* stop and remove checkpoint task */
361 if ( mdb->mi_txn_cp_task ) {
362 struct re_s *re = mdb->mi_txn_cp_task;
363 mdb->mi_txn_cp_task = NULL;
364 ldap_pvt_thread_mutex_lock( &slapd_rq.rq_mutex );
365 if ( ldap_pvt_runqueue_isrunning( &slapd_rq, re ) )
366 ldap_pvt_runqueue_stoptask( &slapd_rq, re );
367 ldap_pvt_runqueue_remove( &slapd_rq, re );
368 ldap_pvt_thread_mutex_unlock( &slapd_rq.rq_mutex );
371 /* monitor handling */
372 (void)mdb_monitor_db_destroy( be );
374 if( mdb->mi_dbenv_home ) ch_free( mdb->mi_dbenv_home );
376 mdb_attr_index_destroy( mdb );
379 be->be_private = NULL;
390 static char *controls[] = {
392 LDAP_CONTROL_MANAGEDSAIT,
394 LDAP_CONTROL_PAGEDRESULTS,
395 LDAP_CONTROL_PRE_READ,
396 LDAP_CONTROL_POST_READ,
397 LDAP_CONTROL_SUBENTRIES,
398 LDAP_CONTROL_X_PERMISSIVE_MODIFY,
400 LDAP_CONTROL_X_TXN_SPEC,
405 /* initialize the underlying database system */
406 Debug( LDAP_DEBUG_TRACE,
407 LDAP_XSTRING(mdb_back_initialize) ": initialize "
408 MDB_UCTYPE " backend\n", 0, 0, 0 );
411 SLAP_BFLAG_INCREMENT |
412 SLAP_BFLAG_SUBENTRIES |
414 SLAP_BFLAG_REFERRALS;
416 bi->bi_controls = controls;
418 { /* version check */
419 int major, minor, patch, ver;
420 char *version = mdb_version( &major, &minor, &patch );
424 /* All our stdio does an ASCII to EBCDIC conversion on
425 * the output. Strings from the MDB library are already
426 * in EBCDIC; we have to go back and forth...
428 strcpy( v2, version );
432 ver = (major << 24) | (minor << 16) | patch;
433 if( ver != MDB_VERSION_FULL ) {
434 /* fail if a versions don't match */
435 Debug( LDAP_DEBUG_ANY,
436 LDAP_XSTRING(mdb_back_initialize) ": "
437 "MDB library version mismatch:"
438 " expected " MDB_VERSION_STRING ","
439 " got %s\n", version, 0, 0 );
443 Debug( LDAP_DEBUG_TRACE, LDAP_XSTRING(mdb_back_initialize)
444 ": %s\n", version, 0, 0 );
452 bi->bi_db_init = mdb_db_init;
453 bi->bi_db_config = config_generic_wrapper;
454 bi->bi_db_open = mdb_db_open;
455 bi->bi_db_close = mdb_db_close;
456 bi->bi_db_destroy = mdb_db_destroy;
458 bi->bi_op_add = mdb_add;
459 bi->bi_op_bind = mdb_bind;
460 bi->bi_op_compare = mdb_compare;
461 bi->bi_op_delete = mdb_delete;
462 bi->bi_op_modify = mdb_modify;
463 bi->bi_op_modrdn = mdb_modrdn;
464 bi->bi_op_search = mdb_search;
466 bi->bi_op_unbind = 0;
467 bi->bi_op_txn = mdb_txn;
469 bi->bi_extended = mdb_extended;
471 bi->bi_chk_referrals = 0;
472 bi->bi_operational = mdb_operational;
474 bi->bi_has_subordinates = mdb_hasSubordinates;
475 bi->bi_entry_release_rw = mdb_entry_release;
476 bi->bi_entry_get_rw = mdb_entry_get;
479 * hooks for slap tools
481 bi->bi_tool_entry_open = mdb_tool_entry_open;
482 bi->bi_tool_entry_close = mdb_tool_entry_close;
483 bi->bi_tool_entry_first = backend_tool_entry_first;
484 bi->bi_tool_entry_first_x = mdb_tool_entry_first_x;
485 bi->bi_tool_entry_next = mdb_tool_entry_next;
486 bi->bi_tool_entry_get = mdb_tool_entry_get;
487 bi->bi_tool_entry_put = mdb_tool_entry_put;
488 bi->bi_tool_entry_reindex = mdb_tool_entry_reindex;
489 bi->bi_tool_sync = 0;
490 bi->bi_tool_dn2id_get = mdb_tool_dn2id_get;
491 bi->bi_tool_entry_modify = mdb_tool_entry_modify;
492 bi->bi_tool_entry_delete = mdb_tool_entry_delete;
494 bi->bi_connection_init = 0;
495 bi->bi_connection_destroy = 0;
497 rc = mdb_back_init_cf( bi );
502 #if (SLAPD_MDB == SLAPD_MOD_DYNAMIC)
504 SLAP_BACKEND_INIT_MODULE( mdb )
506 #endif /* SLAPD_MDB == SLAPD_MOD_DYNAMIC */