s4-dsdb/prefixMap: Add prefixMap shallow copy function
[Samba.git] / source4 / dsdb / schema / schema_prefixmap.c
blobf900f40a904c3b988c13a28293645a98f3d08bb1
1 /*
2 Unix SMB/CIFS implementation.
4 DRS::prefixMap implementation
6 Copyright (C) Kamen Mazdrashki <kamen.mazdrashki@postpath.com> 2009
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
22 #include "includes.h"
23 #include "dsdb/samdb/samdb.h"
24 #include "librpc/gen_ndr/ndr_drsuapi.h"
25 #include "librpc/gen_ndr/ndr_drsblobs.h"
26 #include "../lib/util/asn1.h"
29 /**
30 * Determine range type for supplied ATTID
32 enum dsdb_attid_type dsdb_pfm_get_attid_type(uint32_t attid)
34 if (attid <= 0x7FFFFFFF) {
35 return DSDB_ATTID_TYPE_PFM;
37 else if (attid <= 0xBFFFFFFF) {
38 return DSDB_ATTID_TYPE_INTID;
40 else if (attid <= 0xFFFEFFFF) {
41 return DSDB_ATTID_TYPE_RESERVED;
43 else {
44 return DSDB_ATTID_TYPE_INTERNAL;
48 /**
49 * Allocates schema_prefixMap object in supplied memory context
51 static struct dsdb_schema_prefixmap *_dsdb_schema_prefixmap_talloc(TALLOC_CTX *mem_ctx,
52 uint32_t length)
54 struct dsdb_schema_prefixmap *pfm;
56 pfm = talloc_zero(mem_ctx, struct dsdb_schema_prefixmap);
57 if (!pfm) {
58 return NULL;
61 pfm->length = length;
62 pfm->prefixes = talloc_zero_array(pfm, struct dsdb_schema_prefixmap_oid,
63 pfm->length);
64 if (!pfm->prefixes) {
65 talloc_free(pfm);
66 return NULL;
69 return pfm;
72 /**
73 * Initial prefixMap creation according to:
74 * [MS-DRSR] section 5.12.2
76 WERROR dsdb_schema_pfm_new(TALLOC_CTX *mem_ctx, struct dsdb_schema_prefixmap **_pfm)
78 uint32_t i;
79 struct dsdb_schema_prefixmap *pfm;
80 const struct {
81 uint32_t id;
82 const char *oid_prefix;
83 } pfm_init_data[] = {
84 {.id=0x00000000, .oid_prefix="2.5.4"},
85 {.id=0x00000001, .oid_prefix="2.5.6"},
86 {.id=0x00000002, .oid_prefix="1.2.840.113556.1.2"},
87 {.id=0x00000003, .oid_prefix="1.2.840.113556.1.3"},
88 {.id=0x00000004, .oid_prefix="2.16.840.1.101.2.2.1"},
89 {.id=0x00000005, .oid_prefix="2.16.840.1.101.2.2.3"},
90 {.id=0x00000006, .oid_prefix="2.16.840.1.101.2.1.5"},
91 {.id=0x00000007, .oid_prefix="2.16.840.1.101.2.1.4"},
92 {.id=0x00000008, .oid_prefix="2.5.5"},
93 {.id=0x00000009, .oid_prefix="1.2.840.113556.1.4"},
94 {.id=0x0000000A, .oid_prefix="1.2.840.113556.1.5"},
95 {.id=0x00000013, .oid_prefix="0.9.2342.19200300.100"},
96 {.id=0x00000014, .oid_prefix="2.16.840.1.113730.3"},
97 {.id=0x00000015, .oid_prefix="0.9.2342.19200300.100.1"},
98 {.id=0x00000016, .oid_prefix="2.16.840.1.113730.3.1"},
99 {.id=0x00000017, .oid_prefix="1.2.840.113556.1.5.7000"},
100 {.id=0x00000018, .oid_prefix="2.5.21"},
101 {.id=0x00000019, .oid_prefix="2.5.18"},
102 {.id=0x0000001A, .oid_prefix="2.5.20"},
105 /* allocate mem for prefix map */
106 pfm = _dsdb_schema_prefixmap_talloc(mem_ctx, ARRAY_SIZE(pfm_init_data));
107 W_ERROR_HAVE_NO_MEMORY(pfm);
109 /* build prefixes */
110 for (i = 0; i < pfm->length; i++) {
111 if (!ber_write_partial_OID_String(pfm, &pfm->prefixes[i].bin_oid, pfm_init_data[i].oid_prefix)) {
112 talloc_free(pfm);
113 return WERR_INTERNAL_ERROR;
115 pfm->prefixes[i].id = pfm_init_data[i].id;
118 *_pfm = pfm;
120 return WERR_OK;
124 struct dsdb_schema_prefixmap *dsdb_schema_pfm_copy_shallow(TALLOC_CTX *mem_ctx,
125 const struct dsdb_schema_prefixmap *pfm)
127 uint32_t i;
128 struct dsdb_schema_prefixmap *pfm_copy;
130 pfm_copy = _dsdb_schema_prefixmap_talloc(mem_ctx, pfm->length);
131 if (!pfm_copy) {
132 return NULL;
134 for (i = 0; i < pfm_copy->length; i++) {
135 pfm_copy->prefixes[i] = pfm->prefixes[i];
138 return pfm_copy;
142 * Adds oid to prefix map.
143 * On success returns ID for newly added index
144 * or ID of existing entry that matches oid
145 * Reference: [MS-DRSR] section 5.12.2
147 * \param pfm prefixMap
148 * \param bin_oid OID prefix to be added to prefixMap
149 * \param pfm_id Location where to store prefixMap entry ID
151 static WERROR _dsdb_schema_pfm_add_entry(struct dsdb_schema_prefixmap *pfm, DATA_BLOB bin_oid, uint32_t *_idx)
153 uint32_t i;
154 struct dsdb_schema_prefixmap_oid * pfm_entry;
155 struct dsdb_schema_prefixmap_oid * prefixes_new;
157 /* dup memory for bin-oid prefix to be added */
158 bin_oid = data_blob_dup_talloc(pfm, &bin_oid);
159 W_ERROR_HAVE_NO_MEMORY(bin_oid.data);
161 /* make room for new entry */
162 prefixes_new = talloc_realloc(pfm, pfm->prefixes, struct dsdb_schema_prefixmap_oid, pfm->length + 1);
163 if (!prefixes_new) {
164 talloc_free(bin_oid.data);
165 return WERR_NOMEM;
167 pfm->prefixes = prefixes_new;
169 /* make new unique ID in prefixMap */
170 pfm_entry = &pfm->prefixes[pfm->length];
171 pfm_entry->id = 0;
172 for (i = 0; i < pfm->length; i++) {
173 if (pfm_entry->id < pfm->prefixes[i].id)
174 pfm_entry->id = pfm->prefixes[i].id;
177 /* add new bin-oid prefix */
178 pfm_entry->id++;
179 pfm_entry->bin_oid = bin_oid;
181 *_idx = pfm->length;
182 pfm->length++;
184 return WERR_OK;
189 * Make partial binary OID for supplied OID.
190 * Reference: [MS-DRSR] section 5.12.2
192 static WERROR _dsdb_pfm_make_binary_oid(const char *full_oid, TALLOC_CTX *mem_ctx,
193 DATA_BLOB *_bin_oid, uint32_t *_last_subid)
195 uint32_t last_subid;
196 const char *oid_subid;
198 /* make last sub-identifier value */
199 oid_subid = strrchr(full_oid, '.');
200 if (!oid_subid) {
201 return WERR_INVALID_PARAMETER;
203 oid_subid++;
204 last_subid = strtoul(oid_subid, NULL, 10);
206 /* encode oid in BER format */
207 if (!ber_write_OID_String(mem_ctx, _bin_oid, full_oid)) {
208 DEBUG(0,("ber_write_OID_String() failed for %s\n", full_oid));
209 return WERR_INTERNAL_ERROR;
212 /* get the prefix of the OID */
213 if (last_subid < 128) {
214 _bin_oid->length -= 1;
215 } else {
216 _bin_oid->length -= 2;
219 /* return last_value if requested */
220 if (_last_subid) {
221 *_last_subid = last_subid;
224 return WERR_OK;
228 * Lookup partial-binary-oid in prefixMap
230 WERROR dsdb_schema_pfm_find_binary_oid(const struct dsdb_schema_prefixmap *pfm,
231 DATA_BLOB bin_oid,
232 uint32_t *_idx)
234 uint32_t i;
236 for (i = 0; i < pfm->length; i++) {
237 if (pfm->prefixes[i].bin_oid.length != bin_oid.length) {
238 continue;
241 if (memcmp(pfm->prefixes[i].bin_oid.data, bin_oid.data, bin_oid.length) == 0) {
242 if (_idx) {
243 *_idx = i;
245 return WERR_OK;
249 return WERR_NOT_FOUND;
253 * Lookup full-oid in prefixMap
254 * Note: this may be slow.
256 WERROR dsdb_schema_pfm_find_oid(const struct dsdb_schema_prefixmap *pfm,
257 const char *full_oid,
258 uint32_t *_idx)
260 WERROR werr;
261 DATA_BLOB bin_oid;
263 ZERO_STRUCT(bin_oid);
265 /* make partial-binary-oid to look for */
266 werr = _dsdb_pfm_make_binary_oid(full_oid, NULL, &bin_oid, NULL);
267 W_ERROR_NOT_OK_RETURN(werr);
269 /* lookup the partial-oid */
270 werr = dsdb_schema_pfm_find_binary_oid(pfm, bin_oid, _idx);
272 data_blob_free(&bin_oid);
274 return werr;
278 * Make ATTID for given OID
279 * If OID is not in prefixMap, new prefix
280 * may be added depending on 'can_change_pfm' flag
281 * Reference: [MS-DRSR] section 5.12.2
283 static WERROR dsdb_schema_pfm_make_attid_impl(struct dsdb_schema_prefixmap *pfm,
284 const char *oid,
285 bool can_change_pfm,
286 uint32_t *attid)
288 WERROR werr;
289 uint32_t idx;
290 uint32_t lo_word, hi_word;
291 uint32_t last_subid;
292 DATA_BLOB bin_oid;
294 if (!pfm) {
295 return WERR_INVALID_PARAMETER;
297 if (!oid) {
298 return WERR_INVALID_PARAMETER;
301 werr = _dsdb_pfm_make_binary_oid(oid, pfm, &bin_oid, &last_subid);
302 W_ERROR_NOT_OK_RETURN(werr);
304 /* search the prefix in the prefix table, if none found, add
305 * one entry for new prefix.
307 werr = dsdb_schema_pfm_find_binary_oid(pfm, bin_oid, &idx);
308 if (W_ERROR_IS_OK(werr)) {
309 /* free memory allocated for bin_oid */
310 data_blob_free(&bin_oid);
311 } else {
312 /* return error in read-only mode */
313 if (!can_change_pfm) {
314 return werr;
317 /* entry does not exists, add it */
318 werr = _dsdb_schema_pfm_add_entry(pfm, bin_oid, &idx);
319 W_ERROR_NOT_OK_RETURN(werr);
322 /* compose the attid */
323 lo_word = last_subid % 16384; /* actually get lower 14 bits: lo_word & 0x3FFF */
324 if (last_subid >= 16384) {
325 /* mark it so that it is known to not be the whole lastValue
326 * This will raise 16-th bit*/
327 lo_word += 32768;
329 hi_word = pfm->prefixes[idx].id;
331 /* make ATTID:
332 * HIWORD is prefixMap id
333 * LOWORD is truncated binary-oid */
334 *attid = (hi_word * 65536) + lo_word;
336 return WERR_OK;
340 * Make ATTID for given OID
341 * Reference: [MS-DRSR] section 5.12.2
343 * Note: This function may change prefixMap if prefix
344 * for supplied 'oid' doesn't exists yet.
345 * It is recommended to be used mostly when caller
346 * want to add new prefixes.
347 * Otherwise dsdb_schema_pfm_attid_from_oid() should be used.
349 WERROR dsdb_schema_pfm_make_attid(struct dsdb_schema_prefixmap *pfm,
350 const char *oid,
351 uint32_t *attid)
353 return dsdb_schema_pfm_make_attid_impl(pfm, oid, true, attid);
357 * Make ATTID for given OID
358 * Reference: [MS-DRSR] section 5.12.2
360 WERROR dsdb_schema_pfm_attid_from_oid(struct dsdb_schema_prefixmap *pfm,
361 const char *oid,
362 uint32_t *attid)
364 return dsdb_schema_pfm_make_attid_impl(pfm, oid, false, attid);
368 * Make OID for given ATTID.
369 * Reference: [MS-DRSR] section 5.12.2
371 WERROR dsdb_schema_pfm_oid_from_attid(const struct dsdb_schema_prefixmap *pfm,
372 uint32_t attid,
373 TALLOC_CTX *mem_ctx, const char **_oid)
375 uint32_t i;
376 uint32_t hi_word, lo_word;
377 DATA_BLOB bin_oid = {NULL, 0};
378 struct dsdb_schema_prefixmap_oid *pfm_entry;
379 WERROR werr = WERR_OK;
381 /* sanity check for attid requested */
382 if (dsdb_pfm_get_attid_type(attid) != DSDB_ATTID_TYPE_PFM) {
383 return WERR_INVALID_PARAMETER;
386 /* crack attid value */
387 hi_word = attid >> 16;
388 lo_word = attid & 0xFFFF;
390 /* locate corRespoNding prefixMap entry */
391 pfm_entry = NULL;
392 for (i = 0; i < pfm->length; i++) {
393 if (hi_word == pfm->prefixes[i].id) {
394 pfm_entry = &pfm->prefixes[i];
395 break;
399 if (!pfm_entry) {
400 DEBUG(1,("Failed to find prefixMap entry for ATTID = 0x%08X (%d)\n",
401 attid, attid));
402 return WERR_DS_NO_ATTRIBUTE_OR_VALUE;
405 /* copy oid prefix making enough room */
406 bin_oid.length = pfm_entry->bin_oid.length + 2;
407 bin_oid.data = talloc_array(mem_ctx, uint8_t, bin_oid.length);
408 W_ERROR_HAVE_NO_MEMORY(bin_oid.data);
409 memcpy(bin_oid.data, pfm_entry->bin_oid.data, pfm_entry->bin_oid.length);
411 if (lo_word < 128) {
412 bin_oid.length = bin_oid.length - 1;
413 bin_oid.data[bin_oid.length-1] = lo_word;
415 else {
416 if (lo_word >= 32768) {
417 lo_word -= 32768;
419 bin_oid.data[bin_oid.length-2] = (0x80 | ((lo_word>>7) & 0x7f));
420 bin_oid.data[bin_oid.length-1] = lo_word & 0x7f;
423 if (!ber_read_OID_String(mem_ctx, bin_oid, _oid)) {
424 DEBUG(0,("ber_read_OID_String() failed for %s\n",
425 hex_encode_talloc(bin_oid.data, bin_oid.data, bin_oid.length)));
426 werr = WERR_INTERNAL_ERROR;
429 /* free locally allocated memory */
430 talloc_free(bin_oid.data);
432 return werr;
437 * Verifies drsuapi mappings.
439 static WERROR _dsdb_drsuapi_pfm_verify(const struct drsuapi_DsReplicaOIDMapping_Ctr *ctr,
440 bool have_schema_info)
442 uint32_t i;
443 uint32_t num_mappings;
444 struct drsuapi_DsReplicaOIDMapping *mapping;
446 /* check input params */
447 if (!ctr) {
448 return WERR_INVALID_PARAMETER;
450 if (!ctr->mappings) {
451 return WERR_INVALID_PARAMETER;
453 num_mappings = ctr->num_mappings;
455 if (have_schema_info) {
456 DATA_BLOB blob;
458 if (ctr->num_mappings < 2) {
459 return WERR_INVALID_PARAMETER;
462 /* check last entry for being special */
463 mapping = &ctr->mappings[ctr->num_mappings - 1];
464 if (mapping->id_prefix != 0) {
465 return WERR_INVALID_PARAMETER;
468 /* verify schemaInfo blob is valid one */
469 blob = data_blob_const(mapping->oid.binary_oid, mapping->oid.length);
470 if (!dsdb_schema_info_blob_is_valid(&blob)) {
471 return WERR_INVALID_PARAMETER;
474 /* get number of read mappings in the map */
475 num_mappings--;
478 /* now, verify rest of entries for being at least not null */
479 for (i = 0; i < num_mappings; i++) {
480 mapping = &ctr->mappings[i];
481 if (!mapping->oid.length) {
482 return WERR_INVALID_PARAMETER;
484 if (!mapping->oid.binary_oid) {
485 return WERR_INVALID_PARAMETER;
487 /* check it is not the special entry */
488 if (*mapping->oid.binary_oid == 0xFF) {
489 return WERR_INVALID_PARAMETER;
493 return WERR_OK;
497 * Convert drsuapi_ prefix map to prefixMap internal presentation.
499 * \param ctr Pointer to drsuapi_DsReplicaOIDMapping_Ctr which represents drsuapi_ prefixMap
500 * \param have_schema_info if drsuapi_prefixMap have schem_info in it or not
501 * \param mem_ctx TALLOC_CTX to make allocations in
502 * \param _pfm Out pointer to hold newly created prefixMap
503 * \param _schema_info Out param to store schema_info to. If NULL, schema_info is not decoded
505 WERROR dsdb_schema_pfm_from_drsuapi_pfm(const struct drsuapi_DsReplicaOIDMapping_Ctr *ctr,
506 bool have_schema_info,
507 TALLOC_CTX *mem_ctx,
508 struct dsdb_schema_prefixmap **_pfm,
509 const char **_schema_info)
511 WERROR werr;
512 uint32_t i;
513 DATA_BLOB blob;
514 uint32_t num_mappings;
515 struct dsdb_schema_prefixmap *pfm;
517 if (!_pfm) {
518 return WERR_INVALID_PARAMETER;
522 * error out if schema_info is requested
523 * but it is not in the drsuapi_prefixMap
525 if (_schema_info && !have_schema_info) {
526 return WERR_INVALID_PARAMETER;
529 /* verify drsuapi_pefixMap */
530 werr =_dsdb_drsuapi_pfm_verify(ctr, have_schema_info);
531 W_ERROR_NOT_OK_RETURN(werr);
533 /* allocate mem for prefix map */
534 num_mappings = ctr->num_mappings;
535 if (have_schema_info) {
536 num_mappings--;
538 pfm = _dsdb_schema_prefixmap_talloc(mem_ctx, num_mappings);
539 W_ERROR_HAVE_NO_MEMORY(pfm);
541 /* copy entries from drsuapi_prefixMap */
542 for (i = 0; i < pfm->length; i++) {
543 blob = data_blob_talloc(pfm,
544 ctr->mappings[i].oid.binary_oid,
545 ctr->mappings[i].oid.length);
546 if (!blob.data) {
547 talloc_free(pfm);
548 return WERR_NOMEM;
550 pfm->prefixes[i].id = ctr->mappings[i].id_prefix;
551 pfm->prefixes[i].bin_oid = blob;
554 /* fetch schema_info if requested */
555 if (_schema_info) {
556 /* by this time, i should have this value,
557 * but set it here for clarity */
558 i = ctr->num_mappings - 1;
560 *_schema_info = hex_encode_talloc(mem_ctx,
561 ctr->mappings[i].oid.binary_oid,
562 ctr->mappings[i].oid.length);
563 if (!*_schema_info) {
564 talloc_free(pfm);
565 return WERR_NOMEM;
569 /* schema_prefixMap created successfully */
570 *_pfm = pfm;
572 return WERR_OK;
576 * Convert drsuapi_ prefix map to prefixMap internal presentation.
578 * \param pfm Schema prefixMap to be converted
579 * \param schema_info schema_info string - if NULL, we don't need it
580 * \param mem_ctx TALLOC_CTX to make allocations in
581 * \param _ctr Out pointer to drsuapi_DsReplicaOIDMapping_Ctr prefix map structure
583 WERROR dsdb_drsuapi_pfm_from_schema_pfm(const struct dsdb_schema_prefixmap *pfm,
584 const char *schema_info,
585 TALLOC_CTX *mem_ctx,
586 struct drsuapi_DsReplicaOIDMapping_Ctr **_ctr)
588 uint32_t i;
589 DATA_BLOB blob;
590 struct drsuapi_DsReplicaOIDMapping_Ctr *ctr;
592 if (!_ctr) {
593 return WERR_INVALID_PARAMETER;
595 if (!pfm) {
596 return WERR_INVALID_PARAMETER;
598 if (pfm->length == 0) {
599 return WERR_INVALID_PARAMETER;
602 /* allocate memory for the structure */
603 ctr = talloc_zero(mem_ctx, struct drsuapi_DsReplicaOIDMapping_Ctr);
604 W_ERROR_HAVE_NO_MEMORY(ctr);
606 ctr->num_mappings = (schema_info ? pfm->length + 1 : pfm->length);
607 ctr->mappings = talloc_array(ctr, struct drsuapi_DsReplicaOIDMapping, ctr->num_mappings);
608 if (!ctr->mappings) {
609 talloc_free(ctr);
610 return WERR_NOMEM;
613 /* copy entries from schema_prefixMap */
614 for (i = 0; i < pfm->length; i++) {
615 blob = data_blob_dup_talloc(ctr, &pfm->prefixes[i].bin_oid);
616 if (!blob.data) {
617 talloc_free(ctr);
618 return WERR_NOMEM;
620 ctr->mappings[i].id_prefix = pfm->prefixes[i].id;
621 ctr->mappings[i].oid.length = blob.length;
622 ctr->mappings[i].oid.binary_oid = blob.data;
625 /* make schema_info entry if needed */
626 if (schema_info) {
627 /* by this time, i should have this value,
628 * but set it here for clarity */
629 i = ctr->num_mappings - 1;
631 blob = strhex_to_data_blob(ctr, schema_info);
632 if (!blob.data) {
633 talloc_free(ctr);
634 return WERR_NOMEM;
637 ctr->mappings[i].id_prefix = 0;
638 ctr->mappings[i].oid.length = blob.length;
639 ctr->mappings[i].oid.binary_oid = blob.data;
642 /* drsuapi_prefixMap constructed successfully */
643 *_ctr = ctr;
645 return WERR_OK;
649 * Verifies schema prefixMap and drsuapi prefixMap are same.
650 * Note that we just need to verify pfm contains prefixes
651 * from ctr, not that those prefixes has same id_prefix.
653 WERROR dsdb_schema_pfm_contains_drsuapi_pfm(const struct dsdb_schema_prefixmap *pfm,
654 const struct drsuapi_DsReplicaOIDMapping_Ctr *ctr)
656 WERROR werr;
657 uint32_t i;
658 uint32_t idx;
659 DATA_BLOB bin_oid;
661 /* verify drsuapi_pefixMap */
662 werr = _dsdb_drsuapi_pfm_verify(ctr, true);
663 W_ERROR_NOT_OK_RETURN(werr);
665 /* check pfm contains every entry from ctr, except the last one */
666 for (i = 0; i < ctr->num_mappings - 1; i++) {
667 bin_oid.length = ctr->mappings[i].oid.length;
668 bin_oid.data = ctr->mappings[i].oid.binary_oid;
670 werr = dsdb_schema_pfm_find_binary_oid(pfm, bin_oid, &idx);
671 if (!W_ERROR_IS_OK(werr)) {
672 return WERR_DS_DRA_SCHEMA_MISMATCH;
676 return WERR_OK;