2 Unix SMB/CIFS mplementation.
4 The module that handles the Schema FSMO Role Owner
5 checkings, it also loads the dsdb_schema.
7 Copyright (C) Stefan Metzmacher <metze@samba.org> 2007
8 Copyright (C) Andrew Bartlett <abartlet@samba.org> 2009-2010
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
26 #include "ldb_module.h"
27 #include "dsdb/samdb/samdb.h"
28 #include "librpc/gen_ndr/ndr_misc.h"
29 #include "librpc/gen_ndr/ndr_drsuapi.h"
30 #include "librpc/gen_ndr/ndr_drsblobs.h"
31 #include "param/param.h"
32 #include "dsdb/samdb/ldb_modules/util.h"
34 struct schema_load_private_data {
38 static int dsdb_schema_from_db(struct ldb_module *module, struct ldb_dn *schema_dn, uint64_t current_usn,
39 struct dsdb_schema **schema);
41 struct dsdb_schema *dsdb_schema_refresh(struct ldb_module *module, struct dsdb_schema *schema, bool is_global_schema)
45 struct ldb_result *res;
46 struct ldb_request *treq;
47 struct ldb_seqnum_request *tseq;
48 struct ldb_seqnum_result *tseqr;
49 struct dsdb_control_current_partition *ctrl;
50 struct ldb_context *ldb = ldb_module_get_ctx(module);
51 struct dsdb_schema *new_schema;
53 struct schema_load_private_data *private_data = talloc_get_type(ldb_module_get_private(module), struct schema_load_private_data);
55 /* We can't refresh until the init function has run */
59 /* We don't allow a schema reload during a transaction - nobody else can modify our schema behind our backs */
60 if (private_data->in_transaction) {
64 res = talloc_zero(schema, struct ldb_result);
68 tseq = talloc_zero(res, struct ldb_seqnum_request);
73 tseq->type = LDB_SEQ_HIGHEST_SEQ;
75 ret = ldb_build_extended_req(&treq, ldb_module_get_ctx(module), res,
76 LDB_EXTENDED_SEQUENCE_NUMBER,
80 ldb_extended_default_callback,
82 LDB_REQ_SET_LOCATION(treq);
83 if (ret != LDB_SUCCESS) {
88 ctrl = talloc(treq, struct dsdb_control_current_partition);
93 ctrl->version = DSDB_CONTROL_CURRENT_PARTITION_VERSION;
94 ctrl->dn = schema->base_dn;
96 ret = ldb_request_add_control(treq,
97 DSDB_CONTROL_CURRENT_PARTITION_OID,
99 if (ret != LDB_SUCCESS) {
104 ret = ldb_next_request(module, treq);
105 if (ret != LDB_SUCCESS) {
109 ret = ldb_wait(treq->handle, LDB_WAIT_ALL);
110 if (ret != LDB_SUCCESS) {
114 tseqr = talloc_get_type(res->extended->data,
115 struct ldb_seqnum_result);
116 if (tseqr->seq_num == schema->reload_seq_number) {
121 schema->reload_seq_number = tseqr->seq_num;
124 ret = dsdb_module_load_partition_usn(module, schema->base_dn, ¤t_usn, NULL);
125 if (ret != LDB_SUCCESS || current_usn == schema->loaded_usn) {
129 ret = dsdb_schema_from_db(module, schema->base_dn, current_usn, &new_schema);
130 if (ret != LDB_SUCCESS) {
134 if (is_global_schema) {
135 dsdb_make_schema_global(ldb, new_schema);
142 Given an LDB module (pointing at the schema DB), and the DN, set the populated schema
145 static int dsdb_schema_from_db(struct ldb_module *module, struct ldb_dn *schema_dn, uint64_t current_usn,
146 struct dsdb_schema **schema)
148 struct ldb_context *ldb = ldb_module_get_ctx(module);
152 struct ldb_result *schema_res;
153 struct ldb_result *a_res;
154 struct ldb_result *c_res;
155 static const char *schema_attrs[] = {
163 tmp_ctx = talloc_new(module);
168 /* we don't want to trace the schema load */
169 flags = ldb_get_flags(ldb);
170 ldb_set_flags(ldb, flags & ~LDB_FLG_ENABLE_TRACING);
173 * setup the prefix mappings and schema info
175 ret = dsdb_module_search_dn(module, tmp_ctx, &schema_res,
176 schema_dn, schema_attrs,
177 DSDB_FLAG_NEXT_MODULE);
178 if (ret == LDB_ERR_NO_SUCH_OBJECT) {
179 ldb_reset_err_string(ldb);
180 ldb_debug(ldb, LDB_DEBUG_WARNING,
181 "schema_load_init: no schema head present: (skip schema loading)\n");
183 } else if (ret != LDB_SUCCESS) {
184 ldb_asprintf_errstring(ldb,
185 "dsdb_schema: failed to search the schema head: %s",
191 * load the attribute definitions
193 ret = dsdb_module_search(module, tmp_ctx, &a_res,
194 schema_dn, LDB_SCOPE_ONELEVEL, NULL,
195 DSDB_FLAG_NEXT_MODULE,
196 "(objectClass=attributeSchema)");
197 if (ret != LDB_SUCCESS) {
198 ldb_asprintf_errstring(ldb,
199 "dsdb_schema: failed to search attributeSchema objects: %s",
205 * load the objectClass definitions
207 ret = dsdb_module_search(module, tmp_ctx, &c_res,
208 schema_dn, LDB_SCOPE_ONELEVEL, NULL,
209 DSDB_FLAG_NEXT_MODULE |
210 DSDB_SEARCH_SHOW_DN_IN_STORAGE_FORMAT,
211 "(objectClass=classSchema)");
212 if (ret != LDB_SUCCESS) {
213 ldb_asprintf_errstring(ldb,
214 "dsdb_schema: failed to search classSchema objects: %s",
219 ret = dsdb_schema_from_ldb_results(tmp_ctx, ldb,
220 schema_res, a_res, c_res, schema, &error_string);
221 if (ret != LDB_SUCCESS) {
222 ldb_asprintf_errstring(ldb,
223 "dsdb_schema load failed: %s",
228 (*schema)->refresh_in_progress = true;
230 /* If we have the readOnlySchema opaque, then don't check for
231 * runtime schema updates, as they are not permitted (we would
232 * have to update the backend server schema too */
233 if (!ldb_get_opaque(ldb, "readOnlySchema")) {
234 (*schema)->refresh_fn = dsdb_schema_refresh;
235 (*schema)->loaded_from_module = module;
236 (*schema)->loaded_usn = current_usn;
239 /* "dsdb_set_schema()" steals schema into the ldb_context */
240 ret = dsdb_set_schema(ldb, (*schema));
242 (*schema)->refresh_in_progress = false;
244 if (ret != LDB_SUCCESS) {
245 ldb_debug_set(ldb, LDB_DEBUG_FATAL,
246 "schema_load_init: dsdb_set_schema() failed: %d:%s: %s",
247 ret, ldb_strerror(ret), ldb_errstring(ldb));
251 /* Ensure this module won't go away before the callback */
252 if (talloc_reference(*schema, ldb) == NULL) {
254 ret = LDB_ERR_OPERATIONS_ERROR;
258 if (flags & LDB_FLG_ENABLE_TRACING) {
259 flags = ldb_get_flags(ldb);
260 ldb_set_flags(ldb, flags | LDB_FLG_ENABLE_TRACING);
262 talloc_free(tmp_ctx);
267 static int schema_load_init(struct ldb_module *module)
269 struct schema_load_private_data *private_data;
270 struct dsdb_schema *schema;
271 struct ldb_context *ldb = ldb_module_get_ctx(module);
273 uint64_t current_usn;
274 struct ldb_dn *schema_dn;
276 private_data = talloc_zero(module, struct schema_load_private_data);
277 if (private_data == NULL) {
281 ldb_module_set_private(module, private_data);
283 ret = ldb_next_init(module);
284 if (ret != LDB_SUCCESS) {
288 if (dsdb_get_schema(ldb, NULL)) {
292 schema_dn = ldb_get_schema_basedn(ldb);
294 ldb_reset_err_string(ldb);
295 ldb_debug(ldb, LDB_DEBUG_WARNING,
296 "schema_load_init: no schema dn present: (skip schema loading)\n");
300 ret = dsdb_module_load_partition_usn(module, schema_dn, ¤t_usn, NULL);
301 if (ret != LDB_SUCCESS) {
302 /* Ignore the error and just reload the DB more often */
306 return dsdb_schema_from_db(module, schema_dn, current_usn, &schema);
309 static int schema_load_start_transaction(struct ldb_module *module)
311 struct schema_load_private_data *private_data =
312 talloc_get_type(ldb_module_get_private(module), struct schema_load_private_data);
314 private_data->in_transaction = true;
316 return ldb_next_start_trans(module);
319 static int schema_load_end_transaction(struct ldb_module *module)
321 struct schema_load_private_data *private_data =
322 talloc_get_type(ldb_module_get_private(module), struct schema_load_private_data);
324 private_data->in_transaction = false;
326 return ldb_next_end_trans(module);
329 static int schema_load_del_transaction(struct ldb_module *module)
331 struct schema_load_private_data *private_data =
332 talloc_get_type(ldb_module_get_private(module), struct schema_load_private_data);
334 private_data->in_transaction = false;
336 return ldb_next_del_trans(module);
339 static int schema_load_extended(struct ldb_module *module, struct ldb_request *req)
341 struct ldb_context *ldb;
343 ldb = ldb_module_get_ctx(module);
345 if (strcmp(req->op.extended.oid, DSDB_EXTENDED_SCHEMA_UPDATE_NOW_OID) != 0) {
346 return ldb_next_request(module, req);
349 /* This is a no-op. We reload as soon as we can */
350 return ldb_module_done(req, NULL, NULL, LDB_SUCCESS);
354 static const struct ldb_module_ops ldb_schema_load_module_ops = {
355 .name = "schema_load",
356 .init_context = schema_load_init,
357 .extended = schema_load_extended,
358 .start_transaction = schema_load_start_transaction,
359 .end_transaction = schema_load_end_transaction,
360 .del_transaction = schema_load_del_transaction,
363 int ldb_schema_load_module_init(const char *version)
365 LDB_MODULE_CHECK_VERSION(version);
366 return ldb_register_module(&ldb_schema_load_module_ops);