The following modules must be loaded before this module:

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

Set the script flag.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
setsflag("1");
...
$var(flag) = 11;
setsflag("$var(flag)");
...

Return true if the script flag is set.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
if(issflagset("1"))
{
    ...
}
...

Reset the script flag.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
resetsflag("1");
...

Set the branch flag.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
setbflag("1");
...
$var(flag) = 11;
setbflag("$var(flag)", "1");
...

Return true if the branch flag is set.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
if(isbflagset("1"))
{
    ...
}
...

Reset the branch flag.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
resetbflag("1");
...

Set the destination address URI (outbound proxy address).

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
setdsturi("sip:10.0.0.10");
...

Reset the destination address URI (outbound proxy address).

This function can be used from ANY_ROUTE.

...
resetdsturi();
...

Check if the destination address URI (outbound proxy address) is set.

This function can be used from ANY_ROUTE.

...
if(isdsturiset())
{
   ...
}
...

Evaluates the str and sets the resulting value to variable var. For backward compatibility reasons, the same function can be executed via 'avp_printf(var, str)'.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
pv_printf("$ru", "sip:$rU@$fd");
pv_printf("$avp(x)", "From: $fU - To: $tU");
...

Check if the parameter matches the 'myself' condition (i.e., is a local IP or domain). Note that if the port is missing in the URI, then no port matching is done (in other words, port matching is skipped -- it does not use default SIP ports 5060 or 5061 for matching).

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
if(is_myself("$fu")) {
    ...
}
...

Check if the host part of the parameter matches a local domain or IP address.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
if(is_myhost("$tu")) {
    ...
}
...

Set the debug log level per process.

Meaning of the parameters is as follows:

This function can be used from ANY_ROUTE.

...
setdebug("1");
...
$var(level) = 2;
setdebug("$var(level)");
...

Reset the local debug log level back to the value of core parameter 'debug'.

This function can be used from ANY_ROUTE.

...
resetdebug();
...

This function was replaced by append_branch() from corex module, starting with version 4.0.0.

Returns the list of local SIP server host aliases.

Print command line arguments.

Name: core.arg

Parameters: none.

RPC Command Format:

...
kamctl rpc core.arg
...

Returns back its parameters.

Returns the compile flags.

Verbose info, including version number, compile flags, compiler, repository, hash

Runtime details like running version, uptime, ...

Kill the application.

Name: core.kill

Parameters: none.

RPC Command Format:

...
kamctl rpc core.kill
...

Returns the integers given as parameters.

Returns the strings given as parameters.

Returns the description of running processes.

Returns the detailed description of running processes.

Print working directory.

Name: core.pwd

Parameters: none.

RPC Command Format:

...
kamctl rpc core.pwd
...

Returns shared memory info. It has an optional parameter that specifies the measuring unit: b - bytes (default), k or kb, m or mb, g or gb. Note: when using something different from bytes, the value is truncated.

Returns the list of local SIP server listen sockets.

Returns TCP related info.

Returns TCP connections details.

Returns active TCP options.

Returns udp4_raw mode related info.

Print uptime.

Name: core.uptime

Parameters: none.

RPC Command Format:

...
kamctl rpc core.uptime
...

Print version information.

Name: core.version

Parameters: none.

RPC Command Format:

...
kamctl rpc core.version
...

List preprocessor defines enabled in config.

Name: core.ppdefines

Parameters: none.

RPC Command Format:

...
kamctl rpc core.ppdefines
...

List loaded modules in config.

Name: core.modules

Parameters: none.

RPC Command Format:

...
kamctl rpc core.modules
...

Get the value of a module parameter with integer value.

Name: modparam.getn

Parameters: module_name and parameter_name.

RPC Command Format:

...
kamcli rpc modparam.getn tls keylog_mode
...

Get the value of a module parameter with string value.

Name: modparam.gets

Parameters: module_name and parameter_name.

RPC Command Format:

...
kamcli rpc modparam.gets tls config
...

Set the value of a module parameter with integer value stored in shared memory.

Name: modparam.setn

Parameters: module_name, parameter_name and value.

RPC Command Format:

...
kamcli rpc modparam.setn tls keylog_mode 15
...

List the parameters of the loaded modules.

Name: modparam.list

Parameters: module_name (optional).

RPC Command Format:

...
kamcli rpc modparam.list
kamcli rpc modparam.list tls
...

Print private memory (pkg) usage statistics per process. It can take optionally a filter to print statistics only for a specific process or set of processes. If no filter is given, it prints statistics for all processes.

The filter can be:

Examples:

		kamctl rpc pkg.stats
		kamctl rpc pkg.stats pid 1234
		kamctl rpc pkg.stats rank 1
		kamctl rpc pkg.stats index 10

Get pkg manager details.

Example:

		kamcli rpc pkg.info

Print the list of available internal statistics.

NOTE: the result is an array of strings that have the list of statistics formatted like "name = value", being propagated over the time from the MI variant. Use "stats.fetch" or "stats.fetchn"commands to have a more JSON-friendly output.

Parameters: statsid - which statistics to be printed. If set to 'all' then all statistics are printed; if set to 'statsgroup:' then all statistics in the group are printed; if set to 'statsname' then the statistics identified by the name is printed.

Examples:

		kamctl rpc stats.get_statistics all
		kamctl rpc stats.get_statistics core:
		kamctl rpc stats.get_statistics unsupported_methods
		kamctl rpc stats.get_statistics shmem: fwd_requests fwd_replies

Print the list of available internal statistics with a more json friendly output. Each printed statistic is a field in the output structure: {"statsgroup.statsname" : "statsvalue"}. The value is represented as string to accommodate large numbers.

Parameters: statsid - which statistics to be printed. If set to 'all' then all statistics are printed; if set to 'statsgroup:' then all statistics in the group are printed; if set to 'statsname' then the statistics identified by the name is printed (can be also 'statsgroup.stastname' or 'statsgroup:statsname').

Examples:

		kamctl rpc stats.fetch all
		kamctl rpc stats.fetch core:
		kamctl rpc stats.fetch unsupported_methods
		kamctl rpc stats.fetch shmem.free_size
		kamctl rpc stats.fetch shmem: fwd_requests fwd_replies

Print the list of available internal statistics with a more json friendly output. Each printed statistic is a field in the output structure: {"statsgroup.statsname" : statsvalue}. The value is represented as number.

Parameters: statsid - which statistics to be printed. If set to 'all' then all statistics are printed; if set to 'statsgroup:' then all statistics in the group are printed; if set to 'statsname' then the statistics identified by the name is printed (can be also 'statsgroup.stastname' or 'statsgroup:statsname').

Examples:

		kamctl rpc stats.fetchn all
		kamctl rpc stats.fetchn core:
		kamctl rpc stats.fetchn unsupported_methods
		kamctl rpc stats.fetchn shmem.free_size
		kamctl rpc stats.fetchn shmem: fwd_requests fwd_replies

Reset internal statistics.

Parameters: statsid - same as for get_statistics.

Examples:

		kamctl rpc stats.reset_statistics all
		kamctl rpc stats.reset_statistics core:
		kamctl rpc stats.reset_statistics unsupported_methods
		kamctl rpc stats.reset_statistics shmem: fwd_requests fwd_replies

Return statistics and reset their value in one command.

Parameters: statsid - same as for get_statistics.

Examples:

		kamctl rpc stats.reset_statistics all
		kamctl rpc stats.reset_statistics core:
		kamctl rpc stats.reset_statistics unsupported_methods
		kamctl rpc stats.reset_statistics shmem: fwd_requests fwd_replies

Print list of available RPC commands.

Name: system.listMethods

Parameters: none.

RPC Command Format:

...
kamctl rpc system.listMethods
...

Print the help string for given method.

Returns signature of given method.

Print private(pkg) or shared(shm) memory currently allocated a given module or by all modules.

NOTE: Processing is done only when the command is issued and involves iterating through the list of memory fragments and printing details about them.

NOTE: Only the module functions that directly calls shm_alloc or pkg_alloc are taken into consideration.

The first parameter can be one of the following:

The second parameter can be:

Examples:

		kamctl rpc mod.stats core all
		kamctl rpc mod.stats tm shm
		kamctl rpc mod.stats kex pkg
		kamctl rpc mod.stats all all

Output:

Module: kex
{
    // this is the pkg zone of the module
    // function_name(line_where_pkg_malloc_was_called): size_alloc'ed_by_pkg_malloc
    init_rpc_uptime(74): 56
    Total: 56
}
{
    // this is the shm zone of the module
    // function_name(line_where_shm_malloc_was_called): size_alloc'ed_by_shm_malloc
    pkg_proc_stats_init(79): 864
    Total: 864
}

Same as RPC command "mod.mem_stats", this is an alias command to preserve backward compatibility.

Similar to RPC command "mod.mem_stats", but the output has an extended format, printing info that includes the allocated size and the count of allocated chunks in a combined string value. The parameters are the same like for "mod.mem_stats".