avp Module

Overview This module contains several functions that can be used to manipulate the contents of AVPs (Attribute-Value pairs). The AVPs are variables attached to the SIP message being processed. Each variable has its name and value. AVPs can be used to store arbitrary data or as a means of inter-module comminication. You may also want to check the avpops module which is more flexible and contains more functions. In future SER releases the avp module will be probably deprecated in favor of avpops module.

Exported Functions

<function moreinfo="none">set_iattr(attribute,value)</function> Create an AVP of type integer. Meaning of the parameter is as follows: attribute - The name of of the AVP to be created. value - Integer value of the AVP. <function moreinfo="none">set_iattr</function> usage ... set_iattr("fr_inv_timer", "60") ...

<function moreinfo="none">flags2attr()</function> Store the current state of SER flags into AVP called "flags". <function moreinfo="none">flags2attr</function> usage ... flags2attr() ...

<function moreinfo="none">set_sattr(attribute,value)</function> Create an AVP of type string. Meaning of the parameter is as follows: attribute - The name of of the AVP to be created. value - String value of the AVP. <function moreinfo="none">set_sattr</function> usage ... set_sattr("called_number", "1234") ...

<function moreinfo="none">uri2attr(attribute)</function> Store the Request-URI of the message being processed in an AVP. The new value of the Request-URI will be used if it has been already rewritten by some other function or module. Meaning of the parameter is as follows: attribute - The name of of the AVP. <function moreinfo="none">uri2attr</function> usage ... uri2attr("saved_ruri") ...

<function moreinfo="none">print_sattr(attribute)</function> Print the value of an AVP to syslog. Meaning of the parameter is as follows: attribute - The name of of the AVP.

<function moreinfo="none">attr2uri(attribute)</function> Rewrite the Request-URI of the message being processed with the value of an AVP. Meaning of the parameter is as follows: attribute - The name of of the AVP.

<function moreinfo="none">is_sattr_set(attribute)</function> Test for the existence of AVP with given name. The function returns 1 if given AVP exists and 0 if not. Meaning of the parameter is as follows: attribute - The name of of the AVP. <function moreinfo="none">is_sattr_set</function> usage ... if (is_sattr_set("saved_ruri")) { uri2attr("saved_uri"); } else { rewriteuri("sip:a@iptel.org"); }; ...

<function moreinfo="none">avp_exists(attribute, value)</function> Test whether an AVP with given name and value exists. The functio returns 1 if the AVP with given name and value exists and 0 if not. The value of the AVP is compared string-wise. The comparison is case sensitive. Meaning of the parameter is as follows: attribute - The name of of the AVP. value - The AVP value to look for.