Copyright © 2003 FhG FOKUS
Copyright © 2005 voice-system
Copyright © 2008 Elena-Ramona Modroiu
| Revision History | |
|---|---|
| Revision $Revision$ | $Date$ |
Table of Contents
List of Examples
buf_size parameterforce_color parameterprefix parameterxlog usagexdbg usageTable of Contents
This module provides the possibility to print user formatted log or debug messages from Kamailio scripts, similar to printf function. A C-style printf specifier is replaced with a part of the SIP request or other variables from system. Section 2, “Implemented Specifiers” shows what can be printed out.
In the xlog function, you use pseudo-variables, that are a part of Kamailio core and are used by other modules as well (e.g., avpops in the function avp_printf())
The most important changes from earlier versions of Kamailio are:
- '%' has been replaced by '$'
- to print a header, use now $hdr(header_name[index]) instead of %{header_name[index]}
- to print an AVP, use now $avp([si]:avp_id[index]) instead of %{[si]:avp_id[index]} or $avp([$avp_alias[index]) instead of %{[$avp_alias[index]}
The full list of available pseudo-variables in Kamailio is available at: http://kamailio.org/dokuwiki/
The following modules must be loaded before this module:
No dependencies on other Kamailio modules.
Maximum size of the log message.
Default value is 4096.
When set to 1, forces color printing even if log_stderror=0.
Default value is 0.
Print a formated message using LOG function.
Meaning of the parameters are as follows:
level - The level that will be used in LOG function. It can be:
L_ALERT - log level -5
L_BUG - log level -4
L_CRIT - log level -3
L_ERR - log level -1
L_WARN - log level 0
L_NOTICE - log level 1
L_INFO - log level 2
L_DBG - log level 3
$pv - any valid pseudo-variable, that has an integer value. See above options for valid log levels.
If it is not a pseudo-variable, then what really matters is the third letter of the value. If the log level is higher than the “debug” global parameter, the message is not printed to syslog.
If this parameter is missing, the implicit log level is 'L_ERR'.
format - The formatted string to be printed.
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, ONREPLY_ROUTE, BRANCH_ROUTE.
Example 1.4. xlog usage
...
xlog("L_ERR", "time [$Tf] method ($rm) r-uri ($ru) 2nd via ($hdr(via[1]))\n");
...
xlog("time [$Tf] method ($rm) r-uri ($ru) 2nd via ($hdr(via[1]))\n");
...
$var(loglevel) = 2;
xlog("$var(loglevel)", "time [$Tf] method ($rm) r-uri ($ru)\n");
...
Print a formatted message using DBG function.
Meaning of the parameters is as follows:
format - The formatted string to be printed.
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, ONREPLY_ROUTE, BRANCH_ROUTE.