/* ldb database library Copyright (C) Andrew Tridgell 2004 Copyright (C) Stefan Metzmacher 2004 ** NOTE! The following LGPL license applies to the ldb ** library. This does NOT imply that all of Samba is released ** under the LGPL This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ /* * Name: ldb * * Component: ldb tdb backend * * Description: core functions for tdb backend * * Author: Andrew Tridgell * Author: Stefan Metzmacher */ #include "includes.h" #include "ldb/include/ldb.h" #include "ldb/include/ldb_private.h" #include "ldb/ldb_tdb/ldb_tdb.h" #define LDBLOCK "@INT_LDBLOCK" /* form a TDB_DATA for a record key caller frees note that the key for a record can depend on whether the dn refers to a case sensitive index record or not */ struct TDB_DATA ltdb_key(struct ldb_module *module, const char *dn) { struct ldb_context *ldb = module->ldb; TDB_DATA key; char *key_str = NULL; char *dn_folded = NULL; struct ldb_dn *edn = NULL; struct ldb_dn *cedn = NULL; /* most DNs are case insensitive. The exception is index DNs for case sensitive attributes there are 3 cases dealt with in this code: 1) if the dn doesn't start with @ then uppercase the attribute names and the attributes values of case insensitive attributes 2) if the dn starts with @ then leave it alone - the indexing code handles the rest */ if (*dn == '@') { dn_folded = talloc_strdup(ldb, dn); } else { edn = ldb_dn_explode(ldb, dn); if (!edn) goto failed; cedn = ldb_dn_casefold(ldb, edn); if (!cedn) goto failed; dn_folded = ldb_dn_linearize(ldb, cedn); if (!dn_folded) goto failed; talloc_free(edn); talloc_free(cedn); } key_str = talloc_asprintf(ldb, "DN=%s", dn_folded); talloc_free(dn_folded); if (!key_str) { goto failed; } key.dptr = key_str; key.dsize = strlen(key_str) + 1; return key; failed: talloc_free(edn); talloc_free(cedn); errno = ENOMEM; key.dptr = NULL; key.dsize = 0; return key; } /* lock the database for write - currently a single lock is used */ static int ltdb_lock(struct ldb_module *module, const char *lockname) { struct ltdb_private *ltdb = module->private_data; char *lock_dn; TDB_DATA key; int ret; if (lockname == NULL) { return -1; } lock_dn = talloc_asprintf(module->ldb, "%s_%s", LDBLOCK, lockname); if (lock_dn == NULL) { return -1; } key = ltdb_key(module, lock_dn); if (!key.dptr) { talloc_free(lock_dn); return -1; } ret = tdb_chainlock(ltdb->tdb, key); talloc_free(key.dptr); talloc_free(lock_dn); return ret; } /* unlock the database after a ltdb_lock() */ static int ltdb_unlock(struct ldb_module *module, const char *lockname) { struct ltdb_private *ltdb = module->private_data; char *lock_dn; TDB_DATA key; if (lockname == NULL) { return -1; } lock_dn = talloc_asprintf(module->ldb, "%s_%s", LDBLOCK, lockname); if (lock_dn == NULL) { return -1; } key = ltdb_key(module, lock_dn); if (!key.dptr) { talloc_free(lock_dn); return -1; } tdb_chainunlock(ltdb->tdb, key); talloc_free(key.dptr); talloc_free(lock_dn); return 0; } /* lock the database for read - use by ltdb_search */ int ltdb_lock_read(struct ldb_module *module) { struct ltdb_private *ltdb = module->private_data; TDB_DATA key; int ret; key = ltdb_key(module, LDBLOCK); if (!key.dptr) { return -1; } ret = tdb_chainlock_read(ltdb->tdb, key); talloc_free(key.dptr); return ret; } /* unlock the database after a ltdb_lock_read() */ int ltdb_unlock_read(struct ldb_module *module) { struct ltdb_private *ltdb = module->private_data; TDB_DATA key; key = ltdb_key(module, LDBLOCK); if (!key.dptr) { return -1; } tdb_chainunlock_read(ltdb->tdb, key); talloc_free(key.dptr); return 0; } /* check special dn's have valid attributes currently only @ATTRIBUTES is checked */ int ltdb_check_special_dn(struct ldb_module *module, const struct ldb_message *msg) { struct ltdb_private *ltdb = module->private_data; int i, j; if (strcmp(msg->dn, LTDB_ATTRIBUTES) != 0) { return 0; } /* we have @ATTRIBUTES, let's check attributes are fine */ /* should we check that we deny multivalued attributes ? */ for (i = 0; i < msg->num_elements; i++) { for (j = 0; j < msg->elements[i].num_values; j++) { if (ltdb_check_at_attributes_values(&msg->elements[i].values[j]) != 0) { ltdb->last_err_string = "Invalid attribute value in an @ATTRIBUTES entry"; return -1; } } } return 0; } /* we've made a modification to a dn - possibly reindex and update sequence number */ static int ltdb_modified(struct ldb_module *module, const char *dn) { int ret = 0; if (strcmp(dn, LTDB_INDEXLIST) == 0 || strcmp(dn, LTDB_ATTRIBUTES) == 0) { ret = ltdb_reindex(module); } if (ret == 0 && strcmp(dn, LTDB_BASEINFO) != 0) { ret = ltdb_increase_sequence_number(module); } return ret; } /* store a record into the db */ int ltdb_store(struct ldb_module *module, const struct ldb_message *msg, int flgs) { struct ltdb_private *ltdb = module->private_data; TDB_DATA tdb_key, tdb_data; int ret; tdb_key = ltdb_key(module, msg->dn); if (!tdb_key.dptr) { return -1; } ret = ltdb_pack_data(module, msg, &tdb_data); if (ret == -1) { talloc_free(tdb_key.dptr); return -1; } ret = tdb_store(ltdb->tdb, tdb_key, tdb_data, flgs); if (ret == -1) { goto done; } ret = ltdb_index_add(module, msg); if (ret == -1) { tdb_delete(ltdb->tdb, tdb_key); } done: talloc_free(tdb_key.dptr); talloc_free(tdb_data.dptr); return ret; } /* add a record to the database */ static int ltdb_add(struct ldb_module *module, const struct ldb_message *msg) { struct ltdb_private *ltdb = module->private_data; int ret; ltdb->last_err_string = NULL; ret = ltdb_check_special_dn(module, msg); if (ret != 0) { return ret; } if (ltdb_lock(module, LDBLOCK) != 0) { return -1; } if (ltdb_cache_load(module) != 0) { ltdb_unlock(module, LDBLOCK); return -1; } ret = ltdb_store(module, msg, TDB_INSERT); if (ret == 0) { ltdb_modified(module, msg->dn); } ltdb_unlock(module, LDBLOCK); return ret; } /* delete a record from the database, not updating indexes (used for deleting index records) */ int ltdb_delete_noindex(struct ldb_module *module, const char *dn) { struct ltdb_private *ltdb = module->private_data; TDB_DATA tdb_key; int ret; tdb_key = ltdb_key(module, dn); if (!tdb_key.dptr) { return -1; } ret = tdb_delete(ltdb->tdb, tdb_key); talloc_free(tdb_key.dptr); return ret; } /* delete a record from the database */ static int ltdb_delete(struct ldb_module *module, const char *dn) { struct ltdb_private *ltdb = module->private_data; int ret; struct ldb_message *msg = NULL; ltdb->last_err_string = NULL; if (ltdb_lock(module, LDBLOCK) != 0) { return -1; } if (ltdb_cache_load(module) != 0) { goto failed; } msg = talloc(module, struct ldb_message); if (msg == NULL) { goto failed; } /* in case any attribute of the message was indexed, we need to fetch the old record */ ret = ltdb_search_dn1(module, dn, msg); if (ret != 1) { /* not finding the old record is an error */ goto failed; } ret = ltdb_delete_noindex(module, dn); if (ret == -1) { goto failed; } /* remove any indexed attributes */ ret = ltdb_index_del(module, msg); if (ret == 0) { ltdb_modified(module, dn); } talloc_free(msg); ltdb_unlock(module, LDBLOCK); return ret; failed: talloc_free(msg); ltdb_unlock(module, LDBLOCK); return -1; } /* find an element by attribute name. At the moment this does a linear search, it should be re-coded to use a binary search once all places that modify records guarantee sorted order return the index of the first matching element if found, otherwise -1 */ static int find_element(const struct ldb_message *msg, const char *name) { unsigned int i; for (i=0;inum_elements;i++) { if (ldb_attr_cmp(msg->elements[i].name, name) == 0) { return i; } } return -1; } /* add an element to an existing record. Assumes a elements array that we can call re-alloc on, and assumed that we can re-use the data pointers from the passed in additional values. Use with care! returns 0 on success, -1 on failure (and sets errno) */ static int msg_add_element(struct ldb_context *ldb, struct ldb_message *msg, struct ldb_message_element *el) { struct ldb_message_element *e2; unsigned int i; e2 = talloc_realloc(msg, msg->elements, struct ldb_message_element, msg->num_elements+1); if (!e2) { errno = ENOMEM; return -1; } msg->elements = e2; e2 = &msg->elements[msg->num_elements]; e2->name = el->name; e2->flags = el->flags; e2->values = NULL; if (el->num_values != 0) { e2->values = talloc_array(msg->elements, struct ldb_val, el->num_values); if (!e2->values) { errno = ENOMEM; return -1; } } for (i=0;inum_values;i++) { e2->values[i] = el->values[i]; } e2->num_values = el->num_values; msg->num_elements++; return 0; } /* delete all elements having a specified attribute name */ static int msg_delete_attribute(struct ldb_module *module, struct ldb_context *ldb, struct ldb_message *msg, const char *name) { unsigned int i, j; for (i=0;inum_elements;i++) { if (ldb_attr_cmp(msg->elements[i].name, name) == 0) { for (j=0;jelements[i].num_values;j++) { ltdb_index_del_value(module, msg->dn, &msg->elements[i], j); } talloc_free(msg->elements[i].values); if (msg->num_elements > (i+1)) { memmove(&msg->elements[i], &msg->elements[i+1], sizeof(struct ldb_message_element)* (msg->num_elements - (i+1))); } msg->num_elements--; i--; msg->elements = talloc_realloc(msg, msg->elements, struct ldb_message_element, msg->num_elements); } } return 0; } /* delete all elements matching an attribute name/value return 0 on success, -1 on failure */ static int msg_delete_element(struct ldb_module *module, struct ldb_message *msg, const char *name, const struct ldb_val *val) { struct ldb_context *ldb = module->ldb; unsigned int i; int found; struct ldb_message_element *el; const struct ldb_attrib_handler *h; found = find_element(msg, name); if (found == -1) { return -1; } el = &msg->elements[found]; h = ldb_attrib_handler(ldb, el->name); for (i=0;inum_values;i++) { if (h->comparison_fn(ldb, ldb, &el->values[i], val) == 0) { if (inum_values-1) { memmove(&el->values[i], &el->values[i+1], sizeof(el->values[i])*(el->num_values-(i+1))); } el->num_values--; if (el->num_values == 0) { return msg_delete_attribute(module, ldb, msg, name); } return 0; } } return -1; } /* modify a record - internal interface yuck - this is O(n^2). Luckily n is usually small so we probably get away with it, but if we ever have really large attribute lists then we'll need to look at this again */ int ltdb_modify_internal(struct ldb_module *module, const struct ldb_message *msg) { struct ldb_context *ldb = module->ldb; struct ltdb_private *ltdb = module->private_data; TDB_DATA tdb_key, tdb_data; struct ldb_message *msg2; unsigned i, j; int ret; tdb_key = ltdb_key(module, msg->dn); if (!tdb_key.dptr) { return -1; } tdb_data = tdb_fetch(ltdb->tdb, tdb_key); if (!tdb_data.dptr) { talloc_free(tdb_key.dptr); return -1; } msg2 = talloc(tdb_key.dptr, struct ldb_message); if (msg2 == NULL) { talloc_free(tdb_key.dptr); return -1; } ret = ltdb_unpack_data(module, &tdb_data, msg2); if (ret == -1) { talloc_free(tdb_key.dptr); free(tdb_data.dptr); return -1; } if (!msg2->dn) { msg2->dn = msg->dn; } for (i=0;inum_elements;i++) { struct ldb_message_element *el = &msg->elements[i]; struct ldb_message_element *el2; struct ldb_val *vals; switch (msg->elements[i].flags & LDB_FLAG_MOD_MASK) { case LDB_FLAG_MOD_ADD: /* add this element to the message. fail if it already exists */ ret = find_element(msg2, el->name); if (ret == -1) { if (msg_add_element(ldb, msg2, el) != 0) { goto failed; } continue; } el2 = &msg2->elements[ret]; /* An attribute with this name already exists, add all * values if they don't already exist. */ for (j=0;jnum_values;j++) { if (ldb_msg_find_val(el2, &el->values[j])) { ltdb->last_err_string = "Type or value exists"; goto failed; } } vals = talloc_realloc(msg2->elements, el2->values, struct ldb_val, el2->num_values + el->num_values); if (vals == NULL) goto failed; for (j=0;jnum_values;j++) { vals[el2->num_values + j] = ldb_val_dup(vals, &el->values[j]); } el2->values = vals; el2->num_values += el->num_values; break; case LDB_FLAG_MOD_REPLACE: /* replace all elements of this attribute name with the elements listed. The attribute not existing is not an error */ msg_delete_attribute(module, ldb, msg2, msg->elements[i].name); /* add the replacement element, if not empty */ if (msg->elements[i].num_values != 0 && msg_add_element(ldb, msg2, &msg->elements[i]) != 0) { goto failed; } break; case LDB_FLAG_MOD_DELETE: /* we could be being asked to delete all values or just some values */ if (msg->elements[i].num_values == 0) { if (msg_delete_attribute(module, ldb, msg2, msg->elements[i].name) != 0) { ltdb->last_err_string = "No such attribute"; goto failed; } break; } for (j=0;jelements[i].num_values;j++) { if (msg_delete_element(module, msg2, msg->elements[i].name, &msg->elements[i].values[j]) != 0) { ltdb->last_err_string = "No such attribute"; goto failed; } if (ltdb_index_del_value(module, msg->dn, &msg->elements[i], j) != 0) { goto failed; } } break; default: ltdb->last_err_string = "Invalid ldb_modify flags"; goto failed; } } /* we've made all the mods - save the modified record back into the database */ ret = ltdb_store(module, msg2, TDB_MODIFY); talloc_free(tdb_key.dptr); free(tdb_data.dptr); return ret; failed: talloc_free(tdb_key.dptr); free(tdb_data.dptr); return -1; } /* modify a record */ static int ltdb_modify(struct ldb_module *module, const struct ldb_message *msg) { struct ltdb_private *ltdb = module->private_data; int ret; ltdb->last_err_string = NULL; ret = ltdb_check_special_dn(module, msg); if (ret != 0) { return ret; } if (ltdb_lock(module, LDBLOCK) != 0) { return -1; } if (ltdb_cache_load(module) != 0) { ltdb_unlock(module, LDBLOCK); return -1; } ret = ltdb_modify_internal(module, msg); if (ret == 0) { ltdb_modified(module, msg->dn); } ltdb_unlock(module, LDBLOCK); return ret; } /* rename a record */ static int ltdb_rename(struct ldb_module *module, const char *olddn, const char *newdn) { struct ltdb_private *ltdb = module->private_data; int ret; struct ldb_message *msg; const char *error_str; ltdb->last_err_string = NULL; if (ltdb_lock(module, LDBLOCK) != 0) { return -1; } if (ltdb_cache_load(module) != 0) { ltdb_unlock(module, LDBLOCK); return -1; } msg = talloc(module, struct ldb_message); if (msg == NULL) { goto failed; } /* in case any attribute of the message was indexed, we need to fetch the old record */ ret = ltdb_search_dn1(module, olddn, msg); if (ret != 1) { /* not finding the old record is an error */ goto failed; } msg->dn = talloc_strdup(msg, newdn); if (!msg->dn) { goto failed; } ret = ltdb_add(module, msg); if (ret == -1) { goto failed; } ret = ltdb_delete(module, olddn); error_str = ltdb->last_err_string; if (ret == -1) { ltdb_delete(module, newdn); } ltdb->last_err_string = error_str; talloc_free(msg); ltdb_unlock(module, LDBLOCK); return ret; failed: talloc_free(msg); ltdb_unlock(module, LDBLOCK); return -1; } /* return extended error information */ static const char *ltdb_errstring(struct ldb_module *module) { struct ltdb_private *ltdb = module->private_data; if (ltdb->last_err_string) { return ltdb->last_err_string; } return tdb_errorstr(ltdb->tdb); } static const struct ldb_module_ops ltdb_ops = { .name = "tdb", .search = ltdb_search, .search_bytree = ltdb_search_bytree, .add_record = ltdb_add, .modify_record = ltdb_modify, .delete_record = ltdb_delete, .rename_record = ltdb_rename, .named_lock = ltdb_lock, .named_unlock = ltdb_unlock, .errstring = ltdb_errstring }; /* destroy the ltdb context */ static int ltdb_destructor(void *p) { struct ltdb_private *ltdb = p; tdb_close(ltdb->tdb); return 0; } /* connect to the database */ int ltdb_connect(struct ldb_context *ldb, const char *url, unsigned int flags, const char *options[]) { const char *path; int tdb_flags, open_flags; struct ltdb_private *ltdb; TDB_CONTEXT *tdb; /* parse the url */ if (strchr(url, ':')) { if (strncmp(url, "tdb://", 6) != 0) { ldb_debug(ldb, LDB_DEBUG_ERROR, "Invalid tdb URL '%s'", url); return -1; } path = url+6; } else { path = url; } tdb_flags = TDB_DEFAULT; if (flags & LDB_FLG_RDONLY) { open_flags = O_RDONLY; } else { open_flags = O_CREAT | O_RDWR; } /* note that we use quite a large default hash size */ tdb = tdb_open(path, 10000, tdb_flags, open_flags, 0666); if (!tdb) { ldb_debug(ldb, LDB_DEBUG_ERROR, "Unable to open tdb '%s'\n", path); return -1; } ltdb = talloc_zero(ldb, struct ltdb_private); if (!ltdb) { tdb_close(tdb); ldb_oom(ldb); return -1; } ltdb->tdb = tdb; ltdb->sequence_number = 0; talloc_set_destructor(ltdb, ltdb_destructor); ldb->modules = talloc(ldb, struct ldb_module); if (!ldb->modules) { ldb_oom(ldb); talloc_free(ltdb); return -1; } ldb->modules->ldb = ldb; ldb->modules->prev = ldb->modules->next = NULL; ldb->modules->private_data = ltdb; ldb->modules->ops = <db_ops; return 0; }