source4/lib/messaging/pymessaging.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Copyright © Jelmer Vernooij <jelmer@samba.org> 2008
   4
   5    Based on the equivalent for EJS:
   6    Copyright © Andrew Tridgell <tridge@samba.org> 2005
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20 */
  21
  22 #include <Python.h>
  23 #include "includes.h"
  24 #include "python/modules.h"
  25 #include "libcli/util/pyerrors.h"
  26 #include "librpc/rpc/pyrpc_util.h"
  27 #include "librpc/ndr/libndr.h"
  28 #include "lib/messaging/messaging.h"
  29 #include "lib/messaging/irpc.h"
  30 #include "lib/events/events.h"
  31 #include "cluster/cluster.h"
  32 #include "param/param.h"
  33 #include "param/pyparam.h"
  34 #include "librpc/rpc/dcerpc.h"
  35 #include "librpc/gen_ndr/server_id.h"
  36 #include <pytalloc.h>
  37
  38 void initmessaging(void);
  39
  40 extern PyTypeObject imessaging_Type;
  41
  42 static bool server_id_from_py(PyObject *object, struct server_id *server_id)
  43 {
  44         if (!PyTuple_Check(object)) {
  45                 if (!py_check_dcerpc_type(object, "samba.dcerpc.server_id", "server_id")) {
  46
  47                         PyErr_SetString(PyExc_ValueError, "Expected tuple or server_id");
  48                         return false;
  49                 }
  50                 *server_id = *pytalloc_get_type(object, struct server_id);
  51                 return true;
  52         }
  53         if (PyTuple_Size(object) == 3) {
  54                 return PyArg_ParseTuple(object, "KII", &server_id->pid, &server_id->task_id, &server_id->vnn);
  55         } else {
  56                 int pid, task_id;
  57                 if (!PyArg_ParseTuple(object, "KI", &pid, &task_id))
  58                         return false;
  59                 *server_id = cluster_id(pid, task_id);
  60                 return true;
  61         }
  62 }
  63
  64 typedef struct {
  65         PyObject_HEAD
  66         TALLOC_CTX *mem_ctx;
  67         struct imessaging_context *msg_ctx;
  68 } imessaging_Object;
  69
  70 static PyObject *py_imessaging_connect(PyTypeObject *self, PyObject *args, PyObject *kwargs)
  71 {
  72         struct tevent_context *ev;
  73         const char *kwnames[] = { "own_id", "lp_ctx", NULL };
  74         PyObject *own_id = Py_None;
  75         PyObject *py_lp_ctx = Py_None;
  76         imessaging_Object *ret;
  77         struct loadparm_context *lp_ctx;
  78
  79         if (!PyArg_ParseTupleAndKeywords(args, kwargs, "|OO:connect",
  80                 discard_const_p(char *, kwnames), &own_id, &py_lp_ctx)) {
  81                 return NULL;
  82         }
  83
  84         ret = PyObject_New(imessaging_Object, &imessaging_Type);
  85         if (ret == NULL)
  86                 return NULL;
  87
  88         ret->mem_ctx = talloc_new(NULL);
  89
  90         lp_ctx = lpcfg_from_py_object(ret->mem_ctx, py_lp_ctx);
  91         if (lp_ctx == NULL) {
  92                 PyErr_SetString(PyExc_RuntimeError, "imessaging_connect unable to interpret loadparm_context");
  93                 talloc_free(ret->mem_ctx);
  94                 return NULL;
  95         }
  96
  97         ev = s4_event_context_init(ret->mem_ctx);
  98
  99         if (own_id != Py_None) {
 100                 struct server_id server_id;
 101
 102                 if (!server_id_from_py(own_id, &server_id))
 103                         return NULL;
 104
 105                 ret->msg_ctx = imessaging_init(ret->mem_ctx,
 106                                                lp_ctx,
 107                                                server_id,
 108                                                ev, true);
 109         } else {
 110                 ret->msg_ctx = imessaging_client_init(ret->mem_ctx,
 111                                                       lp_ctx,
 112                                                       ev);
 113         }
 114
 115         if (ret->msg_ctx == NULL) {
 116                 PyErr_SetString(PyExc_RuntimeError, "imessaging_connect unable to create a messaging context");
 117                 talloc_free(ret->mem_ctx);
 118                 return NULL;
 119         }
 120
 121         return (PyObject *)ret;
 122 }
 123
 124 static void py_imessaging_dealloc(PyObject *self)
 125 {
 126         imessaging_Object *iface = (imessaging_Object *)self;
 127         talloc_free(iface->msg_ctx);
 128         self->ob_type->tp_free(self);
 129 }
 130
 131 static PyObject *py_imessaging_send(PyObject *self, PyObject *args, PyObject *kwargs)
 132 {
 133         imessaging_Object *iface = (imessaging_Object *)self;
 134         uint32_t msg_type;
 135         DATA_BLOB data;
 136         PyObject *target;
 137         NTSTATUS status;
 138         struct server_id server;
 139         const char *kwnames[] = { "target", "msg_type", "data", NULL };
 140         int length;
 141
 142         if (!PyArg_ParseTupleAndKeywords(args, kwargs, "Ois#:send",
 143                 discard_const_p(char *, kwnames), &target, &msg_type, &data.data, &length)) {
 144
 145                 return NULL;
 146         }
 147
 148         data.length = length;
 149
 150         if (!server_id_from_py(target, &server))
 151                 return NULL;
 152
 153         status = imessaging_send(iface->msg_ctx, server, msg_type, &data);
 154         if (NT_STATUS_IS_ERR(status)) {
 155                 PyErr_SetNTSTATUS(status);
 156                 return NULL;
 157         }
 158
 159         Py_RETURN_NONE;
 160 }
 161
 162 static void py_msg_callback_wrapper(struct imessaging_context *msg, void *private_data,
 163                                uint32_t msg_type,
 164                                struct server_id server_id, DATA_BLOB *data)
 165 {
 166         PyObject *py_server_id, *callback = (PyObject *)private_data;
 167
 168         struct server_id *p_server_id = talloc(NULL, struct server_id);
 169         if (!p_server_id) {
 170                 PyErr_NoMemory();
 171                 return;
 172         }
 173         *p_server_id = server_id;
 174
 175         py_server_id = py_return_ndr_struct("samba.dcerpc.server_id", "server_id", p_server_id, p_server_id);
 176         talloc_unlink(NULL, p_server_id);
 177
 178         PyObject_CallFunction(callback, discard_const_p(char, "i(O)s#"), msg_type,
 179                               py_server_id,
 180                               data->data, data->length);
 181 }
 182
 183 static PyObject *py_imessaging_register(PyObject *self, PyObject *args, PyObject *kwargs)
 184 {
 185         imessaging_Object *iface = (imessaging_Object *)self;
 186         int msg_type = -1;
 187         PyObject *callback;
 188         NTSTATUS status;
 189         const char *kwnames[] = { "callback", "msg_type", NULL };
 190
 191         if (!PyArg_ParseTupleAndKeywords(args, kwargs, "O|i:register",
 192                 discard_const_p(char *, kwnames), &callback, &msg_type)) {
 193                 return NULL;
 194         }
 195
 196         Py_INCREF(callback);
 197
 198         if (msg_type == -1) {
 199                 uint32_t msg_type32 = msg_type;
 200                 status = imessaging_register_tmp(iface->msg_ctx, callback,
 201                                                 py_msg_callback_wrapper, &msg_type32);
 202                 msg_type = msg_type32;
 203         } else {
 204                 status = imessaging_register(iface->msg_ctx, callback,
 205                                     msg_type, py_msg_callback_wrapper);
 206         }
 207         if (NT_STATUS_IS_ERR(status)) {
 208                 PyErr_SetNTSTATUS(status);
 209                 return NULL;
 210         }
 211
 212         return PyLong_FromLong(msg_type);
 213 }
 214
 215 static PyObject *py_imessaging_deregister(PyObject *self, PyObject *args, PyObject *kwargs)
 216 {
 217         imessaging_Object *iface = (imessaging_Object *)self;
 218         int msg_type = -1;
 219         PyObject *callback;
 220         const char *kwnames[] = { "callback", "msg_type", NULL };
 221
 222         if (!PyArg_ParseTupleAndKeywords(args, kwargs, "O|i:deregister",
 223                 discard_const_p(char *, kwnames), &callback, &msg_type)) {
 224                 return NULL;
 225         }
 226
 227         imessaging_deregister(iface->msg_ctx, msg_type, callback);
 228
 229         Py_DECREF(callback);
 230
 231         Py_RETURN_NONE;
 232 }
 233
 234 static PyObject *py_irpc_servers_byname(PyObject *self, PyObject *args, PyObject *kwargs)
 235 {
 236         imessaging_Object *iface = (imessaging_Object *)self;
 237         char *server_name;
 238         struct server_id *ids;
 239         PyObject *pylist;
 240         int i;
 241         TALLOC_CTX *mem_ctx = talloc_new(NULL);
 242         if (!mem_ctx) {
 243                 PyErr_NoMemory();
 244                 return NULL;
 245         }
 246
 247         if (!PyArg_ParseTuple(args, "s", &server_name)) {
 248                 TALLOC_FREE(mem_ctx);
 249                 return NULL;
 250         }
 251
 252         ids = irpc_servers_byname(iface->msg_ctx, mem_ctx, server_name);
 253
 254         if (ids == NULL) {
 255                 TALLOC_FREE(mem_ctx);
 256                 PyErr_SetString(PyExc_KeyError, "No such name");
 257                 return NULL;
 258         }
 259
 260         for (i = 0; !server_id_is_disconnected(&ids[i]); i++) {
 261                 /* Do nothing */
 262         }
 263
 264         pylist = PyList_New(i);
 265         if (pylist == NULL) {
 266                 TALLOC_FREE(mem_ctx);
 267                 PyErr_NoMemory();
 268                 return NULL;
 269         }
 270         for (i = 0; !server_id_is_disconnected(&ids[i]); i++) {
 271                 PyObject *py_server_id;
 272                 struct server_id *p_server_id = talloc(NULL, struct server_id);
 273                 if (!p_server_id) {
 274                         PyErr_NoMemory();
 275                         return NULL;
 276                 }
 277                 *p_server_id = ids[i];
 278
 279                 py_server_id = py_return_ndr_struct("samba.dcerpc.server_id", "server_id", p_server_id, p_server_id);
 280                 if (!py_server_id) {
 281                         return NULL;
 282                 }
 283                 PyList_SetItem(pylist, i, py_server_id);
 284                 talloc_unlink(NULL, p_server_id);
 285         }
 286         TALLOC_FREE(mem_ctx);
 287         return pylist;
 288 }
 289
 290 static PyObject *py_irpc_all_servers(PyObject *self, PyObject *args, PyObject *kwargs)
 291 {
 292         imessaging_Object *iface = (imessaging_Object *)self;
 293         PyObject *pylist;
 294         int i;
 295         struct irpc_name_records *records;
 296         TALLOC_CTX *mem_ctx = talloc_new(NULL);
 297         if (!mem_ctx) {
 298                 PyErr_NoMemory();
 299                 return NULL;
 300         }
 301
 302         records = irpc_all_servers(iface->msg_ctx, mem_ctx);
 303         if (records == NULL) {
 304                 return NULL;
 305         }
 306
 307         pylist = PyList_New(records->num_records);
 308         if (pylist == NULL) {
 309                 TALLOC_FREE(mem_ctx);
 310                 PyErr_NoMemory();
 311                 return NULL;
 312         }
 313         for (i = 0; i < records->num_records; i++) {
 314                 PyObject *py_name_record
 315                         = py_return_ndr_struct("samba.dcerpc.irpc",
 316                                                "name_record",
 317                                                records->names[i],
 318                                                records->names[i]);
 319                 if (!py_name_record) {
 320                         return NULL;
 321                 }
 322                 PyList_SetItem(pylist, i,
 323                                py_name_record);
 324         }
 325         TALLOC_FREE(mem_ctx);
 326         return pylist;
 327 }
 328
 329 static PyMethodDef py_imessaging_methods[] = {
 330         { "send", (PyCFunction)py_imessaging_send, METH_VARARGS|METH_KEYWORDS,
 331                 "S.send(target, msg_type, data) -> None\nSend a message" },
 332         { "register", (PyCFunction)py_imessaging_register, METH_VARARGS|METH_KEYWORDS,
 333                 "S.register(callback, msg_type=None) -> msg_type\nRegister a message handler" },
 334         { "deregister", (PyCFunction)py_imessaging_deregister, METH_VARARGS|METH_KEYWORDS,
 335                 "S.deregister(callback, msg_type) -> None\nDeregister a message handler" },
 336         { "irpc_servers_byname", (PyCFunction)py_irpc_servers_byname, METH_VARARGS,
 337                 "S.irpc_servers_byname(name) -> list\nGet list of server_id values that are registered for a particular name" },
 338         { "irpc_all_servers", (PyCFunction)py_irpc_all_servers, METH_NOARGS,
 339                 "S.irpc_servers_byname() -> list\nGet list of all registered names and the associated server_id values" },
 340         { NULL, NULL, 0, NULL }
 341 };
 342
 343 static PyObject *py_imessaging_server_id(PyObject *obj, void *closure)
 344 {
 345         imessaging_Object *iface = (imessaging_Object *)obj;
 346         PyObject *py_server_id;
 347         struct server_id server_id = imessaging_get_server_id(iface->msg_ctx);
 348         struct server_id *p_server_id = talloc(NULL, struct server_id);
 349         if (!p_server_id) {
 350                 PyErr_NoMemory();
 351                 return NULL;
 352         }
 353         *p_server_id = server_id;
 354
 355         py_server_id = py_return_ndr_struct("samba.dcerpc.server_id", "server_id", p_server_id, p_server_id);
 356         talloc_unlink(NULL, p_server_id);
 357
 358         return py_server_id;
 359 }
 360
 361 static PyGetSetDef py_imessaging_getset[] = {
 362         { discard_const_p(char, "server_id"), py_imessaging_server_id, NULL,
 363           discard_const_p(char, "local server id") },
 364         { NULL },
 365 };
 366
 367
 368 PyTypeObject imessaging_Type = {
 369         PyObject_HEAD_INIT(NULL) 0,
 370         .tp_name = "messaging.Messaging",
 371         .tp_basicsize = sizeof(imessaging_Object),
 372         .tp_flags = Py_TPFLAGS_DEFAULT|Py_TPFLAGS_BASETYPE,
 373         .tp_new = py_imessaging_connect,
 374         .tp_dealloc = py_imessaging_dealloc,
 375         .tp_methods = py_imessaging_methods,
 376         .tp_getset = py_imessaging_getset,
 377         .tp_doc = "Messaging(own_id=None)\n" \
 378                   "Create a new object that can be used to communicate with the peers in the specified messaging path.\n"
 379 };
 380
 381 void initmessaging(void)
 382 {
 383         PyObject *mod;
 384
 385         if (PyType_Ready(&imessaging_Type) < 0)
 386                 return;
 387
 388         mod = Py_InitModule3("messaging", NULL, "Internal RPC");
 389         if (mod == NULL)
 390                 return;
 391
 392         Py_INCREF((PyObject *)&imessaging_Type);
 393         PyModule_AddObject(mod, "Messaging", (PyObject *)&imessaging_Type);
 394 }