2 Python wrappers for DCERPC/SMB client routines.
4 Copyright (C) Tim Potter, 2002
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 2 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, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 #include "python/py_lsa.h"
23 PyObject *new_lsa_policy_hnd_object(struct cli_state *cli, TALLOC_CTX *mem_ctx,
26 lsa_policy_hnd_object *o;
28 o = PyObject_New(lsa_policy_hnd_object, &lsa_policy_hnd_type);
32 memcpy(&o->pol, pol, sizeof(POLICY_HND));
38 * Exceptions raised by this module
41 PyObject *lsa_error; /* This indicates a non-RPC related error
42 such as name lookup failure */
44 PyObject *lsa_ntstatus; /* This exception is raised when a RPC call
45 returns a status code other than
49 * Open/close lsa handles
52 static PyObject *lsa_open_policy(PyObject *self, PyObject *args,
55 static char *kwlist[] = { "servername", "creds", "access", NULL };
56 char *server, *errstr;
57 PyObject *creds = NULL, *result = NULL;
58 uint32 desired_access = MAXIMUM_ALLOWED_ACCESS;
59 struct cli_state *cli = NULL;
61 TALLOC_CTX *mem_ctx = NULL;
64 if (!PyArg_ParseTupleAndKeywords(
65 args, kw, "s|Oi", kwlist, &server, &creds, &desired_access))
68 if (creds && creds != Py_None && !PyDict_Check(creds)) {
69 PyErr_SetString(PyExc_TypeError,
70 "credentials must be dictionary or None");
74 if (server[0] != '\\' || server[1] != '\\') {
75 PyErr_SetString(PyExc_ValueError, "UNC name required");
81 if (!(cli = open_pipe_creds(server, creds, PI_LSARPC, &errstr))) {
82 PyErr_SetString(lsa_error, errstr);
87 if (!(mem_ctx = talloc_init("lsa_open_policy"))) {
88 PyErr_SetString(lsa_error, "unable to init talloc context\n");
92 ntstatus = cli_lsa_open_policy(cli, mem_ctx, True,
93 SEC_RIGHTS_MAXIMUM_ALLOWED, &hnd);
95 if (!NT_STATUS_IS_OK(ntstatus)) {
96 PyErr_SetObject(lsa_ntstatus, py_ntstatus_tuple(ntstatus));
100 result = new_lsa_policy_hnd_object(cli, mem_ctx, &hnd);
108 talloc_destroy(mem_ctx);
114 static PyObject *lsa_close(PyObject *self, PyObject *args, PyObject *kw)
117 lsa_policy_hnd_object *hnd;
120 /* Parse parameters */
122 if (!PyArg_ParseTuple(args, "O!", &lsa_policy_hnd_type, &po))
125 hnd = (lsa_policy_hnd_object *)po;
127 /* Call rpc function */
129 result = cli_lsa_close(hnd->cli, hnd->mem_ctx, &hnd->pol);
131 /* Cleanup samba stuff */
133 cli_shutdown(hnd->cli);
134 talloc_destroy(hnd->mem_ctx);
142 static PyObject *lsa_lookup_names(PyObject *self, PyObject *args)
144 PyObject *py_names, *result;
146 lsa_policy_hnd_object *hnd = (lsa_policy_hnd_object *)self;
152 if (!PyArg_ParseTuple(args, "O", &py_names))
155 if (!PyList_Check(py_names) && !PyString_Check(py_names)) {
156 PyErr_SetString(PyExc_TypeError, "must be list or string");
160 if (PyList_Check(py_names)) {
162 /* Convert list to char ** array */
164 num_names = PyList_Size(py_names);
165 names = (const char **)talloc(
166 hnd->mem_ctx, num_names * sizeof(char *));
168 for (i = 0; i < num_names; i++) {
169 PyObject *obj = PyList_GetItem(py_names, i);
171 names[i] = talloc_strdup(hnd->mem_ctx, PyString_AsString(obj));
176 /* Just a single element */
179 names = (const char **)talloc(hnd->mem_ctx, sizeof(char *));
181 names[0] = PyString_AsString(py_names);
184 ntstatus = cli_lsa_lookup_names(hnd->cli, hnd->mem_ctx, &hnd->pol,
185 num_names, names, &sids, &name_types);
187 if (!NT_STATUS_IS_OK(ntstatus) && NT_STATUS_V(ntstatus) != 0x107) {
188 PyErr_SetObject(lsa_ntstatus, py_ntstatus_tuple(ntstatus));
192 result = PyList_New(num_names);
194 for (i = 0; i < num_names; i++) {
195 PyObject *sid_obj, *obj;
197 py_from_SID(&sid_obj, &sids[i]);
199 obj = Py_BuildValue("(Oi)", sid_obj, name_types[i]);
201 PyList_SetItem(result, i, obj);
207 static PyObject *lsa_lookup_sids(PyObject *self, PyObject *args,
210 PyObject *py_sids, *result;
213 char **domains, **names;
215 lsa_policy_hnd_object *hnd = (lsa_policy_hnd_object *)self;
216 TALLOC_CTX *mem_ctx = NULL;
219 if (!PyArg_ParseTuple(args, "O", &py_sids))
222 if (!PyList_Check(py_sids) && !PyString_Check(py_sids)) {
223 PyErr_SetString(PyExc_TypeError, "must be list or string");
227 if (!(mem_ctx = talloc_init("lsa_open_policy"))) {
228 PyErr_SetString(lsa_error, "unable to init talloc context\n");
232 if (PyList_Check(py_sids)) {
234 /* Convert dictionary to char ** array */
236 num_sids = PyList_Size(py_sids);
237 sids = (DOM_SID *)talloc(mem_ctx, num_sids * sizeof(DOM_SID));
239 memset(sids, 0, num_sids * sizeof(DOM_SID));
241 for (i = 0; i < num_sids; i++) {
242 PyObject *obj = PyList_GetItem(py_sids, i);
244 if (!string_to_sid(&sids[i], PyString_AsString(obj))) {
245 PyErr_SetString(PyExc_ValueError, "string_to_sid failed");
253 /* Just a single element */
256 sids = (DOM_SID *)talloc(mem_ctx, sizeof(DOM_SID));
258 if (!string_to_sid(&sids[0], PyString_AsString(py_sids))) {
259 PyErr_SetString(PyExc_ValueError, "string_to_sid failed");
265 ntstatus = cli_lsa_lookup_sids(hnd->cli, mem_ctx, &hnd->pol,
266 num_sids, sids, &domains, &names,
269 if (!NT_STATUS_IS_OK(ntstatus)) {
270 PyErr_SetObject(lsa_ntstatus, py_ntstatus_tuple(ntstatus));
275 result = PyList_New(num_sids);
277 for (i = 0; i < num_sids; i++) {
280 obj = Py_BuildValue("{sssssi}", "username", names[i],
281 "domain", domains[i], "name_type",
284 PyList_SetItem(result, i, obj);
289 talloc_destroy(mem_ctx);
294 static PyObject *lsa_enum_trust_dom(PyObject *self, PyObject *args)
296 lsa_policy_hnd_object *hnd = (lsa_policy_hnd_object *)self;
298 uint32 enum_ctx = 0, num_domains, i;
300 DOM_SID *domain_sids;
303 if (!PyArg_ParseTuple(args, ""))
306 ntstatus = cli_lsa_enum_trust_dom(
307 hnd->cli, hnd->mem_ctx, &hnd->pol, &enum_ctx,
308 &num_domains, &domain_names, &domain_sids);
310 if (!NT_STATUS_IS_OK(ntstatus)) {
311 PyErr_SetObject(lsa_ntstatus, py_ntstatus_tuple(ntstatus));
315 result = PyList_New(num_domains);
317 for (i = 0; i < num_domains; i++) {
320 sid_to_string(sid_str, &domain_sids[i]);
323 Py_BuildValue("(ss)", domain_names[i], sid_str));
330 * Method dispatch tables
333 static PyMethodDef lsa_hnd_methods[] = {
337 { "lookup_sids", (PyCFunction)lsa_lookup_sids,
338 METH_VARARGS | METH_KEYWORDS,
339 "Convert sids to names." },
341 { "lookup_names", (PyCFunction)lsa_lookup_names,
342 METH_VARARGS | METH_KEYWORDS,
343 "Convert names to sids." },
345 /* Trusted domains */
347 { "enum_trusted_domains", (PyCFunction)lsa_enum_trust_dom,
349 "Enumerate trusted domains." },
354 static void py_lsa_policy_hnd_dealloc(PyObject* self)
359 static PyObject *py_lsa_policy_hnd_getattr(PyObject *self, char *attrname)
361 return Py_FindMethod(lsa_hnd_methods, self, attrname);
364 PyTypeObject lsa_policy_hnd_type = {
365 PyObject_HEAD_INIT(NULL)
368 sizeof(lsa_policy_hnd_object),
370 py_lsa_policy_hnd_dealloc, /*tp_dealloc*/
372 py_lsa_policy_hnd_getattr, /*tp_getattr*/
377 0, /*tp_as_sequence*/
382 static PyMethodDef lsa_methods[] = {
384 /* Open/close lsa handles */
386 { "open_policy", (PyCFunction)lsa_open_policy,
387 METH_VARARGS | METH_KEYWORDS,
388 "Open a policy handle" },
390 { "close", (PyCFunction)lsa_close,
392 "Close a policy handle" },
394 /* Other stuff - this should really go into a samba config module
395 but for the moment let's leave it here. */
397 { "setup_logging", (PyCFunction)py_setup_logging,
398 METH_VARARGS | METH_KEYWORDS,
399 "Set up debug logging.\n"
401 "Initialises Samba's debug logging system. One argument is expected which\n"
402 "is a boolean specifying whether debugging is interactive and sent to stdout\n"
403 "or logged to a file.\n"
407 ">>> spoolss.setup_logging(interactive = 1)" },
409 { "get_debuglevel", (PyCFunction)get_debuglevel,
411 "Set the current debug level.\n"
415 ">>> spoolss.get_debuglevel()\n"
418 { "set_debuglevel", (PyCFunction)set_debuglevel,
420 "Get the current debug level.\n"
424 ">>> spoolss.set_debuglevel(10)" },
429 static struct const_vals {
432 } module_const_vals[] = {
436 static void const_init(PyObject *dict)
438 struct const_vals *tmp;
441 for (tmp = module_const_vals; tmp->name; tmp++) {
442 obj = PyInt_FromLong(tmp->value);
443 PyDict_SetItemString(dict, tmp->name, obj);
449 * Module initialisation
454 PyObject *module, *dict;
456 /* Initialise module */
458 module = Py_InitModule("lsa", lsa_methods);
459 dict = PyModule_GetDict(module);
461 lsa_error = PyErr_NewException("lsa.error", NULL, NULL);
462 PyDict_SetItemString(dict, "error", lsa_error);
464 lsa_ntstatus = PyErr_NewException("lsa.ntstatus", NULL, NULL);
465 PyDict_SetItemString(dict, "ntstatus", lsa_ntstatus);
467 /* Initialise policy handle object */
469 lsa_policy_hnd_type.ob_type = &PyType_Type;
471 /* Initialise constants */
475 /* Do samba initialisation */
479 setup_logging("lsa", True);