= rlm_python

Python module for freeradius Copyright 2002 Miguel A Paraz
mailto:mparaz@mparaz.com[mparaz@mparaz.com] Copyright 2002
Imperium Technology, Inc.

== Topics

PURPOSE: To allow module writers to write modules in a high-level
language, for implementation or for prototyping.

REQUIRES: Python - tested with 2.2

BUILDING: ./configure –with-experimental-modules

USAGE: Make your module available to the Python interpreter by either
putting it in a standard location, or `EXPORT PYTHONPATH=$location'.

BUGS: 1. Can’t compile statically (./configure –enable-shared=no) -
causes SIGSEGV on the first malloc() in main().

Design: 1. Support for all module functions. 2. One module per function
allowed, for example, from experimental.conf:

```
python {
    mod_instantiate = radiusd_test
    func_instantiate = instantiate

    mod_authorize = radiusd_test
    func_authorize = authorize

    mod_accounting = radiusd_test
    func_accounting = accounting

    mod_preacct = radiusd_test
    func_preacct = preacct

    mod_detach = radiusd_test
    func_detach = detach

}
```

* Different functions are wrappers around the same core.
* `func_detach` is passed no parameters, returns module return value.
* If functions returns None (plain `return' no return), default to
RLM_OK
* Python instantiation function can return -1 to signal failure and abort
startup.

Available to module:

```
import radiusd
radiusd.rad_log(radiusd.L_XXX, message_string)
radiusd.RLM_XXX
```

== TODO

1. Do we need to support other pair operations beyond set (:=) ?
2. Should we pass the value pair info as a dict and not a tuple? Faster?
3. Give access to more radiusd variables like the dictionary. 3. Give
access to other C functions. Let the Python module deal with the
structures directly, instead of letting our C code do it afterwards.
What’s a good way to represent this?
