src/modules/rlm_python/rlm_python.c

   1 /*
   2  * rlm_python.c
   3  *
   4  *
   5  *   This program is free software; you can redistribute it and/or modify
   6  *   it under the terms of the GNU General Public License as published by
   7  *   the Free Software Foundation; either version 2 of the License, or
   8  *   (at your option) any later version.
   9  *
  10  *   This program is distributed in the hope that it will be useful,
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  *   GNU General Public License for more details.
  14  *
  15  *   You should have received a copy of the GNU General Public License
  16  *   along with this program; if not, write to the Free Software
  17  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  18  *
  19  * Copyright 2000  The FreeRADIUS server project
  20  * Copyright 2002  Miguel A.L. Paraz <mparaz@mparaz.com>
  21  * Copyright 2002  Imperium Technology, Inc.
  22  */
  23
  24 #include <Python.h>
  25
  26 #include "autoconf.h"
  27 #include "libradius.h"
  28
  29 #include <stdio.h>
  30 #include <stdlib.h>
  31
  32 #include "radiusd.h"
  33 #include "modules.h"
  34 #include "conffile.h"
  35
  36 static const char rcsid[] = "$Id$";
  37
  38 /*
  39  *      Define a structure for our module configuration.
  40  *
  41  *      These variables do not need to be in a structure, but it's
  42  *      a lot cleaner to do so, and a pointer to the structure can
  43  *      be used as the instance handle.
  44  */
  45 typedef struct rlm_python_t {
  46     /* Config section */
  47
  48     /* Names of modules */
  49     char
  50         *mod_instantiate,
  51         *mod_authorize,
  52         *mod_authenticate,
  53         *mod_preacct,
  54         *mod_accounting,
  55         *mod_checksimul,
  56         *mod_detach,
  57
  58     /* Names of functions */
  59         *func_instantiate,
  60         *func_authorize,
  61         *func_authenticate,
  62         *func_preacct,
  63         *func_accounting,
  64         *func_checksimul,
  65         *func_detach;
  66
  67
  68     /* End Config section */
  69
  70
  71     /* Python objects for modules */
  72     PyObject
  73         *pModule_builtin,
  74         *pModule_instantiate,
  75         *pModule_authorize,
  76         *pModule_authenticate,
  77         *pModule_preacct,
  78         *pModule_accounting,
  79         *pModule_checksimul,
  80         *pModule_detach,
  81
  82
  83         /* Functions */
  84
  85         *pFunc_instantiate,
  86         *pFunc_authorize,
  87         *pFunc_authenticate,
  88         *pFunc_preacct,
  89         *pFunc_accounting,
  90         *pFunc_checksimul,
  91         *pFunc_detach;
  92
  93 } rlm_python_t;
  94
  95 /*
  96  *      A mapping of configuration file names to internal variables.
  97  *
  98  *      Note that the string is dynamically allocated, so it MUST
  99  *      be freed.  When the configuration file parse re-reads the string,
 100  *      it free's the old one, and strdup's the new one, placing the pointer
 101  *      to the strdup'd string into 'config.string'.  This gets around
 102  *      buffer over-flows.
 103  */
 104 static CONF_PARSER module_config[] = {
 105   { "mod_instantiate",  PW_TYPE_STRING_PTR,
 106     offsetof(rlm_python_t, mod_instantiate), NULL,  NULL},
 107   { "func_instantiate",  PW_TYPE_STRING_PTR,
 108     offsetof(rlm_python_t, func_instantiate), NULL,  NULL},
 109
 110   { "mod_authorize",  PW_TYPE_STRING_PTR,
 111     offsetof(rlm_python_t, mod_authorize), NULL,  NULL},
 112   { "func_authorize",  PW_TYPE_STRING_PTR,
 113     offsetof(rlm_python_t, func_authorize), NULL,  NULL},
 114
 115   { "mod_authenticate",  PW_TYPE_STRING_PTR,
 116     offsetof(rlm_python_t, mod_authenticate), NULL,  NULL},
 117   { "func_authenticate",  PW_TYPE_STRING_PTR,
 118     offsetof(rlm_python_t, func_authenticate), NULL,  NULL},
 119
 120   { "mod_preacct",  PW_TYPE_STRING_PTR,
 121     offsetof(rlm_python_t, mod_preacct), NULL,  NULL},
 122   { "func_preacct",  PW_TYPE_STRING_PTR,
 123     offsetof(rlm_python_t, func_preacct), NULL,  NULL},
 124
 125   { "mod_accounting",  PW_TYPE_STRING_PTR,
 126     offsetof(rlm_python_t, mod_accounting), NULL,  NULL},
 127   { "func_accounting",  PW_TYPE_STRING_PTR,
 128     offsetof(rlm_python_t, func_accounting), NULL,  NULL},
 129
 130   { "mod_checksimul",  PW_TYPE_STRING_PTR,
 131     offsetof(rlm_python_t, mod_checksimul), NULL,  NULL},
 132   { "func_checksimul",  PW_TYPE_STRING_PTR,
 133     offsetof(rlm_python_t, func_checksimul), NULL,  NULL},
 134
 135   { "mod_detach",  PW_TYPE_STRING_PTR,
 136     offsetof(rlm_python_t, mod_detach), NULL,  NULL},
 137   { "func_detach",  PW_TYPE_STRING_PTR,
 138     offsetof(rlm_python_t, func_detach), NULL,  NULL},
 139
 140
 141   { NULL, -1, 0, NULL, NULL }           /* end the list */
 142 };
 143
 144 /*
 145  * radiusd Python functions
 146  */
 147
 148 /* radlog wrapper */
 149 static PyObject *radlog_py(const PyObject *self, PyObject *args) {
 150     int status;
 151     char *msg;
 152
 153     if (!PyArg_ParseTuple(args, "is", &status, &msg)) {
 154         return NULL;
 155     }
 156
 157     radlog(status, msg);
 158     return Py_None;
 159 }
 160
 161 static PyMethodDef radiusd_methods[] = {
 162     {"radlog", (PyCFunction)radlog_py, METH_VARARGS, "freeradius radlog()."},
 163     {NULL, NULL, 0, NULL}
 164 };
 165
 166 /*
 167  *      Do any per-module initialization.  e.g. set up connections
 168  *      to external databases, read configuration files, set up
 169  *      dictionary entries, etc.
 170  *
 171  *      Try to avoid putting too much stuff in here - it's better to
 172  *      do it in instantiate() where it is not global.
 173  */
 174 static int python_init(void)
 175 {
 176     /*
 177      * Initialize Python interpreter. Fatal error if this fails.
 178      */
 179     Py_Initialize();
 180
 181     radlog(L_DBG, "python_init done");
 182
 183     return 0;
 184 }
 185
 186 /* Extract string representation of Python error. */
 187 static void python_error(void) {
 188     PyObject *pType, *pValue, *pTraceback, *pStr1, *pStr2;
 189
 190     PyErr_Fetch(&pType, &pValue, &pTraceback);
 191     pStr1 = PyObject_Str(pType);
 192     pStr2 = PyObject_Str(pValue);
 193
 194     radlog(L_ERR, "%s: %s\n",
 195            PyString_AsString(pStr1), PyString_AsString(pStr2));
 196 }
 197
 198 /* Tuple to value pair conversion */
 199 static void add_vp_tuple(VALUE_PAIR **vpp, PyObject *pValue,
 200                          const char *function_name) {
 201     int i, outertuplesize;
 202     VALUE_PAIR  *vp;
 203
 204     /* If the Python function gave us None for the tuple, then just return. */
 205     if (pValue == Py_None) {
 206         return;
 207     }
 208
 209     if (!PyTuple_Check(pValue)) {
 210         radlog(L_ERR, "%s: non-tuple passed", function_name);
 211     }
 212
 213     /* Get the tuple size. */
 214     outertuplesize = PyTuple_Size(pValue);
 215
 216     for (i = 0; i < outertuplesize; i++) {
 217         PyObject *pTupleElement = PyTuple_GetItem(pValue, i);
 218
 219         if ((pTupleElement != NULL) &&
 220             (PyTuple_Check(pTupleElement))) {
 221
 222             /* Check if it's a pair */
 223             int tuplesize;
 224
 225             if ((tuplesize = PyTuple_Size(pTupleElement)) != 2) {
 226                 radlog(L_ERR, "%s: tuple element %d is a tuple "
 227                        " of size %d. must be 2\n", function_name,
 228                        i, tuplesize);
 229             }
 230             else {
 231                 PyObject *pString1, *pString2;
 232
 233                 pString1 = PyTuple_GetItem(pTupleElement, 0);
 234                 pString2 = PyTuple_GetItem(pTupleElement, 1);
 235
 236                 /* xxx PyString_Check does not compile here */
 237                 if  ((pString1 != NULL) &&
 238                      (pString2 != NULL) &&
 239                      PyObject_TypeCheck(pString1,&PyString_Type) &&
 240                      PyObject_TypeCheck(pString2,&PyString_Type)) {
 241
 242
 243                     const char *s1, *s2;
 244
 245                     /* pairmake() will convert and find any
 246                      * errors in the pair.
 247                      */
 248
 249                     s1 = PyString_AsString(pString1);
 250                     s2 = PyString_AsString(pString2);
 251
 252                     if ((s1 != NULL) && (s2 != NULL)) {
 253                         radlog(L_DBG, "%s: %s = %s ",
 254                                function_name, s1, s2);
 255
 256                         /* xxx Might need to support other T_OP */
 257                         vp = pairmake(s1, s2, T_OP_EQ);
 258                         if (vp != NULL) {
 259                             pairadd(vpp, vp);
 260                             radlog(L_DBG, "%s: s1, s2 OK\n",
 261                                    function_name);
 262                         }
 263                         else {
 264                             radlog(L_DBG, "%s: s1, s2 FAILED\n",
 265                                    function_name);
 266                         }
 267                     }
 268                     else {
 269                         radlog(L_ERR, "%s: string conv failed\n",
 270                                function_name);
 271                     }
 272
 273                 }
 274                 else {
 275                     radlog(L_ERR, "%s: tuple element %d must be "
 276                            "(string, string)", function_name, i);
 277                 }
 278             }
 279         }
 280         else {
 281             radlog(L_ERR, "%s: tuple element %d is not a tuple\n",
 282                    function_name, i);
 283         }
 284     }
 285
 286 }
 287
 288 /* This is the core Python function that the others wrap around.
 289  * Pass the value-pair print strings in a tuple.
 290  * xxx We're not checking the errors. If we have errors, what do we do?
 291  */
 292
 293 static int python_function(REQUEST *request,
 294                            PyObject *pFunc, const char *function_name)
 295 {
 296 #define BUF_SIZE 1024
 297
 298     char buf[BUF_SIZE];         /* same size as vp_print buffer */
 299
 300     VALUE_PAIR  *vp;
 301
 302     PyObject *pValue, *pValuePairContainer, **pValueHolder, **pValueHolderPtr;
 303     int i, n_tuple, return_value;
 304
 305     /* Return with "OK, continue" if the function is not defined. */
 306     if (pFunc == NULL) {
 307         return RLM_MODULE_OK;
 308     }
 309
 310     /* Default return value is "OK, continue" */
 311     return_value = RLM_MODULE_OK;
 312
 313     /* We will pass a tuple containing (name, value) tuples
 314      * We can safely use the Python function to build up a tuple,
 315      * since the tuple is not used elsewhere.
 316      *
 317      * Determine the size of our tuple by walking through the packet.
 318      * If request is NULL, pass None.
 319      */
 320     n_tuple = 0;
 321
 322     if (request != NULL) {
 323         for (vp = request->packet->vps; vp; vp = vp->next) {
 324             n_tuple++;
 325         }
 326     }
 327
 328     /* Create the tuple and a holder for the pointers, so that we can
 329      * decref more efficiently later without the overhead of reading
 330      * the tuple.
 331      *
 332      * We use malloc() instead of the Python memory allocator since we
 333      * are not embedded.
 334      */
 335
 336     if (NULL == (pValueHolder = pValueHolderPtr =
 337                  malloc(sizeof(PyObject *) * n_tuple))) {
 338
 339         radlog(L_ERR, "%s: malloc of %d bytes failed\n",
 340                function_name, sizeof(PyObject *) * n_tuple);
 341
 342         return -1;
 343     }
 344
 345     if (n_tuple == 0) {
 346         pValuePairContainer = Py_None;
 347     }
 348     else {
 349         pValuePairContainer = PyTuple_New(n_tuple);
 350
 351         i = 0;
 352         for (vp = request->packet->vps; vp; vp = vp->next) {
 353             PyObject *pValuePair, *pString1, *pString2;
 354
 355             /* The inside tuple has two only: */
 356             pValuePair = PyTuple_New(2);
 357
 358             /* The name. logic from vp_prints, lib/print.c */
 359             if (vp->flags.has_tag) {
 360                 snprintf(buf, BUF_SIZE, "%s:%d", vp->name, vp->flags.tag);
 361             }
 362             else {
 363                 strcpy(buf, vp->name);
 364             }
 365
 366             pString1 = PyString_FromString(buf);
 367             PyTuple_SetItem(pValuePair, 0, pString1);
 368
 369
 370             /* The value. Use delimiter - don't know what that means */
 371             vp_prints_value(buf, sizeof(buf), vp, 1);
 372             pString2 = PyString_FromString(buf);
 373             PyTuple_SetItem(pValuePair, 1, pString2);
 374
 375             /* Put the tuple inside the container */
 376             PyTuple_SetItem(pValuePairContainer, i++, pValuePair);
 377
 378             /* Store the pointer in our malloc() storage */
 379             *pValueHolderPtr++ = pValuePair;
 380         }
 381     }
 382
 383
 384     /* Call Python function.
 385      */
 386
 387     if (pFunc && PyCallable_Check(pFunc)) {
 388         PyObject *pArgs;
 389
 390         /* call the function with a singleton tuple containing the
 391          * container tuple.
 392          */
 393
 394         if ((pArgs = PyTuple_New(1)) == NULL) {
 395             radlog(L_ERR, "%s: could not create tuple", function_name);
 396             return -1;
 397         }
 398         if ((PyTuple_SetItem(pArgs, 0, pValuePairContainer)) != 0) {
 399             radlog(L_ERR, "%s: could not set tuple item", function_name);
 400             return -1;
 401         }
 402
 403         if ((pValue = PyObject_CallObject(pFunc, pArgs)) == NULL) {
 404             radlog(L_ERR, "%s: function call failed", function_name);
 405             python_error();
 406             return -1;
 407         }
 408
 409         /* The function returns either:
 410          *  1. tuple containing the integer return value,
 411          *  then the integer reply code (or None to not set),
 412          *  then the string tuples to build the reply with.
 413          *     (returnvalue, (p1, s1), (p2, s2))
 414          *
 415          *  2. the function return value alone
 416          *
 417          *  3. None - default return value is set
 418          *
 419          * xxx This code is messy!
 420          */
 421
 422         if (PyTuple_Check(pValue)) {
 423             PyObject *pTupleInt;
 424
 425             if (PyTuple_Size(pValue) != 3) {
 426                 radlog(L_ERR, "%s: tuple must be " \
 427                        "(return, replyTuple, configTuple)",
 428                        function_name);
 429
 430             }
 431             else {
 432                 pTupleInt = PyTuple_GetItem(pValue, 0);
 433
 434                 if ((pTupleInt == NULL) || !PyInt_Check(pTupleInt)) {
 435                     radlog(L_ERR, "%s: first tuple element not an integer",
 436                            function_name);
 437                 }
 438                 else {
 439                     /* Now have the return value */
 440                     return_value = PyInt_AsLong(pTupleInt);
 441
 442                     /* Reply item tuple */
 443                     add_vp_tuple(&request->reply->vps,
 444                                  PyTuple_GetItem(pValue, 1), function_name);
 445
 446                     /* Config item tuple */
 447                     add_vp_tuple(&request->config_items,
 448                                  PyTuple_GetItem(pValue, 2), function_name);
 449                 }
 450             }
 451         }
 452         else if (PyInt_Check(pValue)) {
 453             /* Just an integer */
 454             return_value = PyInt_AsLong(pValue);
 455         }
 456         else if (pValue == Py_None) {
 457             /* returned 'None', return value defaults to "OK, continue." */
 458             return_value = RLM_MODULE_OK;
 459         }
 460         else {
 461             /* Not tuple or None */
 462             radlog(L_ERR, "%s function did not return a tuple or None\n",
 463                    function_name);
 464         }
 465
 466
 467         /* Decrease reference counts for the argument and return tuple */
 468         Py_DECREF(pArgs);
 469         Py_DECREF(pValue);
 470     }
 471
 472     /* Decrease reference count for the tuples passed, the
 473      * container tuple, and the return value.
 474      */
 475
 476     pValueHolderPtr = pValueHolder;
 477     i = n_tuple;
 478     while (i--) {
 479         /* Can't write as pValueHolderPtr since Py_DECREF is a macro */
 480         Py_DECREF(*pValueHolderPtr);
 481         pValueHolderPtr++;
 482     }
 483     free(pValueHolder);
 484     Py_DECREF(pValuePairContainer);
 485
 486     /* pDict and pFunc are borrowed and must not be Py_DECREF-ed */
 487
 488     /* Free pairs if we are rejecting.
 489      * xxx Shouldn't the core do that?
 490      */
 491
 492     if ((return_value == RLM_MODULE_REJECT) && (request != NULL)) {
 493         pairfree(&(request->reply->vps));
 494     }
 495
 496     /* Return the specified by the Python module */
 497     return return_value;
 498 }
 499
 500
 501 static struct varlookup {
 502         const char*     name;
 503         int             value;
 504 } constants[] = {
 505         { "L_DBG",              L_DBG                   },
 506         { "L_AUTH",             L_AUTH                  },
 507         { "L_INFO",             L_INFO                  },
 508         { "L_ERR",              L_ERR                   },
 509         { "L_PROXY",            L_PROXY                 },
 510         { "L_CONS",             L_CONS                  },
 511         { "RLM_MODULE_REJECT",  RLM_MODULE_REJECT       },
 512         { "RLM_MODULE_FAIL",    RLM_MODULE_FAIL         },
 513         { "RLM_MODULE_OK",      RLM_MODULE_OK           },
 514         { "RLM_MODULE_HANDLED", RLM_MODULE_HANDLED      },
 515         { "RLM_MODULE_INVALID", RLM_MODULE_INVALID      },
 516         { "RLM_MODULE_USERLOCK",RLM_MODULE_USERLOCK     },
 517         { "RLM_MODULE_NOTFOUND",RLM_MODULE_NOTFOUND     },
 518         { "RLM_MODULE_NOOP",    RLM_MODULE_NOOP         },
 519         { "RLM_MODULE_UPDATED", RLM_MODULE_UPDATED      },
 520         { "RLM_MODULE_NUMCODES",RLM_MODULE_NUMCODES     },
 521         { NULL, 0 },
 522 };
 523
 524 /*
 525  * Import a user module and load a function from it
 526  */
 527 static int load_python_function(const char* module, const char* func,
 528                                 PyObject** pyModule, PyObject** pyFunc) {
 529
 530     if ((module==NULL) || (func==NULL)) {
 531         *pyFunc=NULL;
 532         *pyModule=NULL;
 533     } else {
 534         PyObject *pName;
 535
 536         pName = PyString_FromString(module);
 537         Py_INCREF(pName);
 538         *pyModule = PyImport_Import(pName);
 539         Py_DECREF(pName);
 540         if (*pyModule != NULL) {
 541             PyObject *pDict;
 542
 543             pDict = PyModule_GetDict(*pyModule);
 544             /* pDict: borrowed reference */
 545
 546             *pyFunc = PyDict_GetItemString(pDict, func);
 547             /* pFunc: Borrowed reference */
 548         } else {
 549             python_error();
 550
 551             radlog(L_ERR, "Failed to import python module \"%s\"\n", module);
 552             return -1;
 553         }
 554     }
 555
 556     return 0;
 557 }
 558
 559
 560 /*
 561  *      Do any per-module initialization that is separate to each
 562  *      configured instance of the module.  e.g. set up connections
 563  *      to external databases, read configuration files, set up
 564  *      dictionary entries, etc.
 565  *
 566  *      If configuration information is given in the config section
 567  *      that must be referenced in later calls, store a handle to it
 568  *      in *instance otherwise put a null pointer there.
 569  *
 570  */
 571 static int python_instantiate(CONF_SECTION *conf, void **instance)
 572 {
 573     rlm_python_t *data;
 574     PyObject *module;
 575     int idx;
 576
 577     /*
 578          *      Set up a storage area for instance data
 579          */
 580     data = rad_malloc(sizeof(*data));
 581     if (!data) {
 582       return -1;
 583     }
 584     memset(data, 0, sizeof(*data));
 585
 586     /*
 587          *      If the configuration parameters can't be parsed, then
 588          *      fail.
 589          */
 590     if (cf_section_parse(conf, data, module_config) < 0) {
 591         free(data);
 592         return -1;
 593     }
 594
 595
 596     /*
 597      * Setup our 'radiusd' module.
 598      */
 599
 600     /* Code */
 601     if ((module = data->pModule_builtin =
 602          Py_InitModule3("radiusd", radiusd_methods,
 603                         "FreeRADIUS Module.")) == NULL) {
 604
 605         radlog(L_ERR, "Python Py_InitModule3 failed");
 606         free(data);
 607         return -1;
 608     }
 609
 610     /*
 611      * Load constants into module
 612      */
 613     for (idx=0; constants[idx].name; idx++)
 614         if ((PyModule_AddIntConstant(module, constants[idx].name, constants[idx].value)) == -1) {
 615
 616             radlog(L_ERR, "Python AddIntConstant failed");
 617         }
 618
 619
 620     /*
 621      * Import user modules.
 622      */
 623
 624     if (load_python_function(data->mod_instantiate, data->func_instantiate,
 625                 &data->pModule_instantiate, &data->pFunc_instantiate)==-1) {
 626         /* TODO: check if we need to cleanup data */
 627         return -1;
 628     }
 629
 630     if (load_python_function(data->mod_authenticate, data->func_authenticate,
 631                 &data->pModule_authenticate, &data->pFunc_authenticate)==-1) {
 632         /* TODO: check if we need to cleanup data */
 633         return -1;
 634     }
 635
 636     if (load_python_function(data->mod_authorize, data->func_authorize,
 637                 &data->pModule_authorize, &data->pFunc_authorize)==-1) {
 638         /* TODO: check if we need to cleanup data */
 639         return -1;
 640     }
 641
 642     if (load_python_function(data->mod_preacct, data->func_preacct,
 643                 &data->pModule_preacct, &data->pFunc_preacct)==-1) {
 644         /* TODO: check if we need to cleanup data */
 645         return -1;
 646     }
 647
 648     if (load_python_function(data->mod_accounting, data->func_accounting,
 649                 &data->pModule_accounting, &data->pFunc_accounting)==-1) {
 650         /* TODO: check if we need to cleanup data */
 651         return -1;
 652     }
 653
 654     if (load_python_function(data->mod_checksimul, data->func_checksimul,
 655                 &data->pModule_checksimul, &data->pFunc_checksimul)==-1) {
 656         /* TODO: check if we need to cleanup data */
 657         return -1;
 658     }
 659
 660     if (load_python_function(data->mod_detach, data->func_detach,
 661                 &data->pModule_detach, &data->pFunc_detach)==-1) {
 662         /* TODO: check if we need to cleanup data */
 663         return -1;
 664     }
 665
 666     *instance=data;
 667
 668     /* Call the instantiate function.  No request.  Use the return value. */
 669     return python_function(NULL, data->pFunc_instantiate, "instantiate");
 670 }
 671
 672 /* Wrapper functions */
 673 static int python_authorize(void *instance, REQUEST *request)
 674 {
 675     return python_function(request,
 676                            ((struct rlm_python_t *)instance)->pFunc_authorize,
 677                            "authorize");
 678 }
 679
 680 static int python_authenticate(void *instance, REQUEST *request)
 681 {
 682     return python_function(
 683         request,
 684         ((struct rlm_python_t *)instance)->pFunc_authenticate,
 685         "authenticate");
 686 }
 687
 688 static int python_preacct(void *instance, REQUEST *request)
 689 {
 690     return python_function(
 691         request,
 692         ((struct rlm_python_t *)instance)->pFunc_preacct,
 693         "preacct");
 694 }
 695
 696 static int python_accounting(void *instance, REQUEST *request)
 697 {
 698     return python_function(
 699         request,
 700         ((struct rlm_python_t *)instance)->pFunc_accounting,
 701         "accounting");
 702 }
 703
 704 static int python_checksimul(void *instance, REQUEST *request)
 705 {
 706     return python_function(
 707         request,
 708         ((struct rlm_python_t *)instance)->pFunc_checksimul,
 709         "checksimul");
 710 }
 711
 712
 713 static int python_detach(void *instance)
 714 {
 715     int return_value;
 716
 717     /* Default return value is failure */
 718     return_value = -1;
 719
 720     if (((rlm_python_t *)instance)->pFunc_detach &&
 721         PyCallable_Check(((rlm_python_t *)instance)->pFunc_detach)) {
 722
 723         PyObject *pArgs, *pValue;
 724
 725         /* call the function with an empty tuple */
 726
 727         pArgs = PyTuple_New(0);
 728         pValue = PyObject_CallObject(((rlm_python_t *)instance)->pFunc_detach,
 729                                      pArgs);
 730
 731         if (pValue == NULL) {
 732             python_error();
 733             return -1;
 734         }
 735         else {
 736             if (!PyInt_Check(pValue)) {
 737                 radlog(L_ERR, "detach: return value not an integer");
 738             }
 739             else {
 740                 return_value = PyInt_AsLong(pValue);
 741             }
 742         }
 743
 744         /* Decrease reference counts for the argument and return tuple */
 745         Py_DECREF(pArgs);
 746         Py_DECREF(pValue);
 747     }
 748
 749     free(instance);
 750
 751 #if 0
 752     /* xxx test delete module object so it will be reloaded later.
 753      * xxx useless since we can't SIGHUP reliably, anyway.
 754      */
 755     PyObject_Del(((struct rlm_python_t *)instance)->pModule_accounting);
 756 #endif
 757
 758     radlog(L_DBG, "python_detach done");
 759
 760     /* Return the specified by the Python module */
 761     return return_value;
 762 }
 763
 764 /*
 765  *      The module name should be the only globally exported symbol.
 766  *      That is, everything else should be 'static'.
 767  *
 768  *      If the module needs to temporarily modify it's instantiation
 769  *      data, the type should be changed to RLM_TYPE_THREAD_UNSAFE.
 770  *      The server will then take care of ensuring that the module
 771  *      is single-threaded.
 772  */
 773 module_t rlm_python = {
 774         "python",
 775         RLM_TYPE_THREAD_SAFE,           /* type */
 776         python_init,                    /* initialization */
 777         python_instantiate,             /* instantiation */
 778         {
 779                 python_authenticate,    /* authentication */
 780                 python_authorize,       /* authorization */
 781                 python_preacct,         /* preaccounting */
 782                 python_accounting,      /* accounting */
 783                 python_checksimul,      /* checksimul */
 784                 NULL,                   /* pre-proxy */
 785                 NULL,                   /* post-proxy */
 786                 NULL                    /* post-auth */
 787         },
 788         python_detach,                  /* detach */
 789         NULL,                           /* destroy */
 790 };