CLOSEDDIAL module

Admin Guide

Overview

This module provides functionality which allows to group users using a common field, in such a way that a particular group defines abbreviated codes for users, allowing closed dialing within the group, locating users by their abbreviated code, besides their full identification. This module offers a functionality similar to Centrex. The relationship between users and their abbreviated codes, and their grouping is defined in a database table (see below).

Dependencies

OpenSIPS Modules

The following modules must be loaded before this module:

• A database module, like mysql, postgres or dbtext

External Libraries or Applications

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

• None.

Exported Parameters

db_url (string)

URL of the database table to be used.

Default value is “mysql://opensips:opensipsrw@localhost/opensips”.

Set db_url parameter

...
modparam("closeddial", "db_url", "mysql://username:password@dbhost/opensips")
...

user_column (string)

Column of the table which stores the username

Default value is “username”.

Set user_column parameter

...
modparam("closeddial", "user_column", "user")
...

domain_column (string)

Column of the table which stores the domain associated to usernames.

Default value is “domain”.

Set domain_column parameter

...
modparam("closeddial", "domain_column", "domain")
...

group_id_column (string)

Column of the table which stores the group_id which groups the usernames.

Default value is “group_id”.

Set group_id_column parameter

...
modparam("closeddial", "group_id_column", "groupid")
...

cd_user_column (string)

Column of the table which stores the closed dial code associated to a username.

Default value is “cd_username”.

Set user_column parameter

...
modparam("closeddial", "cd_user_column", "cd_user")
...

cd_domain_column (string)

Column of the table which stores the domain associated to closed dial usernames.

Default value is “cd_domain”.

Set cd_domain_column parameter

...
modparam("closeddial", "cd_domain_column", "cddomain")
...

new_uri_column (string)

Column of the table which stores the new URI which will be used to rewrite the request, in case a possitive match be found.

Default value is “new_uri”.

Set new_uri_column parameter

...
modparam("closeddial", "new_uri_column", "new_uri")
...

use_domain (integer)

If enabled (set to non zero value) then domain will be used also used for searching new uri; otherwise only the username part will be used.

Default value is “0 (no)”.

Set use_domain parameter

...
modparam("closeddial", "use_domain", 1)
...

Exported Functions

cd_lookup(domain [, group])

This function is used to lookup in the database the corresponding URI for an abbreviated code dialed, according to group which From user belongs to. After finding the group for From user, the dialed code and found group are used to look for the new URI to rewrite the request.

If a positive match is found, R-URI is rewritten; if no match is found, R-URI is not changed.

Meaning of the parameters is as follows:

• domain
  Table where searching is going to be perfomed on.
• group Optional parameter which can be used to store the group to be used in searching. This group must be associated to From user.

Both of the parameters can contain pseudovariables.

This function can be used from REQUEST_ROUTE and FAILURE_ROUTE.

cd_lookup usage

...

# Abbreviated code of two digits
if($(rU{s.len}) == 2)
{
        # Group AVP could be loaded at register time.
        $avp(group)="companyA";
        cd_lookup("closeddial", "$avp(group)");
};
...

# Abbreviated code of three digits
if($(rU{s.len}) == 3)
{
        # Group is searched on database, by using
        # From username.
        cd_lookup("closeddial");
};
...

Installation

A table needs to be created on the database to store relationship between usernames, their corresponding abbreviated codes and their grouping using group attribute.

The SQL syntax to create the table can be found in closeddial-create.sql script at opensips/scripts folder.

Contributors

By Commit Statistics

Top contributors by DevScore⁽¹⁾, authored commits⁽²⁾ and lines added/removed⁽³⁾

#	Name	DevScore	Commits	Lines++	Lines—
1.	Sergio Gutierrez	15	6	922	10
2.	Bogdan-Andrei Iancu (@bogdan-iancu)	8	6	7	6
3.	Stefan Darius (@dariusstefan)	7	3	287	37
4.	Razvan Crainea (@razvancrainea)	4	2	4	4

(1) DevScore = author_commits + author_lines_added / (project_lines_added / project_commits) + author_lines_deleted / (project_lines_deleted / project_commits)

(2) including any documentation-related commits, excluding merge commits

(3) ignoring whitespace edits, renamed files and auto-generated files

By Commit Activity

#	Name	Commit Activity
1.	Stefan Darius (@dariusstefan)	Jun 2026 - Jul 2026
2.	Razvan Crainea (@razvancrainea)	Jun 2011 - Jun 2026
3.	Bogdan-Andrei Iancu (@bogdan-iancu)	Feb 2009 - Apr 2011
4.	Sergio Gutierrez	Feb 2009 - Nov 2010

(1) including any documentation-related commits, excluding merge commits

Documentation

Contributors

Last edited by: Razvan Crainea (@razvancrainea), Sergio Gutierrez, Bogdan-Andrei Iancu (@bogdan-iancu).

License

All documentation files (i.e. .md extension) are licensed under the Creative Common License 4.0