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"
28 static PyObject
*PyExc_NTSTATUSError
;
29 static PyObject
*PyExc_WERRORError
;
30 static PyObject
*PyExc_HRESULTError
;
31 static PyObject
*PyExc_DsExtendedError
;
33 static PyObject
*py_generate_random_str(PyObject
*self
, PyObject
*args
)
38 if (!PyArg_ParseTuple(args
, "i", &len
))
41 retstr
= generate_random_str(NULL
, len
);
42 ret
= PyStr_FromString(retstr
);
47 static PyObject
*py_generate_random_password(PyObject
*self
, PyObject
*args
)
52 if (!PyArg_ParseTuple(args
, "ii", &min
, &max
))
55 retstr
= generate_random_password(NULL
, min
, max
);
59 ret
= PyStr_FromString(retstr
);
64 static PyObject
*py_generate_random_machine_password(PyObject
*self
, PyObject
*args
)
69 if (!PyArg_ParseTuple(args
, "ii", &min
, &max
))
72 retstr
= generate_random_machine_password(NULL
, min
, max
);
76 ret
= PyUnicode_FromString(retstr
);
81 static PyObject
*py_check_password_quality(PyObject
*self
, PyObject
*args
)
85 if (!PyArg_ParseTuple(args
, "s", &pass
)) {
89 return PyBool_FromLong(check_password_quality(pass
));
92 static PyObject
*py_generate_random_bytes(PyObject
*self
, PyObject
*args
)
96 uint8_t *bytes
= NULL
;
98 if (!PyArg_ParseTuple(args
, "i", &len
))
101 bytes
= talloc_zero_size(NULL
, len
);
102 generate_random_buffer(bytes
, len
);
103 ret
= PyBytes_FromStringAndSize((const char *)bytes
, len
);
108 static PyObject
*py_unix2nttime(PyObject
*self
, PyObject
*args
)
114 if (!PyArg_ParseTuple(args
, "I", &_t
)) {
119 unix_to_nt_time(&nt
, t
);
121 return PyLong_FromLongLong((uint64_t)nt
);
124 static PyObject
*py_nttime2unix(PyObject
*self
, PyObject
*args
)
128 if (!PyArg_ParseTuple(args
, "K", &nt
))
131 t
= nt_time_to_unix(nt
);
133 return PyInt_FromLong((uint64_t)t
);
136 static PyObject
*py_nttime2string(PyObject
*self
, PyObject
*args
)
142 if (!PyArg_ParseTuple(args
, "K", &nt
))
145 tmp_ctx
= talloc_new(NULL
);
146 if (tmp_ctx
== NULL
) {
151 string
= nt_time_string(tmp_ctx
, nt
);
152 ret
= PyStr_FromString(string
);
154 talloc_free(tmp_ctx
);
159 static PyObject
*py_set_debug_level(PyObject
*self
, PyObject
*args
)
162 if (!PyArg_ParseTuple(args
, "I", &level
))
164 (DEBUGLEVEL
) = level
;
168 static PyObject
*py_get_debug_level(PyObject
*self
)
170 return PyInt_FromLong(DEBUGLEVEL
);
173 static PyObject
*py_is_ntvfs_fileserver_built(PyObject
*self
)
175 #ifdef WITH_NTVFS_FILESERVER
182 static PyObject
*py_is_heimdal_built(PyObject
*self
)
184 #ifdef SAMBA4_USES_HEIMDAL
192 return the list of interface IPs we have configured
193 takes an loadparm context, returns a list of IPs in string form
195 Does not return addresses on 127.0.0.0/8
197 static PyObject
*py_interface_ips(PyObject
*self
, PyObject
*args
)
203 struct loadparm_context
*lp_ctx
;
204 struct interface
*ifaces
;
206 int all_interfaces
= 1;
208 if (!PyArg_ParseTuple(args
, "O|i", &py_lp_ctx
, &all_interfaces
))
211 tmp_ctx
= talloc_new(NULL
);
212 if (tmp_ctx
== NULL
) {
217 lp_ctx
= lpcfg_from_py_object(tmp_ctx
, py_lp_ctx
);
218 if (lp_ctx
== NULL
) {
219 talloc_free(tmp_ctx
);
223 load_interface_list(tmp_ctx
, lp_ctx
, &ifaces
);
225 count
= iface_list_count(ifaces
);
227 /* first count how many are not loopback addresses */
228 for (ifcount
= i
= 0; i
<count
; i
++) {
229 const char *ip
= iface_list_n_ip(ifaces
, i
);
231 if (all_interfaces
) {
236 if (iface_list_same_net(ip
, "127.0.0.1", "255.0.0.0")) {
240 if (iface_list_same_net(ip
, "169.254.0.0", "255.255.0.0")) {
244 if (iface_list_same_net(ip
, "::1", "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff")) {
248 if (iface_list_same_net(ip
, "fe80::", "ffff:ffff:ffff:ffff::")) {
255 pylist
= PyList_New(ifcount
);
256 for (ifcount
= i
= 0; i
<count
; i
++) {
257 const char *ip
= iface_list_n_ip(ifaces
, i
);
259 if (all_interfaces
) {
260 PyList_SetItem(pylist
, ifcount
, PyStr_FromString(ip
));
265 if (iface_list_same_net(ip
, "127.0.0.1", "255.0.0.0")) {
269 if (iface_list_same_net(ip
, "169.254.0.0", "255.255.0.0")) {
273 if (iface_list_same_net(ip
, "::1", "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff")) {
277 if (iface_list_same_net(ip
, "fe80::", "ffff:ffff:ffff:ffff::")) {
281 PyList_SetItem(pylist
, ifcount
, PyStr_FromString(ip
));
284 talloc_free(tmp_ctx
);
288 static PyObject
*py_strcasecmp_m(PyObject
*self
, PyObject
*args
)
292 if (!PyArg_ParseTuple(args
, "ss", &s1
, &s2
))
295 return PyInt_FromLong(strcasecmp_m(s1
, s2
));
298 static PyObject
*py_strstr_m(PyObject
*self
, PyObject
*args
)
302 if (!PyArg_ParseTuple(args
, "ss", &s1
, &s2
))
305 ret
= strstr_m(s1
, s2
);
309 return PyStr_FromString(ret
);
312 static PyMethodDef py_misc_methods
[] = {
313 { "generate_random_str", (PyCFunction
)py_generate_random_str
, METH_VARARGS
,
314 "generate_random_str(len) -> string\n"
315 "Generate random string with specified length." },
316 { "generate_random_password", (PyCFunction
)py_generate_random_password
,
317 METH_VARARGS
, "generate_random_password(min, max) -> string\n"
318 "Generate random password (based on printable ascii characters) "
319 "with a length >= min and <= max." },
320 { "generate_random_machine_password", (PyCFunction
)py_generate_random_machine_password
,
321 METH_VARARGS
, "generate_random_machine_password(min, max) -> string\n"
322 "Generate random password "
323 "(based on random utf16 characters converted to utf8 or "
324 "random ascii characters if 'unix charset' is not 'utf8')"
325 "with a length >= min (at least 14) and <= max (at most 255)." },
326 { "check_password_quality", (PyCFunction
)py_check_password_quality
,
327 METH_VARARGS
, "check_password_quality(pass) -> bool\n"
328 "Check password quality against Samba's check_password_quality,"
329 "the implementation of Microsoft's rules:"
330 "http://msdn.microsoft.com/en-us/subscriptions/cc786468%28v=ws.10%29.aspx"
332 { "unix2nttime", (PyCFunction
)py_unix2nttime
, METH_VARARGS
,
333 "unix2nttime(timestamp) -> nttime" },
334 { "nttime2unix", (PyCFunction
)py_nttime2unix
, METH_VARARGS
,
335 "nttime2unix(nttime) -> timestamp" },
336 { "nttime2string", (PyCFunction
)py_nttime2string
, METH_VARARGS
,
337 "nttime2string(nttime) -> string" },
338 { "set_debug_level", (PyCFunction
)py_set_debug_level
, METH_VARARGS
,
340 { "get_debug_level", (PyCFunction
)py_get_debug_level
, METH_NOARGS
,
342 { "interface_ips", (PyCFunction
)py_interface_ips
, METH_VARARGS
,
343 "interface_ips(lp_ctx[, all_interfaces) -> list_of_ifaces\n"
345 "get interface IP address list"},
346 { "strcasecmp_m", (PyCFunction
)py_strcasecmp_m
, METH_VARARGS
,
347 "(for testing) compare two strings using Samba's strcasecmp_m()"},
348 { "strstr_m", (PyCFunction
)py_strstr_m
, METH_VARARGS
,
349 "(for testing) find one string in another with Samba's strstr_m()"},
350 { "is_ntvfs_fileserver_built", (PyCFunction
)py_is_ntvfs_fileserver_built
, METH_NOARGS
,
351 "is the NTVFS file server built in this installation?" },
352 { "is_heimdal_built", (PyCFunction
)py_is_heimdal_built
, METH_NOARGS
,
353 "is Samba built with Heimdal Kerberbos?" },
354 { "generate_random_bytes",
355 (PyCFunction
)py_generate_random_bytes
,
357 "generate_random_bytes(len) -> bytes\n"
358 "Generate random bytes with specified length." },
362 static struct PyModuleDef moduledef
= {
363 PyModuleDef_HEAD_INIT
,
365 .m_doc
= "Python bindings for miscellaneous Samba functions.",
367 .m_methods
= py_misc_methods
,
370 MODULE_INIT_FUNC(_glue
)
374 debug_setup_talloc_log();
376 m
= PyModule_Create(&moduledef
);
380 PyModule_AddObject(m
, "version",
381 PyStr_FromString(SAMBA_VERSION_STRING
));
382 PyExc_NTSTATUSError
= PyErr_NewException(discard_const_p(char, "samba.NTSTATUSError"), PyExc_RuntimeError
, NULL
);
383 if (PyExc_NTSTATUSError
!= NULL
) {
384 Py_INCREF(PyExc_NTSTATUSError
);
385 PyModule_AddObject(m
, "NTSTATUSError", PyExc_NTSTATUSError
);
388 PyExc_WERRORError
= PyErr_NewException(discard_const_p(char, "samba.WERRORError"), PyExc_RuntimeError
, NULL
);
389 if (PyExc_WERRORError
!= NULL
) {
390 Py_INCREF(PyExc_WERRORError
);
391 PyModule_AddObject(m
, "WERRORError", PyExc_WERRORError
);
394 PyExc_HRESULTError
= PyErr_NewException(discard_const_p(char, "samba.HRESULTError"), PyExc_RuntimeError
, NULL
);
395 if (PyExc_HRESULTError
!= NULL
) {
396 Py_INCREF(PyExc_HRESULTError
);
397 PyModule_AddObject(m
, "HRESULTError", PyExc_HRESULTError
);
400 PyExc_DsExtendedError
= PyErr_NewException(discard_const_p(char, "samba.DsExtendedError"), PyExc_RuntimeError
, NULL
);
401 if (PyExc_DsExtendedError
!= NULL
) {
402 Py_INCREF(PyExc_DsExtendedError
);
403 PyModule_AddObject(m
, "DsExtendedError", PyExc_DsExtendedError
);