2 Unix SMB/CIFS implementation.
6 Copyright (C) 2005,2006 Tim Potter <tpot@samba.org>
7 Copyright (C) 2006 Simo Sorce <idra@samba.org>
8 Copyright (C) 2007-2008 Jelmer Vernooij <jelmer@samba.org>
10 ** NOTE! The following LGPL license applies to the ldb
11 ** library. This does NOT imply that all of Samba is released
14 This library is free software; you can redistribute it and/or
15 modify it under the terms of the GNU Lesser General Public
16 License as published by the Free Software Foundation; either
17 version 3 of the License, or (at your option) any later version.
19 This library is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22 Lesser General Public License for more details.
24 You should have received a copy of the GNU Lesser General Public
25 License along with this library; if not, see <http://www.gnu.org/licenses/>.
33 #include "ldb_errors.h"
34 #include "ldb_private.h"
36 PyObject *PyExc_LdbError;
38 void PyErr_SetLdbError(int ret, struct ldb_context *ldb_ctx)
40 PyErr_SetObject(PyExc_LdbError, Py_BuildValue((char *)"(i,s)", ret, ldb_ctx == NULL?ldb_strerror(ret):ldb_errstring(ldb_ctx)));
42 PyObject *PyObject_FromLdbValue(struct ldb_context *ldb_ctx,
43 struct ldb_message_element *el,
46 const struct ldb_schema_attribute *a;
47 struct ldb_val new_val;
48 TALLOC_CTX *mem_ctx = talloc_new(NULL);
53 if (ldb_ctx != NULL) {
54 a = ldb_schema_attribute_by_name(ldb_ctx, el->name);
57 if (a->syntax->ldif_write_fn(ldb_ctx, mem_ctx, val, &new_val) != 0) {
64 ret = PyString_FromStringAndSize((const char *)new_val.data, new_val.length);
71 bool PyObject_AsDn(TALLOC_CTX *mem_ctx, PyObject *object,
72 struct ldb_context *ldb_ctx, struct ldb_dn **dn)
76 if (ldb_ctx != NULL && PyString_Check(object)) {
77 odn = ldb_dn_new(mem_ctx, ldb_ctx, PyString_AsString(object));
82 if (PyLdbDn_Check(object)) {
83 *dn = PyLdbDn_AsDn(object);
87 PyErr_SetString(PyExc_TypeError, "Expected DN");
91 static PyObject *PyLdbResult_FromResult(struct ldb_result *result)
98 ret = PyList_New(result->count);
99 for (i = 0; i < result->count; i++) {
100 PyList_SetItem(ret, i,
101 PyLdbMessage_FromMessage(result->msgs[i])
107 static struct ldb_result *PyLdbResult_AsResult(TALLOC_CTX *mem_ctx, PyObject *obj)
109 struct ldb_result *res;
115 res = talloc_zero(mem_ctx, struct ldb_result);
116 res->count = PyList_Size(obj);
117 res->msgs = talloc_array(res, struct ldb_message *, res->count);
118 for (i = 0; i < res->count; i++) {
119 PyObject *item = PyList_GetItem(obj, i);
120 res->msgs[i] = PyLdbMessage_AsMessage(item);
125 static PyObject *py_ldb_dn_validate(PyLdbDnObject *self)
127 return PyBool_FromLong(ldb_dn_validate(self->ptr));
130 static PyObject *py_ldb_dn_is_valid(PyLdbDnObject *self)
132 return PyBool_FromLong(ldb_dn_is_valid(self->ptr));
135 static PyObject *py_ldb_dn_is_special(PyLdbDnObject *self)
137 return PyBool_FromLong(ldb_dn_is_special(self->ptr));
140 static PyObject *py_ldb_dn_is_null(PyLdbDnObject *self)
142 return PyBool_FromLong(ldb_dn_is_null(self->ptr));
145 static PyObject *py_ldb_dn_get_casefold(PyLdbDnObject *self)
147 return PyString_FromString(ldb_dn_get_casefold(self->ptr));
150 static PyObject *py_ldb_dn_get_linearized(PyLdbDnObject *self)
152 return PyString_FromString(ldb_dn_get_linearized(self->ptr));
155 static PyObject *py_ldb_dn_canonical_str(PyLdbDnObject *self)
157 return PyString_FromString(ldb_dn_canonical_string(self->ptr, self->ptr));
160 static PyObject *py_ldb_dn_canonical_ex_str(PyLdbDnObject *self)
162 return PyString_FromString(ldb_dn_canonical_ex_string(self->ptr, self->ptr));
165 static PyObject *py_ldb_dn_repr(PyLdbDnObject *self)
167 return PyString_FromFormat("Dn(%s)", PyObject_REPR(PyString_FromString(ldb_dn_get_linearized(self->ptr))));
170 static PyObject *py_ldb_dn_check_special(PyLdbDnObject *self, PyObject *args)
174 if (!PyArg_ParseTuple(args, "s", &name))
177 return ldb_dn_check_special(self->ptr, name)?Py_True:Py_False;
180 static int py_ldb_dn_compare(PyLdbDnObject *dn1, PyLdbDnObject *dn2)
182 return ldb_dn_compare(dn1->ptr, dn2->ptr);
185 static PyObject *py_ldb_dn_get_parent(PyLdbDnObject *self)
187 struct ldb_dn *dn = PyLdbDn_AsDn((PyObject *)self);
188 return PyLdbDn_FromDn(ldb_dn_get_parent(NULL, dn));
191 #define dn_ldb_ctx(dn) ((struct ldb_context *)dn)
193 static PyObject *py_ldb_dn_add_child(PyLdbDnObject *self, PyObject *args)
196 struct ldb_dn *dn, *other;
197 if (!PyArg_ParseTuple(args, "O", &py_other))
200 dn = PyLdbDn_AsDn((PyObject *)self);
202 if (!PyObject_AsDn(NULL, py_other, dn_ldb_ctx(dn), &other))
205 return ldb_dn_add_child(dn, other)?Py_True:Py_False;
208 static PyObject *py_ldb_dn_add_base(PyLdbDnObject *self, PyObject *args)
211 struct ldb_dn *other, *dn;
212 if (!PyArg_ParseTuple(args, "O", &py_other))
215 dn = PyLdbDn_AsDn((PyObject *)self);
217 if (!PyObject_AsDn(NULL, py_other, dn_ldb_ctx(dn), &other))
220 return ldb_dn_add_base(dn, other)?Py_True:Py_False;
223 static PyMethodDef py_ldb_dn_methods[] = {
224 { "validate", (PyCFunction)py_ldb_dn_validate, METH_NOARGS,
225 "S.validate() -> bool\n"
226 "Validate DN is correct." },
227 { "is_valid", (PyCFunction)py_ldb_dn_is_valid, METH_NOARGS,
228 "S.is_valid() -> bool\n" },
229 { "is_special", (PyCFunction)py_ldb_dn_is_special, METH_NOARGS,
230 "S.is_special() -> bool\n"
231 "Check whether this is a special LDB DN." },
232 { "is_null", (PyCFunction)py_ldb_dn_is_null, METH_NOARGS,
233 "Check whether this is a null DN." },
234 { "get_casefold", (PyCFunction)py_ldb_dn_get_casefold, METH_NOARGS,
236 { "get_linearized", (PyCFunction)py_ldb_dn_get_linearized, METH_NOARGS,
238 { "canonical_str", (PyCFunction)py_ldb_dn_canonical_str, METH_NOARGS,
239 "S.canonical_str() -> string\n"
240 "Canonical version of this DN (like a posix path)." },
241 { "canonical_ex_str", (PyCFunction)py_ldb_dn_canonical_ex_str, METH_NOARGS,
242 "S.canonical_ex_str() -> string\n"
243 "Canonical version of this DN (like a posix path, with terminating newline)." },
244 { "check_special", (PyCFunction)py_ldb_dn_is_special, METH_VARARGS,
246 { "parent", (PyCFunction)py_ldb_dn_get_parent, METH_NOARGS,
248 "Get the parent for this DN." },
249 { "add_child", (PyCFunction)py_ldb_dn_add_child, METH_VARARGS,
250 "S.add_child(dn) -> None\n"
251 "Add a child DN to this DN." },
252 { "add_base", (PyCFunction)py_ldb_dn_add_base, METH_VARARGS,
253 "S.add_base(dn) -> None\n"
254 "Add a base DN to this DN." },
255 { "check_special", (PyCFunction)py_ldb_dn_check_special, METH_VARARGS,
260 static Py_ssize_t py_ldb_dn_len(PyLdbDnObject *self)
262 return ldb_dn_get_comp_num(PyLdbDn_AsDn((PyObject *)self));
265 static PyObject *py_ldb_dn_concat(PyLdbDnObject *self, PyObject *py_other)
267 struct ldb_dn *dn = PyLdbDn_AsDn((PyObject *)self),
269 struct ldb_dn *ret = ldb_dn_copy(NULL, dn);
270 if (!PyObject_AsDn(NULL, py_other, NULL, &other))
272 ldb_dn_add_child(ret, other);
273 return PyLdbDn_FromDn(ret);
276 static PySequenceMethods py_ldb_dn_seq = {
277 .sq_length = (lenfunc)py_ldb_dn_len,
278 .sq_concat = (binaryfunc)py_ldb_dn_concat,
281 static PyObject *py_ldb_dn_new(PyTypeObject *type, PyObject *args, PyObject *kwargs)
286 struct ldb_context *ldb_ctx;
287 const char *kwnames[] = { "ldb", "dn", NULL };
289 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "Os", (char **)kwnames, &py_ldb, &str))
292 ldb_ctx = PyLdb_AsLdbContext(py_ldb);
294 ret = ldb_dn_new(ldb_ctx, ldb_ctx, str);
295 /* ldb_dn_new() doesn't accept NULL as memory context, so
296 we do it this way... */
297 talloc_steal(NULL, ret);
299 if (ret == NULL || !ldb_dn_validate(ret)) {
300 PyErr_SetString(PyExc_ValueError, "unable to parse dn string");
304 return py_talloc_import(&PyLdbDn, ret);
307 PyObject *PyLdbDn_FromDn(struct ldb_dn *dn)
309 return py_talloc_import(&PyLdbDn, dn);
312 PyTypeObject PyLdbDn = {
314 .tp_methods = py_ldb_dn_methods,
315 .tp_str = (reprfunc)py_ldb_dn_get_linearized,
316 .tp_repr = (reprfunc)py_ldb_dn_repr,
317 .tp_compare = (cmpfunc)py_ldb_dn_compare,
318 .tp_as_sequence = &py_ldb_dn_seq,
319 .tp_doc = "A LDB distinguished name.",
320 .tp_new = py_ldb_dn_new,
321 .tp_dealloc = py_talloc_dealloc,
322 .tp_basicsize = sizeof(PyLdbObject),
326 static void py_ldb_debug(void *context, enum ldb_debug_level level, const char *fmt, va_list ap) PRINTF_ATTRIBUTE(3, 0);
327 static void py_ldb_debug(void *context, enum ldb_debug_level level, const char *fmt, va_list ap)
329 PyObject *fn = context;
330 PyObject_CallFunction(fn, (char *)"(i,O)", level, PyString_FromFormatV(fmt, ap));
333 static PyObject *py_ldb_set_debug(PyLdbObject *self, PyObject *args)
337 if (!PyArg_ParseTuple(args, "O", &cb))
341 /* FIXME: Where do we DECREF cb ? */
342 PyErr_LDB_ERROR_IS_ERR_RAISE(ldb_set_debug(self->ptr, py_ldb_debug, cb), PyLdb_AsLdbContext(self));
347 static PyObject *py_ldb_set_create_perms(PyTypeObject *self, PyObject *args)
350 if (!PyArg_ParseTuple(args, "I", &perms))
353 ldb_set_create_perms(PyLdb_AsLdbContext(self), perms);
358 static PyObject *py_ldb_set_modules_dir(PyTypeObject *self, PyObject *args)
361 if (!PyArg_ParseTuple(args, "s", &modules_dir))
364 ldb_set_modules_dir(PyLdb_AsLdbContext(self), modules_dir);
369 static PyObject *py_ldb_transaction_start(PyLdbObject *self)
371 PyErr_LDB_ERROR_IS_ERR_RAISE(ldb_transaction_start(PyLdb_AsLdbContext(self)), PyLdb_AsLdbContext(self));
375 static PyObject *py_ldb_transaction_commit(PyLdbObject *self)
377 PyErr_LDB_ERROR_IS_ERR_RAISE(ldb_transaction_commit(PyLdb_AsLdbContext(self)), PyLdb_AsLdbContext(self));
381 static PyObject *py_ldb_transaction_cancel(PyLdbObject *self)
383 PyErr_LDB_ERROR_IS_ERR_RAISE(ldb_transaction_cancel(PyLdb_AsLdbContext(self)), PyLdb_AsLdbContext(self));
387 static PyObject *py_ldb_setup_wellknown_attributes(PyLdbObject *self)
389 PyErr_LDB_ERROR_IS_ERR_RAISE(ldb_setup_wellknown_attributes(PyLdb_AsLdbContext(self)), PyLdb_AsLdbContext(self));
393 static PyObject *py_ldb_repr(PyLdbObject *self)
395 return PyString_FromFormat("<ldb connection>");
398 static PyObject *py_ldb_get_root_basedn(PyLdbObject *self)
400 struct ldb_dn *dn = ldb_get_root_basedn(PyLdb_AsLdbContext(self));
403 return PyLdbDn_FromDn(dn);
407 static PyObject *py_ldb_get_schema_basedn(PyLdbObject *self)
409 struct ldb_dn *dn = ldb_get_schema_basedn(PyLdb_AsLdbContext(self));
412 return PyLdbDn_FromDn(dn);
416 static PyObject *py_ldb_get_config_basedn(PyLdbObject *self)
418 struct ldb_dn *dn = ldb_get_config_basedn(PyLdb_AsLdbContext(self));
421 return PyLdbDn_FromDn(dn);
425 static PyObject *py_ldb_get_default_basedn(PyLdbObject *self)
427 struct ldb_dn *dn = ldb_get_default_basedn(PyLdb_AsLdbContext(self));
430 return PyLdbDn_FromDn(dn);
433 static const char **PyList_AsStringList(TALLOC_CTX *mem_ctx, PyObject *list)
437 if (!PyList_Check(list)) {
438 PyErr_SetString(PyExc_TypeError, "options is not a list");
441 ret = talloc_array(NULL, const char *, PyList_Size(list)+1);
442 for (i = 0; i < PyList_Size(list); i++) {
443 PyObject *item = PyList_GetItem(list, i);
444 if (!PyString_Check(item)) {
445 PyErr_SetString(PyExc_TypeError, "options should be strings");
448 ret[i] = PyString_AsString(item);
454 static int py_ldb_init(PyLdbObject *self, PyObject *args, PyObject *kwargs)
456 const char *kwnames[] = { "url", "flags", "options", NULL };
458 PyObject *py_options = Py_None;
459 const char **options;
462 struct ldb_context *ldb;
464 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "|ziO:Ldb.__init__", (char **)kwnames,
465 &url, &flags, &py_options))
468 ldb = PyLdb_AsLdbContext(self);
470 if (py_options == Py_None) {
473 options = PyList_AsStringList(ldb, py_options);
479 ret = ldb_connect(ldb, url, flags, options);
480 if (ret != LDB_SUCCESS) {
481 PyErr_SetLdbError(ret, ldb);
486 talloc_free(options);
490 static PyObject *py_ldb_new(PyTypeObject *type, PyObject *args, PyObject *kwargs)
492 struct ldb_context *ldb;
493 ldb = ldb_init(NULL, event_context_init(NULL));
499 return py_talloc_import(type, ldb);
502 static PyObject *py_ldb_connect(PyLdbObject *self, PyObject *args, PyObject *kwargs)
506 PyObject *py_options = Py_None;
508 const char **options;
509 const char *kwnames[] = { "url", "flags", "options", NULL };
510 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "s|iO", (char **)kwnames, &url, &flags,
514 if (py_options == Py_None) {
517 options = PyList_AsStringList(NULL, py_options);
522 ret = ldb_connect(PyLdb_AsLdbContext(self), url, flags, options);
523 talloc_free(options);
525 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, PyLdb_AsLdbContext(self));
530 static PyObject *py_ldb_modify(PyLdbObject *self, PyObject *args)
534 if (!PyArg_ParseTuple(args, "O", &py_msg))
537 if (!PyLdbMessage_Check(py_msg)) {
538 PyErr_SetString(PyExc_TypeError, "Expected Ldb Message");
542 ret = ldb_modify(PyLdb_AsLdbContext(self), PyLdbMessage_AsMessage(py_msg));
543 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, PyLdb_AsLdbContext(self));
548 static PyObject *py_ldb_add(PyLdbObject *self, PyObject *args)
552 Py_ssize_t dict_pos, msg_pos;
553 struct ldb_message_element *msgel;
554 struct ldb_message *msg;
555 PyObject *key, *value;
557 if (!PyArg_ParseTuple(args, "O", &py_msg))
560 if (PyDict_Check(py_msg)) {
561 PyObject *dn_value = PyDict_GetItemString(py_msg, "dn");
562 msg = ldb_msg_new(NULL);
563 msg->elements = talloc_zero_array(msg, struct ldb_message_element, PyDict_Size(py_msg));
564 msg_pos = dict_pos = 0;
566 if (!PyObject_AsDn(msg, dn_value, PyLdb_AsLdbContext(self), &msg->dn)) {
567 PyErr_SetString(PyExc_TypeError, "unable to import dn object");
570 if (msg->dn == NULL) {
571 PyErr_SetString(PyExc_TypeError, "dn set but not found");
576 while (PyDict_Next(py_msg, &dict_pos, &key, &value)) {
577 char *key_str = PyString_AsString(key);
578 if (strcmp(key_str, "dn") != 0) {
579 msgel = PyObject_AsMessageElement(msg->elements, value, 0, key_str);
581 PyErr_SetString(PyExc_TypeError, "unable to import element");
584 memcpy(&msg->elements[msg_pos], msgel, sizeof(*msgel));
589 if (msg->dn == NULL) {
590 PyErr_SetString(PyExc_TypeError, "no dn set");
594 msg->num_elements = msg_pos;
596 msg = PyLdbMessage_AsMessage(py_msg);
599 ret = ldb_add(PyLdb_AsLdbContext(self), msg);
600 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, PyLdb_AsLdbContext(self));
607 static PyObject *py_ldb_delete(PyLdbObject *self, PyObject *args)
612 if (!PyArg_ParseTuple(args, "O", &py_dn))
615 if (!PyObject_AsDn(NULL, py_dn, PyLdb_AsLdbContext(self), &dn))
618 ret = ldb_delete(PyLdb_AsLdbContext(self), dn);
619 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, PyLdb_AsLdbContext(self));
624 static PyObject *py_ldb_rename(PyLdbObject *self, PyObject *args)
626 PyObject *py_dn1, *py_dn2;
627 struct ldb_dn *dn1, *dn2;
629 if (!PyArg_ParseTuple(args, "OO", &py_dn1, &py_dn2))
632 if (!PyLdbDn_Check(py_dn1) || !PyLdbDn_Check(py_dn2)) {
633 PyErr_SetString(PyExc_TypeError, "Expected Ldb Dn");
637 if (!PyObject_AsDn(NULL, py_dn1, PyLdb_AsLdbContext(self), &dn1))
640 if (!PyObject_AsDn(NULL, py_dn2, PyLdb_AsLdbContext(self), &dn2))
643 ret = ldb_rename(PyLdb_AsLdbContext(self), dn1, dn2);
644 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, PyLdb_AsLdbContext(self));
649 static PyObject *py_ldb_schema_attribute_remove(PyLdbObject *self, PyObject *args)
652 if (!PyArg_ParseTuple(args, "s", &name))
655 ldb_schema_attribute_remove(PyLdb_AsLdbContext(self), name);
660 static PyObject *py_ldb_schema_attribute_add(PyLdbObject *self, PyObject *args)
662 char *attribute, *syntax;
665 if (!PyArg_ParseTuple(args, "sIs", &attribute, &flags, &syntax))
668 ret = ldb_schema_attribute_add(PyLdb_AsLdbContext(self), attribute, flags, syntax);
670 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, PyLdb_AsLdbContext(self));
675 static PyObject *ldb_ldif_to_pyobject(struct ldb_ldif *ldif)
680 /* We don't want this attached to the 'ldb' any more */
681 talloc_steal(NULL, ldif);
682 return Py_BuildValue((char *)"(iO)", ldif->changetype,
683 PyLdbMessage_FromMessage(ldif->msg));
688 static PyObject *py_ldb_parse_ldif(PyLdbObject *self, PyObject *args)
691 struct ldb_ldif *ldif;
694 if (!PyArg_ParseTuple(args, "s", &s))
697 list = PyList_New(0);
698 while ((ldif = ldb_ldif_read_string(self->ptr, &s)) != NULL) {
699 PyList_Append(list, ldb_ldif_to_pyobject(ldif));
701 return PyObject_GetIter(list);
704 static PyObject *py_ldb_schema_format_value(PyLdbObject *self, PyObject *args)
706 const struct ldb_schema_attribute *a;
707 struct ldb_val old_val;
708 struct ldb_val new_val;
714 if (!PyArg_ParseTuple(args, "sO", &element_name, &val))
717 mem_ctx = talloc_new(NULL);
719 old_val.data = (uint8_t *)PyString_AsString(val);
720 old_val.length = PyString_Size(val);
722 a = ldb_schema_attribute_by_name(PyLdb_AsLdbContext(self), element_name);
728 if (a->syntax->ldif_write_fn(PyLdb_AsLdbContext(self), mem_ctx, &old_val, &new_val) != 0) {
729 talloc_free(mem_ctx);
733 ret = PyString_FromStringAndSize((const char *)new_val.data, new_val.length);
735 talloc_free(mem_ctx);
740 static PyObject *py_ldb_search(PyLdbObject *self, PyObject *args, PyObject *kwargs)
742 PyObject *py_base = Py_None;
743 enum ldb_scope scope = LDB_SCOPE_DEFAULT;
745 PyObject *py_attrs = Py_None;
746 PyObject *py_controls = Py_None;
747 const char *kwnames[] = { "base", "scope", "expression", "attrs", "controls", NULL };
749 struct ldb_result *res;
750 struct ldb_request *req;
752 struct ldb_context *ldb_ctx;
753 struct ldb_control **parsed_controls;
756 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "|OisOO", (char **)kwnames,
757 &py_base, &scope, &expr, &py_attrs, &py_controls))
760 ldb_ctx = PyLdb_AsLdbContext(self);
762 if (py_attrs == Py_None) {
765 attrs = PyList_AsStringList(ldb_ctx, py_attrs);
770 if (py_base == Py_None) {
771 base = ldb_get_default_basedn(ldb_ctx);
773 if (!PyObject_AsDn(ldb_ctx, py_base, ldb_ctx, &base))
777 if (py_controls == Py_None) {
778 parsed_controls = NULL;
780 const char **controls = PyList_AsStringList(ldb_ctx, py_controls);
781 parsed_controls = ldb_parse_control_strings(ldb_ctx, ldb_ctx, controls);
782 talloc_free(controls);
785 res = talloc_zero(ldb_ctx, struct ldb_result);
791 ret = ldb_build_search_req(&req, ldb_ctx, ldb_ctx,
798 ldb_search_default_callback,
801 if (ret != LDB_SUCCESS) {
803 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, ldb_ctx);
807 ret = ldb_request(ldb_ctx, req);
809 if (ret == LDB_SUCCESS) {
810 ret = ldb_wait(req->handle, LDB_WAIT_ALL);
815 return PyLdbResult_FromResult(res);
818 static PyObject *py_ldb_get_opaque(PyLdbObject *self, PyObject *args)
823 if (!PyArg_ParseTuple(args, "s", &name))
826 data = ldb_get_opaque(PyLdb_AsLdbContext(self), name);
828 /* FIXME: More interpretation */
833 static PyObject *py_ldb_set_opaque(PyLdbObject *self, PyObject *args)
838 if (!PyArg_ParseTuple(args, "sO", &name, &data))
841 /* FIXME: More interpretation */
843 ldb_set_opaque(PyLdb_AsLdbContext(self), name, data);
848 static PyMethodDef py_ldb_methods[] = {
849 { "set_debug", (PyCFunction)py_ldb_set_debug, METH_VARARGS,
850 "S.set_debug(callback) -> None\n"
851 "Set callback for LDB debug messages.\n"
852 "The callback should accept a debug level and debug text." },
853 { "set_create_perms", (PyCFunction)py_ldb_set_create_perms, METH_VARARGS,
854 "S.set_create_perms(mode) -> None\n"
855 "Set mode to use when creating new LDB files." },
856 { "set_modules_dir", (PyCFunction)py_ldb_set_modules_dir, METH_VARARGS,
857 "S.set_modules_dir(path) -> None\n"
858 "Set path LDB should search for modules" },
859 { "transaction_start", (PyCFunction)py_ldb_transaction_start, METH_NOARGS,
860 "S.transaction_start() -> None\n"
861 "Start a new transaction." },
862 { "transaction_commit", (PyCFunction)py_ldb_transaction_commit, METH_NOARGS,
863 "S.transaction_commit() -> None\n"
864 "commit a new transaction." },
865 { "transaction_cancel", (PyCFunction)py_ldb_transaction_cancel, METH_NOARGS,
866 "S.transaction_cancel() -> None\n"
867 "cancel a new transaction." },
868 { "setup_wellknown_attributes", (PyCFunction)py_ldb_setup_wellknown_attributes, METH_NOARGS,
870 { "get_root_basedn", (PyCFunction)py_ldb_get_root_basedn, METH_NOARGS,
872 { "get_schema_basedn", (PyCFunction)py_ldb_get_schema_basedn, METH_NOARGS,
874 { "get_default_basedn", (PyCFunction)py_ldb_get_default_basedn, METH_NOARGS,
876 { "get_config_basedn", (PyCFunction)py_ldb_get_config_basedn, METH_NOARGS,
878 { "connect", (PyCFunction)py_ldb_connect, METH_VARARGS|METH_KEYWORDS,
879 "S.connect(url, flags=0, options=None) -> None\n"
880 "Connect to a LDB URL." },
881 { "modify", (PyCFunction)py_ldb_modify, METH_VARARGS,
882 "S.modify(message) -> None\n"
883 "Modify an entry." },
884 { "add", (PyCFunction)py_ldb_add, METH_VARARGS,
885 "S.add(message) -> None\n"
887 { "delete", (PyCFunction)py_ldb_delete, METH_VARARGS,
888 "S.delete(dn) -> None\n"
889 "Remove an entry." },
890 { "rename", (PyCFunction)py_ldb_rename, METH_VARARGS,
891 "S.rename(old_dn, new_dn) -> None\n"
892 "Rename an entry." },
893 { "search", (PyCFunction)py_ldb_search, METH_VARARGS|METH_KEYWORDS,
894 "S.search(base=None, scope=None, expression=None, attrs=None, controls=None) -> msgs\n"
895 "Search in a database.\n"
897 ":param base: Optional base DN to search\n"
898 ":param scope: Search scope (SCOPE_BASE, SCOPE_ONELEVEL or SCOPE_SUBTREE)\n"
899 ":param expression: Optional search expression\n"
900 ":param attrs: Attributes to return (defaults to all)\n"
901 ":param controls: Optional list of controls\n"
902 ":return: Iterator over Message objects\n"
904 { "schema_attribute_remove", (PyCFunction)py_ldb_schema_attribute_remove, METH_VARARGS,
906 { "schema_attribute_add", (PyCFunction)py_ldb_schema_attribute_add, METH_VARARGS,
908 { "schema_format_value", (PyCFunction)py_ldb_schema_format_value, METH_VARARGS,
910 { "parse_ldif", (PyCFunction)py_ldb_parse_ldif, METH_VARARGS,
911 "S.parse_ldif(ldif) -> iter(messages)\n"
912 "Parse a string formatted using LDIF." },
913 { "get_opaque", (PyCFunction)py_ldb_set_opaque, METH_VARARGS,
914 "S.get_opaque(name) -> value\n"
915 "Get an opaque value set on this LDB connection. \n"
916 ":note: The returned value may not be useful in Python."
918 { "set_opaque", (PyCFunction)py_ldb_get_opaque, METH_VARARGS,
919 "S.set_opaque(name, value) -> None\n"
920 "Set an opaque value on this LDB connection. \n"
921 ":note: Passing incorrect values may cause crashes." },
925 PyObject *PyLdbModule_FromModule(struct ldb_module *mod)
927 return py_talloc_import(&PyLdbModule, mod);
930 static PyObject *py_ldb_get_firstmodule(PyLdbObject *self, void *closure)
932 return PyLdbModule_FromModule(PyLdb_AsLdbContext(self)->modules);
935 static PyGetSetDef py_ldb_getset[] = {
936 { (char *)"firstmodule", (getter)py_ldb_get_firstmodule, NULL, NULL },
940 static int py_ldb_contains(PyLdbObject *self, PyObject *obj)
942 struct ldb_context *ldb_ctx = PyLdb_AsLdbContext(self);
944 struct ldb_result *result;
948 if (!PyObject_AsDn(ldb_ctx, obj, ldb_ctx, &dn))
951 ret = ldb_search(ldb_ctx, ldb_ctx, &result, dn, LDB_SCOPE_BASE, NULL, NULL);
952 if (ret != LDB_SUCCESS) {
953 PyErr_SetLdbError(ret, ldb_ctx);
957 count = result->count;
964 static PySequenceMethods py_ldb_seq = {
965 .sq_contains = (objobjproc)py_ldb_contains,
968 PyObject *PyLdb_FromLdbContext(struct ldb_context *ldb_ctx)
970 return py_talloc_import(&PyLdb, ldb_ctx);
973 PyTypeObject PyLdb = {
974 PyObject_HEAD_INIT(NULL)
976 .tp_methods = py_ldb_methods,
977 .tp_repr = (reprfunc)py_ldb_repr,
978 .tp_new = py_ldb_new,
979 .tp_init = (initproc)py_ldb_init,
980 .tp_dealloc = py_talloc_dealloc,
981 .tp_getset = py_ldb_getset,
982 .tp_getattro = PyObject_GenericGetAttr,
983 .tp_basicsize = sizeof(PyLdbObject),
984 .tp_doc = "Connection to a LDB database.",
985 .tp_as_sequence = &py_ldb_seq,
986 .tp_flags = Py_TPFLAGS_DEFAULT|Py_TPFLAGS_BASETYPE,
989 static PyObject *py_ldb_module_repr(PyLdbModuleObject *self)
991 return PyString_FromFormat("<ldb module '%s'>", PyLdbModule_AsModule(self)->ops->name);
994 static PyObject *py_ldb_module_str(PyLdbModuleObject *self)
996 return PyString_FromString(PyLdbModule_AsModule(self)->ops->name);
999 static PyObject *py_ldb_module_start_transaction(PyLdbModuleObject *self)
1001 PyLdbModule_AsModule(self)->ops->start_transaction(PyLdbModule_AsModule(self));
1005 static PyObject *py_ldb_module_end_transaction(PyLdbModuleObject *self)
1007 PyLdbModule_AsModule(self)->ops->end_transaction(PyLdbModule_AsModule(self));
1011 static PyObject *py_ldb_module_del_transaction(PyLdbModuleObject *self)
1013 PyLdbModule_AsModule(self)->ops->del_transaction(PyLdbModule_AsModule(self));
1017 static PyObject *py_ldb_module_search(PyLdbModuleObject *self, PyObject *args, PyObject *kwargs)
1019 PyObject *py_base, *py_tree, *py_attrs;
1021 struct ldb_request *req;
1022 const char *kwnames[] = { "base", "scope", "tree", "attrs", NULL };
1023 struct ldb_module *mod;
1024 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "OiOO", (char **)kwnames,
1025 &py_base, &scope, &py_tree, &py_attrs))
1028 req = talloc_zero(NULL, struct ldb_request);
1030 req->operation = LDB_SEARCH;
1031 req->op.search.base = PyLdbDn_AsDn(py_base);
1032 req->op.search.scope = scope;
1033 req->op.search.tree = PyLdbTree_AsTree(py_tree);
1034 if (py_attrs == Py_None) {
1035 req->op.search.attrs = NULL;
1037 req->op.search.attrs = PyList_AsStringList(req, py_attrs);
1040 req->op.search.res = talloc_zero(NULL, struct ldb_result);
1044 ret = mod->ops->search(mod, req);
1047 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, NULL);
1049 return PyLdbResult_FromResult(req->op.search.res);
1053 static PyObject *py_ldb_module_add(PyLdbModuleObject *self, PyObject *args)
1055 struct ldb_request *req;
1056 PyObject *py_message;
1059 if (!PyArg_ParseTuple(args, "O", &py_message))
1062 req = talloc_zero(NULL, struct ldb_request);
1063 req->operation = LDB_ADD;
1064 req->op.add.message = PyLdbMessage_AsMessage(py_message);
1066 ret = PyLdbModule_AsModule(self)->ops->add(PyLdbModule_AsModule(self), req);
1068 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, NULL);
1073 static PyObject *py_ldb_module_modify(PyLdbModuleObject *self, PyObject *args)
1076 struct ldb_request *req;
1077 PyObject *py_message;
1079 if (!PyArg_ParseTuple(args, "O", &py_message))
1082 req = talloc_zero(NULL, struct ldb_request);
1083 req->operation = LDB_MODIFY;
1084 req->op.mod.message = PyLdbMessage_AsMessage(py_message);
1086 ret = PyLdbModule_AsModule(self)->ops->modify(PyLdbModule_AsModule(self), req);
1088 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, NULL);
1093 static PyObject *py_ldb_module_delete(PyLdbModuleObject *self, PyObject *args)
1096 struct ldb_request *req;
1099 if (!PyArg_ParseTuple(args, "O", &py_dn))
1102 req = talloc_zero(NULL, struct ldb_request);
1103 req->operation = LDB_DELETE;
1104 req->op.del.dn = PyLdbDn_AsDn(py_dn);
1106 ret = PyLdbModule_AsModule(self)->ops->del(PyLdbModule_AsModule(self), req);
1108 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, NULL);
1113 static PyObject *py_ldb_module_rename(PyLdbModuleObject *self, PyObject *args)
1116 struct ldb_request *req;
1117 PyObject *py_dn1, *py_dn2;
1119 if (!PyArg_ParseTuple(args, "OO", &py_dn1, &py_dn2))
1122 req = talloc_zero(NULL, struct ldb_request);
1124 req->operation = LDB_RENAME;
1125 req->op.rename.olddn = PyLdbDn_AsDn(py_dn1);
1126 req->op.rename.newdn = PyLdbDn_AsDn(py_dn2);
1128 ret = PyLdbModule_AsModule(self)->ops->rename(PyLdbModule_AsModule(self), req);
1130 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, NULL);
1135 static PyMethodDef py_ldb_module_methods[] = {
1136 { "search", (PyCFunction)py_ldb_module_search, METH_VARARGS|METH_KEYWORDS, NULL },
1137 { "add", (PyCFunction)py_ldb_module_add, METH_VARARGS, NULL },
1138 { "modify", (PyCFunction)py_ldb_module_modify, METH_VARARGS, NULL },
1139 { "rename", (PyCFunction)py_ldb_module_rename, METH_VARARGS, NULL },
1140 { "delete", (PyCFunction)py_ldb_module_delete, METH_VARARGS, NULL },
1141 { "start_transaction", (PyCFunction)py_ldb_module_start_transaction, METH_NOARGS, NULL },
1142 { "end_transaction", (PyCFunction)py_ldb_module_end_transaction, METH_NOARGS, NULL },
1143 { "del_transaction", (PyCFunction)py_ldb_module_del_transaction, METH_NOARGS, NULL },
1147 PyTypeObject PyLdbModule = {
1148 .tp_name = "LdbModule",
1149 .tp_methods = py_ldb_module_methods,
1150 .tp_repr = (reprfunc)py_ldb_module_repr,
1151 .tp_str = (reprfunc)py_ldb_module_str,
1152 .tp_basicsize = sizeof(py_talloc_Object),
1153 .tp_dealloc = py_talloc_dealloc,
1156 struct ldb_message_element *PyObject_AsMessageElement(TALLOC_CTX *mem_ctx,
1157 PyObject *set_obj, int flags,
1158 const char *attr_name)
1160 struct ldb_message_element *me;
1162 if (PyLdbMessageElement_Check(set_obj))
1163 return PyLdbMessageElement_AsMessageElement(set_obj);
1165 me = talloc(mem_ctx, struct ldb_message_element);
1167 me->name = attr_name;
1169 if (PyString_Check(set_obj)) {
1171 me->values = talloc_array(me, struct ldb_val, me->num_values);
1172 me->values[0].length = PyString_Size(set_obj);
1173 me->values[0].data = (uint8_t *)talloc_strdup(me->values,
1174 PyString_AsString(set_obj));
1175 } else if (PySequence_Check(set_obj)) {
1177 me->num_values = PySequence_Size(set_obj);
1178 me->values = talloc_array(me, struct ldb_val, me->num_values);
1179 for (i = 0; i < me->num_values; i++) {
1180 PyObject *obj = PySequence_GetItem(set_obj, i);
1181 me->values[i].length = PyString_Size(obj);
1182 me->values[i].data = (uint8_t *)PyString_AsString(obj);
1193 PyObject *ldb_msg_element_to_set(struct ldb_context *ldb_ctx,
1194 struct ldb_message_element *me)
1199 /* Python << 2.5 doesn't have PySet_New and PySet_Add. */
1200 result = PyList_New(me->num_values);
1202 for (i = 0; i < me->num_values; i++) {
1203 PyList_SetItem(result, i,
1204 PyObject_FromLdbValue(ldb_ctx, me, &me->values[i]));
1210 PyObject *py_ldb_msg_element_get(PyLdbMessageElementObject *self, PyObject *args)
1213 if (!PyArg_ParseTuple(args, "i", &i))
1215 if (i < 0 || i >= PyLdbMessageElement_AsMessageElement(self)->num_values)
1218 return PyObject_FromLdbValue(NULL, PyLdbMessageElement_AsMessageElement(self),
1219 &(PyLdbMessageElement_AsMessageElement(self)->values[i]));
1222 static PyMethodDef py_ldb_msg_element_methods[] = {
1223 { "get", (PyCFunction)py_ldb_msg_element_get, METH_VARARGS, NULL },
1227 static Py_ssize_t py_ldb_msg_element_len(PyLdbMessageElementObject *self)
1229 return PyLdbMessageElement_AsMessageElement(self)->num_values;
1232 static PyObject *py_ldb_msg_element_find(PyLdbMessageElementObject *self, Py_ssize_t idx)
1234 struct ldb_message_element *el = PyLdbMessageElement_AsMessageElement(self);
1235 if (idx < 0 || idx >= el->num_values) {
1236 PyErr_SetString(PyExc_IndexError, "Out of range");
1239 return PyString_FromStringAndSize((char *)el->values[idx].data, el->values[idx].length);
1242 static PySequenceMethods py_ldb_msg_element_seq = {
1243 .sq_length = (lenfunc)py_ldb_msg_element_len,
1244 .sq_item = (ssizeargfunc)py_ldb_msg_element_find,
1247 static int py_ldb_msg_element_cmp(PyLdbMessageElementObject *self, PyLdbMessageElementObject *other)
1249 return ldb_msg_element_compare(PyLdbMessageElement_AsMessageElement(self),
1250 PyLdbMessageElement_AsMessageElement(other));
1253 static PyObject *py_ldb_msg_element_iter(PyLdbMessageElementObject *self)
1255 return PyObject_GetIter(ldb_msg_element_to_set(NULL, PyLdbMessageElement_AsMessageElement(self)));
1258 PyObject *PyLdbMessageElement_FromMessageElement(struct ldb_message_element *el)
1260 return py_talloc_import(&PyLdbMessageElement, el);
1263 static PyObject *py_ldb_msg_element_new(PyTypeObject *type, PyObject *args, PyObject *kwargs)
1265 PyObject *py_elements = NULL;
1266 struct ldb_message_element *el;
1269 const char *kwnames[] = { "elements", "flags", "name", NULL };
1270 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "|Ois", (char **)kwnames, &py_elements, &flags, &name))
1273 el = talloc_zero(NULL, struct ldb_message_element);
1275 if (py_elements != NULL) {
1277 if (!PySequence_Check(py_elements)) {
1279 el->values = talloc_array(el, struct ldb_val, 1);
1280 el->values[0].data = (uint8_t *)PyString_AsString(py_elements);
1281 el->values[0].length = PyString_Size(py_elements);
1283 el->num_values = PySequence_Size(py_elements);
1284 el->values = talloc_array(el, struct ldb_val, el->num_values);
1285 for (i = 0; i < el->num_values; i++) {
1286 PyObject *item = PySequence_GetItem(py_elements, i);
1287 el->values[i].data = (uint8_t *)PyString_AsString(item);
1288 el->values[i].length = PyString_Size(item);
1294 el->name = talloc_strdup(el, name);
1296 return py_talloc_import(&PyLdbMessageElement, el);
1299 static PyObject *py_ldb_msg_element_repr(PyLdbMessageElementObject *self)
1301 char *element_str = NULL;
1303 struct ldb_message_element *el = PyLdbMessageElement_AsMessageElement(self);
1306 for (i = 0; i < el->num_values; i++) {
1307 PyObject *o = py_ldb_msg_element_find(self, i);
1308 if (element_str == NULL)
1309 element_str = talloc_strdup(NULL, PyObject_REPR(o));
1311 element_str = talloc_asprintf_append(element_str, ",%s", PyObject_REPR(o));
1314 ret = PyString_FromFormat("MessageElement([%s])", element_str);
1316 talloc_free(element_str);
1321 PyTypeObject PyLdbMessageElement = {
1322 .tp_name = "MessageElement",
1323 .tp_basicsize = sizeof(PyLdbMessageElementObject),
1324 .tp_dealloc = py_talloc_dealloc,
1325 .tp_repr = (reprfunc)py_ldb_msg_element_repr,
1326 .tp_methods = py_ldb_msg_element_methods,
1327 .tp_compare = (cmpfunc)py_ldb_msg_element_cmp,
1328 .tp_iter = (getiterfunc)py_ldb_msg_element_iter,
1329 .tp_as_sequence = &py_ldb_msg_element_seq,
1330 .tp_new = py_ldb_msg_element_new,
1333 static PyObject *py_ldb_msg_remove_attr(PyLdbMessageObject *self, PyObject *args)
1336 if (!PyArg_ParseTuple(args, "s", &name))
1339 ldb_msg_remove_attr(self->ptr, name);
1344 static PyObject *py_ldb_msg_keys(PyLdbMessageObject *self)
1346 struct ldb_message *msg = PyLdbMessage_AsMessage(self);
1348 PyObject *obj = PyList_New(msg->num_elements+(msg->dn != NULL?1:0));
1349 if (msg->dn != NULL) {
1350 PyList_SetItem(obj, j, PyString_FromString("dn"));
1353 for (i = 0; i < msg->num_elements; i++) {
1354 PyList_SetItem(obj, j, PyString_FromString(msg->elements[i].name));
1360 static PyObject *py_ldb_msg_getitem_helper(PyLdbMessageObject *self, PyObject *py_name)
1362 struct ldb_message_element *el;
1363 char *name = PyString_AsString(py_name);
1364 if (!strcmp(name, "dn"))
1365 return PyLdbDn_FromDn(PyLdbMessage_AsMessage(self)->dn);
1366 el = ldb_msg_find_element(PyLdbMessage_AsMessage(self), name);
1370 return (PyObject *)PyLdbMessageElement_FromMessageElement(el);
1373 static PyObject *py_ldb_msg_getitem(PyLdbMessageObject *self, PyObject *py_name)
1375 PyObject *ret = py_ldb_msg_getitem_helper(self, py_name);
1377 PyErr_SetString(PyExc_KeyError, "No such element");
1383 static PyObject *py_ldb_msg_get(PyLdbMessageObject *self, PyObject *args)
1385 PyObject *name, *ret;
1386 if (!PyArg_ParseTuple(args, "O", &name))
1389 ret = py_ldb_msg_getitem_helper(self, name);
1395 static PyObject *py_ldb_msg_items(PyLdbMessageObject *self)
1397 struct ldb_message *msg = PyLdbMessage_AsMessage(self);
1399 PyObject *l = PyList_New(msg->num_elements + (msg->dn == NULL?0:1));
1401 if (msg->dn != NULL) {
1402 PyList_SetItem(l, 0, Py_BuildValue("(sO)", "dn", PyLdbDn_FromDn(msg->dn)));
1405 for (i = 0; i < msg->num_elements; i++, j++) {
1406 PyList_SetItem(l, j, Py_BuildValue("(sO)", msg->elements[i].name, PyLdbMessageElement_FromMessageElement(&msg->elements[i])));
1411 static PyMethodDef py_ldb_msg_methods[] = {
1412 { "keys", (PyCFunction)py_ldb_msg_keys, METH_NOARGS, NULL },
1413 { "remove", (PyCFunction)py_ldb_msg_remove_attr, METH_VARARGS, NULL },
1414 { "get", (PyCFunction)py_ldb_msg_get, METH_VARARGS, NULL },
1415 { "items", (PyCFunction)py_ldb_msg_items, METH_NOARGS, NULL },
1419 static int py_ldb_msg_setitem(PyLdbMessageObject *self, PyObject *name, PyObject *value)
1421 char *attr_name = PyString_AsString(name);
1422 if (value == NULL) {
1423 ldb_msg_remove_attr(self->ptr, attr_name);
1425 struct ldb_message_element *el = PyObject_AsMessageElement(NULL,
1426 value, 0, attr_name);
1429 talloc_steal(self->ptr, el);
1430 ldb_msg_remove_attr(PyLdbMessage_AsMessage(self), attr_name);
1431 ldb_msg_add(PyLdbMessage_AsMessage(self), el, el->flags);
1436 static Py_ssize_t py_ldb_msg_length(PyLdbMessageObject *self)
1438 return PyLdbMessage_AsMessage(self)->num_elements;
1441 static PyMappingMethods py_ldb_msg_mapping = {
1442 .mp_length = (lenfunc)py_ldb_msg_length,
1443 .mp_subscript = (binaryfunc)py_ldb_msg_getitem,
1444 .mp_ass_subscript = (objobjargproc)py_ldb_msg_setitem,
1447 static PyObject *py_ldb_msg_new(PyTypeObject *type, PyObject *args, PyObject *kwargs)
1449 const char *kwnames[] = { "dn", NULL };
1450 struct ldb_message *ret;
1451 PyObject *pydn = NULL;
1452 if (!PyArg_ParseTupleAndKeywords(args, kwargs, "|O", (char **)kwnames, &pydn))
1455 ret = ldb_msg_new(NULL);
1462 if (!PyObject_AsDn(NULL, pydn, NULL, &ret->dn))
1465 return py_talloc_import(&PyLdbMessage, ret);
1468 PyObject *PyLdbMessage_FromMessage(struct ldb_message *msg)
1470 return py_talloc_import(&PyLdbMessage, msg);
1473 static PyObject *py_ldb_msg_get_dn(PyLdbMessageObject *self, void *closure)
1475 return PyLdbDn_FromDn(PyLdbMessage_AsMessage(self)->dn);
1478 static int py_ldb_msg_set_dn(PyLdbMessageObject *self, PyObject *value, void *closure)
1480 PyLdbMessage_AsMessage(self)->dn = PyLdbDn_AsDn(value);
1484 static PyGetSetDef py_ldb_msg_getset[] = {
1485 { (char *)"dn", (getter)py_ldb_msg_get_dn, (setter)py_ldb_msg_set_dn, NULL },
1489 static PyObject *py_ldb_msg_repr(PyLdbMessageObject *self)
1491 PyObject *dict = PyDict_New(), *ret;
1492 if (PyDict_Update(dict, (PyObject *)self) != 0)
1494 ret = PyString_FromFormat("Message(%s)", PyObject_REPR(dict));
1499 PyTypeObject PyLdbMessage = {
1500 .tp_name = "Message",
1501 .tp_methods = py_ldb_msg_methods,
1502 .tp_getset = py_ldb_msg_getset,
1503 .tp_as_mapping = &py_ldb_msg_mapping,
1504 .tp_basicsize = sizeof(PyLdbMessageObject),
1505 .tp_dealloc = py_talloc_dealloc,
1506 .tp_new = py_ldb_msg_new,
1507 .tp_repr = (reprfunc)py_ldb_msg_repr,
1510 PyObject *PyLdbTree_FromTree(struct ldb_parse_tree *tree)
1512 return py_talloc_import(&PyLdbTree, tree);
1515 PyTypeObject PyLdbTree = {
1517 .tp_basicsize = sizeof(PyLdbTreeObject),
1518 .tp_dealloc = py_talloc_dealloc,
1522 int py_module_search(struct ldb_module *mod, struct ldb_request *req)
1524 PyObject *py_ldb = mod->private_data;
1525 PyObject *py_result, *py_base, *py_attrs, *py_tree;
1527 py_base = PyLdbDn_FromDn(req->op.search.base);
1529 if (py_base == NULL)
1530 return LDB_ERR_OPERATIONS_ERROR;
1532 py_tree = PyLdbTree_FromTree(req->op.search.tree);
1534 if (py_tree == NULL)
1535 return LDB_ERR_OPERATIONS_ERROR;
1537 if (req->op.search.attrs == NULL) {
1541 for (len = 0; req->op.search.attrs[len]; len++);
1542 py_attrs = PyList_New(len);
1543 for (i = 0; i < len; i++)
1544 PyList_SetItem(py_attrs, i, PyString_FromString(req->op.search.attrs[i]));
1547 py_result = PyObject_CallMethod(py_ldb, (char *)"search", (char *)"OiOO", py_base, req->op.search.scope, py_tree, py_attrs);
1549 Py_DECREF(py_attrs);
1553 if (py_result == NULL) {
1554 return LDB_ERR_OPERATIONS_ERROR;
1557 req->op.search.res = PyLdbResult_AsResult(NULL, py_result);
1558 if (req->op.search.res == NULL) {
1559 return LDB_ERR_OPERATIONS_ERROR;
1562 Py_DECREF(py_result);
1567 int py_module_add(struct ldb_module *mod, struct ldb_request *req)
1569 PyObject *py_ldb = mod->private_data;
1570 PyObject *py_result, *py_msg;
1572 py_msg = PyLdbMessage_FromMessage((struct ldb_message *)req->op.add.message);
1574 if (py_msg == NULL) {
1575 return LDB_ERR_OPERATIONS_ERROR;
1578 py_result = PyObject_CallMethod(py_ldb, (char *)"add", (char *)"O", py_msg);
1582 if (py_result == NULL) {
1583 return LDB_ERR_OPERATIONS_ERROR;
1586 Py_DECREF(py_result);
1591 int py_module_modify(struct ldb_module *mod, struct ldb_request *req)
1593 PyObject *py_ldb = mod->private_data;
1594 PyObject *py_result, *py_msg;
1596 py_msg = PyLdbMessage_FromMessage((struct ldb_message *)req->op.mod.message);
1598 if (py_msg == NULL) {
1599 return LDB_ERR_OPERATIONS_ERROR;
1602 py_result = PyObject_CallMethod(py_ldb, (char *)"modify", (char *)"O", py_msg);
1606 if (py_result == NULL) {
1607 return LDB_ERR_OPERATIONS_ERROR;
1610 Py_DECREF(py_result);
1615 int py_module_del(struct ldb_module *mod, struct ldb_request *req)
1617 PyObject *py_ldb = mod->private_data;
1618 PyObject *py_result, *py_dn;
1620 py_dn = PyLdbDn_FromDn(req->op.del.dn);
1623 return LDB_ERR_OPERATIONS_ERROR;
1625 py_result = PyObject_CallMethod(py_ldb, (char *)"delete", (char *)"O", py_dn);
1627 if (py_result == NULL) {
1628 return LDB_ERR_OPERATIONS_ERROR;
1631 Py_DECREF(py_result);
1636 int py_module_rename(struct ldb_module *mod, struct ldb_request *req)
1638 PyObject *py_ldb = mod->private_data;
1639 PyObject *py_result, *py_olddn, *py_newdn;
1641 py_olddn = PyLdbDn_FromDn(req->op.rename.olddn);
1643 if (py_olddn == NULL)
1644 return LDB_ERR_OPERATIONS_ERROR;
1646 py_newdn = PyLdbDn_FromDn(req->op.rename.newdn);
1648 if (py_newdn == NULL)
1649 return LDB_ERR_OPERATIONS_ERROR;
1651 py_result = PyObject_CallMethod(py_ldb, (char *)"rename", (char *)"OO", py_olddn, py_newdn);
1653 Py_DECREF(py_olddn);
1654 Py_DECREF(py_newdn);
1656 if (py_result == NULL) {
1657 return LDB_ERR_OPERATIONS_ERROR;
1660 Py_DECREF(py_result);
1665 int py_module_request(struct ldb_module *mod, struct ldb_request *req)
1667 PyObject *py_ldb = mod->private_data;
1668 PyObject *py_result;
1670 py_result = PyObject_CallMethod(py_ldb, (char *)"request", (char *)"");
1672 return LDB_ERR_OPERATIONS_ERROR;
1675 int py_module_extended(struct ldb_module *mod, struct ldb_request *req)
1677 PyObject *py_ldb = mod->private_data;
1678 PyObject *py_result;
1680 py_result = PyObject_CallMethod(py_ldb, (char *)"extended", (char *)"");
1682 return LDB_ERR_OPERATIONS_ERROR;
1685 int py_module_start_transaction(struct ldb_module *mod)
1687 PyObject *py_ldb = mod->private_data;
1688 PyObject *py_result;
1690 py_result = PyObject_CallMethod(py_ldb, (char *)"start_transaction", (char *)"");
1692 if (py_result == NULL) {
1693 return LDB_ERR_OPERATIONS_ERROR;
1696 Py_DECREF(py_result);
1701 int py_module_end_transaction(struct ldb_module *mod)
1703 PyObject *py_ldb = mod->private_data;
1704 PyObject *py_result;
1706 py_result = PyObject_CallMethod(py_ldb, (char *)"end_transaction", (char *)"");
1708 if (py_result == NULL) {
1709 return LDB_ERR_OPERATIONS_ERROR;
1712 Py_DECREF(py_result);
1717 int py_module_del_transaction(struct ldb_module *mod)
1719 PyObject *py_ldb = mod->private_data;
1720 PyObject *py_result;
1722 py_result = PyObject_CallMethod(py_ldb, (char *)"del_transaction", (char *)"");
1724 if (py_result == NULL) {
1725 return LDB_ERR_OPERATIONS_ERROR;
1728 Py_DECREF(py_result);
1733 static int py_module_destructor(struct ldb_module *mod)
1735 Py_DECREF((PyObject *)mod->private_data);
1739 int py_module_init (struct ldb_module *mod)
1741 PyObject *py_class = mod->ops->private_data;
1742 PyObject *py_result, *py_next, *py_ldb;
1744 py_ldb = PyLdb_FromLdbContext(mod->ldb);
1747 return LDB_ERR_OPERATIONS_ERROR;
1749 py_next = PyLdbModule_FromModule(mod->next);
1751 if (py_next == NULL)
1752 return LDB_ERR_OPERATIONS_ERROR;
1754 py_result = PyObject_CallFunction(py_class, (char *)"OO", py_ldb, py_next);
1756 if (py_result == NULL) {
1757 return LDB_ERR_OPERATIONS_ERROR;
1760 mod->private_data = py_result;
1762 talloc_set_destructor(mod, py_module_destructor);
1764 return ldb_next_init(mod);
1767 static PyObject *py_register_module(PyObject *module, PyObject *args)
1770 struct ldb_module_ops *ops;
1773 if (!PyArg_ParseTuple(args, "O", &input))
1776 ops = talloc_zero(talloc_autofree_context(), struct ldb_module_ops);
1782 ops->name = talloc_strdup(ops, PyString_AsString(PyObject_GetAttrString(input, (char *)"name")));
1785 ops->private_data = input;
1786 ops->init_context = py_module_init;
1787 ops->search = py_module_search;
1788 ops->add = py_module_add;
1789 ops->modify = py_module_modify;
1790 ops->del = py_module_del;
1791 ops->rename = py_module_rename;
1792 ops->request = py_module_request;
1793 ops->extended = py_module_extended;
1794 ops->start_transaction = py_module_start_transaction;
1795 ops->end_transaction = py_module_end_transaction;
1796 ops->del_transaction = py_module_del_transaction;
1798 ret = ldb_register_module(ops);
1800 PyErr_LDB_ERROR_IS_ERR_RAISE(ret, NULL);
1805 static PyObject *py_timestring(PyObject *module, PyObject *args)
1810 if (!PyArg_ParseTuple(args, "L", &t))
1812 tresult = ldb_timestring(NULL, t);
1813 ret = PyString_FromString(tresult);
1814 talloc_free(tresult);
1818 static PyObject *py_string_to_time(PyObject *module, PyObject *args)
1821 if (!PyArg_ParseTuple(args, "s", &str))
1824 return PyInt_FromLong(ldb_string_to_time(str));
1827 static PyObject *py_valid_attr_name(PyObject *self, PyObject *args)
1830 if (!PyArg_ParseTuple(args, "s", &name))
1832 return PyBool_FromLong(ldb_valid_attr_name(name));
1835 static PyMethodDef py_ldb_global_methods[] = {
1836 { "register_module", py_register_module, METH_VARARGS,
1837 "S.register_module(module) -> None\n"
1838 "Register a LDB module."},
1839 { "timestring", py_timestring, METH_VARARGS,
1840 "S.timestring(int) -> string\n"
1841 "Generate a LDAP time string from a UNIX timestamp" },
1842 { "string_to_time", py_string_to_time, METH_VARARGS,
1843 "S.string_to_time(string) -> int\n"
1844 "Parse a LDAP time string into a UNIX timestamp." },
1845 { "valid_attr_name", py_valid_attr_name, METH_VARARGS,
1846 "S.valid_attr_name(name) -> bool\n"
1847 "Check whether the supplied name is a valid attribute name." },
1848 { "open", (PyCFunction)py_ldb_new, METH_VARARGS|METH_KEYWORDS,
1857 if (PyType_Ready(&PyLdbDn) < 0)
1860 if (PyType_Ready(&PyLdbMessage) < 0)
1863 if (PyType_Ready(&PyLdbMessageElement) < 0)
1866 if (PyType_Ready(&PyLdb) < 0)
1869 if (PyType_Ready(&PyLdbModule) < 0)
1872 if (PyType_Ready(&PyLdbTree) < 0)
1875 m = Py_InitModule3("ldb", py_ldb_global_methods,
1876 "An interface to LDB, a LDAP-like API that can either to talk an embedded database (TDB-based) or a standards-compliant LDAP server.");
1880 PyModule_AddObject(m, "SCOPE_DEFAULT", PyInt_FromLong(LDB_SCOPE_DEFAULT));
1881 PyModule_AddObject(m, "SCOPE_BASE", PyInt_FromLong(LDB_SCOPE_BASE));
1882 PyModule_AddObject(m, "SCOPE_ONELEVEL", PyInt_FromLong(LDB_SCOPE_ONELEVEL));
1883 PyModule_AddObject(m, "SCOPE_SUBTREE", PyInt_FromLong(LDB_SCOPE_SUBTREE));
1885 PyModule_AddObject(m, "CHANGETYPE_NONE", PyInt_FromLong(LDB_CHANGETYPE_NONE));
1886 PyModule_AddObject(m, "CHANGETYPE_ADD", PyInt_FromLong(LDB_CHANGETYPE_ADD));
1887 PyModule_AddObject(m, "CHANGETYPE_DELETE", PyInt_FromLong(LDB_CHANGETYPE_DELETE));
1888 PyModule_AddObject(m, "CHANGETYPE_MODIFY", PyInt_FromLong(LDB_CHANGETYPE_MODIFY));
1890 PyModule_AddObject(m, "SUCCESS", PyInt_FromLong(LDB_SUCCESS));
1891 PyModule_AddObject(m, "ERR_OPERATIONS_ERROR", PyInt_FromLong(LDB_ERR_OPERATIONS_ERROR));
1892 PyModule_AddObject(m, "ERR_PROTOCOL_ERROR", PyInt_FromLong(LDB_ERR_PROTOCOL_ERROR));
1893 PyModule_AddObject(m, "ERR_TIME_LIMIT_EXCEEDED", PyInt_FromLong(LDB_ERR_TIME_LIMIT_EXCEEDED));
1894 PyModule_AddObject(m, "ERR_SIZE_LIMIT_EXCEEDED", PyInt_FromLong(LDB_ERR_SIZE_LIMIT_EXCEEDED));
1895 PyModule_AddObject(m, "ERR_COMPARE_FALSE", PyInt_FromLong(LDB_ERR_COMPARE_FALSE));
1896 PyModule_AddObject(m, "ERR_COMPARE_TRUE", PyInt_FromLong(LDB_ERR_COMPARE_TRUE));
1897 PyModule_AddObject(m, "ERR_AUTH_METHOD_NOT_SUPPORTED", PyInt_FromLong(LDB_ERR_AUTH_METHOD_NOT_SUPPORTED));
1898 PyModule_AddObject(m, "ERR_STRONG_AUTH_REQUIRED", PyInt_FromLong(LDB_ERR_STRONG_AUTH_REQUIRED));
1899 PyModule_AddObject(m, "ERR_REFERRAL", PyInt_FromLong(LDB_ERR_REFERRAL));
1900 PyModule_AddObject(m, "ERR_ADMIN_LIMIT_EXCEEDED", PyInt_FromLong(LDB_ERR_ADMIN_LIMIT_EXCEEDED));
1901 PyModule_AddObject(m, "ERR_UNSUPPORTED_CRITICAL_EXTENSION", PyInt_FromLong(LDB_ERR_UNSUPPORTED_CRITICAL_EXTENSION));
1902 PyModule_AddObject(m, "ERR_CONFIDENTIALITY_REQUIRED", PyInt_FromLong(LDB_ERR_CONFIDENTIALITY_REQUIRED));
1903 PyModule_AddObject(m, "ERR_SASL_BIND_IN_PROGRESS", PyInt_FromLong(LDB_ERR_SASL_BIND_IN_PROGRESS));
1904 PyModule_AddObject(m, "ERR_NO_SUCH_ATTRIBUTE", PyInt_FromLong(LDB_ERR_NO_SUCH_ATTRIBUTE));
1905 PyModule_AddObject(m, "ERR_UNDEFINED_ATTRIBUTE_TYPE", PyInt_FromLong(LDB_ERR_UNDEFINED_ATTRIBUTE_TYPE));
1906 PyModule_AddObject(m, "ERR_INAPPROPRIATE_MATCHING", PyInt_FromLong(LDB_ERR_INAPPROPRIATE_MATCHING));
1907 PyModule_AddObject(m, "ERR_CONSTRAINT_VIOLATION", PyInt_FromLong(LDB_ERR_CONSTRAINT_VIOLATION));
1908 PyModule_AddObject(m, "ERR_ATTRIBUTE_OR_VALUE_EXISTS", PyInt_FromLong(LDB_ERR_ATTRIBUTE_OR_VALUE_EXISTS));
1909 PyModule_AddObject(m, "ERR_INVALID_ATTRIBUTE_SYNTAX", PyInt_FromLong(LDB_ERR_INVALID_ATTRIBUTE_SYNTAX));
1910 PyModule_AddObject(m, "ERR_NO_SUCH_OBJECT", PyInt_FromLong(LDB_ERR_NO_SUCH_OBJECT));
1911 PyModule_AddObject(m, "ERR_ALIAS_PROBLEM", PyInt_FromLong(LDB_ERR_ALIAS_PROBLEM));
1912 PyModule_AddObject(m, "ERR_INVALID_DN_SYNTAX", PyInt_FromLong(LDB_ERR_INVALID_DN_SYNTAX));
1913 PyModule_AddObject(m, "ERR_ALIAS_DEREFERINCING_PROBLEM", PyInt_FromLong(LDB_ERR_ALIAS_DEREFERENCING_PROBLEM));
1914 PyModule_AddObject(m, "ERR_INAPPROPRIATE_AUTHENTICATION", PyInt_FromLong(LDB_ERR_INAPPROPRIATE_AUTHENTICATION));
1915 PyModule_AddObject(m, "ERR_INVALID_CREDENTIALS", PyInt_FromLong(LDB_ERR_INVALID_CREDENTIALS));
1916 PyModule_AddObject(m, "ERR_INSUFFICIENT_ACCESS_RIGHTS", PyInt_FromLong(LDB_ERR_INSUFFICIENT_ACCESS_RIGHTS));
1917 PyModule_AddObject(m, "ERR_BUSY", PyInt_FromLong(LDB_ERR_BUSY));
1918 PyModule_AddObject(m, "ERR_UNAVAILABLE", PyInt_FromLong(LDB_ERR_UNAVAILABLE));
1919 PyModule_AddObject(m, "ERR_UNWILLING_TO_PERFORM", PyInt_FromLong(LDB_ERR_UNWILLING_TO_PERFORM));
1920 PyModule_AddObject(m, "ERR_LOOP_DETECT", PyInt_FromLong(LDB_ERR_LOOP_DETECT));
1921 PyModule_AddObject(m, "ERR_NAMING_VIOLATION", PyInt_FromLong(LDB_ERR_NAMING_VIOLATION));
1922 PyModule_AddObject(m, "ERR_OBJECT_CLASS_VIOLATION", PyInt_FromLong(LDB_ERR_OBJECT_CLASS_VIOLATION));
1923 PyModule_AddObject(m, "ERR_NOT_ALLOWED_ON_NON_LEAF", PyInt_FromLong(LDB_ERR_NOT_ALLOWED_ON_NON_LEAF));
1924 PyModule_AddObject(m, "ERR_NOT_ALLOWED_ON_RDN", PyInt_FromLong(LDB_ERR_NOT_ALLOWED_ON_RDN));
1925 PyModule_AddObject(m, "ERR_ENTYR_ALREADY_EXISTS", PyInt_FromLong(LDB_ERR_ENTRY_ALREADY_EXISTS));
1926 PyModule_AddObject(m, "ERR_OBJECT_CLASS_MODS_PROHIBITED", PyInt_FromLong(LDB_ERR_OBJECT_CLASS_MODS_PROHIBITED));
1927 PyModule_AddObject(m, "ERR_AFFECTS_MULTIPLE_DSAS", PyInt_FromLong(LDB_ERR_AFFECTS_MULTIPLE_DSAS));
1929 PyModule_AddObject(m, "ERR_OTHER", PyInt_FromLong(LDB_ERR_OTHER));
1931 PyModule_AddObject(m, "__docformat__", PyString_FromString("restructuredText"));
1933 PyExc_LdbError = PyErr_NewException((char *)"_ldb.LdbError", NULL, NULL);
1934 PyModule_AddObject(m, "LdbError", PyExc_LdbError);
1937 Py_INCREF(&PyLdbDn);
1938 Py_INCREF(&PyLdbModule);
1939 Py_INCREF(&PyLdbMessage);
1940 Py_INCREF(&PyLdbMessageElement);
1941 Py_INCREF(&PyLdbTree);
1943 PyModule_AddObject(m, "Ldb", (PyObject *)&PyLdb);
1944 PyModule_AddObject(m, "Dn", (PyObject *)&PyLdbDn);
1945 PyModule_AddObject(m, "Message", (PyObject *)&PyLdbMessage);
1946 PyModule_AddObject(m, "MessageElement", (PyObject *)&PyLdbMessageElement);
1947 PyModule_AddObject(m, "Module", (PyObject *)&PyLdbModule);
1948 PyModule_AddObject(m, "Tree", (PyObject *)&PyLdbTree);
1953 /* ldb_message_element */
1954 %rename(MessageElement) ldb_message_element;
1955 %feature("docstring") ldb_message_element "Message element.";
1956 typedef struct ldb_message_element {
1958 PyObject *__set__(void)
1960 return ldb_msg_element_to_set(NULL, $self);
1963 ldb_message_element(PyObject *set_obj, int flags=0, const char *name = NULL)
1965 return PyObject_AsMessageElement(NULL, set_obj, flags, name);
1970 def __getitem__(self, i):
1973 raise KeyError("no such value")
1977 return "MessageElement([%s])" % (",".join(repr(x) for x in self.__set__()))
1979 } ldb_message_element;
1983 typedef struct ldb_message {
1987 ldb_msg(ldb_dn *dn = NULL) {
1988 ret->dn = talloc_reference(ret, dn);
1992 void __setitem__(const char *attr_name, ldb_message_element *val)
1994 struct ldb_message_element *el;
1996 ldb_msg_remove_attr($self, attr_name);
1998 el = talloc($self, struct ldb_message_element);
1999 el->name = talloc_strdup(el, attr_name);
2000 el->num_values = val->num_values;
2001 el->values = talloc_reference(el, val->values);
2003 ldb_msg_add($self, el, val->flags);
2006 void __setitem__(const char *attr_name, PyObject *val)
2010 def get(self, key, default=None):
2013 return self.find_element(key)
2015 def iteritems(self):
2016 for k in self.keys():
2020 return list(self.iteritems())
2023 return "Message(%s)" % repr(dict(self.iteritems()))
2028 typedef struct ldb_context {
2030 def itermodules(self):
2031 m = self.firstmodule
2032 while m is not None:
2037 return list(self.itermodules())