s4-prefixMap: dsdb_schema_pfm_oid_from_attid() to use const prefixMap
[Samba.git] / source4 / dsdb / schema / schema_prefixmap.c
blob18b22ffdcd5097cb09554c93a97ee615d242d914
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;
125 * Adds oid to prefix map.
126 * On success returns ID for newly added index
127 * or ID of existing entry that matches oid
128 * Reference: [MS-DRSR] section 5.12.2
130 * \param pfm prefixMap
131 * \param bin_oid OID prefix to be added to prefixMap
132 * \param pfm_id Location where to store prefixMap entry ID
134 static WERROR _dsdb_schema_pfm_add_entry(struct dsdb_schema_prefixmap *pfm, DATA_BLOB bin_oid, uint32_t *_idx)
136 uint32_t i;
137 struct dsdb_schema_prefixmap_oid * pfm_entry;
138 struct dsdb_schema_prefixmap_oid * prefixes_new;
140 /* dup memory for bin-oid prefix to be added */
141 bin_oid = data_blob_dup_talloc(pfm, &bin_oid);
142 W_ERROR_HAVE_NO_MEMORY(bin_oid.data);
144 /* make room for new entry */
145 prefixes_new = talloc_realloc(pfm, pfm->prefixes, struct dsdb_schema_prefixmap_oid, pfm->length + 1);
146 if (!prefixes_new) {
147 talloc_free(bin_oid.data);
148 return WERR_NOMEM;
150 pfm->prefixes = prefixes_new;
152 /* make new unique ID in prefixMap */
153 pfm_entry = &pfm->prefixes[pfm->length];
154 pfm_entry->id = 0;
155 for (i = 0; i < pfm->length; i++) {
156 if (pfm_entry->id < pfm->prefixes[i].id)
157 pfm_entry->id = pfm->prefixes[i].id;
160 /* add new bin-oid prefix */
161 pfm_entry->id++;
162 pfm_entry->bin_oid = bin_oid;
164 *_idx = pfm->length;
165 pfm->length++;
167 return WERR_OK;
172 * Make partial binary OID for supplied OID.
173 * Reference: [MS-DRSR] section 5.12.2
175 static WERROR _dsdb_pfm_make_binary_oid(const char *full_oid, TALLOC_CTX *mem_ctx,
176 DATA_BLOB *_bin_oid, uint32_t *_last_subid)
178 uint32_t last_subid;
179 const char *oid_subid;
181 /* make last sub-identifier value */
182 oid_subid = strrchr(full_oid, '.');
183 if (!oid_subid) {
184 return WERR_INVALID_PARAMETER;
186 oid_subid++;
187 last_subid = strtoul(oid_subid, NULL, 10);
189 /* encode oid in BER format */
190 if (!ber_write_OID_String(mem_ctx, _bin_oid, full_oid)) {
191 DEBUG(0,("ber_write_OID_String() failed for %s\n", full_oid));
192 return WERR_INTERNAL_ERROR;
195 /* get the prefix of the OID */
196 if (last_subid < 128) {
197 _bin_oid->length -= 1;
198 } else {
199 _bin_oid->length -= 2;
202 /* return last_value if requested */
203 if (_last_subid) {
204 *_last_subid = last_subid;
207 return WERR_OK;
211 * Lookup partial-binary-oid in prefixMap
213 WERROR dsdb_schema_pfm_find_binary_oid(const struct dsdb_schema_prefixmap *pfm,
214 DATA_BLOB bin_oid,
215 uint32_t *_idx)
217 uint32_t i;
219 for (i = 0; i < pfm->length; i++) {
220 if (pfm->prefixes[i].bin_oid.length != bin_oid.length) {
221 continue;
224 if (memcmp(pfm->prefixes[i].bin_oid.data, bin_oid.data, bin_oid.length) == 0) {
225 if (_idx) {
226 *_idx = i;
228 return WERR_OK;
232 return WERR_NOT_FOUND;
236 * Lookup full-oid in prefixMap
237 * Note: this may be slow.
239 WERROR dsdb_schema_pfm_find_oid(const struct dsdb_schema_prefixmap *pfm,
240 const char *full_oid,
241 uint32_t *_idx)
243 WERROR werr;
244 DATA_BLOB bin_oid;
246 ZERO_STRUCT(bin_oid);
248 /* make partial-binary-oid to look for */
249 werr = _dsdb_pfm_make_binary_oid(full_oid, NULL, &bin_oid, NULL);
250 W_ERROR_NOT_OK_RETURN(werr);
252 /* lookup the partial-oid */
253 werr = dsdb_schema_pfm_find_binary_oid(pfm, bin_oid, _idx);
255 data_blob_free(&bin_oid);
257 return werr;
261 * Make ATTID for given OID
262 * If OID is not in prefixMap, new prefix
263 * may be added depending on 'can_change_pfm' flag
264 * Reference: [MS-DRSR] section 5.12.2
266 static WERROR dsdb_schema_pfm_make_attid_impl(struct dsdb_schema_prefixmap *pfm,
267 const char *oid,
268 bool can_change_pfm,
269 uint32_t *attid)
271 WERROR werr;
272 uint32_t idx;
273 uint32_t lo_word, hi_word;
274 uint32_t last_subid;
275 DATA_BLOB bin_oid;
277 if (!pfm) {
278 return WERR_INVALID_PARAMETER;
280 if (!oid) {
281 return WERR_INVALID_PARAMETER;
284 werr = _dsdb_pfm_make_binary_oid(oid, pfm, &bin_oid, &last_subid);
285 W_ERROR_NOT_OK_RETURN(werr);
287 /* search the prefix in the prefix table, if none found, add
288 * one entry for new prefix.
290 werr = dsdb_schema_pfm_find_binary_oid(pfm, bin_oid, &idx);
291 if (W_ERROR_IS_OK(werr)) {
292 /* free memory allocated for bin_oid */
293 data_blob_free(&bin_oid);
294 } else {
295 /* return error in read-only mode */
296 if (!can_change_pfm) {
297 return werr;
300 /* entry does not exists, add it */
301 werr = _dsdb_schema_pfm_add_entry(pfm, bin_oid, &idx);
302 W_ERROR_NOT_OK_RETURN(werr);
305 /* compose the attid */
306 lo_word = last_subid % 16384; /* actually get lower 14 bits: lo_word & 0x3FFF */
307 if (last_subid >= 16384) {
308 /* mark it so that it is known to not be the whole lastValue
309 * This will raise 16-th bit*/
310 lo_word += 32768;
312 hi_word = pfm->prefixes[idx].id;
314 /* make ATTID:
315 * HIWORD is prefixMap id
316 * LOWORD is truncated binary-oid */
317 *attid = (hi_word * 65536) + lo_word;
319 return WERR_OK;
323 * Make ATTID for given OID
324 * Reference: [MS-DRSR] section 5.12.2
326 * Note: This function may change prefixMap if prefix
327 * for supplied 'oid' doesn't exists yet.
328 * It is recommended to be used mostly when caller
329 * want to add new prefixes.
330 * Otherwise dsdb_schema_pfm_attid_from_oid() should be used.
332 WERROR dsdb_schema_pfm_make_attid(struct dsdb_schema_prefixmap *pfm,
333 const char *oid,
334 uint32_t *attid)
336 return dsdb_schema_pfm_make_attid_impl(pfm, oid, true, attid);
340 * Make ATTID for given OID
341 * Reference: [MS-DRSR] section 5.12.2
343 WERROR dsdb_schema_pfm_attid_from_oid(struct dsdb_schema_prefixmap *pfm,
344 const char *oid,
345 uint32_t *attid)
347 return dsdb_schema_pfm_make_attid_impl(pfm, oid, false, attid);
351 * Make OID for given ATTID.
352 * Reference: [MS-DRSR] section 5.12.2
354 WERROR dsdb_schema_pfm_oid_from_attid(const struct dsdb_schema_prefixmap *pfm,
355 uint32_t attid,
356 TALLOC_CTX *mem_ctx, const char **_oid)
358 uint32_t i;
359 uint32_t hi_word, lo_word;
360 DATA_BLOB bin_oid = {NULL, 0};
361 struct dsdb_schema_prefixmap_oid *pfm_entry;
362 WERROR werr = WERR_OK;
364 /* sanity check for attid requested */
365 if (dsdb_pfm_get_attid_type(attid) != DSDB_ATTID_TYPE_PFM) {
366 return WERR_INVALID_PARAMETER;
369 /* crack attid value */
370 hi_word = attid >> 16;
371 lo_word = attid & 0xFFFF;
373 /* locate corRespoNding prefixMap entry */
374 pfm_entry = NULL;
375 for (i = 0; i < pfm->length; i++) {
376 if (hi_word == pfm->prefixes[i].id) {
377 pfm_entry = &pfm->prefixes[i];
378 break;
382 if (!pfm_entry) {
383 DEBUG(1,("Failed to find prefixMap entry for ATTID = 0x%08X (%d)\n",
384 attid, attid));
385 return WERR_DS_NO_ATTRIBUTE_OR_VALUE;
388 /* copy oid prefix making enough room */
389 bin_oid.length = pfm_entry->bin_oid.length + 2;
390 bin_oid.data = talloc_array(mem_ctx, uint8_t, bin_oid.length);
391 W_ERROR_HAVE_NO_MEMORY(bin_oid.data);
392 memcpy(bin_oid.data, pfm_entry->bin_oid.data, pfm_entry->bin_oid.length);
394 if (lo_word < 128) {
395 bin_oid.length = bin_oid.length - 1;
396 bin_oid.data[bin_oid.length-1] = lo_word;
398 else {
399 if (lo_word >= 32768) {
400 lo_word -= 32768;
402 bin_oid.data[bin_oid.length-2] = (0x80 | ((lo_word>>7) & 0x7f));
403 bin_oid.data[bin_oid.length-1] = lo_word & 0x7f;
406 if (!ber_read_OID_String(mem_ctx, bin_oid, _oid)) {
407 DEBUG(0,("ber_read_OID_String() failed for %s\n",
408 hex_encode_talloc(bin_oid.data, bin_oid.data, bin_oid.length)));
409 werr = WERR_INTERNAL_ERROR;
412 /* free locally allocated memory */
413 talloc_free(bin_oid.data);
415 return werr;
420 * Verifies drsuapi mappings.
422 static WERROR _dsdb_drsuapi_pfm_verify(const struct drsuapi_DsReplicaOIDMapping_Ctr *ctr,
423 bool have_schema_info)
425 uint32_t i;
426 uint32_t num_mappings;
427 struct drsuapi_DsReplicaOIDMapping *mapping;
429 /* check input params */
430 if (!ctr) {
431 return WERR_INVALID_PARAMETER;
433 if (!ctr->mappings) {
434 return WERR_INVALID_PARAMETER;
436 num_mappings = ctr->num_mappings;
438 if (have_schema_info) {
439 DATA_BLOB blob;
441 if (ctr->num_mappings < 2) {
442 return WERR_INVALID_PARAMETER;
445 /* check last entry for being special */
446 mapping = &ctr->mappings[ctr->num_mappings - 1];
447 if (mapping->id_prefix != 0) {
448 return WERR_INVALID_PARAMETER;
451 /* verify schemaInfo blob is valid one */
452 blob = data_blob_const(mapping->oid.binary_oid, mapping->oid.length);
453 if (!dsdb_schema_info_blob_is_valid(&blob)) {
454 return WERR_INVALID_PARAMETER;
457 /* get number of read mappings in the map */
458 num_mappings--;
461 /* now, verify rest of entries for being at least not null */
462 for (i = 0; i < num_mappings; i++) {
463 mapping = &ctr->mappings[i];
464 if (!mapping->oid.length) {
465 return WERR_INVALID_PARAMETER;
467 if (!mapping->oid.binary_oid) {
468 return WERR_INVALID_PARAMETER;
470 /* check it is not the special entry */
471 if (*mapping->oid.binary_oid == 0xFF) {
472 return WERR_INVALID_PARAMETER;
476 return WERR_OK;
480 * Convert drsuapi_ prefix map to prefixMap internal presentation.
482 * \param ctr Pointer to drsuapi_DsReplicaOIDMapping_Ctr which represents drsuapi_ prefixMap
483 * \param have_schema_info if drsuapi_prefixMap have schem_info in it or not
484 * \param mem_ctx TALLOC_CTX to make allocations in
485 * \param _pfm Out pointer to hold newly created prefixMap
486 * \param _schema_info Out param to store schema_info to. If NULL, schema_info is not decoded
488 WERROR dsdb_schema_pfm_from_drsuapi_pfm(const struct drsuapi_DsReplicaOIDMapping_Ctr *ctr,
489 bool have_schema_info,
490 TALLOC_CTX *mem_ctx,
491 struct dsdb_schema_prefixmap **_pfm,
492 const char **_schema_info)
494 WERROR werr;
495 uint32_t i;
496 DATA_BLOB blob;
497 uint32_t num_mappings;
498 struct dsdb_schema_prefixmap *pfm;
500 if (!_pfm) {
501 return WERR_INVALID_PARAMETER;
505 * error out if schema_info is requested
506 * but it is not in the drsuapi_prefixMap
508 if (_schema_info && !have_schema_info) {
509 return WERR_INVALID_PARAMETER;
512 /* verify drsuapi_pefixMap */
513 werr =_dsdb_drsuapi_pfm_verify(ctr, have_schema_info);
514 W_ERROR_NOT_OK_RETURN(werr);
516 /* allocate mem for prefix map */
517 num_mappings = ctr->num_mappings;
518 if (have_schema_info) {
519 num_mappings--;
521 pfm = _dsdb_schema_prefixmap_talloc(mem_ctx, num_mappings);
522 W_ERROR_HAVE_NO_MEMORY(pfm);
524 /* copy entries from drsuapi_prefixMap */
525 for (i = 0; i < pfm->length; i++) {
526 blob = data_blob_talloc(pfm,
527 ctr->mappings[i].oid.binary_oid,
528 ctr->mappings[i].oid.length);
529 if (!blob.data) {
530 talloc_free(pfm);
531 return WERR_NOMEM;
533 pfm->prefixes[i].id = ctr->mappings[i].id_prefix;
534 pfm->prefixes[i].bin_oid = blob;
537 /* fetch schema_info if requested */
538 if (_schema_info) {
539 /* by this time, i should have this value,
540 * but set it here for clarity */
541 i = ctr->num_mappings - 1;
543 *_schema_info = hex_encode_talloc(mem_ctx,
544 ctr->mappings[i].oid.binary_oid,
545 ctr->mappings[i].oid.length);
546 if (!*_schema_info) {
547 talloc_free(pfm);
548 return WERR_NOMEM;
552 /* schema_prefixMap created successfully */
553 *_pfm = pfm;
555 return WERR_OK;
559 * Convert drsuapi_ prefix map to prefixMap internal presentation.
561 * \param pfm Schema prefixMap to be converted
562 * \param schema_info schema_info string - if NULL, we don't need it
563 * \param mem_ctx TALLOC_CTX to make allocations in
564 * \param _ctr Out pointer to drsuapi_DsReplicaOIDMapping_Ctr prefix map structure
566 WERROR dsdb_drsuapi_pfm_from_schema_pfm(const struct dsdb_schema_prefixmap *pfm,
567 const char *schema_info,
568 TALLOC_CTX *mem_ctx,
569 struct drsuapi_DsReplicaOIDMapping_Ctr **_ctr)
571 uint32_t i;
572 DATA_BLOB blob;
573 struct drsuapi_DsReplicaOIDMapping_Ctr *ctr;
575 if (!_ctr) {
576 return WERR_INVALID_PARAMETER;
578 if (!pfm) {
579 return WERR_INVALID_PARAMETER;
581 if (pfm->length == 0) {
582 return WERR_INVALID_PARAMETER;
585 /* allocate memory for the structure */
586 ctr = talloc_zero(mem_ctx, struct drsuapi_DsReplicaOIDMapping_Ctr);
587 W_ERROR_HAVE_NO_MEMORY(ctr);
589 ctr->num_mappings = (schema_info ? pfm->length + 1 : pfm->length);
590 ctr->mappings = talloc_array(ctr, struct drsuapi_DsReplicaOIDMapping, ctr->num_mappings);
591 if (!ctr->mappings) {
592 talloc_free(ctr);
593 return WERR_NOMEM;
596 /* copy entries from schema_prefixMap */
597 for (i = 0; i < pfm->length; i++) {
598 blob = data_blob_dup_talloc(ctr, &pfm->prefixes[i].bin_oid);
599 if (!blob.data) {
600 talloc_free(ctr);
601 return WERR_NOMEM;
603 ctr->mappings[i].id_prefix = pfm->prefixes[i].id;
604 ctr->mappings[i].oid.length = blob.length;
605 ctr->mappings[i].oid.binary_oid = blob.data;
608 /* make schema_info entry if needed */
609 if (schema_info) {
610 /* by this time, i should have this value,
611 * but set it here for clarity */
612 i = ctr->num_mappings - 1;
614 blob = strhex_to_data_blob(ctr, schema_info);
615 if (!blob.data) {
616 talloc_free(ctr);
617 return WERR_NOMEM;
620 ctr->mappings[i].id_prefix = 0;
621 ctr->mappings[i].oid.length = blob.length;
622 ctr->mappings[i].oid.binary_oid = blob.data;
625 /* drsuapi_prefixMap constructed successfully */
626 *_ctr = ctr;
628 return WERR_OK;
632 * Verifies schema prefixMap and drsuapi prefixMap are same.
633 * Note that we just need to verify pfm contains prefixes
634 * from ctr, not that those prefixes has same id_prefix.
636 WERROR dsdb_schema_pfm_contains_drsuapi_pfm(const struct dsdb_schema_prefixmap *pfm,
637 const struct drsuapi_DsReplicaOIDMapping_Ctr *ctr)
639 WERROR werr;
640 uint32_t i;
641 uint32_t idx;
642 DATA_BLOB bin_oid;
644 /* verify drsuapi_pefixMap */
645 werr = _dsdb_drsuapi_pfm_verify(ctr, true);
646 W_ERROR_NOT_OK_RETURN(werr);
648 /* check pfm contains every entry from ctr, except the last one */
649 for (i = 0; i < ctr->num_mappings - 1; i++) {
650 bin_oid.length = ctr->mappings[i].oid.length;
651 bin_oid.data = ctr->mappings[i].oid.binary_oid;
653 werr = dsdb_schema_pfm_find_binary_oid(pfm, bin_oid, &idx);
654 if (!W_ERROR_IS_OK(werr)) {
655 return WERR_DS_DRA_SCHEMA_MISMATCH;
659 return WERR_OK;