2 Unix SMB/CIFS implementation.
3 Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2007
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/>.
21 #include "python/py3compat.h"
24 #include "param/pyparam.h"
25 #include "lib/socket/netif.h"
26 #include "lib/util/debug.h"
29 static PyObject
*PyExc_NTSTATUSError
;
30 static PyObject
*PyExc_WERRORError
;
31 static PyObject
*PyExc_HRESULTError
;
32 static PyObject
*PyExc_DsExtendedError
;
34 static PyObject
*py_generate_random_str(PyObject
*self
, PyObject
*args
)
39 if (!PyArg_ParseTuple(args
, "i", &len
))
42 retstr
= generate_random_str(NULL
, len
);
43 ret
= PyStr_FromString(retstr
);
48 static PyObject
*py_generate_random_password(PyObject
*self
, PyObject
*args
)
53 if (!PyArg_ParseTuple(args
, "ii", &min
, &max
))
56 retstr
= generate_random_password(NULL
, min
, max
);
60 ret
= PyStr_FromString(retstr
);
65 static PyObject
*py_generate_random_machine_password(PyObject
*self
, PyObject
*args
)
70 if (!PyArg_ParseTuple(args
, "ii", &min
, &max
))
73 retstr
= generate_random_machine_password(NULL
, min
, max
);
77 ret
= PyUnicode_FromString(retstr
);
82 static PyObject
*py_check_password_quality(PyObject
*self
, PyObject
*args
)
86 if (!PyArg_ParseTuple(args
, "s", &pass
)) {
90 return PyBool_FromLong(check_password_quality(pass
));
93 static PyObject
*py_generate_random_bytes(PyObject
*self
, PyObject
*args
)
97 uint8_t *bytes
= NULL
;
99 if (!PyArg_ParseTuple(args
, "i", &len
))
102 bytes
= talloc_zero_size(NULL
, len
);
103 generate_random_buffer(bytes
, len
);
104 ret
= PyBytes_FromStringAndSize((const char *)bytes
, len
);
109 static PyObject
*py_unix2nttime(PyObject
*self
, PyObject
*args
)
115 if (!PyArg_ParseTuple(args
, "I", &_t
)) {
120 unix_to_nt_time(&nt
, t
);
122 return PyLong_FromLongLong((uint64_t)nt
);
125 static PyObject
*py_nttime2unix(PyObject
*self
, PyObject
*args
)
129 if (!PyArg_ParseTuple(args
, "K", &nt
))
132 t
= nt_time_to_unix(nt
);
134 return PyInt_FromLong((uint64_t)t
);
137 static PyObject
*py_nttime2string(PyObject
*self
, PyObject
*args
)
143 if (!PyArg_ParseTuple(args
, "K", &nt
))
146 tmp_ctx
= talloc_new(NULL
);
147 if (tmp_ctx
== NULL
) {
152 string
= nt_time_string(tmp_ctx
, nt
);
153 ret
= PyStr_FromString(string
);
155 talloc_free(tmp_ctx
);
160 static PyObject
*py_set_debug_level(PyObject
*self
, PyObject
*args
)
163 if (!PyArg_ParseTuple(args
, "I", &level
))
165 debuglevel_set(level
);
169 static PyObject
*py_get_debug_level(PyObject
*self
)
171 return PyInt_FromLong(debuglevel_get());
174 static PyObject
*py_fault_setup(PyObject
*self
)
184 static PyObject
*py_is_ntvfs_fileserver_built(PyObject
*self
)
186 #ifdef WITH_NTVFS_FILESERVER
193 static PyObject
*py_is_heimdal_built(PyObject
*self
)
195 #ifdef SAMBA4_USES_HEIMDAL
203 return the list of interface IPs we have configured
204 takes an loadparm context, returns a list of IPs in string form
206 Does not return addresses on 127.0.0.0/8
208 static PyObject
*py_interface_ips(PyObject
*self
, PyObject
*args
)
214 struct loadparm_context
*lp_ctx
;
215 struct interface
*ifaces
;
217 int all_interfaces
= 1;
219 if (!PyArg_ParseTuple(args
, "O|i", &py_lp_ctx
, &all_interfaces
))
222 tmp_ctx
= talloc_new(NULL
);
223 if (tmp_ctx
== NULL
) {
228 lp_ctx
= lpcfg_from_py_object(tmp_ctx
, py_lp_ctx
);
229 if (lp_ctx
== NULL
) {
230 talloc_free(tmp_ctx
);
234 load_interface_list(tmp_ctx
, lp_ctx
, &ifaces
);
236 count
= iface_list_count(ifaces
);
238 /* first count how many are not loopback addresses */
239 for (ifcount
= i
= 0; i
<count
; i
++) {
240 const char *ip
= iface_list_n_ip(ifaces
, i
);
242 if (all_interfaces
) {
247 if (iface_list_same_net(ip
, "127.0.0.1", "255.0.0.0")) {
251 if (iface_list_same_net(ip
, "169.254.0.0", "255.255.0.0")) {
255 if (iface_list_same_net(ip
, "::1", "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff")) {
259 if (iface_list_same_net(ip
, "fe80::", "ffff:ffff:ffff:ffff::")) {
266 pylist
= PyList_New(ifcount
);
267 for (ifcount
= i
= 0; i
<count
; i
++) {
268 const char *ip
= iface_list_n_ip(ifaces
, i
);
270 if (all_interfaces
) {
271 PyList_SetItem(pylist
, ifcount
, PyStr_FromString(ip
));
276 if (iface_list_same_net(ip
, "127.0.0.1", "255.0.0.0")) {
280 if (iface_list_same_net(ip
, "169.254.0.0", "255.255.0.0")) {
284 if (iface_list_same_net(ip
, "::1", "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff")) {
288 if (iface_list_same_net(ip
, "fe80::", "ffff:ffff:ffff:ffff::")) {
292 PyList_SetItem(pylist
, ifcount
, PyStr_FromString(ip
));
295 talloc_free(tmp_ctx
);
299 static PyObject
*py_strcasecmp_m(PyObject
*self
, PyObject
*args
)
301 const char *s1
= NULL
;
302 const char *s2
= NULL
;
304 if (!PyArg_ParseTuple(args
, PYARG_STR_UNI
306 "utf8", &s1
, "utf8", &s2
)) {
310 cmp_result
= strcasecmp_m(s1
, s2
);
311 PyMem_Free(discard_const_p(char, s1
));
312 PyMem_Free(discard_const_p(char, s2
));
313 return PyInt_FromLong(cmp_result
);
316 static PyObject
*py_strstr_m(PyObject
*self
, PyObject
*args
)
318 const char *s1
= NULL
;
319 const char *s2
= NULL
;
320 char *strstr_ret
= NULL
;
321 PyObject
*result
= NULL
;
322 if (!PyArg_ParseTuple(args
, PYARG_STR_UNI
324 "utf8", &s1
, "utf8", &s2
))
327 strstr_ret
= strstr_m(s1
, s2
);
329 PyMem_Free(discard_const_p(char, s1
));
330 PyMem_Free(discard_const_p(char, s2
));
333 result
= PyUnicode_FromString(strstr_ret
);
334 PyMem_Free(discard_const_p(char, s1
));
335 PyMem_Free(discard_const_p(char, s2
));
339 static PyMethodDef py_misc_methods
[] = {
340 { "generate_random_str", (PyCFunction
)py_generate_random_str
, METH_VARARGS
,
341 "generate_random_str(len) -> string\n"
342 "Generate random string with specified length." },
343 { "generate_random_password", (PyCFunction
)py_generate_random_password
,
344 METH_VARARGS
, "generate_random_password(min, max) -> string\n"
345 "Generate random password (based on printable ascii characters) "
346 "with a length >= min and <= max." },
347 { "generate_random_machine_password", (PyCFunction
)py_generate_random_machine_password
,
348 METH_VARARGS
, "generate_random_machine_password(min, max) -> string\n"
349 "Generate random password "
350 "(based on random utf16 characters converted to utf8 or "
351 "random ascii characters if 'unix charset' is not 'utf8')"
352 "with a length >= min (at least 14) and <= max (at most 255)." },
353 { "check_password_quality", (PyCFunction
)py_check_password_quality
,
354 METH_VARARGS
, "check_password_quality(pass) -> bool\n"
355 "Check password quality against Samba's check_password_quality,"
356 "the implementation of Microsoft's rules:"
357 "http://msdn.microsoft.com/en-us/subscriptions/cc786468%28v=ws.10%29.aspx"
359 { "unix2nttime", (PyCFunction
)py_unix2nttime
, METH_VARARGS
,
360 "unix2nttime(timestamp) -> nttime" },
361 { "nttime2unix", (PyCFunction
)py_nttime2unix
, METH_VARARGS
,
362 "nttime2unix(nttime) -> timestamp" },
363 { "nttime2string", (PyCFunction
)py_nttime2string
, METH_VARARGS
,
364 "nttime2string(nttime) -> string" },
365 { "set_debug_level", (PyCFunction
)py_set_debug_level
, METH_VARARGS
,
367 { "get_debug_level", (PyCFunction
)py_get_debug_level
, METH_NOARGS
,
369 { "fault_setup", (PyCFunction
)py_fault_setup
, METH_NOARGS
,
370 "setup the default samba panic handler" },
371 { "interface_ips", (PyCFunction
)py_interface_ips
, METH_VARARGS
,
372 "interface_ips(lp_ctx[, all_interfaces) -> list_of_ifaces\n"
374 "get interface IP address list"},
375 { "strcasecmp_m", (PyCFunction
)py_strcasecmp_m
, METH_VARARGS
,
376 "(for testing) compare two strings using Samba's strcasecmp_m()"},
377 { "strstr_m", (PyCFunction
)py_strstr_m
, METH_VARARGS
,
378 "(for testing) find one string in another with Samba's strstr_m()"},
379 { "is_ntvfs_fileserver_built", (PyCFunction
)py_is_ntvfs_fileserver_built
, METH_NOARGS
,
380 "is the NTVFS file server built in this installation?" },
381 { "is_heimdal_built", (PyCFunction
)py_is_heimdal_built
, METH_NOARGS
,
382 "is Samba built with Heimdal Kerberbos?" },
383 { "generate_random_bytes",
384 (PyCFunction
)py_generate_random_bytes
,
386 "generate_random_bytes(len) -> bytes\n"
387 "Generate random bytes with specified length." },
391 static struct PyModuleDef moduledef
= {
392 PyModuleDef_HEAD_INIT
,
394 .m_doc
= "Python bindings for miscellaneous Samba functions.",
396 .m_methods
= py_misc_methods
,
399 MODULE_INIT_FUNC(_glue
)
403 debug_setup_talloc_log();
405 m
= PyModule_Create(&moduledef
);
409 PyModule_AddObject(m
, "version",
410 PyStr_FromString(SAMBA_VERSION_STRING
));
411 PyExc_NTSTATUSError
= PyErr_NewException(discard_const_p(char, "samba.NTSTATUSError"), PyExc_RuntimeError
, NULL
);
412 if (PyExc_NTSTATUSError
!= NULL
) {
413 Py_INCREF(PyExc_NTSTATUSError
);
414 PyModule_AddObject(m
, "NTSTATUSError", PyExc_NTSTATUSError
);
417 PyExc_WERRORError
= PyErr_NewException(discard_const_p(char, "samba.WERRORError"), PyExc_RuntimeError
, NULL
);
418 if (PyExc_WERRORError
!= NULL
) {
419 Py_INCREF(PyExc_WERRORError
);
420 PyModule_AddObject(m
, "WERRORError", PyExc_WERRORError
);
423 PyExc_HRESULTError
= PyErr_NewException(discard_const_p(char, "samba.HRESULTError"), PyExc_RuntimeError
, NULL
);
424 if (PyExc_HRESULTError
!= NULL
) {
425 Py_INCREF(PyExc_HRESULTError
);
426 PyModule_AddObject(m
, "HRESULTError", PyExc_HRESULTError
);
429 PyExc_DsExtendedError
= PyErr_NewException(discard_const_p(char, "samba.DsExtendedError"), PyExc_RuntimeError
, NULL
);
430 if (PyExc_DsExtendedError
!= NULL
) {
431 Py_INCREF(PyExc_DsExtendedError
);
432 PyModule_AddObject(m
, "DsExtendedError", PyExc_DsExtendedError
);