The following modules must be loaded before this module:

The following libraries or applications must be installed before running Kamailio with this module loaded:

Searches for the re in the message.

Meaning of the parameters is as follows:

Note: it performs Posix regex matching and the 're' parameter is compiled with the flags REG_EXTENDED|REG_ICASE|REG_NEWLINE.

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if ( search("[Ss][Ii][Pp]") ) { /*....*/ };
...

Searches for the re in the body of the message.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if ( search_body("[Ss][Ii][Pp]") ) { /*....*/ };
...

Searches for the re in the body of the message.

Meaning of the parameters is as follows:

Both parameters can contain variables.

This function can be used from ANY_ROUTE.

...
if ( search_str("$ru", ";transport=tcp") ) { /*....*/ };
...

Searches for the re in the body of a header field.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if ( search_hf("From", ":test@", "a") ) { /*....*/ };
...

Searches for the first match of re and appends txt after it.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
search_append("[Oo]pen[Ss]er", " SIP Proxy");
...

Searches for the first match of re in the body of the message and appends txt after it.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
search_append_body("[Oo]pen[Ss]er", " SIP Proxy");
...

Replaces the first occurrence of re with txt.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
replace("server", "Kamailio SIP Proxy");
...

Replaces the first occurrence of re in the body of the message with txt.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
replace_body("server", "Kamailio SIP Proxy");
...

Replaces the first occurrence of re in the SIP headers of the message with txt.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
replace_hdrs("Kamailio", "Kamailio SIP Proxy");
...

Replaces all occurrence of re with txt.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
replace_all("server", "Kamailio SIP Proxy");
...

Replaces all occurrence of re in the body of the message with txt. Matching is done on a per-line basis.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
replace_body_all("server", "Kamailio SIP Proxy");
...

Replaces all occurrence of re in the body of the message with txt. Matching is done over the whole body.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
# strip the whole body from the message:
if(has_body() && replace_body_atonce("^.+$", ""))
        remove_hf("Content-Type");
...

Replaces the first or all occurrence of 'match' with 'repl' by doing string comparison for matching. It is applied over headers and message body (not over the first line).

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
replace_str("Kamailio", "Kamailio SIP Proxy", "a");
...

Replaces the first or all occurrence of 'match' with 'repl' by doing string comparison for matching. It is applied over the message body.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
replace_body_str("Kamailio", "Kamailio SIP Proxy", "a");
...

Replaces the first or all occurrence of 'match' with 'repl' by doing string comparison for matching. It is applied over the part with headers of the SIP message.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
replace_hdrs_str("Kamailio", "Kamailio SIP Proxy", "a");
...

Replaces re with repl.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
# replace the uri in to: with the message uri (just an example)
if ( subst('/^To:(.*)sip:[^@]*@[a-zA-Z0-9.]+(.*)$/t:\1\u\2/ig') ) {};

# replace the uri in to: with the value of avp sip_address (just an example)
if ( subst('/^To:(.*)sip:[^@]*@[a-zA-Z0-9.]+(.*)$/t:\1$avp(sip_address)\2/ig') ) {};

...

Runs the re substitution on the message uri (like subst but works only on the uri)

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
# adds 3463 prefix to numeric uris, and save the original uri (\0 match)
# as a parameter: orig_uri (just an example)
if (subst_uri('/^sip:([0-9]+)@(.*)$/sip:3463\1@\2;orig_uri=\0/i')){$

# adds the avp 'uri_prefix' as prefix to numeric uris, and save the original
# uri (\0 match) as a parameter: orig_uri (just an example)
if (subst_uri('/^sip:([0-9]+)@(.*)$/sip:$avp(uri_prefix)\1@\2;orig_uri=\0/i')){$

...

Runs the re substitution on the message uri (like subst_uri but works only on the user portion of the uri)

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
# adds 3463 prefix to uris ending with 3642 (just an example)
if (subst_user('/3642$/36423463/')){$

...
# adds avp 'user_prefix' as prefix to username in r-uri ending with 3642
if (subst_user('/(.*)3642$/$avp(user_prefix)\13642/')){$

...

Replaces re with repl in the body of the message.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if ( subst_body('/^o=(.*) /o=$fU /') ) {};

...

Substitutions in the body of a header field.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if ( subst_hf("From", "/:test@/:best@/", "a") ) { /*....*/ };
...

Sed-like substitution subexp applied to itext, with result stored in opv.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
subst_v("$var(x)", "/:test@/:best@/", "$var(r)");
...

Set body to a SIP message.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
set_body("test", "text/plain");
...

Set body to a SIP reply to be generated by Kamailio.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
set_reply_body("test", "text/plain");
...

Filters multipart/mixed body by leaving out all other body parts except the first body part of given type.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if (has_body("multipart/mixed")) {
    if (filter_body("application/sdp")) {
        remove_hf("Content-Type");
        append_hf("Content-Type: application/sdp\r\n");
    } else {
        xlog("Body part application/sdp not found\n");
    }
}
...

Append txt as header to the reply that is going to be generated by Kamailio (e.g., via sl_send_reply(...)).

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, BRANCH_ROUTE, FAILURE_ROUTE, ERROR_ROUTE.

...
append_to_reply("Foo: bar\r\n");
append_to_reply("Foo: $rm at $Ts\r\n");
...

Appends 'txt' as header at the end of all the headers, or after last header named 'hdr' if the second parameter is provided.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
append_hf("P-hint: VOICEMAIL\r\n");
append_hf("From-username: $fU\r\n", "Call-ID");
...

Inserts 'txt' as header before the first header field, or before first header named 'hdr' if the second parameter is provided.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
insert_hf("P-hint: VOICEMAIL\r\n");
insert_hf("To-username: $tU\r\n");
insert_hf("P-hint: VOICEMAIL\r\n", "Call-ID");
insert_hf("To-username: $tU\r\n", "Call-ID");
...

Append header field name with original Request-URI in middle.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
append_urihf("CC-Diversion: ", "\r\n");
...

Return true if a header field is present in message.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if (is_present_hf("From")) xlog("From HF Present");
...

Same as is_present_hf() function, but the parameter can contain variables.

...
if (is_present_hf_pv("$var(hname)")) xinfo("Header $var(hname) is present\n");
...

Return true if a header field whose name matches regular expression 'hf_name_re' is present in message.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if (is_present_hf_re("^P-"))
    xlog("There are headers starting with P-\n");
...

Same as is_present_hf_re() function, but the parameter can contain variables.

...
if (is_present_hf_re_pv_("^$var(prefix)"))
    xlog("There are headers starting with $var(prefix)\n");
...

Adds a time header to the reply of the request. You must use it before functions that are likely to send a reply, e.g., save() from 'registrar' module. Header format is: “Date: %a, %d %b %Y %H:%M:%S GMT”, with the legend:

Return true if a header was successfully appended.

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
append_time();
...

Adds a time header to the request. Header format is: “Date: %a, %d %b %Y %H:%M:%S GMT”, with the legend:

Return true if a header was successfully appended.

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

...
if(!is_present_hf("Date"))
    append_time_to_request();
...

Check if the method of the message matches the name. If name is a known method (invite, cancel, ack, bye, options, info, update, register, message, subscribe, notify, refer, prack), the function performs method ID testing (integer comparison) instead of ignore case string comparison.

The 'name' can be a list of methods in the form of 'method1|method2|...'. In this case, the function returns true if the SIP message's method is one from the list. IMPORTANT NOTE: in the list must be only methods defined in Kamailio with ID (invite, cancel, ack, bye, options, info, update, register, message, subscribe, notify, refer, prack, publish; for more see: http://www.iana.org/assignments/sip-parameters).

If used for replies, the function tests the value of method field from CSeq header.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE, and BRANCH_ROUTE.

...
if(is_method("INVITE"))
{
    # process INVITEs here
}
if(is_method("OPTION|UPDATE"))
{
    # process OPTIONs and UPDATEs here
}
...

Remove from message all headers with name “hname”. Header matching is case-insensitive. Matches and removes also the compact header forms.

Returns true if at least one header is found and removed.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if(remove_hf("User-Agent"))
{
    # User Agent header removed
}
# compact form: remove "Contact" or "m" header
remove_hf("Contact");
# compact form: remove "Contact" or "m" header
remove_hf("m");
...

Same as remove_hf() function, but the parameter can contain variables.

...
remove_hf_pv("$var(hname)");
...

Remove from message all headers with name matching regular expression “re”

Returns true if at least one header is found and removed.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
if(remove_hf_re("^P-"))
{
    # All headers starting with "P-" removed
}
...

Same as remove_hf_re() function, but the parameter can contain variables.

...
if(remove_hf_re_pv("^$var(prefix)"))
{
    # All headers starting with $var(prefix) value removed
}
...

Remove from message all headers with name matching regular expression “expmatch”, but not matching regular expression “expskip”.

Returns true if at least one header is found and removed.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
if(remove_hf_exp("^P-", "^P-Keep-"))
{
    # All headers starting with "P-" removed,
    # except the ones starting with "P-Keep-"
}
...

Same as remove_hf_exp() function, but the parameters can contain variables.

...
if(remove_hf_exp_pv("^$var(match)", "^$var(keep)"))
{
    # All headers starting with $var(match) value removed,
    # except the ones starting with $var(keep) value
}
...

Remove from message the headers matching by name 'hname' with the index 'idx'.

Returns true if the header is removed.

Meaning of the parameters is as follows:

The parameters can be config variables.

This function can be used from ANY_ROUTE.

...
remove_hf_idx("X-My-Header", "-1");
...

Remove from message all headers with name 'hname' matching the body with expression “expr”, based on operator “op”.

Returns true if at least one header is found and removed.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
if(remove_hf_match("X-Info", "in", "^data")) {
    # all headers with name "X-Info" that have the body matching regular
    # expression "^data" are removed
}
...

The function returns true if the SIP message has a body attached. The check includes also the “Content-Length” header presence and value.

If a parameter is given, the mime described will be also checked against the “Content-Type” header.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if(has_body("application/sdp"))
{
    # do interesting stuff here
}
...

The function returns true if the SIP message has a body attached and at least one audio stream in on hold. The return code of the function indicates the detected hold type:

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if(is_audio_on_hold())
{
    switch ($rc) {
    case 1:
        # RFC2543 hold type
        # do interesting stuff here
        break;
    case 2:
        # RFC3264 hold type
        # do interesting stuff here
        break;
}
...

The function returns true if the SIP message has a Privacy header field that includes the given privacy_type among its privacy values. See http://www.iana.org/assignments/sip-priv-values for possible privacy type values.

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if(is_privacy("id"))
{
    # do interesting stuff here
}
...

Function checks if subject string is found in list string where list items are separated by separator string. Subject and list strings may contain pseudo variables. Separator string needs to be one character long. Returns 1 if subject is found and -1 otherwise.

Function can be used from all kinds of routes.

...
$var(subject) = "fi";
$var(list) = "dk,fi,no,se";
if (in_list("$var(subject)", "$var(list)", ",")) {
    xlog("L_INFO", "subject is found in list\n");
}
...

Function checks if any element in list string is a prefix for subject string where list items are separated by separator string. Subject and list strings may contain pseudo variables. Separator string needs to be one character long. Returns 1 if subject is found and -1 otherwise.

Function can be used from all kinds of routes.

...
$var(subject) = "final";
$var(list) = "dk,fi,no,se";
if (in_list_prefix("$var(subject)", "$var(list)", ",")) {
    xlog("L_INFO", "prefix for subject is found in list\n");
}
...

The function returns true if the two parameters matches as string case sensitive comparison.

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if(cmp_str("$rU", "kamailio"))
{
    # do interesting stuff here
}
...

The function returns true if the two parameters matches as string case insensitive comparison.

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if(cmp_istr("$rU@you", "kamailio@YOU"))
{
    # do interesting stuff here
}
...

The function returns true if the first string starts with the second string.

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if (starts_with("$rU", "+358"))
{
    # do interesting stuff here
}
...

The function returns true if the first string ends with the second string. The parameters can contain variables.

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE, FAILURE_ROUTE and BRANCH_ROUTE.

...
if (ends_with("$rU", "8800"))
{
    # do interesting stuff here
}
...

The function returns true (greater than 0) if the str2 string is found in str1, case sensitive comparison.

This function can be used from ANY_ROUTE.

...
if (str_find("$rU", "8800")) {
    # do interesting stuff here
}
...

The function returns true (greater than 0) if the str2 string is found in str1, case insensitive comparison.

This function can be used from ANY_ROUTE.

...
if (str_ifind("$rU", "Alice")) {
    # do interesting stuff here
}
...

Return 1 (true) if any character in "clist" is found inside "txt". Both paramters can contain variables.

This function can be used from ANY_ROUTE.

...
if (str_any_in("$hdr(X-Hdr)", ";',:")) {
    # do interesting stuff here
}
...

Set multipart body to a SIP message. If called with no parameters, will convert present body to multipart.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

The core will take care of the last boundary ending with "--", detecting which one is the last and fixing the others if needed.

Note: it may be required that msg_apply_changes() from textopsx module has to be executed if there are other operations over the new body.

...
set_body_multipart("test", "text/plain", "delimiter");
msg_apply_changes();
append_body_part(...);
msg_apply_changes();

...

# Will produce:

...
Content-Type: multipart/mixed;boundary="delimiter"
Mime-Version: 1.0

--delimiter
Content-Type: text/plain

text

--delimiter
...

Append a part on multipart body SIP message. Will use "unique-boundary-1" as boundary.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

The core will take care of the last boundary ending with "--", detecting which one is the last and fixing the others if needed.

Note: it may be required that msg_apply_changes() from textopsx module has to be executed if there are other operations over the new body.

...
$var(b) = "7e Od 04 55 75 69 20 4d 61 6b 65 43 61 6c 6c";
append_body_part("$var(b)", "application/vnd.cirpack.isdn-ext", "signal;handling=required");
msg_apply_changes();
...

# Will append this to the body:

...
Content-Type: application/vnd.cirpack.isdn-ext
Content-Disposition: signal;handling=required

7e Od 04 55 75 69 20 4d 61 6b 65 43 61 6c 6c

--unique-boundary-1
...

If other headers should be added to a MIME body part, they can be appended after the value of the content-type parameter, separated by `\r\n` (at the very end do not add the '\r\n').

...
$var(b) = "7e Od 04 55 75 69 20 4d 61 6b 65 43 61 6c 6c";
append_body_part("$var(b)", "application/vnd.cirpack.isdn-ext\r\nX-Header: xyz", "signal;handling=required");
msg_apply_changes();
...

# Will append this to the body:

...
Content-Type: application/vnd.cirpack.isdn-ext
X-Header: xyz
Content-Disposition: signal;handling=required

7e Od 04 55 75 69 20 4d 61 6b 65 43 61 6c 6c

--unique-boundary-1
...

Append a part on multipart body SIP message, with the content provided in hexa format. Will use "unique-boundary-1" as boundary.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

The core will take care of the last boundary ending with "--", detecting which one is the last and fixing the others if needed.

Note: it may be required that msg_apply_changes() from textopsx module has to be executed if there are other operations over the new body.

...
$var(b) = "6b 61 6d 61 69 6c 69 6f";
append_body_part_hex("$var(b)", "application/my-custom-ext");
msg_apply_changes();
...

# Will append this to the body:

...
Content-Type: application/my-custom-ext

kamailio

--unique-boundary-1
...

If other headers should be added to a MIME body part, see the docs for append_body_part(...) function.

Return the content of a multipart body SIP message, storing it in opv.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE, ONREPLY_ROUTE.

...
get_body_part("application/vnd.cirpack.isdn-ext", "$var(pbody)");
...

Return the content of a multipart body SIP message, including headers and boundary string, storing it in opv.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE, ONREPLY_ROUTE.

...
get_body_part("application/vnd.cirpack.isdn-ext", "$var(hbody)");
...

Remove a part on a multipart body SIP message.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

The core will take care of the last boundary ending with "--", detecting which one is the last and fixing the others if needed.

Note: it may be required that msg_apply_changes() from textopsx module has to be executed if there are other operations over the new body.

...
remove_body_part("application/vnd.cirpack.isdn-ext");
msg_apply_changes();
...

Search in text with given regular expression then set dpv pseudo-variable with the matched token at provided index.

Meaning of the parameters is as follows:

This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.

Note that the regular expression extended is used. More info at: https://www.regular-expressions.info/posix.html.

	...
	regex_substring("___ abc123def ___ ghi456 ___", "([a-z]*)([0-9]+)([a-z]*)",
			1, 3, "$var(asd)");
	xlog("L_WARN","RESULT: $var(asd)\r\n");
	------
	result:
	abc
	----
	...

Remove parameter matching by name from Via body at the specified index. The index starts from 0 (first Via body). Negative index counts from the end of the list for Via header bodies (-1 is the last Via body).

Meaning of the parameters is as follows:

The parameters can also be variables.

This function can be used from ANY_ROUTE.

...
via_param_rm("p1", "0");
...

For programmatic use only--import the Textops API.

Meaning of the parameters is as follows: