[Devel] New module: perl

[Daniel-Constantin Mierla]

Hello Bastian,

thanks for the contribution. The html documentation of the module is now 
available on OpenSER site as well:

http://www.openser.org/docs/modules/1.2.x/perl.html

If I am not wrong, this should be something similar to AGI interface in 
Asterisk -- one can access and update from Perl applications the 
internals (exported functions, structures ...) of OpenSER. Sonce here is 
a lot to explore, I will open a dokuwiki page dedicated to this 
extension, to let users share experiences.

Cheers,
Daniel


On 12/11/06 12:41, Bastian Friedrich wrote:
> Hi everybody,
>
> since last friday, OpenSER HEAD has a new module, called perl. As the name 
> suggests, it incorporates a Perl interpreter within OpenSER.
>
> What can you do with it?
> ========================
> The perl module lets you request information from the SIP message currently 
> active, lets you make decisions based on that information and finally modify 
> the SIP message.
>
> In other words, you can do almost everything you could have done in the 
> OpenSER configuration file, plus much, much more.
>
> How do I use it?
> ================
> The perl module should be automatically compiled in current CVS checkouts of 
> the HEAD branch, as long as you have a fairly recent Perl version (including 
> possibly necessary development packages) installed on your system. Load it in 
> your OpenSER configuration just like all the other modules.
>
> Set the two module parameters "filename" and "modpath"; the first one points 
> to your perl script (samples are included in the doc directory), the second 
> points to the path where the Perl packages reside (they currently are 
> not "installed" anywhere automatically. Feel free to do that yourself).
>
> In the configuration file, you may then call the functions defined in your 
> Perl script with the "perl_exec" and "perl_exec_simple" functions. The 
> samples and the README file should tell you more about it.
>
> What should the Perl script look like?
> ======================================
> Please take a look at the doc/samples directory located in the perl module 
> directory. They should give you an introduction of how such a script could 
> look like.
>
> The full API is described in the README file.
>
> The module documentation on the OpenSER website is not 100% apt as of now, but 
> should be updated during the next days.
>
> Great! And now?
> ===============
> Please feel free to test the perl module. Although it currently runs fine for 
> me, deployment in production environments is not recommended. Tell me about 
> your experiences and any bugs you found. If you write a test script, I'd be 
> thankfull if you send it to me for inclusion as a sample.
>
> If you have any questions or remarks, please send a mail to the users or 
> developer mailing lists (depending on the focus), or directly to me.
>
> Thx for your attention, Regards,
>    Bastian
>
>