You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kamailio/modules_k/rtimer/README

107 lines
2.5 KiB

RTimer Module
Daniel-Constantin Mierla
asipto.com
<miconda@gmail.com>
Edited by
Daniel-Constantin Mierla
<miconda@gmail.com>
Copyright © 2009 http://www.asipto.com
__________________________________________________________
Table of Contents
1. Admin Guide
1.1. Overview
1.2. Dependencies
1.2.1. Kamailio Modules
1.2.2. External Libraries or Applications
1.3. Exported Parameters
1.3.1. timer (str)
1.3.2. exec (str)
List of Examples
1.1. Set timer parameter
1.2. Set exec parameter
Chapter 1. Admin Guide
1.1. Overview
The module executes route blocks on a timer base. It can create
new timer processes and execute many route blocks on same
timer.
A static faked SIP message is given as parameter to called
functions, so all functions available for REQUEST_ROUTE can be
used.
1.2. Dependencies
1.2.1. Kamailio Modules
The following modules must be loaded before this module:
* No dependencies on other Kamailio modules.
1.2.2. External Libraries or Applications
The following libraries or applications must be installed
before running Kamailio with this module loaded:
* None.
1.3. Exported Parameters
1.3.1. timer (str)
The definition of a timer. The value of the parameter must have
the following format:
* "name=_string_;mode=_number_;interval=_number_"
The parameter can be set multiple times to get more timers in
same configuration file.
* name - name of the timer.
* mode - if set to 1, will create a new timer process.
* interval - timer interval in seconds.
Default value is NULL.
Example 1.1. Set timer parameter
...
modparam("rtimer", "timer", "name=ta;interval=10;mode=1;")
...
1.3.2. exec (str)
Specify route to be executed on timer. The value of the
parameter must have the following format:
* "timer=_string_;route=_number_"
The parameter can be set multiple times to get more routes
executed on same timer.
* timer - name of the timer.
* route - the index of the route to be executed.
Default value is NULL.
Example 1.2. Set exec parameter
...
modparam("rtimer", "timer", "name=ta;interval=10;mode=1;")
modparam("rtimer", "exec", "timer=ta;route=8")
route[8] {
xlog("timer routine: time is %TF\n");
# delete from my sql cache table entries older than 2H
sql_query("delete from kamailio_cache where last_updated<$TS-3600");
}
...