%docentities; ]>

This module provides access to a limited number of Kamailio core functions. As the most interesting functions deal with SIP messages, they are located in the Kamailio::Message class below.

Logs the message with Kamailio's logging facility. The logging level is one of the following: Please note that this method is NOT automatically exported, as it collides with the perl function log (which calculates the logarithm). Either explicitly import the function (via ), or call it with its full name:

This package provides access functions for an Kamailio structure and its sub-components. Through its means it is possible to fully configure alternative routing decisions.

Returns one of the constants SIP_REQUEST, SIP_REPLY, SIP_INVALID stating the type of the current message.

Returns the status code of the current Reply message. This function is invalid in Request context!

Returns the reason of the current Reply message. This function is invalid in Request context!

Returns the version string of the current SIP message.

This function returns the recipient URI of the present SIP message: getRURI();]]> getRURI returns a string. See getParsedRURI() below how to receive a parsed structure. This function is valid in request messages only.

Returns the current method, such as , , and so on. getMethod();]]> This function is valid in request messages only.

Returns the full message header as present in the current message. You might use this header to further work with it with your favorite MIME package. getFullHeader();]]>

Returns the message body.

Returns the whole message including headers and body.

Returns the body of the first message header with this name. getHeader("To");]]> ]]>

Returns an array of all header names. Duplicates possible!

Search for an arbitrary function in module exports and call it with the parameters self, string1, string2. and/or may be omitted. As this function provides access to the functions that are exported to the Kamailio configuration file, it is autoloaded for unknown functions. Instead of writing moduleFunction("sl_send_reply", "500", "Internal Error"); $m->moduleFunction("xlog", "L_INFO", "foo");]]> you may as well write sl_send_reply("500", "Internal Error"); $m->xlog("L_INFO", "foo");]]> WARNING In Kamailio 1.2, only a limited subset of module functions is available. This restriction will be removed in a later version. Here is a list of functions that are expected to be working (not claiming completeness):

Logs the message with Kamailio's logging facility. The logging level is one of the following: The logging function should be accessed via the Kamailio module variant. This one, located in Kamailio::Message, is deprecated.

Sets a new destination (recipient) URI. Useful for rerouting the current message/call. getRURI() =~ m/\@somedomain.net/) { $m->rewrite_ruri("sip:dispatcher\@organization.net"); }]]>

Sets a message flag. The constants as known from the C API may be used, when Constants.pm is included.

Resets a message flag.

Returns whether a message flag is set or not.

Returns a new string where all pseudo variables are substituted by their values. Can be used to receive the values of single variables, too. Please remember that you need to escape the '$' sign in perl strings!

Append a branch to current message.

Returns the current destination URI as an Kamailio::URI object.

This package provides functions for access to sip_uri structures.

Returns the user part of this URI.

Returns the host part of this URI.

Returns the passwd part of this URI.

Returns the port part of this URI.

Returns the params part of this URI.

Returns the headers part of this URI.

Returns the transport part of this URI.

Returns the ttl part of this URI.

Returns the user_param part of this URI.

Returns the maddr part of this URI.

Returns the method part of this URI.

Returns the lr part of this URI.

Returns the r2 part of this URI.

Returns the transport_val part of this URI.

Returns the ttl_val part of this URI.

Returns the user_param_val part of this URI.

Returns the maddr_val part of this URI.

Returns the method_val part of this URI.

Returns the lr_val part of this URI.

Returns the r2_val part of this URI.

This package provides access functions for Kamailio's AVPs. These variables can be created, evaluated, modified and removed through this package. Please note that these functions do NOT support the notation used in the configuration file, but directly work on strings or numbers. See documentation of add method below.

Add an AVP. Add an Kamailio AVP to its environment. name and val may both be integers or strings; this function will try to guess what is correct. Please note that is something different than due to this evaluation: The first will create _string_ AVPs with the name 10, while the latter will create a numerical AVP. You can modify/overwrite AVPs with this function.

get an Kamailio AVP:

Destroy an AVP.

Kamailio::Utils::PhoneNumbers - Functions for canonical forms of phone numbers. "0", internationalPrefix => "+", longDistancePrefix => "0", areaCode => "761", pbxCode => "456842", countryCode => "49" ); $canonical = $phonenumbers->canonicalForm("07612034567"); $number = $phonenumbers->dialNumber("+497612034567");]]> A telphone number starting with a plus sign and containing all dial prefixes is in canonical form. This is usally not the number to dial at any location, so the dialing number depends on the context of the user/system. The idea to canonicalize numbers were taken from hylafax. Example: +497614514829 is the canonical form of my phone number, 829 is the number to dial at Pyramid, 4514829 is the dialing number from Freiburg are and so on. To canonicalize any number, we strip off any dial prefix we find and then add the prefixes for the location. So, when the user enters the number 04514829 in context pyramid, we remove the publicAccessPrefix (at Pyramid this is 0) and the pbxPrefix (4514 here). The result is 829. Then we add all the general dial prefixes - 49 (country) 761 (area) 4514 (pbx) and 829, the number itself => +497614514829 To get the dialing number from a canonical phone number, we substract all general prefixes until we have something As said before, the interpretation of a phone number depends on the context of the location. For the functions in this package, the context is created through the operator. The following fields should be set: This module exports the following functions when ed:

The new operator returns an object of this type and sets its locational context according to the passed parameters. See Kamailio::Utils::PhoneNumbers above.

Convert a phone number (given as first argument) into its canonical form. When no context is passed in as the second argument, the default context from the systems configuration file is used.

Convert a canonical phone number (given in the first argument) into a number to to dial. WHen no context is given in the second argument, a default context from the systems configuration is used.

Kamailio::LDAPUtils::LDAPConf - Read openldap config from standard config files. This module may be used to retrieve the global LDAP configuration as used by other LDAP software, such as and . The configuration is usualy stored in When used from an account with sufficient privilegs (e.g. root), the ldap manager passwort is also retrieved.

Returns a new, initialized object.

Returns the servers base-dn to use when doing queries.

Returns the ldap host to contact.

Returns the ldap servers port.

Returns an uri to contact the ldap server. When there is no ldap_uri in the configuration file, an uri is constucted from host and port.

Returns the ldap "root" password. Note that the is only available when the current account has sufficient privilegs to access .

Returns the DN to use for "root"-access to the ldap server.

Returns the DN to use for authentication to the ldap server. When no bind dn has been specified in the configuration file, returns the .

Returns the password to use for authentication to the ldap server. When no bind password has been specified, returns the if any.

Kamailio::LDAPUtils::LDAPConnection - Perl module to perform simple LDAP queries. OO-Style interface: Procedural interface: search( new Kamailio::LDAPUtils::LDAPConfig(), "uid=andi","ou=people,ou=coreworks,ou=de");]]> This perl module offers a somewhat simplified interface to the functionality. It is intended for cases where just a few attributes should be retrieved without the overhead of the full featured .

Set up a new LDAP connection. The first argument, when given, should be a hash reference pointing to to the connection parameters, possibly an object. This argument may be in which case a new (default) object is used. When the optional second argument is a true value, the connection will be authenticated. Otherwise an anonymous bind is done. On success, a new object is returned, otherwise the result is .

perform an ldap search, return the dn of the first matching directory entry, unless a specific attribute has been requested, in wich case the values(s) fot this attribute are returned. When the first argument (conf) is a , it will be used to perform the queries. You can pass the first argument implicitly by using the "method" syntax. Otherwise the argument should be a reference to a hash containing the connection setup parameters as contained in a object. In this mode, the from previous queries will be reused.

conf configuration object, used to find host,port,suffix and use_ldap_checks filter ldap search filter, eg '(mail=some@domain)' base search base for this query. If undef use default suffix, concat base with default suffix if the last char is a ',' requested_attributes retrieve the given attributes instead of the dn from the ldap directory.

Without any specific , return the dn of all matching entries in the LDAP directory. When some are given, return an array with those attibutes. When multiple entries match the query, the attribute lists are concatenated.

This package is an (abstract) base class for all virtual databases. Derived packages can be configured to be used by Kamailio as a database. The base class itself should NOT be used in this context, as it does not provide any functionality.

This package provides a number of constants taken from enums and defines of Kamailio header files. Unfortunately, there is no mechanism for updating the constants automatically, so check the values if you are in doubt.

This adapter can be used with the speeddial module.

This package is intended for usage with the alias_db module. The query VTab has to take two arguments and return an array of two arguments (user name/domain).

Queries the vtab with the given arguments for request conditions, keys to return and sort order column name.

This package is an Adapter for the acc and siptrace modules, featuring only an insert operation.

This package is intended for debug usage. It will print information about requested functions and operations of a client module. Use this module to request schema information when creating new adapters.

This adapter is intended for usage with the auth_db module. The VTab should take a username as an argument and return a (plain text!) password.

This package represents a request condition for database access, consisting of a column name, an operator (=, <, >, ...), a data type and a value. This package inherits from Kamailio::VDB::Pair and thus includes its methods.

Constructs a new Column object.

Returns or sets the current operator.

This package represents database key/value pairs, consisting of a key, a value type, and the value. This package inherits from Kamailio::VDB::Value and thus has the same methods.

Constructs a new Column object.

Returns or sets the current key.

This package handles virtual tables and is used by the Kamailio::VDB class to store information about valid tables. The package is not inteded for end user access.

Invokes an operation on the table (insert, update, ...) with the given arguments.

This package represents a database value. Additional to the data itself, information about its type is stored.

When accessing a Kamailio::VDB::Value object as a string, it simply returns its data regardless of its type. =cut use strict; package Kamailio::VDB::Value; use overload '""' => \&stringify; sub stringify { shift->{data} } use Kamailio; use Kamailio::Constants; our @ISA = qw ( Kamailio::Utils::Debug );

Constructs a new Value object. Its data type and the data are passed as parameters.

Returns or sets the current data type. Please consider using the constants from Kamailio::Constants

Returns or sets the current data.

This package represents database column definition, consisting of a column name and its data type.

When accessing a Kamailio::VDB::Column object as a string, it simply returns its column name regardless of its type. =cut package Kamailio::VDB::Column; use overload '""' => \&stringify; sub stringify { shift->{name} } use Kamailio; use Kamailio::Constants; our @ISA = qw ( Kamailio::Utils::Debug );

Constructs a new Column object. Its type and the name are passed as parameters.

Returns or sets the current type. Please consider using the constants from Kamailio::Constants

Returns or sets the current column name.

This class represents a VDB result set. It contains a column definition, plus an array of rows. Rows themselves are simply references to arrays of scalars.

The constructor creates a new Result object. Its first parameter is a reference to an array of Kamailio::VDB::Column objects. Additional parameters may be passed to provide initial rows, which are references to arrays of scalars.