vfs_ceph_new: common prefix to debug-log messages
[Samba.git] / source4 / dsdb / pydsdb.c
blob2ae569b2749d7291703c5be45e2100d9343565bd
1 /*
2 Unix SMB/CIFS implementation.
3 Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2007-2010
4 Copyright (C) Matthias Dieter Wallnöfer 2009
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
20 #include "lib/replace/system/python.h"
21 #include "python/py3compat.h"
22 #include "includes.h"
23 #include <ldb.h>
24 #include <pyldb.h>
25 #include "dsdb/samdb/samdb.h"
26 #include "libcli/security/security.h"
27 #include "librpc/ndr/libndr.h"
28 #include "system/kerberos.h"
29 #include "auth/kerberos/kerberos.h"
30 #include "librpc/rpc/pyrpc_util.h"
31 #include "lib/policy/policy.h"
32 #include "param/pyparam.h"
33 #include "lib/util/dlinklist.h"
34 #include "dsdb/kcc/garbage_collect_tombstones.h"
35 #include "dsdb/kcc/scavenge_dns_records.h"
36 #include "libds/common/flag_mapping.h"
38 #undef strcasecmp
40 static PyObject *py_ldb_get_exception(void)
42 PyObject *mod = PyImport_ImportModule("ldb");
43 PyObject *result = NULL;
44 if (mod == NULL)
45 return NULL;
47 result = PyObject_GetAttrString(mod, "LdbError");
48 Py_CLEAR(mod);
49 return result;
52 static PyObject *py_samdb_server_site_name(PyObject *self, PyObject *args)
54 PyObject *py_ldb, *result;
55 struct ldb_context *ldb;
56 const char *site;
57 TALLOC_CTX *mem_ctx;
59 if (!PyArg_ParseTuple(args, "O", &py_ldb))
60 return NULL;
62 PyErr_LDB_OR_RAISE(py_ldb, ldb);
64 mem_ctx = talloc_new(NULL);
65 if (mem_ctx == NULL) {
66 PyErr_NoMemory();
67 return NULL;
70 site = samdb_server_site_name(ldb, mem_ctx);
71 if (site == NULL) {
72 PyErr_SetString(PyExc_RuntimeError, "Failed to find server site");
73 talloc_free(mem_ctx);
74 return NULL;
77 result = PyUnicode_FromString(site);
78 talloc_free(mem_ctx);
79 return result;
82 static PyObject *py_dsdb_convert_schema_to_openldap(PyObject *self,
83 PyObject *args)
85 char *target_str, *mapping;
86 PyObject *py_ldb;
87 struct ldb_context *ldb;
88 PyObject *ret;
89 char *retstr;
91 if (!PyArg_ParseTuple(args, "Oss", &py_ldb, &target_str, &mapping))
92 return NULL;
94 PyErr_LDB_OR_RAISE(py_ldb, ldb);
96 retstr = dsdb_convert_schema_to_openldap(ldb, target_str, mapping);
97 if (retstr == NULL) {
98 PyErr_SetString(PyExc_RuntimeError,
99 "dsdb_convert_schema_to_openldap failed");
100 return NULL;
103 ret = PyUnicode_FromString(retstr);
104 talloc_free(retstr);
105 return ret;
108 static PyObject *py_samdb_set_domain_sid(PyLdbObject *self, PyObject *args)
110 PyObject *py_ldb, *py_sid;
111 struct ldb_context *ldb;
112 struct dom_sid *sid;
113 bool ret;
114 const char *sid_str = NULL;
116 if (!PyArg_ParseTuple(args, "OO", &py_ldb, &py_sid))
117 return NULL;
119 PyErr_LDB_OR_RAISE(py_ldb, ldb);
121 sid_str = PyUnicode_AsUTF8(py_sid);
122 if (sid_str == NULL) {
123 PyErr_NoMemory();
124 return NULL;
127 sid = dom_sid_parse_talloc(NULL, sid_str);
128 if (sid == NULL) {
129 PyErr_NoMemory();
130 return NULL;
133 ret = samdb_set_domain_sid(ldb, sid);
134 talloc_free(sid);
135 if (!ret) {
136 PyErr_SetString(PyExc_RuntimeError, "set_domain_sid failed");
137 return NULL;
139 Py_RETURN_NONE;
142 static PyObject *py_samdb_set_ntds_settings_dn(PyLdbObject *self, PyObject *args)
144 PyObject *py_ldb, *py_ntds_settings_dn;
145 struct ldb_context *ldb;
146 struct ldb_dn *ntds_settings_dn;
147 TALLOC_CTX *tmp_ctx;
148 bool ret;
150 if (!PyArg_ParseTuple(args, "OO", &py_ldb, &py_ntds_settings_dn))
151 return NULL;
153 PyErr_LDB_OR_RAISE(py_ldb, ldb);
155 tmp_ctx = talloc_new(NULL);
156 if (tmp_ctx == NULL) {
157 PyErr_NoMemory();
158 return NULL;
161 if (!pyldb_Object_AsDn(tmp_ctx, py_ntds_settings_dn, ldb, &ntds_settings_dn)) {
162 /* exception thrown by "pyldb_Object_AsDn" */
163 talloc_free(tmp_ctx);
164 return NULL;
167 ret = samdb_set_ntds_settings_dn(ldb, ntds_settings_dn);
168 talloc_free(tmp_ctx);
169 if (!ret) {
170 PyErr_SetString(PyExc_RuntimeError, "set_ntds_settings_dn failed");
171 return NULL;
173 Py_RETURN_NONE;
176 static PyObject *py_samdb_get_domain_sid(PyLdbObject *self, PyObject *args)
178 PyObject *py_ldb;
179 struct ldb_context *ldb;
180 const struct dom_sid *sid;
181 struct dom_sid_buf buf;
182 PyObject *ret;
184 if (!PyArg_ParseTuple(args, "O", &py_ldb))
185 return NULL;
187 PyErr_LDB_OR_RAISE(py_ldb, ldb);
189 sid = samdb_domain_sid(ldb);
190 if (!sid) {
191 PyErr_SetString(PyExc_RuntimeError, "samdb_domain_sid failed");
192 return NULL;
195 ret = PyUnicode_FromString(dom_sid_str_buf(sid, &buf));
196 return ret;
199 static PyObject *py_samdb_ntds_invocation_id(PyObject *self, PyObject *args)
201 PyObject *py_ldb, *result;
202 struct ldb_context *ldb;
203 const struct GUID *guid;
204 char *retstr;
206 if (!PyArg_ParseTuple(args, "O", &py_ldb)) {
207 return NULL;
210 PyErr_LDB_OR_RAISE(py_ldb, ldb);
212 guid = samdb_ntds_invocation_id(ldb);
213 if (guid == NULL) {
214 PyErr_SetString(PyExc_RuntimeError,
215 "Failed to find NTDS invocation ID");
216 return NULL;
219 retstr = GUID_string(NULL, guid);
220 if (retstr == NULL) {
221 PyErr_NoMemory();
222 return NULL;
224 result = PyUnicode_FromString(retstr);
225 talloc_free(retstr);
226 return result;
229 static PyObject *py_dsdb_get_oid_from_attid(PyObject *self, PyObject *args)
231 PyObject *py_ldb;
232 struct ldb_context *ldb;
233 uint32_t attid;
234 struct dsdb_schema *schema;
235 const char *oid;
236 PyObject *ret;
237 WERROR status;
238 TALLOC_CTX *mem_ctx;
240 if (!PyArg_ParseTuple(args, "OI", &py_ldb, &attid))
241 return NULL;
243 PyErr_LDB_OR_RAISE(py_ldb, ldb);
245 mem_ctx = talloc_new(NULL);
246 if (!mem_ctx) {
247 PyErr_NoMemory();
248 return NULL;
251 schema = dsdb_get_schema(ldb, mem_ctx);
252 if (!schema) {
253 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb \n");
254 talloc_free(mem_ctx);
255 return NULL;
258 status = dsdb_schema_pfm_oid_from_attid(schema->prefixmap, attid,
259 mem_ctx, &oid);
260 if (!W_ERROR_IS_OK(status)) {
261 PyErr_SetWERROR(status);
262 talloc_free(mem_ctx);
263 return NULL;
266 ret = PyUnicode_FromString(oid);
268 talloc_free(mem_ctx);
270 return ret;
274 static PyObject *py_dsdb_get_attid_from_lDAPDisplayName(PyObject *self, PyObject *args)
276 PyObject *py_ldb, *is_schema_nc;
277 struct ldb_context *ldb;
278 struct dsdb_schema *schema;
279 const char *ldap_display_name;
280 bool schema_nc = false;
281 const struct dsdb_attribute *a;
282 uint32_t attid;
284 if (!PyArg_ParseTuple(args, "OsO", &py_ldb, &ldap_display_name, &is_schema_nc))
285 return NULL;
287 PyErr_LDB_OR_RAISE(py_ldb, ldb);
289 if (is_schema_nc) {
290 if (!PyBool_Check(is_schema_nc)) {
291 PyErr_SetString(PyExc_TypeError, "Expected boolean is_schema_nc");
292 return NULL;
294 if (is_schema_nc == Py_True) {
295 schema_nc = true;
299 schema = dsdb_get_schema(ldb, NULL);
301 if (!schema) {
302 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
303 return NULL;
306 a = dsdb_attribute_by_lDAPDisplayName(schema, ldap_display_name);
307 if (a == NULL) {
308 PyErr_Format(PyExc_KeyError, "Failed to find attribute '%s'", ldap_display_name);
309 return NULL;
312 attid = dsdb_attribute_get_attid(a, schema_nc);
314 return PyLong_FromUnsignedLong(attid);
318 return the systemFlags as int from the attribute name
320 static PyObject *py_dsdb_get_systemFlags_from_lDAPDisplayName(PyObject *self, PyObject *args)
322 PyObject *py_ldb;
323 struct ldb_context *ldb;
324 struct dsdb_schema *schema;
325 const char *ldap_display_name;
326 const struct dsdb_attribute *attribute;
328 if (!PyArg_ParseTuple(args, "Os", &py_ldb, &ldap_display_name))
329 return NULL;
331 PyErr_LDB_OR_RAISE(py_ldb, ldb);
333 schema = dsdb_get_schema(ldb, NULL);
335 if (!schema) {
336 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
337 return NULL;
340 attribute = dsdb_attribute_by_lDAPDisplayName(schema, ldap_display_name);
341 if (attribute == NULL) {
342 PyErr_Format(PyExc_KeyError, "Failed to find attribute '%s'", ldap_display_name);
343 return NULL;
346 return PyLong_FromLong(attribute->systemFlags);
350 return the linkID from the attribute name
352 static PyObject *py_dsdb_get_linkId_from_lDAPDisplayName(PyObject *self, PyObject *args)
354 PyObject *py_ldb;
355 struct ldb_context *ldb;
356 struct dsdb_schema *schema;
357 const char *ldap_display_name;
358 const struct dsdb_attribute *attribute;
360 if (!PyArg_ParseTuple(args, "Os", &py_ldb, &ldap_display_name))
361 return NULL;
363 PyErr_LDB_OR_RAISE(py_ldb, ldb);
365 schema = dsdb_get_schema(ldb, NULL);
367 if (!schema) {
368 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
369 return NULL;
372 attribute = dsdb_attribute_by_lDAPDisplayName(schema, ldap_display_name);
373 if (attribute == NULL) {
374 PyErr_Format(PyExc_KeyError, "Failed to find attribute '%s'", ldap_display_name);
375 return NULL;
378 return PyLong_FromLong(attribute->linkID);
382 return the backlink attribute name (if any) for an attribute
384 static PyObject *py_dsdb_get_backlink_from_lDAPDisplayName(PyObject *self, PyObject *args)
386 PyObject *py_ldb;
387 struct ldb_context *ldb;
388 struct dsdb_schema *schema;
389 const char *ldap_display_name;
390 const struct dsdb_attribute *attribute, *target_attr;
392 if (!PyArg_ParseTuple(args, "Os", &py_ldb, &ldap_display_name))
393 return NULL;
395 PyErr_LDB_OR_RAISE(py_ldb, ldb);
397 schema = dsdb_get_schema(ldb, NULL);
399 if (!schema) {
400 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
401 return NULL;
404 attribute = dsdb_attribute_by_lDAPDisplayName(schema, ldap_display_name);
405 if (attribute == NULL) {
406 PyErr_Format(PyExc_KeyError, "Failed to find attribute '%s'", ldap_display_name);
407 return NULL;
410 if (attribute->linkID == 0) {
411 Py_RETURN_NONE;
414 target_attr = dsdb_attribute_by_linkID(schema, attribute->linkID ^ 1);
415 if (target_attr == NULL) {
416 /* when we add pseudo-backlinks we'll need to handle
417 them here */
418 Py_RETURN_NONE;
421 return PyUnicode_FromString(target_attr->lDAPDisplayName);
425 static PyObject *py_dsdb_get_lDAPDisplayName_by_attid(PyObject *self, PyObject *args)
427 PyObject *py_ldb;
428 struct ldb_context *ldb;
429 struct dsdb_schema *schema;
430 const struct dsdb_attribute *a;
431 uint32_t attid;
433 if (!PyArg_ParseTuple(args, "OI", &py_ldb, &attid))
434 return NULL;
436 PyErr_LDB_OR_RAISE(py_ldb, ldb);
438 schema = dsdb_get_schema(ldb, NULL);
440 if (!schema) {
441 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
442 return NULL;
445 a = dsdb_attribute_by_attributeID_id(schema, attid);
446 if (a == NULL) {
447 PyErr_Format(PyExc_KeyError, "Failed to find attribute '0x%08x'", attid);
448 return NULL;
451 return PyUnicode_FromString(a->lDAPDisplayName);
456 return the attribute syntax oid as a string from the attribute name
458 static PyObject *py_dsdb_get_syntax_oid_from_lDAPDisplayName(PyObject *self, PyObject *args)
460 PyObject *py_ldb;
461 struct ldb_context *ldb;
462 struct dsdb_schema *schema;
463 const char *ldap_display_name;
464 const struct dsdb_attribute *attribute;
466 if (!PyArg_ParseTuple(args, "Os", &py_ldb, &ldap_display_name))
467 return NULL;
469 PyErr_LDB_OR_RAISE(py_ldb, ldb);
471 schema = dsdb_get_schema(ldb, NULL);
473 if (!schema) {
474 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
475 return NULL;
478 attribute = dsdb_attribute_by_lDAPDisplayName(schema, ldap_display_name);
479 if (attribute == NULL) {
480 PyErr_Format(PyExc_KeyError, "Failed to find attribute '%s'", ldap_display_name);
481 return NULL;
484 return PyUnicode_FromString(attribute->syntax->ldap_oid);
488 convert a python string to a DRSUAPI drsuapi_DsReplicaAttribute attribute
490 static PyObject *py_dsdb_DsReplicaAttribute(PyObject *self, PyObject *args)
492 PyObject *py_ldb, *el_list, *ret;
493 struct ldb_context *ldb;
494 char *ldap_display_name;
495 const struct dsdb_attribute *a;
496 struct dsdb_schema *schema;
497 struct dsdb_syntax_ctx syntax_ctx;
498 struct ldb_message_element *el;
499 struct drsuapi_DsReplicaAttribute *attr;
500 TALLOC_CTX *tmp_ctx;
501 WERROR werr;
502 Py_ssize_t i;
504 if (!PyArg_ParseTuple(args, "OsO", &py_ldb, &ldap_display_name, &el_list)) {
505 return NULL;
508 PyErr_LDB_OR_RAISE(py_ldb, ldb);
510 schema = dsdb_get_schema(ldb, NULL);
511 if (!schema) {
512 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
513 return NULL;
516 a = dsdb_attribute_by_lDAPDisplayName(schema, ldap_display_name);
517 if (a == NULL) {
518 PyErr_Format(PyExc_KeyError, "Failed to find attribute '%s'", ldap_display_name);
519 return NULL;
522 dsdb_syntax_ctx_init(&syntax_ctx, ldb, schema);
523 syntax_ctx.is_schema_nc = false;
525 tmp_ctx = talloc_new(ldb);
526 if (tmp_ctx == NULL) {
527 PyErr_NoMemory();
528 return NULL;
531 /* If we were not given an LdbMessageElement */
532 if (!PyList_Check(el_list)) {
533 if (!py_check_dcerpc_type(el_list, "ldb", "MessageElement")) {
534 PyErr_SetString(py_ldb_get_exception(),
535 "list of strings or ldb MessageElement object required");
536 return NULL;
539 * NOTE:
540 * el may not be a valid talloc context, it
541 * could be part of an array
543 el = pyldb_MessageElement_AsMessageElement(el_list);
544 } else {
545 el = talloc_zero(tmp_ctx, struct ldb_message_element);
546 if (el == NULL) {
547 PyErr_NoMemory();
548 talloc_free(tmp_ctx);
549 return NULL;
552 el->name = ldap_display_name;
553 el->num_values = PyList_Size(el_list);
555 el->values = talloc_array(el, struct ldb_val, el->num_values);
556 if (el->values == NULL) {
557 PyErr_NoMemory();
558 talloc_free(tmp_ctx);
559 return NULL;
562 for (i = 0; i < el->num_values; i++) {
563 PyObject *item = PyList_GetItem(el_list, i);
564 if (!(PyBytes_Check(item))) {
565 PyErr_Format(PyExc_TypeError,
566 "ldif_element type should be bytes"
568 talloc_free(tmp_ctx);
569 return NULL;
571 el->values[i].data =
572 (uint8_t *)PyBytes_AsString(item);
573 el->values[i].length = PyBytes_Size(item);
577 attr = talloc_zero(tmp_ctx, struct drsuapi_DsReplicaAttribute);
578 if (attr == NULL) {
579 PyErr_NoMemory();
580 talloc_free(tmp_ctx);
581 return NULL;
584 werr = a->syntax->ldb_to_drsuapi(&syntax_ctx, a, el, attr, attr);
585 PyErr_WERROR_NOT_OK_RAISE(werr);
587 ret = py_return_ndr_struct("samba.dcerpc.drsuapi", "DsReplicaAttribute", attr, attr);
589 talloc_free(tmp_ctx);
591 return ret;
596 normalise a ldb attribute list
598 static PyObject *py_dsdb_normalise_attributes(PyObject *self, PyObject *args)
600 PyObject *py_ldb, *el_list, *py_ret;
601 struct ldb_context *ldb;
602 char *ldap_display_name;
603 const struct dsdb_attribute *a;
604 struct dsdb_schema *schema;
605 struct dsdb_syntax_ctx syntax_ctx;
606 struct ldb_message_element *el, *new_el;
607 struct drsuapi_DsReplicaAttribute *attr;
608 PyLdbMessageElementObject *ret;
609 TALLOC_CTX *tmp_ctx;
610 WERROR werr;
611 Py_ssize_t i;
612 PyTypeObject *py_type = NULL;
613 PyObject *module = NULL;
615 if (!PyArg_ParseTuple(args, "OsO", &py_ldb, &ldap_display_name, &el_list)) {
616 return NULL;
619 PyErr_LDB_OR_RAISE(py_ldb, ldb);
621 schema = dsdb_get_schema(ldb, NULL);
622 if (!schema) {
623 PyErr_SetString(PyExc_RuntimeError, "Failed to find a schema from ldb");
624 return NULL;
627 a = dsdb_attribute_by_lDAPDisplayName(schema, ldap_display_name);
628 if (a == NULL) {
629 PyErr_Format(PyExc_KeyError, "Failed to find attribute '%s'", ldap_display_name);
630 return NULL;
633 dsdb_syntax_ctx_init(&syntax_ctx, ldb, schema);
634 syntax_ctx.is_schema_nc = false;
636 tmp_ctx = talloc_new(ldb);
637 if (tmp_ctx == NULL) {
638 PyErr_NoMemory();
639 return NULL;
642 if (!PyList_Check(el_list)) {
643 if (!py_check_dcerpc_type(el_list, "ldb", "MessageElement")) {
644 PyErr_SetString(py_ldb_get_exception(),
645 "list of strings or ldb MessageElement object required");
646 return NULL;
649 * NOTE:
650 * el may not be a valid talloc context, it
651 * could be part of an array
653 el = pyldb_MessageElement_AsMessageElement(el_list);
654 } else {
655 el = talloc_zero(tmp_ctx, struct ldb_message_element);
656 if (el == NULL) {
657 PyErr_NoMemory();
658 talloc_free(tmp_ctx);
659 return NULL;
662 el->name = ldap_display_name;
663 el->num_values = PyList_Size(el_list);
665 el->values = talloc_array(el, struct ldb_val, el->num_values);
666 if (el->values == NULL) {
667 PyErr_NoMemory();
668 talloc_free(tmp_ctx);
669 return NULL;
672 for (i = 0; i < el->num_values; i++) {
673 PyObject *item = PyList_GetItem(el_list, i);
674 if (!PyBytes_Check(item)) {
675 PyErr_Format(PyExc_TypeError,
676 "ldif_element type should be bytes"
678 talloc_free(tmp_ctx);
679 return NULL;
681 el->values[i].data = (uint8_t *)PyBytes_AsString(item);
682 el->values[i].length = PyBytes_Size(item);
686 new_el = talloc_zero(tmp_ctx, struct ldb_message_element);
687 if (new_el == NULL) {
688 PyErr_NoMemory();
689 talloc_free(tmp_ctx);
690 return NULL;
693 /* Normalise "objectClass" attribute if needed */
694 if (ldb_attr_cmp(a->lDAPDisplayName, "objectClass") == 0) {
695 int iret;
696 iret = dsdb_sort_objectClass_attr(ldb, schema, el, new_el, new_el);
697 if (iret != LDB_SUCCESS) {
698 PyErr_SetString(PyExc_RuntimeError, ldb_errstring(ldb));
699 talloc_free(tmp_ctx);
700 return NULL;
704 /* first run ldb_to_drsuapi, then convert back again. This has
705 * the effect of normalising the attributes
708 attr = talloc_zero(tmp_ctx, struct drsuapi_DsReplicaAttribute);
709 if (attr == NULL) {
710 PyErr_NoMemory();
711 talloc_free(tmp_ctx);
712 return NULL;
715 werr = a->syntax->ldb_to_drsuapi(&syntax_ctx, a, el, attr, attr);
716 PyErr_WERROR_NOT_OK_RAISE(werr);
718 /* now convert back again */
719 werr = a->syntax->drsuapi_to_ldb(&syntax_ctx, a, attr, new_el, new_el);
720 PyErr_WERROR_NOT_OK_RAISE(werr);
722 module = PyImport_ImportModule("ldb");
723 if (module == NULL) {
724 return NULL;
727 py_type = (PyTypeObject *)PyObject_GetAttrString(module, "MessageElement");
728 if (py_type == NULL) {
729 Py_DECREF(module);
730 return NULL;
733 Py_CLEAR(module);
735 py_ret = py_type->tp_alloc(py_type, 0);
736 Py_CLEAR(py_type);
737 if (py_ret == NULL) {
738 PyErr_NoMemory();
739 return NULL;
741 ret = (PyLdbMessageElementObject *)py_ret;
743 ret->mem_ctx = talloc_new(NULL);
744 if (talloc_reference(ret->mem_ctx, new_el) == NULL) {
745 Py_CLEAR(py_ret);
746 PyErr_NoMemory();
747 return NULL;
749 ret->el = new_el;
751 talloc_free(tmp_ctx);
753 return py_ret;
757 static PyObject *py_dsdb_set_ntds_invocation_id(PyObject *self, PyObject *args)
759 PyObject *py_ldb, *py_guid;
760 bool ret;
761 struct GUID guid;
762 struct ldb_context *ldb;
763 if (!PyArg_ParseTuple(args, "OO", &py_ldb, &py_guid))
764 return NULL;
766 PyErr_LDB_OR_RAISE(py_ldb, ldb);
767 GUID_from_string(PyUnicode_AsUTF8(py_guid), &guid);
769 if (GUID_all_zero(&guid)) {
770 PyErr_SetString(PyExc_RuntimeError, "set_ntds_invocation_id rejected due to all-zero invocation ID");
771 return NULL;
774 ret = samdb_set_ntds_invocation_id(ldb, &guid);
775 if (!ret) {
776 PyErr_SetString(PyExc_RuntimeError, "set_ntds_invocation_id failed");
777 return NULL;
779 Py_RETURN_NONE;
782 static PyObject *py_samdb_ntds_objectGUID(PyObject *self, PyObject *args)
784 PyObject *py_ldb, *result;
785 struct ldb_context *ldb;
786 const struct GUID *guid;
787 char *retstr;
789 if (!PyArg_ParseTuple(args, "O", &py_ldb)) {
790 return NULL;
793 PyErr_LDB_OR_RAISE(py_ldb, ldb);
795 guid = samdb_ntds_objectGUID(ldb);
796 if (guid == NULL) {
797 PyErr_SetString(PyExc_RuntimeError, "Failed to find NTDS GUID");
798 return NULL;
801 retstr = GUID_string(NULL, guid);
802 if (retstr == NULL) {
803 PyErr_NoMemory();
804 return NULL;
806 result = PyUnicode_FromString(retstr);
807 talloc_free(retstr);
808 return result;
811 static PyObject *py_dsdb_set_global_schema(PyObject *self, PyObject *args)
813 PyObject *py_ldb;
814 struct ldb_context *ldb;
815 int ret;
816 if (!PyArg_ParseTuple(args, "O", &py_ldb))
817 return NULL;
819 PyErr_LDB_OR_RAISE(py_ldb, ldb);
821 ret = dsdb_set_global_schema(ldb);
822 PyErr_LDB_ERROR_IS_ERR_RAISE(py_ldb_get_exception(), ret, ldb);
824 Py_RETURN_NONE;
827 static PyObject *py_dsdb_load_partition_usn(PyObject *self, PyObject *args)
829 PyObject *py_dn, *py_ldb, *result;
830 struct ldb_dn *dn;
831 uint64_t highest_uSN, urgent_uSN;
832 struct ldb_context *ldb;
833 TALLOC_CTX *mem_ctx;
834 int ret;
836 if (!PyArg_ParseTuple(args, "OO", &py_ldb, &py_dn)) {
837 return NULL;
840 PyErr_LDB_OR_RAISE(py_ldb, ldb);
842 mem_ctx = talloc_new(NULL);
843 if (mem_ctx == NULL) {
844 PyErr_NoMemory();
845 return NULL;
848 if (!pyldb_Object_AsDn(mem_ctx, py_dn, ldb, &dn)) {
849 talloc_free(mem_ctx);
850 return NULL;
853 ret = dsdb_load_partition_usn(ldb, dn, &highest_uSN, &urgent_uSN);
854 if (ret != LDB_SUCCESS) {
855 PyErr_Format(PyExc_RuntimeError,
856 "Failed to load partition [%s] uSN - %s",
857 ldb_dn_get_linearized(dn),
858 ldb_errstring(ldb));
859 talloc_free(mem_ctx);
860 return NULL;
863 talloc_free(mem_ctx);
865 result = Py_BuildValue(
866 "{s:l, s:l}",
867 "uSNHighest", (uint64_t)highest_uSN,
868 "uSNUrgent", (uint64_t)urgent_uSN);
870 return result;
873 static PyObject *py_dsdb_set_am_rodc(PyObject *self, PyObject *args)
875 PyObject *py_ldb;
876 bool ret;
877 struct ldb_context *ldb;
878 int py_val;
880 if (!PyArg_ParseTuple(args, "Oi", &py_ldb, &py_val))
881 return NULL;
883 PyErr_LDB_OR_RAISE(py_ldb, ldb);
884 ret = samdb_set_am_rodc(ldb, (bool)py_val);
885 if (!ret) {
886 PyErr_SetString(PyExc_RuntimeError, "set_am_rodc failed");
887 return NULL;
889 Py_RETURN_NONE;
892 static PyObject *py_dsdb_set_schema_from_ldif(PyObject *self, PyObject *args)
894 WERROR result;
895 char *pf, *df, *dn;
896 PyObject *py_ldb;
897 struct ldb_context *ldb;
899 if (!PyArg_ParseTuple(args, "Osss", &py_ldb, &pf, &df, &dn))
900 return NULL;
902 PyErr_LDB_OR_RAISE(py_ldb, ldb);
904 result = dsdb_set_schema_from_ldif(ldb, pf, df, dn);
905 PyErr_WERROR_NOT_OK_RAISE(result);
907 Py_RETURN_NONE;
910 static PyObject *py_dsdb_set_schema_from_ldb(PyObject *self, PyObject *args)
912 PyObject *py_ldb;
913 struct ldb_context *ldb;
914 PyObject *py_from_ldb;
915 struct ldb_context *from_ldb;
916 struct dsdb_schema *schema;
917 int ret;
918 char write_indices_and_attributes = SCHEMA_WRITE;
919 if (!PyArg_ParseTuple(args, "OO|b",
920 &py_ldb, &py_from_ldb, &write_indices_and_attributes))
921 return NULL;
923 PyErr_LDB_OR_RAISE(py_ldb, ldb);
925 PyErr_LDB_OR_RAISE(py_from_ldb, from_ldb);
927 schema = dsdb_get_schema(from_ldb, NULL);
928 if (!schema) {
929 PyErr_SetString(PyExc_RuntimeError, "Failed to set find a schema on 'from' ldb!\n");
930 return NULL;
933 ret = dsdb_reference_schema(ldb, schema, write_indices_and_attributes);
934 PyErr_LDB_ERROR_IS_ERR_RAISE(py_ldb_get_exception(), ret, ldb);
936 Py_RETURN_NONE;
939 static PyObject *py_dsdb_write_prefixes_from_schema_to_ldb(PyObject *self, PyObject *args)
941 PyObject *py_ldb;
942 struct ldb_context *ldb;
943 WERROR result;
944 struct dsdb_schema *schema;
946 if (!PyArg_ParseTuple(args, "O", &py_ldb))
947 return NULL;
949 PyErr_LDB_OR_RAISE(py_ldb, ldb);
951 schema = dsdb_get_schema(ldb, NULL);
952 if (!schema) {
953 PyErr_SetString(PyExc_RuntimeError, "Failed to set find a schema on ldb!\n");
954 return NULL;
957 result = dsdb_write_prefixes_from_schema_to_ldb(NULL, ldb, schema);
958 PyErr_WERROR_NOT_OK_RAISE(result);
960 Py_RETURN_NONE;
964 static PyObject *py_dsdb_get_partitions_dn(PyObject *self, PyObject *args)
966 struct ldb_context *ldb;
967 struct ldb_dn *dn;
968 PyObject *py_ldb, *ret;
970 if (!PyArg_ParseTuple(args, "O", &py_ldb))
971 return NULL;
973 PyErr_LDB_OR_RAISE(py_ldb, ldb);
975 dn = samdb_partitions_dn(ldb, NULL);
976 if (dn == NULL) {
977 PyErr_NoMemory();
978 return NULL;
980 ret = pyldb_Dn_FromDn(dn, (PyLdbObject *)py_ldb);
981 talloc_free(dn);
982 return ret;
986 static PyObject *py_dsdb_get_nc_root(PyObject *self, PyObject *args)
988 struct ldb_context *ldb;
989 struct ldb_dn *dn, *nc_root;
990 PyObject *py_ldb, *py_ldb_dn, *py_nc_root;
991 int ret;
993 if (!PyArg_ParseTuple(args, "OO", &py_ldb, &py_ldb_dn))
994 return NULL;
996 PyErr_LDB_OR_RAISE(py_ldb, ldb);
997 PyErr_LDB_DN_OR_RAISE(py_ldb_dn, dn);
999 ret = dsdb_find_nc_root(ldb, ldb, dn, &nc_root);
1000 PyErr_LDB_ERROR_IS_ERR_RAISE(py_ldb_get_exception(), ret, ldb);
1002 py_nc_root = pyldb_Dn_FromDn(nc_root, (PyLdbObject *)py_ldb);
1003 talloc_unlink(ldb, nc_root);
1004 return py_nc_root;
1007 static PyObject *py_dsdb_get_wellknown_dn(PyObject *self, PyObject *args)
1009 struct ldb_context *ldb;
1010 struct ldb_dn *nc_dn, *wk_dn;
1011 char *wkguid;
1012 PyObject *py_ldb, *py_nc_dn, *py_wk_dn;
1013 int ret;
1015 if (!PyArg_ParseTuple(args, "OOs", &py_ldb, &py_nc_dn, &wkguid))
1016 return NULL;
1018 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1019 PyErr_LDB_DN_OR_RAISE(py_nc_dn, nc_dn);
1021 ret = dsdb_wellknown_dn(ldb, ldb, nc_dn, wkguid, &wk_dn);
1022 if (ret == LDB_ERR_NO_SUCH_OBJECT) {
1023 PyErr_Format(PyExc_KeyError, "Failed to find well known DN for GUID %s", wkguid);
1024 return NULL;
1027 PyErr_LDB_ERROR_IS_ERR_RAISE(py_ldb_get_exception(), ret, ldb);
1029 py_wk_dn = pyldb_Dn_FromDn(wk_dn, (PyLdbObject *)py_ldb);
1030 talloc_unlink(ldb, wk_dn);
1031 return py_wk_dn;
1036 call into samdb_rodc()
1038 static PyObject *py_dsdb_am_rodc(PyObject *self, PyObject *args)
1040 PyObject *py_ldb;
1041 struct ldb_context *ldb;
1042 int ret;
1043 bool am_rodc;
1045 if (!PyArg_ParseTuple(args, "O", &py_ldb))
1046 return NULL;
1048 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1050 ret = samdb_rodc(ldb, &am_rodc);
1051 if (ret != LDB_SUCCESS) {
1052 PyErr_SetString(PyExc_RuntimeError, ldb_errstring(ldb));
1053 return NULL;
1056 return PyBool_FromLong(am_rodc);
1060 call into samdb_is_pdc()
1062 static PyObject *py_dsdb_am_pdc(PyObject *self, PyObject *args)
1064 PyObject *py_ldb;
1065 struct ldb_context *ldb;
1066 bool am_pdc;
1068 if (!PyArg_ParseTuple(args, "O", &py_ldb))
1069 return NULL;
1071 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1073 am_pdc = samdb_is_pdc(ldb);
1074 return PyBool_FromLong(am_pdc);
1078 call DSDB_EXTENDED_CREATE_OWN_RID_SET to get a new RID set for this server
1080 static PyObject *py_dsdb_create_own_rid_set(PyObject *self, PyObject *args)
1082 PyObject *py_ldb;
1083 struct ldb_context *ldb;
1084 int ret;
1085 struct ldb_result *ext_res;
1087 if (!PyArg_ParseTuple(args, "O", &py_ldb))
1088 return NULL;
1090 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1093 * Run DSDB_EXTENDED_CREATE_OWN_RID_SET to get a RID set
1096 ret = ldb_extended(ldb, DSDB_EXTENDED_CREATE_OWN_RID_SET, NULL, &ext_res);
1098 PyErr_LDB_ERROR_IS_ERR_RAISE(py_ldb_get_exception(), ret, ldb);
1100 TALLOC_FREE(ext_res);
1102 Py_RETURN_NONE;
1106 call DSDB_EXTENDED_ALLOCATE_RID to get a new RID set for this server
1108 static PyObject *py_dsdb_allocate_rid(PyObject *self, PyObject *args)
1110 PyObject *py_ldb;
1111 struct ldb_context *ldb;
1112 int ret;
1113 uint32_t rid;
1114 struct ldb_result *ext_res = NULL;
1115 struct dsdb_extended_allocate_rid *rid_return = NULL;
1116 if (!PyArg_ParseTuple(args, "O", &py_ldb)) {
1117 return NULL;
1120 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1122 rid_return = talloc_zero(ldb, struct dsdb_extended_allocate_rid);
1123 if (rid_return == NULL) {
1124 return PyErr_NoMemory();
1128 * Run DSDB_EXTENDED_ALLOCATE_RID to get a new RID
1131 ret = ldb_extended(ldb, DSDB_EXTENDED_ALLOCATE_RID, rid_return, &ext_res);
1132 if (ret != LDB_SUCCESS) {
1133 TALLOC_FREE(rid_return);
1134 TALLOC_FREE(ext_res);
1135 PyErr_LDB_ERROR_IS_ERR_RAISE(py_ldb_get_exception(), ret, ldb);
1138 rid = rid_return->rid;
1139 TALLOC_FREE(rid_return);
1140 TALLOC_FREE(ext_res);
1142 return PyLong_FromLong(rid);
1145 #ifdef AD_DC_BUILD_IS_ENABLED
1147 * These functions will not work correctly on non-AD_DC builds.
1149 * The only real principal in deciding whether to put something within
1150 * these guards is whether it will compile and work when
1151 * bld.AD_DC_BUILD_IS_ENABLED() says no.
1153 * Most of DSDB is built and samba-tool will work fine with remote
1154 * servers (using -H ldap://), but some DNS and periodic service
1155 * functions are not built.
1158 static PyObject *py_dns_delete_tombstones(PyObject *self, PyObject *args)
1160 PyObject *py_ldb;
1161 NTSTATUS status;
1162 struct ldb_context *ldb = NULL;
1163 TALLOC_CTX *mem_ctx = NULL;
1164 char *error_string = NULL;
1166 if (!PyArg_ParseTuple(args, "O", &py_ldb)) {
1167 return NULL;
1169 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1171 mem_ctx = talloc_new(ldb);
1172 if (mem_ctx == NULL) {
1173 return PyErr_NoMemory();
1176 status = dns_delete_tombstones(mem_ctx, ldb, &error_string);
1178 if (!NT_STATUS_IS_OK(status)) {
1179 if (error_string) {
1180 PyErr_Format(PyExc_RuntimeError, "%s", error_string);
1181 } else {
1182 PyErr_SetNTSTATUS(status);
1184 TALLOC_FREE(mem_ctx);
1185 return NULL;
1188 TALLOC_FREE(mem_ctx);
1189 Py_RETURN_NONE;
1192 static PyObject *py_scavenge_dns_records(PyObject *self, PyObject *args)
1194 PyObject *py_ldb;
1195 NTSTATUS status;
1196 struct ldb_context *ldb = NULL;
1197 TALLOC_CTX *mem_ctx = NULL;
1198 char *error_string = NULL;
1200 if (!PyArg_ParseTuple(args, "O", &py_ldb)) {
1201 return NULL;
1203 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1205 mem_ctx = talloc_new(ldb);
1206 if (mem_ctx == NULL) {
1207 return PyErr_NoMemory();
1210 status = dns_tombstone_records(mem_ctx, ldb, &error_string);
1212 if (!NT_STATUS_IS_OK(status)) {
1213 if (error_string) {
1214 PyErr_Format(PyExc_RuntimeError, "%s", error_string);
1215 } else {
1216 PyErr_SetNTSTATUS(status);
1218 TALLOC_FREE(mem_ctx);
1219 return NULL;
1222 TALLOC_FREE(mem_ctx);
1223 Py_RETURN_NONE;
1226 static PyObject *py_dsdb_garbage_collect_tombstones(PyObject *self, PyObject *args)
1228 PyObject *py_ldb, *py_list_dn;
1229 struct ldb_context *ldb = NULL;
1230 Py_ssize_t i;
1231 Py_ssize_t length;
1232 long long _current_time, _tombstone_lifetime = LLONG_MAX;
1233 uint32_t tombstone_lifetime32;
1234 struct dsdb_ldb_dn_list_node *part = NULL;
1235 time_t current_time, tombstone_lifetime;
1236 TALLOC_CTX *mem_ctx = NULL;
1237 NTSTATUS status;
1238 unsigned int num_objects_removed = 0;
1239 unsigned int num_links_removed = 0;
1240 char *error_string = NULL;
1242 if (!PyArg_ParseTuple(args, "OOL|L", &py_ldb,
1243 &py_list_dn, &_current_time, &_tombstone_lifetime)) {
1244 return NULL;
1248 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1250 mem_ctx = talloc_new(ldb);
1251 if (mem_ctx == NULL) {
1252 return PyErr_NoMemory();
1255 current_time = _current_time;
1257 if (_tombstone_lifetime == LLONG_MAX) {
1258 int ret = dsdb_tombstone_lifetime(ldb, &tombstone_lifetime32);
1259 if (ret != LDB_SUCCESS) {
1260 PyErr_Format(PyExc_RuntimeError,
1261 "Failed to get tombstone lifetime: %s",
1262 ldb_errstring(ldb));
1263 TALLOC_FREE(mem_ctx);
1264 return NULL;
1266 tombstone_lifetime = tombstone_lifetime32;
1267 } else {
1268 tombstone_lifetime = _tombstone_lifetime;
1271 if (!PyList_Check(py_list_dn)) {
1272 PyErr_SetString(PyExc_TypeError, "A list of DNs were expected");
1273 TALLOC_FREE(mem_ctx);
1274 return NULL;
1277 length = PyList_GET_SIZE(py_list_dn);
1279 for (i = 0; i < length; i++) {
1280 const char *part_str = PyUnicode_AsUTF8(PyList_GetItem(py_list_dn, i));
1281 struct ldb_dn *p;
1282 struct dsdb_ldb_dn_list_node *node;
1284 if (part_str == NULL) {
1285 TALLOC_FREE(mem_ctx);
1286 return PyErr_NoMemory();
1289 p = ldb_dn_new(mem_ctx, ldb, part_str);
1290 if (p == NULL) {
1291 PyErr_Format(PyExc_RuntimeError, "Failed to parse DN %s", part_str);
1292 TALLOC_FREE(mem_ctx);
1293 return NULL;
1295 node = talloc_zero(mem_ctx, struct dsdb_ldb_dn_list_node);
1296 node->dn = p;
1298 DLIST_ADD_END(part, node);
1301 status = dsdb_garbage_collect_tombstones(mem_ctx, ldb,
1302 part, current_time,
1303 tombstone_lifetime,
1304 &num_objects_removed,
1305 &num_links_removed,
1306 &error_string);
1308 if (!NT_STATUS_IS_OK(status)) {
1309 if (error_string) {
1310 PyErr_Format(PyExc_RuntimeError, "%s", error_string);
1311 } else {
1312 PyErr_SetNTSTATUS(status);
1314 TALLOC_FREE(mem_ctx);
1315 return NULL;
1318 TALLOC_FREE(mem_ctx);
1320 return Py_BuildValue("(II)", num_objects_removed,
1321 num_links_removed);
1324 #else
1326 static PyObject *py_dsdb_not_implemented(PyObject *self, PyObject *args)
1328 PyErr_SetString(PyExc_NotImplementedError,
1329 "Library built without AD DC support");
1330 return NULL;
1333 #endif /* AD_DC_BUILD_IS_ENABLED */
1336 static PyObject *py_dsdb_create_gkdi_root_key(PyObject *self, PyObject *args, PyObject *kwargs)
1338 int ret;
1339 PyObject *py_ldb = NULL;
1340 PyObject *py_dn = NULL;
1341 struct ldb_context *samdb;
1342 /* long long time for Python conversions, NTTIME for Samba libs */
1343 unsigned long long ll_current_time = 0;
1344 unsigned long long ll_use_start_time = 0;
1345 NTTIME current_time, use_start_time;
1346 struct GUID root_key_id = {0};
1347 const struct ldb_message * root_key_msg = NULL;
1349 TALLOC_CTX *tmp_ctx = NULL;
1350 const char * const kwnames[] = {
1351 "ldb",
1352 "current_time",
1353 "use_start_time",
1354 NULL
1357 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "O|KK",
1358 discard_const_p(char *, kwnames),
1359 &py_ldb,
1360 &ll_current_time,
1361 &ll_use_start_time)) {
1362 return NULL;
1365 PyErr_LDB_OR_RAISE(py_ldb, samdb);
1367 current_time = ll_current_time;
1368 use_start_time = ll_use_start_time;
1370 * If current_time or use_start_time are not provided, we use
1371 * now. FIXME? should use_start_time be +10 hours or something?
1373 if (current_time == 0 || use_start_time == 0) {
1374 struct timeval now = timeval_current();
1375 NTTIME nt_now = timeval_to_nttime(&now);
1376 if (current_time == 0) {
1377 current_time = nt_now;
1379 if (use_start_time == 0) {
1380 use_start_time = nt_now;
1384 tmp_ctx = talloc_new(samdb);
1385 if (tmp_ctx == NULL) {
1386 return PyErr_NoMemory();
1388 ret = gkdi_new_root_key(tmp_ctx,
1389 samdb,
1390 current_time,
1391 use_start_time,
1392 &root_key_id,
1393 &root_key_msg);
1395 PyErr_LDB_ERROR_IS_ERR_RAISE_FREE(py_ldb_get_exception(), ret,
1396 samdb, tmp_ctx);
1399 py_dn = pyldb_Dn_FromDn(root_key_msg->dn,
1400 (PyLdbObject *)py_ldb);
1401 if (py_dn == NULL) {
1402 PyErr_LDB_ERROR_IS_ERR_RAISE_FREE(py_ldb_get_exception(),
1403 LDB_ERR_OPERATIONS_ERROR,
1404 samdb, tmp_ctx);
1408 * py_dn keeps a talloc_reference to it's own dn, and the
1409 * root_key is in the database.
1411 TALLOC_FREE(tmp_ctx);
1412 return py_dn;
1416 static PyObject *py_dsdb_load_udv_v2(PyObject *self, PyObject *args)
1418 uint32_t count;
1419 int ret, i;
1420 bool ok;
1421 PyObject *py_ldb = NULL, *py_dn = NULL, *pylist = NULL;
1422 struct ldb_context *samdb = NULL;
1423 struct ldb_dn *dn = NULL;
1424 struct drsuapi_DsReplicaCursor2 *cursors = NULL;
1425 TALLOC_CTX *tmp_ctx = NULL;
1427 if (!PyArg_ParseTuple(args, "OO", &py_ldb, &py_dn)) {
1428 return NULL;
1431 PyErr_LDB_OR_RAISE(py_ldb, samdb);
1433 tmp_ctx = talloc_new(samdb);
1434 if (tmp_ctx == NULL) {
1435 return PyErr_NoMemory();
1438 ok = pyldb_Object_AsDn(tmp_ctx, py_dn, samdb, &dn);
1439 if (!ok) {
1440 TALLOC_FREE(tmp_ctx);
1441 return NULL;
1444 ret = dsdb_load_udv_v2(samdb, dn, tmp_ctx, &cursors, &count);
1445 if (ret != LDB_SUCCESS) {
1446 TALLOC_FREE(tmp_ctx);
1447 PyErr_SetString(PyExc_RuntimeError,
1448 "Failed to load udv from ldb");
1449 return NULL;
1452 pylist = PyList_New(count);
1453 if (pylist == NULL) {
1454 TALLOC_FREE(tmp_ctx);
1455 return PyErr_NoMemory();
1458 for (i = 0; i < count; i++) {
1459 PyObject *py_cursor;
1460 struct drsuapi_DsReplicaCursor2 *cursor;
1461 cursor = talloc(tmp_ctx, struct drsuapi_DsReplicaCursor2);
1462 if (cursor == NULL) {
1463 TALLOC_FREE(tmp_ctx);
1464 return PyErr_NoMemory();
1466 *cursor = cursors[i];
1468 py_cursor = py_return_ndr_struct("samba.dcerpc.drsuapi",
1469 "DsReplicaCursor2",
1470 cursor, cursor);
1471 if (py_cursor == NULL) {
1472 TALLOC_FREE(tmp_ctx);
1473 return PyErr_NoMemory();
1476 PyList_SetItem(pylist, i, py_cursor);
1479 TALLOC_FREE(tmp_ctx);
1480 return pylist;
1483 static PyObject *py_dsdb_user_account_control_flag_bit_to_string(PyObject *self, PyObject *args)
1485 const char *str;
1486 long long uf;
1487 if (!PyArg_ParseTuple(args, "L", &uf)) {
1488 return NULL;
1491 if (uf > UINT32_MAX) {
1492 return PyErr_Format(PyExc_OverflowError, "No UF_ flags are over UINT32_MAX");
1494 if (uf < 0) {
1495 return PyErr_Format(PyExc_KeyError, "No UF_ flags are less then zero");
1498 str = dsdb_user_account_control_flag_bit_to_string(uf);
1499 if (str == NULL) {
1500 return PyErr_Format(PyExc_KeyError,
1501 "No such UF_ flag 0x%08x",
1502 (unsigned int)uf);
1504 return PyUnicode_FromString(str);
1507 static PyObject *py_dsdb_check_and_update_fl(PyObject *self, PyObject *args)
1509 TALLOC_CTX *frame = NULL;
1511 PyObject *py_ldb = NULL, *py_lp = NULL;
1512 struct ldb_context *ldb = NULL;
1513 struct loadparm_context *lp_ctx = NULL;
1515 int ret;
1517 if (!PyArg_ParseTuple(args, "OO", &py_ldb, &py_lp)) {
1518 return NULL;
1521 PyErr_LDB_OR_RAISE(py_ldb, ldb);
1523 frame = talloc_stackframe();
1525 lp_ctx = lpcfg_from_py_object(frame, py_lp);
1526 if (lp_ctx == NULL) {
1527 TALLOC_FREE(frame);
1528 return NULL;
1531 ret = dsdb_check_and_update_fl(ldb, lp_ctx);
1532 TALLOC_FREE(frame);
1534 PyErr_LDB_ERROR_IS_ERR_RAISE(py_ldb_get_exception(), ret, ldb);
1536 Py_RETURN_NONE;
1539 static PyObject *py_dsdb_dc_operatingSystemVersion(PyObject *self, PyObject *args)
1541 const char *str = NULL;
1542 int dc_level = 0;
1544 if (!PyArg_ParseTuple(args, "i", &dc_level)) {
1545 return NULL;
1548 str = dsdb_dc_operatingSystemVersion(dc_level);
1549 if (str == NULL) {
1550 return PyErr_Format(PyExc_KeyError,
1551 "dsdb_dc_operatingSystemVersion(%d) failed",
1552 dc_level);
1555 return PyUnicode_FromString(str);
1558 static PyMethodDef py_dsdb_methods[] = {
1559 { "_samdb_server_site_name", (PyCFunction)py_samdb_server_site_name,
1560 METH_VARARGS, "Get the server site name as a string"},
1561 { "_dsdb_convert_schema_to_openldap",
1562 (PyCFunction)py_dsdb_convert_schema_to_openldap, METH_VARARGS,
1563 "dsdb_convert_schema_to_openldap(ldb, target_str, mapping) -> str\n"
1564 "Create an OpenLDAP schema from a schema." },
1565 { "_samdb_set_domain_sid", (PyCFunction)py_samdb_set_domain_sid,
1566 METH_VARARGS,
1567 "samdb_set_domain_sid(samdb, sid)\n"
1568 "Set SID of domain to use." },
1569 { "_samdb_get_domain_sid", (PyCFunction)py_samdb_get_domain_sid,
1570 METH_VARARGS,
1571 "samdb_get_domain_sid(samdb)\n"
1572 "Get SID of domain in use." },
1573 { "_samdb_ntds_invocation_id", (PyCFunction)py_samdb_ntds_invocation_id,
1574 METH_VARARGS, "get the NTDS invocation ID GUID as a string"},
1575 { "_samdb_set_ntds_settings_dn", (PyCFunction)py_samdb_set_ntds_settings_dn,
1576 METH_VARARGS,
1577 "samdb_set_ntds_settings_dn(samdb, ntds_settings_dn)\n"
1578 "Set NTDS Settings DN for this LDB (allows it to be set before the DB fully exists)." },
1579 { "_dsdb_get_oid_from_attid", (PyCFunction)py_dsdb_get_oid_from_attid,
1580 METH_VARARGS, NULL },
1581 { "_dsdb_get_attid_from_lDAPDisplayName", (PyCFunction)py_dsdb_get_attid_from_lDAPDisplayName,
1582 METH_VARARGS, NULL },
1583 { "_dsdb_get_syntax_oid_from_lDAPDisplayName", (PyCFunction)py_dsdb_get_syntax_oid_from_lDAPDisplayName,
1584 METH_VARARGS, NULL },
1585 { "_dsdb_get_systemFlags_from_lDAPDisplayName", (PyCFunction)py_dsdb_get_systemFlags_from_lDAPDisplayName,
1586 METH_VARARGS, NULL },
1587 { "_dsdb_get_linkId_from_lDAPDisplayName", (PyCFunction)py_dsdb_get_linkId_from_lDAPDisplayName,
1588 METH_VARARGS, NULL },
1589 { "_dsdb_get_lDAPDisplayName_by_attid", (PyCFunction)py_dsdb_get_lDAPDisplayName_by_attid,
1590 METH_VARARGS, NULL },
1591 { "_dsdb_get_backlink_from_lDAPDisplayName", (PyCFunction)py_dsdb_get_backlink_from_lDAPDisplayName,
1592 METH_VARARGS, NULL },
1593 { "_dsdb_set_ntds_invocation_id",
1594 (PyCFunction)py_dsdb_set_ntds_invocation_id, METH_VARARGS,
1595 NULL },
1596 { "_samdb_ntds_objectGUID", (PyCFunction)py_samdb_ntds_objectGUID,
1597 METH_VARARGS, "get the NTDS objectGUID as a string"},
1598 { "_dsdb_set_global_schema", (PyCFunction)py_dsdb_set_global_schema,
1599 METH_VARARGS, NULL },
1600 { "_dsdb_load_partition_usn", (PyCFunction)py_dsdb_load_partition_usn,
1601 METH_VARARGS,
1602 "get uSNHighest and uSNUrgent from the partition @REPLCHANGED"},
1603 { "_dsdb_set_am_rodc",
1604 (PyCFunction)py_dsdb_set_am_rodc, METH_VARARGS,
1605 NULL },
1606 { "_am_rodc",
1607 (PyCFunction)py_dsdb_am_rodc, METH_VARARGS,
1608 NULL },
1609 { "_am_pdc",
1610 (PyCFunction)py_dsdb_am_pdc, METH_VARARGS,
1611 NULL },
1612 { "_dsdb_set_schema_from_ldif", (PyCFunction)py_dsdb_set_schema_from_ldif, METH_VARARGS,
1613 NULL },
1614 { "_dsdb_set_schema_from_ldb", (PyCFunction)py_dsdb_set_schema_from_ldb, METH_VARARGS,
1615 NULL },
1616 { "_dsdb_write_prefixes_from_schema_to_ldb", (PyCFunction)py_dsdb_write_prefixes_from_schema_to_ldb, METH_VARARGS,
1617 NULL },
1618 { "_dsdb_get_partitions_dn", (PyCFunction)py_dsdb_get_partitions_dn, METH_VARARGS, NULL },
1619 { "_dsdb_get_nc_root", (PyCFunction)py_dsdb_get_nc_root, METH_VARARGS, NULL },
1620 { "_dsdb_get_wellknown_dn", (PyCFunction)py_dsdb_get_wellknown_dn, METH_VARARGS, NULL },
1621 { "_dsdb_DsReplicaAttribute", (PyCFunction)py_dsdb_DsReplicaAttribute, METH_VARARGS, NULL },
1622 { "_dsdb_normalise_attributes", (PyCFunction)py_dsdb_normalise_attributes, METH_VARARGS, NULL },
1623 #ifdef AD_DC_BUILD_IS_ENABLED
1624 { "_dsdb_garbage_collect_tombstones", (PyCFunction)py_dsdb_garbage_collect_tombstones, METH_VARARGS,
1625 "_dsdb_kcc_check_deleted(samdb, [dn], current_time, tombstone_lifetime)"
1626 " -> (num_objects_expunged, num_links_expunged)" },
1627 { "_scavenge_dns_records", (PyCFunction)py_scavenge_dns_records,
1628 METH_VARARGS, NULL},
1629 { "_dns_delete_tombstones", (PyCFunction)py_dns_delete_tombstones,
1630 METH_VARARGS, NULL},
1631 #else
1632 { "_dsdb_garbage_collect_tombstones", (PyCFunction)py_dsdb_not_implemented,
1633 METH_VARARGS, NULL},
1634 { "_scavenge_dns_records", (PyCFunction)py_dsdb_not_implemented,
1635 METH_VARARGS, NULL},
1636 { "_dns_delete_tombstones", (PyCFunction)py_dsdb_not_implemented,
1637 METH_VARARGS, NULL},
1638 #endif
1639 { "_dsdb_create_gkdi_root_key",
1640 (PyCFunction)py_dsdb_create_gkdi_root_key,
1641 METH_VARARGS | METH_KEYWORDS,
1642 PyDoc_STR("_dsdb_create_gkdi_root_key(samdb)"
1643 " -> Dn of the new root key") },
1644 { "_dsdb_create_own_rid_set", (PyCFunction)py_dsdb_create_own_rid_set, METH_VARARGS,
1645 "_dsdb_create_own_rid_set(samdb)"
1646 " -> None" },
1647 { "_dsdb_allocate_rid", (PyCFunction)py_dsdb_allocate_rid, METH_VARARGS,
1648 "_dsdb_allocate_rid(samdb)"
1649 " -> RID" },
1650 { "_dsdb_load_udv_v2", (PyCFunction)py_dsdb_load_udv_v2, METH_VARARGS, NULL },
1651 { "user_account_control_flag_bit_to_string",
1652 (PyCFunction)py_dsdb_user_account_control_flag_bit_to_string,
1653 METH_VARARGS,
1654 "user_account_control_flag_bit_to_string(bit)"
1655 " -> string name" },
1656 { "check_and_update_fl",
1657 (PyCFunction)py_dsdb_check_and_update_fl,
1658 METH_VARARGS,
1659 "check_and_update_fl(ldb, lp) -> None\n"
1660 "Hook to run in testing the code run on samba server startup "
1661 "to validate and update DC functional levels"},
1662 { "dc_operatingSystemVersion",
1663 (PyCFunction)py_dsdb_dc_operatingSystemVersion,
1664 METH_VARARGS,
1665 "dsdb_dc_operatingSystemVersion(dc_level)"
1666 " -> string name" },
1670 static struct PyModuleDef moduledef = {
1671 PyModuleDef_HEAD_INIT,
1672 .m_name = "dsdb",
1673 .m_doc = "Python bindings for the directory service databases.",
1674 .m_size = -1,
1675 .m_methods = py_dsdb_methods,
1678 MODULE_INIT_FUNC(dsdb)
1680 PyObject *m;
1682 m = PyModule_Create(&moduledef);
1684 if (m == NULL)
1685 return NULL;
1687 #define ADD_DSDB_FLAG(val) PyModule_AddObject(m, #val, PyLong_FromLong(val))
1689 /* "userAccountControl" flags */
1690 ADD_DSDB_FLAG(UF_NORMAL_ACCOUNT);
1691 ADD_DSDB_FLAG(UF_TEMP_DUPLICATE_ACCOUNT);
1692 ADD_DSDB_FLAG(UF_SERVER_TRUST_ACCOUNT);
1693 ADD_DSDB_FLAG(UF_WORKSTATION_TRUST_ACCOUNT);
1694 ADD_DSDB_FLAG(UF_INTERDOMAIN_TRUST_ACCOUNT);
1695 ADD_DSDB_FLAG(UF_PASSWD_NOTREQD);
1696 ADD_DSDB_FLAG(UF_ACCOUNTDISABLE);
1698 ADD_DSDB_FLAG(UF_SCRIPT);
1699 ADD_DSDB_FLAG(UF_ACCOUNTDISABLE);
1700 ADD_DSDB_FLAG(UF_00000004);
1701 ADD_DSDB_FLAG(UF_HOMEDIR_REQUIRED);
1702 ADD_DSDB_FLAG(UF_LOCKOUT);
1703 ADD_DSDB_FLAG(UF_PASSWD_NOTREQD);
1704 ADD_DSDB_FLAG(UF_PASSWD_CANT_CHANGE);
1705 ADD_DSDB_FLAG(UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED);
1706 ADD_DSDB_FLAG(UF_TEMP_DUPLICATE_ACCOUNT);
1707 ADD_DSDB_FLAG(UF_NORMAL_ACCOUNT);
1708 ADD_DSDB_FLAG(UF_00000400);
1709 ADD_DSDB_FLAG(UF_INTERDOMAIN_TRUST_ACCOUNT);
1710 ADD_DSDB_FLAG(UF_WORKSTATION_TRUST_ACCOUNT);
1711 ADD_DSDB_FLAG(UF_SERVER_TRUST_ACCOUNT);
1712 ADD_DSDB_FLAG(UF_00004000);
1713 ADD_DSDB_FLAG(UF_00008000);
1714 ADD_DSDB_FLAG(UF_DONT_EXPIRE_PASSWD);
1715 ADD_DSDB_FLAG(UF_MNS_LOGON_ACCOUNT);
1716 ADD_DSDB_FLAG(UF_SMARTCARD_REQUIRED);
1717 ADD_DSDB_FLAG(UF_TRUSTED_FOR_DELEGATION);
1718 ADD_DSDB_FLAG(UF_NOT_DELEGATED);
1719 ADD_DSDB_FLAG(UF_USE_DES_KEY_ONLY);
1720 ADD_DSDB_FLAG(UF_DONT_REQUIRE_PREAUTH);
1721 ADD_DSDB_FLAG(UF_PASSWORD_EXPIRED);
1722 ADD_DSDB_FLAG(UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION);
1723 ADD_DSDB_FLAG(UF_NO_AUTH_DATA_REQUIRED);
1724 ADD_DSDB_FLAG(UF_PARTIAL_SECRETS_ACCOUNT);
1725 ADD_DSDB_FLAG(UF_USE_AES_KEYS);
1727 /* groupType flags */
1728 ADD_DSDB_FLAG(GTYPE_SECURITY_BUILTIN_LOCAL_GROUP);
1729 ADD_DSDB_FLAG(GTYPE_SECURITY_GLOBAL_GROUP);
1730 ADD_DSDB_FLAG(GTYPE_SECURITY_DOMAIN_LOCAL_GROUP);
1731 ADD_DSDB_FLAG(GTYPE_SECURITY_UNIVERSAL_GROUP);
1732 ADD_DSDB_FLAG(GTYPE_DISTRIBUTION_GLOBAL_GROUP);
1733 ADD_DSDB_FLAG(GTYPE_DISTRIBUTION_DOMAIN_LOCAL_GROUP);
1734 ADD_DSDB_FLAG(GTYPE_DISTRIBUTION_UNIVERSAL_GROUP);
1736 /* "sAMAccountType" flags */
1737 ADD_DSDB_FLAG(ATYPE_NORMAL_ACCOUNT);
1738 ADD_DSDB_FLAG(ATYPE_WORKSTATION_TRUST);
1739 ADD_DSDB_FLAG(ATYPE_INTERDOMAIN_TRUST);
1740 ADD_DSDB_FLAG(ATYPE_SECURITY_GLOBAL_GROUP);
1741 ADD_DSDB_FLAG(ATYPE_SECURITY_LOCAL_GROUP);
1742 ADD_DSDB_FLAG(ATYPE_SECURITY_UNIVERSAL_GROUP);
1743 ADD_DSDB_FLAG(ATYPE_DISTRIBUTION_GLOBAL_GROUP);
1744 ADD_DSDB_FLAG(ATYPE_DISTRIBUTION_LOCAL_GROUP);
1745 ADD_DSDB_FLAG(ATYPE_DISTRIBUTION_UNIVERSAL_GROUP);
1747 /* "domainFunctionality", "forestFunctionality" flags in the rootDSE */
1748 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2000);
1749 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2003_MIXED);
1750 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2003);
1751 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2008);
1752 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2008_R2);
1753 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2012);
1754 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2012_R2);
1755 ADD_DSDB_FLAG(DS_DOMAIN_FUNCTION_2016);
1757 /* nc replica flags */
1758 ADD_DSDB_FLAG(INSTANCE_TYPE_IS_NC_HEAD);
1759 ADD_DSDB_FLAG(INSTANCE_TYPE_UNINSTANT);
1760 ADD_DSDB_FLAG(INSTANCE_TYPE_WRITE);
1761 ADD_DSDB_FLAG(INSTANCE_TYPE_NC_ABOVE);
1762 ADD_DSDB_FLAG(INSTANCE_TYPE_NC_COMING);
1763 ADD_DSDB_FLAG(INSTANCE_TYPE_NC_GOING);
1765 /* "systemFlags" */
1766 ADD_DSDB_FLAG(SYSTEM_FLAG_CR_NTDS_NC);
1767 ADD_DSDB_FLAG(SYSTEM_FLAG_CR_NTDS_DOMAIN);
1768 ADD_DSDB_FLAG(SYSTEM_FLAG_CR_NTDS_NOT_GC_REPLICATED);
1769 ADD_DSDB_FLAG(SYSTEM_FLAG_SCHEMA_BASE_OBJECT);
1770 ADD_DSDB_FLAG(SYSTEM_FLAG_ATTR_IS_RDN);
1771 ADD_DSDB_FLAG(SYSTEM_FLAG_DISALLOW_MOVE_ON_DELETE);
1772 ADD_DSDB_FLAG(SYSTEM_FLAG_DOMAIN_DISALLOW_MOVE);
1773 ADD_DSDB_FLAG(SYSTEM_FLAG_DOMAIN_DISALLOW_RENAME);
1774 ADD_DSDB_FLAG(SYSTEM_FLAG_CONFIG_ALLOW_LIMITED_MOVE);
1775 ADD_DSDB_FLAG(SYSTEM_FLAG_CONFIG_ALLOW_MOVE);
1776 ADD_DSDB_FLAG(SYSTEM_FLAG_CONFIG_ALLOW_RENAME);
1777 ADD_DSDB_FLAG(SYSTEM_FLAG_DISALLOW_DELETE);
1779 /* Kerberos encryption type constants */
1780 ADD_DSDB_FLAG(ENC_ALL_TYPES);
1781 ADD_DSDB_FLAG(ENC_CRC32);
1782 ADD_DSDB_FLAG(ENC_RSA_MD5);
1783 ADD_DSDB_FLAG(ENC_RC4_HMAC_MD5);
1784 ADD_DSDB_FLAG(ENC_HMAC_SHA1_96_AES128);
1785 ADD_DSDB_FLAG(ENC_HMAC_SHA1_96_AES256);
1786 ADD_DSDB_FLAG(ENC_HMAC_SHA1_96_AES256_SK);
1788 ADD_DSDB_FLAG(SEARCH_FLAG_ATTINDEX);
1789 ADD_DSDB_FLAG(SEARCH_FLAG_PDNTATTINDEX);
1790 ADD_DSDB_FLAG(SEARCH_FLAG_ANR);
1791 ADD_DSDB_FLAG(SEARCH_FLAG_PRESERVEONDELETE);
1792 ADD_DSDB_FLAG(SEARCH_FLAG_COPY);
1793 ADD_DSDB_FLAG(SEARCH_FLAG_TUPLEINDEX);
1794 ADD_DSDB_FLAG(SEARCH_FLAG_SUBTREEATTRINDEX);
1795 ADD_DSDB_FLAG(SEARCH_FLAG_CONFIDENTIAL);
1796 ADD_DSDB_FLAG(SEARCH_FLAG_NEVERVALUEAUDIT);
1797 ADD_DSDB_FLAG(SEARCH_FLAG_RODC_ATTRIBUTE);
1799 ADD_DSDB_FLAG(DS_FLAG_ATTR_NOT_REPLICATED);
1800 ADD_DSDB_FLAG(DS_FLAG_ATTR_REQ_PARTIAL_SET_MEMBER);
1801 ADD_DSDB_FLAG(DS_FLAG_ATTR_IS_CONSTRUCTED);
1803 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_AUTO_TOPOLOGY_DISABLED);
1804 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_TOPL_CLEANUP_DISABLED);
1805 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_TOPL_MIN_HOPS_DISABLED);
1806 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_TOPL_DETECT_STALE_DISABLED);
1807 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_INTER_SITE_AUTO_TOPOLOGY_DISABLED);
1808 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_GROUP_CACHING_ENABLED);
1809 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_FORCE_KCC_WHISTLER_BEHAVIOR);
1810 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_RAND_BH_SELECTION_DISABLED);
1811 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_SCHEDULE_HASHING_ENABLED);
1812 ADD_DSDB_FLAG(DS_NTDSSETTINGS_OPT_IS_REDUNDANT_SERVER_TOPOLOGY_ENABLED);
1814 ADD_DSDB_FLAG(DS_NTDSDSA_OPT_IS_GC);
1815 ADD_DSDB_FLAG(DS_NTDSDSA_OPT_DISABLE_INBOUND_REPL);
1816 ADD_DSDB_FLAG(DS_NTDSDSA_OPT_DISABLE_OUTBOUND_REPL);
1817 ADD_DSDB_FLAG(DS_NTDSDSA_OPT_DISABLE_NTDSCONN_XLATE);
1818 ADD_DSDB_FLAG(DS_NTDSDSA_OPT_DISABLE_SPN_REGISTRATION);
1820 /* dsHeuristics character indexes (see MS-ADTS 7.1.1.2.4.1.2) */
1821 ADD_DSDB_FLAG(DS_HR_SUPFIRSTLASTANR);
1822 ADD_DSDB_FLAG(DS_HR_SUPLASTFIRSTANR);
1823 ADD_DSDB_FLAG(DS_HR_DOLISTOBJECT);
1824 ADD_DSDB_FLAG(DS_HR_DONICKRES);
1825 ADD_DSDB_FLAG(DS_HR_LDAP_USEPERMMOD);
1826 ADD_DSDB_FLAG(DS_HR_HIDEDSID);
1827 ADD_DSDB_FLAG(DS_HR_BLOCK_ANONYMOUS_OPS);
1828 ADD_DSDB_FLAG(DS_HR_ALLOW_ANON_NSPI);
1829 ADD_DSDB_FLAG(DS_HR_USER_PASSWORD_SUPPORT);
1830 ADD_DSDB_FLAG(DS_HR_TENTH_CHAR);
1831 ADD_DSDB_FLAG(DS_HR_SPECIFY_GUID_ON_ADD);
1832 ADD_DSDB_FLAG(DS_HR_NO_STANDARD_SD);
1833 ADD_DSDB_FLAG(DS_HR_ALLOW_NONSECURE_PWD_OPS);
1834 ADD_DSDB_FLAG(DS_HR_NO_PROPAGATE_ON_NOCHANGE);
1835 ADD_DSDB_FLAG(DS_HR_COMPUTE_ANR_STATS);
1836 ADD_DSDB_FLAG(DS_HR_ADMINSDEXMASK);
1837 ADD_DSDB_FLAG(DS_HR_KVNOEMUW2K);
1839 ADD_DSDB_FLAG(DS_HR_TWENTIETH_CHAR);
1840 ADD_DSDB_FLAG(DS_HR_ATTR_AUTHZ_ON_LDAP_ADD);
1841 ADD_DSDB_FLAG(DS_HR_BLOCK_OWNER_IMPLICIT_RIGHTS);
1842 ADD_DSDB_FLAG(DS_HR_THIRTIETH_CHAR);
1843 ADD_DSDB_FLAG(DS_HR_FOURTIETH_CHAR);
1844 ADD_DSDB_FLAG(DS_HR_FIFTIETH_CHAR);
1845 ADD_DSDB_FLAG(DS_HR_SIXTIETH_CHAR);
1846 ADD_DSDB_FLAG(DS_HR_SEVENTIETH_CHAR);
1847 ADD_DSDB_FLAG(DS_HR_EIGHTIETH_CHAR);
1848 ADD_DSDB_FLAG(DS_HR_NINETIETH_CHAR);
1850 ADD_DSDB_FLAG(NTDSCONN_KCC_GC_TOPOLOGY);
1851 ADD_DSDB_FLAG(NTDSCONN_KCC_RING_TOPOLOGY);
1852 ADD_DSDB_FLAG(NTDSCONN_KCC_MINIMIZE_HOPS_TOPOLOGY);
1853 ADD_DSDB_FLAG(NTDSCONN_KCC_STALE_SERVERS_TOPOLOGY);
1854 ADD_DSDB_FLAG(NTDSCONN_KCC_OSCILLATING_CONNECTION_TOPOLOGY);
1855 ADD_DSDB_FLAG(NTDSCONN_KCC_INTERSITE_GC_TOPOLOGY);
1856 ADD_DSDB_FLAG(NTDSCONN_KCC_INTERSITE_TOPOLOGY);
1857 ADD_DSDB_FLAG(NTDSCONN_KCC_SERVER_FAILOVER_TOPOLOGY);
1858 ADD_DSDB_FLAG(NTDSCONN_KCC_SITE_FAILOVER_TOPOLOGY);
1859 ADD_DSDB_FLAG(NTDSCONN_KCC_REDUNDANT_SERVER_TOPOLOGY);
1861 ADD_DSDB_FLAG(NTDSCONN_OPT_IS_GENERATED);
1862 ADD_DSDB_FLAG(NTDSCONN_OPT_TWOWAY_SYNC);
1863 ADD_DSDB_FLAG(NTDSCONN_OPT_OVERRIDE_NOTIFY_DEFAULT);
1864 ADD_DSDB_FLAG(NTDSCONN_OPT_USE_NOTIFY);
1865 ADD_DSDB_FLAG(NTDSCONN_OPT_DISABLE_INTERSITE_COMPRESSION);
1866 ADD_DSDB_FLAG(NTDSCONN_OPT_USER_OWNED_SCHEDULE);
1867 ADD_DSDB_FLAG(NTDSCONN_OPT_RODC_TOPOLOGY);
1869 /* Site Link Object options */
1870 ADD_DSDB_FLAG(NTDSSITELINK_OPT_USE_NOTIFY);
1871 ADD_DSDB_FLAG(NTDSSITELINK_OPT_TWOWAY_SYNC);
1872 ADD_DSDB_FLAG(NTDSSITELINK_OPT_DISABLE_COMPRESSION);
1874 /* GPO policy flags */
1875 ADD_DSDB_FLAG(GPLINK_OPT_DISABLE);
1876 ADD_DSDB_FLAG(GPLINK_OPT_ENFORCE);
1877 ADD_DSDB_FLAG(GPO_FLAG_USER_DISABLE);
1878 ADD_DSDB_FLAG(GPO_FLAG_MACHINE_DISABLE);
1879 ADD_DSDB_FLAG(GPO_INHERIT);
1880 ADD_DSDB_FLAG(GPO_BLOCK_INHERITANCE);
1882 #define ADD_DSDB_STRING(val) PyModule_AddObject(m, #val, PyUnicode_FromString(val))
1884 ADD_DSDB_STRING(DSDB_SYNTAX_BINARY_DN);
1885 ADD_DSDB_STRING(DSDB_SYNTAX_STRING_DN);
1886 ADD_DSDB_STRING(DSDB_SYNTAX_OR_NAME);
1887 ADD_DSDB_STRING(DSDB_CONTROL_DBCHECK);
1888 ADD_DSDB_STRING(DSDB_CONTROL_DBCHECK_MODIFY_RO_REPLICA);
1889 ADD_DSDB_STRING(DSDB_CONTROL_DBCHECK_FIX_DUPLICATE_LINKS);
1890 ADD_DSDB_STRING(DSDB_CONTROL_DBCHECK_FIX_LINK_DN_NAME);
1891 ADD_DSDB_STRING(DSDB_CONTROL_DBCHECK_FIX_LINK_DN_SID);
1892 ADD_DSDB_STRING(DSDB_CONTROL_REPLMD_VANISH_LINKS);
1893 ADD_DSDB_STRING(DSDB_CONTROL_PERMIT_INTERDOMAIN_TRUST_UAC_OID);
1894 ADD_DSDB_STRING(DSDB_CONTROL_SKIP_DUPLICATES_CHECK_OID);
1895 ADD_DSDB_STRING(DSDB_CONTROL_BYPASS_PASSWORD_HASH_OID);
1896 ADD_DSDB_STRING(DSDB_CONTROL_INVALID_NOT_IMPLEMENTED);
1898 ADD_DSDB_STRING(DS_GUID_COMPUTERS_CONTAINER);
1899 ADD_DSDB_STRING(DS_GUID_DELETED_OBJECTS_CONTAINER);
1900 ADD_DSDB_STRING(DS_GUID_DOMAIN_CONTROLLERS_CONTAINER);
1901 ADD_DSDB_STRING(DS_GUID_FOREIGNSECURITYPRINCIPALS_CONTAINER);
1902 ADD_DSDB_STRING(DS_GUID_INFRASTRUCTURE_CONTAINER);
1903 ADD_DSDB_STRING(DS_GUID_LOSTANDFOUND_CONTAINER);
1904 ADD_DSDB_STRING(DS_GUID_MICROSOFT_PROGRAM_DATA_CONTAINER);
1905 ADD_DSDB_STRING(DS_GUID_NTDS_QUOTAS_CONTAINER);
1906 ADD_DSDB_STRING(DS_GUID_PROGRAM_DATA_CONTAINER);
1907 ADD_DSDB_STRING(DS_GUID_SYSTEMS_CONTAINER);
1908 ADD_DSDB_STRING(DS_GUID_USERS_CONTAINER);
1909 ADD_DSDB_STRING(DS_GUID_MANAGED_SERVICE_ACCOUNTS_CONTAINER);
1911 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_DEPARTMENT);
1912 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_DNS_HOST_NAME);
1913 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_INSTANCE_TYPE);
1914 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_MS_SFU_30);
1915 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_NT_SECURITY_DESCRIPTOR);
1916 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_PRIMARY_GROUP_ID);
1917 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_SERVICE_PRINCIPAL_NAME);
1918 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_USER_ACCOUNT_CONTROL);
1919 ADD_DSDB_STRING(DS_GUID_SCHEMA_ATTR_USER_PASSWORD);
1920 ADD_DSDB_STRING(DS_GUID_SCHEMA_CLASS_COMPUTER);
1921 ADD_DSDB_STRING(DS_GUID_SCHEMA_CLASS_MANAGED_SERVICE_ACCOUNT);
1922 ADD_DSDB_STRING(DS_GUID_SCHEMA_CLASS_USER);
1924 ADD_DSDB_STRING(DSDB_FULL_JOIN_REPLICATION_COMPLETED_OPAQUE_NAME);
1926 return m;