2
Unix SMB/CIFS implementation.
3
Samba utility functions
4
Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2008
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/>.
22
#include <structmember.h>
23
#include "librpc/rpc/pyrpc.h"
24
#include "librpc/rpc/dcerpc.h"
25
#include "lib/events/events.h"
26
#include "param/pyparam.h"
28
#ifndef Py_RETURN_NONE
29
#define Py_RETURN_NONE return Py_INCREF(Py_None), Py_None
32
static PyObject *py_dcerpc_run_function(dcerpc_InterfaceObject *iface,
33
const struct PyNdrRpcMethodDef *md,
34
PyObject *args, PyObject *kwargs)
39
PyObject *result = Py_None;
41
if (md->pack_in_data == NULL || md->unpack_out_data == NULL) {
42
PyErr_SetString(PyExc_NotImplementedError, "No marshalling code available yet");
46
mem_ctx = talloc_new(NULL);
47
if (mem_ctx == NULL) {
52
r = talloc_zero_size(mem_ctx, md->table->calls[md->opnum].struct_size);
58
if (!md->pack_in_data(args, kwargs, r)) {
63
status = md->call(iface->pipe, mem_ctx, r);
64
if (NT_STATUS_IS_ERR(status)) {
65
PyErr_SetDCERPCStatus(iface->pipe, status);
70
result = md->unpack_out_data(r);
76
static PyObject *py_dcerpc_call_wrapper(PyObject *self, PyObject *args, void *wrapped, PyObject *kwargs)
78
dcerpc_InterfaceObject *iface = (dcerpc_InterfaceObject *)self;
79
const struct PyNdrRpcMethodDef *md = (const struct PyNdrRpcMethodDef *)wrapped;
81
return py_dcerpc_run_function(iface, md, args, kwargs);
85
bool PyInterface_AddNdrRpcMethods(PyTypeObject *ifacetype, const struct PyNdrRpcMethodDef *mds)
88
for (i = 0; mds[i].name; i++) {
90
struct wrapperbase *wb = (struct wrapperbase *)calloc(sizeof(struct wrapperbase), 1);
92
wb->name = discard_const_p(char, mds[i].name);
93
wb->flags = PyWrapperFlag_KEYWORDS;
94
wb->wrapper = (wrapperfunc)py_dcerpc_call_wrapper;
95
wb->doc = discard_const_p(char, mds[i].doc);
97
ret = PyDescr_NewWrapper(ifacetype, wb, discard_const_p(void, &mds[i]));
99
PyDict_SetItemString(ifacetype->tp_dict, mds[i].name,
106
static bool PyString_AsGUID(PyObject *object, struct GUID *uuid)
109
status = GUID_from_string(PyString_AsString(object), uuid);
110
if (NT_STATUS_IS_ERR(status)) {
111
PyErr_SetNTSTATUS(status);
117
static bool ndr_syntax_from_py_object(PyObject *object, struct ndr_syntax_id *syntax_id)
119
ZERO_STRUCTP(syntax_id);
121
if (PyString_Check(object)) {
122
return PyString_AsGUID(object, &syntax_id->uuid);
123
} else if (PyTuple_Check(object)) {
124
if (PyTuple_Size(object) < 1 || PyTuple_Size(object) > 2) {
125
PyErr_SetString(PyExc_ValueError, "Syntax ID tuple has invalid size");
129
if (!PyString_Check(PyTuple_GetItem(object, 0))) {
130
PyErr_SetString(PyExc_ValueError, "Expected GUID as first element in tuple");
134
if (!PyString_AsGUID(PyTuple_GetItem(object, 0), &syntax_id->uuid))
137
if (!PyInt_Check(PyTuple_GetItem(object, 1))) {
138
PyErr_SetString(PyExc_ValueError, "Expected version as second element in tuple");
142
syntax_id->if_version = PyInt_AsLong(PyTuple_GetItem(object, 1));
146
PyErr_SetString(PyExc_TypeError, "Expected UUID or syntax id tuple");
150
static PyObject *py_iface_server_name(PyObject *obj, void *closure)
152
const char *server_name;
153
dcerpc_InterfaceObject *iface = (dcerpc_InterfaceObject *)obj;
155
server_name = dcerpc_server_name(iface->pipe);
156
if (server_name == NULL)
159
return PyString_FromString(server_name);
162
static PyObject *py_ndr_syntax_id(struct ndr_syntax_id *syntax_id)
167
uuid_str = GUID_string(NULL, &syntax_id->uuid);
168
if (uuid_str == NULL)
171
ret = Py_BuildValue("(s,i)", uuid_str, syntax_id->if_version);
173
talloc_free(uuid_str);
178
static PyObject *py_iface_abstract_syntax(PyObject *obj, void *closure)
180
dcerpc_InterfaceObject *iface = (dcerpc_InterfaceObject *)obj;
182
return py_ndr_syntax_id(&iface->pipe->syntax);
185
static PyObject *py_iface_transfer_syntax(PyObject *obj, void *closure)
187
dcerpc_InterfaceObject *iface = (dcerpc_InterfaceObject *)obj;
189
return py_ndr_syntax_id(&iface->pipe->transfer_syntax);
192
static PyGetSetDef dcerpc_interface_getsetters[] = {
193
{ discard_const_p(char, "server_name"), py_iface_server_name, NULL,
194
discard_const_p(char, "name of the server, if connected over SMB") },
195
{ discard_const_p(char, "abstract_syntax"), py_iface_abstract_syntax, NULL,
196
discard_const_p(char, "syntax id of the abstract syntax") },
197
{ discard_const_p(char, "transfer_syntax"), py_iface_transfer_syntax, NULL,
198
discard_const_p(char, "syntax id of the transfersyntax") },
202
static PyMemberDef dcerpc_interface_members[] = {
203
{ discard_const_p(char, "request_timeout"), T_INT,
204
offsetof(struct dcerpc_pipe, request_timeout), 0,
205
discard_const_p(char, "request timeout, in seconds") },
209
void PyErr_SetDCERPCStatus(struct dcerpc_pipe *p, NTSTATUS status)
211
if (p != NULL && NT_STATUS_EQUAL(status, NT_STATUS_NET_WRITE_FAULT)) {
212
const char *errstr = dcerpc_errstr(NULL, p->last_fault_code);
213
PyErr_SetObject(PyExc_RuntimeError,
214
Py_BuildValue("(i,s)", p->last_fault_code,
217
PyErr_SetNTSTATUS(status);
221
static PyObject *py_iface_request(PyObject *self, PyObject *args, PyObject *kwargs)
223
dcerpc_InterfaceObject *iface = (dcerpc_InterfaceObject *)self;
225
DATA_BLOB data_in, data_out;
230
PyObject *object = NULL;
231
struct GUID object_guid;
232
TALLOC_CTX *mem_ctx = talloc_new(NULL);
233
const char *kwnames[] = { "opnum", "data", "object", NULL };
235
if (!PyArg_ParseTupleAndKeywords(args, kwargs, "is#|O:request",
236
discard_const_p(char *, kwnames), &opnum, &in_data, &in_length, &object)) {
240
data_in.data = (uint8_t *)talloc_memdup(mem_ctx, in_data, in_length);
241
data_in.length = in_length;
243
ZERO_STRUCT(data_out);
245
if (object != NULL && !PyString_AsGUID(object, &object_guid)) {
249
status = dcerpc_request(iface->pipe, object?&object_guid:NULL,
250
opnum, false, mem_ctx, &data_in, &data_out);
252
if (NT_STATUS_IS_ERR(status)) {
253
PyErr_SetDCERPCStatus(iface->pipe, status);
254
talloc_free(mem_ctx);
258
ret = PyString_FromStringAndSize((char *)data_out.data, data_out.length);
260
talloc_free(mem_ctx);
264
static PyObject *py_iface_alter_context(PyObject *self, PyObject *args, PyObject *kwargs)
266
dcerpc_InterfaceObject *iface = (dcerpc_InterfaceObject *)self;
268
const char *kwnames[] = { "abstract_syntax", "transfer_syntax", NULL };
269
PyObject *py_abstract_syntax = Py_None, *py_transfer_syntax = Py_None;
270
struct ndr_syntax_id abstract_syntax, transfer_syntax;
272
if (!PyArg_ParseTupleAndKeywords(args, kwargs, "O|O:alter_context",
273
discard_const_p(char *, kwnames), &py_abstract_syntax,
274
&py_transfer_syntax)) {
278
if (!ndr_syntax_from_py_object(py_abstract_syntax, &abstract_syntax))
281
if (py_transfer_syntax == Py_None) {
282
transfer_syntax = ndr_transfer_syntax;
284
if (!ndr_syntax_from_py_object(py_transfer_syntax,
289
status = dcerpc_alter_context(iface->pipe, iface->pipe, &abstract_syntax,
292
if (NT_STATUS_IS_ERR(status)) {
293
PyErr_SetDCERPCStatus(iface->pipe, status);
300
PyObject *py_dcerpc_interface_init_helper(PyTypeObject *type, PyObject *args, PyObject *kwargs, const struct ndr_interface_table *table)
302
dcerpc_InterfaceObject *ret;
303
const char *binding_string;
304
struct cli_credentials *credentials;
305
struct loadparm_context *lp_ctx = NULL;
306
PyObject *py_lp_ctx = Py_None, *py_credentials = Py_None, *py_basis = Py_None;
307
TALLOC_CTX *mem_ctx = NULL;
308
struct tevent_context *event_ctx;
311
const char *kwnames[] = {
312
"binding", "lp_ctx", "credentials", "basis_connection", NULL
314
extern struct cli_credentials *cli_credentials_from_py_object(PyObject *py_obj);
316
if (!PyArg_ParseTupleAndKeywords(args, kwargs, "s|OOO:samr", discard_const_p(char *, kwnames), &binding_string, &py_lp_ctx, &py_credentials, &py_basis)) {
320
lp_ctx = lp_from_py_object(py_lp_ctx);
321
if (lp_ctx == NULL) {
322
PyErr_SetString(PyExc_TypeError, "Expected loadparm context");
326
status = dcerpc_init(lp_ctx);
327
if (!NT_STATUS_IS_OK(status)) {
328
PyErr_SetNTSTATUS(status);
331
credentials = cli_credentials_from_py_object(py_credentials);
332
if (credentials == NULL) {
333
PyErr_SetString(PyExc_TypeError, "Expected credentials");
336
ret = PyObject_New(dcerpc_InterfaceObject, type);
338
event_ctx = event_context_init(mem_ctx);
340
if (py_basis != Py_None) {
341
struct dcerpc_pipe *base_pipe;
343
if (!PyObject_TypeCheck(py_basis, &dcerpc_InterfaceType)) {
344
PyErr_SetString(PyExc_ValueError, "basis_connection must be a DCE/RPC connection");
345
talloc_free(mem_ctx);
349
base_pipe = ((dcerpc_InterfaceObject *)py_basis)->pipe;
351
status = dcerpc_secondary_context(base_pipe, &ret->pipe, table);
353
status = dcerpc_pipe_connect(NULL, &ret->pipe, binding_string,
354
table, credentials, event_ctx, lp_ctx);
356
if (NT_STATUS_IS_ERR(status)) {
357
PyErr_SetNTSTATUS(status);
358
talloc_free(mem_ctx);
362
ret->pipe->conn->flags |= DCERPC_NDR_REF_ALLOC;
363
return (PyObject *)ret;
366
static PyMethodDef dcerpc_interface_methods[] = {
367
{ "request", (PyCFunction)py_iface_request, METH_VARARGS|METH_KEYWORDS, "S.request(opnum, data, object=None) -> data\nMake a raw request" },
368
{ "alter_context", (PyCFunction)py_iface_alter_context, METH_VARARGS|METH_KEYWORDS, "S.alter_context(syntax)\nChange to a different interface" },
369
{ NULL, NULL, 0, NULL },
373
static void dcerpc_interface_dealloc(PyObject* self)
375
dcerpc_InterfaceObject *interface = (dcerpc_InterfaceObject *)self;
376
talloc_free(interface->pipe);
380
static PyObject *dcerpc_interface_new(PyTypeObject *self, PyObject *args, PyObject *kwargs)
382
dcerpc_InterfaceObject *ret;
383
const char *binding_string;
384
struct cli_credentials *credentials;
385
struct loadparm_context *lp_ctx = NULL;
386
PyObject *py_lp_ctx = Py_None, *py_credentials = Py_None;
387
TALLOC_CTX *mem_ctx = NULL;
388
struct tevent_context *event_ctx;
391
PyObject *syntax, *py_basis = Py_None;
392
const char *kwnames[] = {
393
"binding", "syntax", "lp_ctx", "credentials", "basis_connection", NULL
395
extern struct cli_credentials *cli_credentials_from_py_object(PyObject *py_obj);
396
struct ndr_interface_table *table;
398
if (!PyArg_ParseTupleAndKeywords(args, kwargs, "sO|OOO:connect", discard_const_p(char *, kwnames), &binding_string, &syntax, &py_lp_ctx, &py_credentials, &py_basis)) {
402
lp_ctx = lp_from_py_object(py_lp_ctx);
403
if (lp_ctx == NULL) {
404
PyErr_SetString(PyExc_TypeError, "Expected loadparm context");
408
credentials = cli_credentials_from_py_object(py_credentials);
409
if (credentials == NULL) {
410
PyErr_SetString(PyExc_TypeError, "Expected credentials");
413
ret = PyObject_New(dcerpc_InterfaceObject, &dcerpc_InterfaceType);
415
event_ctx = s4_event_context_init(mem_ctx);
417
/* Create a dummy interface table struct. TODO: In the future, we should rather just allow
418
* connecting without requiring an interface table.
421
table = talloc_zero(mem_ctx, struct ndr_interface_table);
424
PyErr_SetString(PyExc_MemoryError, "Allocating interface table");
428
if (!ndr_syntax_from_py_object(syntax, &table->syntax_id)) {
434
if (py_basis != Py_None) {
435
struct dcerpc_pipe *base_pipe;
437
if (!PyObject_TypeCheck(py_basis, &dcerpc_InterfaceType)) {
438
PyErr_SetString(PyExc_ValueError, "basis_connection must be a DCE/RPC connection");
439
talloc_free(mem_ctx);
443
base_pipe = ((dcerpc_InterfaceObject *)py_basis)->pipe;
445
status = dcerpc_secondary_context(base_pipe, &ret->pipe,
447
ret->pipe = talloc_steal(NULL, ret->pipe);
449
status = dcerpc_pipe_connect(NULL, &ret->pipe, binding_string,
450
table, credentials, event_ctx, lp_ctx);
453
if (NT_STATUS_IS_ERR(status)) {
454
PyErr_SetDCERPCStatus(ret->pipe, status);
455
talloc_free(mem_ctx);
458
ret->pipe->conn->flags |= DCERPC_NDR_REF_ALLOC;
459
return (PyObject *)ret;
462
PyTypeObject dcerpc_InterfaceType = {
463
PyObject_HEAD_INIT(NULL) 0,
464
.tp_name = "dcerpc.ClientConnection",
465
.tp_basicsize = sizeof(dcerpc_InterfaceObject),
466
.tp_dealloc = dcerpc_interface_dealloc,
467
.tp_getset = dcerpc_interface_getsetters,
468
.tp_members = dcerpc_interface_members,
469
.tp_methods = dcerpc_interface_methods,
470
.tp_doc = "ClientConnection(binding, syntax, lp_ctx=None, credentials=None) -> connection\n"
472
"binding should be a DCE/RPC binding string (for example: ncacn_ip_tcp:127.0.0.1)\n"
473
"syntax should be a tuple with a GUID and version number of an interface\n"
474
"lp_ctx should be a path to a smb.conf file or a param.LoadParm object\n"
475
"credentials should be a credentials.Credentials object.\n\n",
476
.tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
477
.tp_new = dcerpc_interface_new,
484
if (PyType_Ready(&dcerpc_InterfaceType) < 0)
487
m = Py_InitModule3("base", NULL, "DCE/RPC protocol implementation");
491
Py_INCREF((PyObject *)&dcerpc_InterfaceType);
492
PyModule_AddObject(m, "ClientConnection", (PyObject *)&dcerpc_InterfaceType);