2 Unix SMB/CIFS implementation.
3 Samba utility functions
4 Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2008
5 Copyright (C) Wilco Baan Hofman <wilco@baanhofman.nl> 2010
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #include "lib/replace/system/python.h"
22 #include "python/py3compat.h"
24 #include "python/modules.h"
25 #include "libcli/util/pyerrors.h"
26 #include "lib/registry/registry.h"
28 #include "lib/events/events.h"
29 #include "auth/credentials/pycredentials.h"
30 #include "param/pyparam.h"
32 extern PyTypeObject PyRegistryKey
;
33 extern PyTypeObject PyRegistry
;
34 extern PyTypeObject PyHiveKey
;
36 /*#define PyRegistryKey_AsRegistryKey(obj) pytalloc_get_type(obj, struct registry_key)*/
37 #define PyRegistry_AsRegistryContext(obj) ((struct registry_context *)pytalloc_get_ptr(obj))
38 #define PyHiveKey_AsHiveKey(obj) ((struct hive_key*)pytalloc_get_ptr(obj))
41 static PyObject
*py_get_predefined_key_by_name(PyObject
*self
, PyObject
*args
)
45 struct registry_context
*ctx
= PyRegistry_AsRegistryContext(self
);
46 struct registry_key
*key
;
48 if (!PyArg_ParseTuple(args
, "s", &name
))
51 result
= reg_get_predefined_key_by_name(ctx
, name
, &key
);
52 PyErr_WERROR_NOT_OK_RAISE(result
);
54 return pytalloc_steal(&PyRegistryKey
, key
);
57 static PyObject
*py_key_del_abs(PyObject
*self
, PyObject
*args
)
61 struct registry_context
*ctx
= PyRegistry_AsRegistryContext(self
);
63 if (!PyArg_ParseTuple(args
, "s", &path
))
66 result
= reg_key_del_abs(ctx
, path
);
67 PyErr_WERROR_NOT_OK_RAISE(result
);
72 static PyObject
*py_get_predefined_key(PyObject
*self
, PyObject
*args
)
75 struct registry_context
*ctx
= PyRegistry_AsRegistryContext(self
);
77 struct registry_key
*key
;
79 if (!PyArg_ParseTuple(args
, "I", &hkey
))
82 result
= reg_get_predefined_key(ctx
, hkey
, &key
);
83 PyErr_WERROR_NOT_OK_RAISE(result
);
85 return pytalloc_steal(&PyRegistryKey
, key
);
88 static PyObject
*py_diff_apply(PyObject
*self
, PyObject
*args
)
92 struct registry_context
*ctx
= PyRegistry_AsRegistryContext(self
);
93 if (!PyArg_ParseTuple(args
, "s", &filename
))
96 result
= reg_diff_apply(ctx
, filename
);
97 PyErr_WERROR_NOT_OK_RAISE(result
);
102 static PyObject
*py_mount_hive(PyObject
*self
, PyObject
*args
)
104 struct registry_context
*ctx
= PyRegistry_AsRegistryContext(self
);
106 PyObject
*py_hivekey
, *py_elements
= Py_None
;
107 const char **elements
;
110 if (!PyArg_ParseTuple(args
, "OI|O", &py_hivekey
, &hkey
, &py_elements
))
113 if (!PyList_Check(py_elements
) && py_elements
!= Py_None
) {
114 PyErr_SetString(PyExc_TypeError
, "Expected list of elements");
118 if (py_elements
== Py_None
) {
122 elements
= talloc_array(NULL
, const char *, PyList_Size(py_elements
));
123 for (i
= 0; i
< PyList_Size(py_elements
); i
++)
124 elements
[i
] = PyUnicode_AsUTF8(PyList_GetItem(py_elements
, i
));
127 SMB_ASSERT(ctx
!= NULL
);
129 result
= reg_mount_hive(ctx
, PyHiveKey_AsHiveKey(py_hivekey
), hkey
, elements
);
130 PyErr_WERROR_NOT_OK_RAISE(result
);
135 static PyObject
*registry_new(PyTypeObject
*type
, PyObject
*args
, PyObject
*kwargs
)
138 struct registry_context
*ctx
;
139 result
= reg_open_local(NULL
, &ctx
);
140 PyErr_WERROR_NOT_OK_RAISE(result
);
141 return pytalloc_steal(&PyRegistry
, ctx
);
144 static PyMethodDef registry_methods
[] = {
145 { "get_predefined_key_by_name", py_get_predefined_key_by_name
, METH_VARARGS
,
146 "S.get_predefined_key_by_name(name) -> key\n"
147 "Find a predefined key by name" },
148 { "key_del_abs", py_key_del_abs
, METH_VARARGS
, "S.key_del_abs(name) -> None\n"
149 "Delete a key by absolute path." },
150 { "get_predefined_key", py_get_predefined_key
, METH_VARARGS
, "S.get_predefined_key(hkey_id) -> key\n"
151 "Find a predefined key by id" },
152 { "diff_apply", py_diff_apply
, METH_VARARGS
, "S.diff_apply(filename) -> None\n"
153 "Apply the diff from the specified file" },
154 { "mount_hive", py_mount_hive
, METH_VARARGS
, "S.mount_hive(key, key_id, elements=None) -> None\n"
155 "Mount the specified key at the specified path." },
159 PyTypeObject PyRegistry
= {
160 .tp_name
= "Registry",
161 .tp_methods
= registry_methods
,
162 .tp_new
= registry_new
,
163 .tp_flags
= Py_TPFLAGS_DEFAULT
,
166 static PyObject
*py_hive_key_del(PyObject
*self
, PyObject
*args
)
169 struct hive_key
*key
= PyHiveKey_AsHiveKey(self
);
172 if (!PyArg_ParseTuple(args
, "s", &name
))
175 result
= hive_key_del(NULL
, key
, name
);
177 PyErr_WERROR_NOT_OK_RAISE(result
);
182 static PyObject
*py_hive_key_flush(PyObject
*self
,
183 PyObject
*Py_UNUSED(ignored
))
186 struct hive_key
*key
= PyHiveKey_AsHiveKey(self
);
188 result
= hive_key_flush(key
);
189 PyErr_WERROR_NOT_OK_RAISE(result
);
194 static PyObject
*py_hive_key_del_value(PyObject
*self
, PyObject
*args
)
198 struct hive_key
*key
= PyHiveKey_AsHiveKey(self
);
200 if (!PyArg_ParseTuple(args
, "s", &name
))
203 result
= hive_key_del_value(NULL
, key
, name
);
205 PyErr_WERROR_NOT_OK_RAISE(result
);
210 static PyObject
*py_hive_key_set_value(PyObject
*self
, PyObject
*args
)
215 Py_ssize_t value_length
= 0;
217 struct hive_key
*key
= PyHiveKey_AsHiveKey(self
);
219 if (!PyArg_ParseTuple(args
, "sIz#", &name
, &type
, &value
.data
, &value_length
)) {
222 value
.length
= value_length
;
224 if (value
.data
!= NULL
)
225 result
= hive_key_set_value(key
, name
, type
, value
);
227 result
= hive_key_del_value(NULL
, key
, name
);
229 PyErr_WERROR_NOT_OK_RAISE(result
);
234 static PyMethodDef hive_key_methods
[] = {
235 { "del", py_hive_key_del
, METH_VARARGS
, "S.del(name) -> None\n"
237 { "flush", (PyCFunction
)py_hive_key_flush
, METH_NOARGS
, "S.flush() -> None\n"
238 "Flush this key to disk" },
239 { "del_value", py_hive_key_del_value
, METH_VARARGS
, "S.del_value(name) -> None\n"
241 { "set_value", py_hive_key_set_value
, METH_VARARGS
, "S.set_value(name, type, data) -> None\n"
246 static PyObject
*hive_new(PyTypeObject
*type
, PyObject
*args
, PyObject
*kwargs
) {
250 static PyObject
*py_open_hive(PyTypeObject
*type
, PyObject
*args
, PyObject
*kwargs
)
252 const char *kwnames
[] = { "location", "lp_ctx", "session_info", "credentials", NULL
};
254 struct loadparm_context
*lp_ctx
;
255 PyObject
*py_lp_ctx
= Py_None
;
256 PyObject
*py_session_info
= Py_None
;
257 PyObject
*py_credentials
= Py_None
;
258 struct auth_session_info
*session_info
;
259 struct cli_credentials
*credentials
;
261 struct hive_key
*hive_key
;
264 if (!PyArg_ParseTupleAndKeywords(args
, kwargs
, "s|OOO",
265 discard_const_p(char *, kwnames
),
267 &py_lp_ctx
, &py_session_info
,
271 mem_ctx
= talloc_new(NULL
);
272 if (mem_ctx
== NULL
) {
277 lp_ctx
= lpcfg_from_py_object(mem_ctx
, py_lp_ctx
);
278 if (lp_ctx
== NULL
) {
279 PyErr_SetString(PyExc_TypeError
, "Expected loadparm context");
280 talloc_free(mem_ctx
);
284 credentials
= cli_credentials_from_py_object(py_credentials
);
285 if (credentials
== NULL
) {
286 PyErr_SetString(PyExc_TypeError
, "Expected credentials");
287 talloc_free(mem_ctx
);
292 result
= reg_open_hive(NULL
, location
, session_info
, credentials
,
293 samba_tevent_context_init(NULL
),
295 talloc_free(mem_ctx
);
296 PyErr_WERROR_NOT_OK_RAISE(result
);
298 return pytalloc_steal(&PyHiveKey
, hive_key
);
301 PyTypeObject PyHiveKey
= {
302 .tp_name
= "HiveKey",
303 .tp_methods
= hive_key_methods
,
305 .tp_flags
= Py_TPFLAGS_DEFAULT
,
308 PyTypeObject PyRegistryKey
= {
309 .tp_name
= "RegistryKey",
310 .tp_flags
= Py_TPFLAGS_DEFAULT
,
313 static PyObject
*py_open_samba(PyObject
*self
, PyObject
*args
, PyObject
*kwargs
)
315 const char *kwnames
[] = { "lp_ctx", "session_info", NULL
};
316 struct registry_context
*reg_ctx
;
318 struct loadparm_context
*lp_ctx
;
319 PyObject
*py_lp_ctx
= Py_None
;
320 PyObject
*py_session_info
= Py_None
;
321 PyObject
*py_credentials
= Py_None
;
322 struct auth_session_info
*session_info
;
323 struct cli_credentials
*credentials
;
326 if (!PyArg_ParseTupleAndKeywords(args
, kwargs
, "|OOO",
327 discard_const_p(char *, kwnames
),
328 &py_lp_ctx
, &py_session_info
,
332 mem_ctx
= talloc_new(NULL
);
333 if (mem_ctx
== NULL
) {
338 lp_ctx
= lpcfg_from_py_object(mem_ctx
, py_lp_ctx
);
339 if (lp_ctx
== NULL
) {
340 PyErr_SetString(PyExc_TypeError
, "Expected loadparm context");
341 talloc_free(mem_ctx
);
345 credentials
= cli_credentials_from_py_object(py_credentials
);
346 if (credentials
== NULL
) {
347 PyErr_SetString(PyExc_TypeError
, "Expected credentials");
348 talloc_free(mem_ctx
);
352 session_info
= NULL
; /* FIXME */
354 result
= reg_open_samba(NULL
, ®_ctx
, NULL
,
355 lp_ctx
, session_info
, credentials
);
356 talloc_free(mem_ctx
);
357 if (!W_ERROR_IS_OK(result
)) {
358 PyErr_SetWERROR(result
);
362 return pytalloc_steal(&PyRegistry
, reg_ctx
);
365 static PyObject
*py_open_ldb_file(PyObject
*self
, PyObject
*args
, PyObject
*kwargs
)
367 const char *kwnames
[] = { "location", "session_info", "credentials", "lp_ctx", NULL
};
368 PyObject
*py_session_info
= Py_None
, *py_credentials
= Py_None
, *py_lp_ctx
= Py_None
;
371 struct loadparm_context
*lp_ctx
;
372 struct cli_credentials
*credentials
;
373 struct hive_key
*key
;
374 struct auth_session_info
*session_info
;
377 if (!PyArg_ParseTupleAndKeywords(args
, kwargs
, "s|OOO",
378 discard_const_p(char *, kwnames
),
379 &location
, &py_session_info
,
380 &py_credentials
, &py_lp_ctx
))
383 mem_ctx
= talloc_new(NULL
);
384 if (mem_ctx
== NULL
) {
389 lp_ctx
= lpcfg_from_py_object(mem_ctx
, py_lp_ctx
);
390 if (lp_ctx
== NULL
) {
391 PyErr_SetString(PyExc_TypeError
, "Expected loadparm context");
392 talloc_free(mem_ctx
);
396 credentials
= cli_credentials_from_py_object(py_credentials
);
397 if (credentials
== NULL
) {
398 PyErr_SetString(PyExc_TypeError
, "Expected credentials");
399 talloc_free(mem_ctx
);
403 session_info
= NULL
; /* FIXME */
405 result
= reg_open_ldb_file(NULL
, location
, session_info
, credentials
,
406 s4_event_context_init(NULL
), lp_ctx
, &key
);
407 talloc_free(mem_ctx
);
408 PyErr_WERROR_NOT_OK_RAISE(result
);
410 return pytalloc_steal(&PyHiveKey
, key
);
413 static PyObject
*py_str_regtype(PyObject
*self
, PyObject
*args
)
417 if (!PyArg_ParseTuple(args
, "i", ®type
))
420 return PyUnicode_FromString(str_regtype(regtype
));
423 static PyObject
*py_get_predef_name(PyObject
*self
, PyObject
*args
)
428 if (!PyArg_ParseTuple(args
, "I", &hkey
))
431 str
= reg_get_predef_name(hkey
);
434 return PyUnicode_FromString(str
);
437 static PyMethodDef py_registry_methods
[] = {
438 { "open_samba", PY_DISCARD_FUNC_SIG(PyCFunction
, py_open_samba
),
439 METH_VARARGS
|METH_KEYWORDS
, "open_samba() -> reg" },
440 { "open_ldb", PY_DISCARD_FUNC_SIG(PyCFunction
, py_open_ldb_file
),
441 METH_VARARGS
|METH_KEYWORDS
, "open_ldb(location, session_info=None, credentials=None, loadparm_context=None) -> key" },
442 { "open_hive", PY_DISCARD_FUNC_SIG(PyCFunction
, py_open_hive
),
443 METH_VARARGS
|METH_KEYWORDS
, "open_hive(location, session_info=None, credentials=None, loadparm_context=None) -> key" },
444 { "str_regtype", py_str_regtype
, METH_VARARGS
, "str_regtype(int) -> str" },
445 { "get_predef_name", py_get_predef_name
, METH_VARARGS
, "get_predef_name(hkey) -> str" },
449 static struct PyModuleDef moduledef
= {
450 PyModuleDef_HEAD_INIT
,
451 .m_name
= "registry",
454 .m_methods
= py_registry_methods
,
457 MODULE_INIT_FUNC(registry
)
461 if (pytalloc_BaseObject_PyType_Ready(&PyHiveKey
) < 0)
464 if (pytalloc_BaseObject_PyType_Ready(&PyRegistry
) < 0)
467 if (pytalloc_BaseObject_PyType_Ready(&PyRegistryKey
) < 0)
470 m
= PyModule_Create(&moduledef
);
474 PyModule_AddObject(m
, "HKEY_CLASSES_ROOT", PyLong_FromLong(HKEY_CLASSES_ROOT
));
475 PyModule_AddObject(m
, "HKEY_CURRENT_USER", PyLong_FromLong(HKEY_CURRENT_USER
));
476 PyModule_AddObject(m
, "HKEY_LOCAL_MACHINE", PyLong_FromLong(HKEY_LOCAL_MACHINE
));
477 PyModule_AddObject(m
, "HKEY_USERS", PyLong_FromLong(HKEY_USERS
));
478 PyModule_AddObject(m
, "HKEY_PERFORMANCE_DATA", PyLong_FromLong(HKEY_PERFORMANCE_DATA
));
479 PyModule_AddObject(m
, "HKEY_CURRENT_CONFIG", PyLong_FromLong(HKEY_CURRENT_CONFIG
));
480 PyModule_AddObject(m
, "HKEY_DYN_DATA", PyLong_FromLong(HKEY_DYN_DATA
));
481 PyModule_AddObject(m
, "HKEY_PERFORMANCE_TEXT", PyLong_FromLong(HKEY_PERFORMANCE_TEXT
));
482 PyModule_AddObject(m
, "HKEY_PERFORMANCE_NLSTEXT", PyLong_FromLong(HKEY_PERFORMANCE_NLSTEXT
));
484 Py_INCREF(&PyRegistry
);
485 PyModule_AddObject(m
, "Registry", (PyObject
*)&PyRegistry
);
487 Py_INCREF(&PyHiveKey
);
488 PyModule_AddObject(m
, "HiveKey", (PyObject
*)&PyHiveKey
);
490 Py_INCREF(&PyRegistryKey
);
491 PyModule_AddObject(m
, "RegistryKey", (PyObject
*)&PyRegistryKey
);