Table of Contents
List of Tables
List of Examples
Domain module implements checks that based on domain table determine if a host part of an URI is “local” or not. A “local” domain is one that the proxy is responsible for.
Domain module operates in caching or non-caching mode depending on
value of module parameter db_mode
.
In caching mode domain module reads the contents of domain table into
cache memory when the module is loaded. After that domain table is
re-read only when module is given domain_reload fifo command. Any
changes in domain table must thus be followed by
“domain_reload” command in order to reflect them in
module behavior. In non-caching mode domain module always queries domain
table in the database.
Caching is implemented using a hash table. The size of the hash table is given by HASH_SIZE constant defined in domain_mod.h. Its “factory default” value is 128.
The module depends on the following modules (in the other words the listed modules must be loaded before this module):
database -- Any database module
This is URL of the database to be used.
Default value is “mysql://opensipsro:opensipsro@localhost/opensips”
Database mode: 0 means non-caching, 1 means caching.
Default value is 0 (non-caching).
Name of table containing names of local domains that the proxy is responsible for. Local users must have in their sip uri a host part that is equal to one of these domains.
Default value is “domain”.
Name of column containing domains in domain table.
Default value is “domain”.
Checks based on domain table if host part of From header uri is one of the local domains that the proxy is responsible for. The argument is optional and if present it should contain a writable pseudo variable that will be populated with the attributes from the database.
This function can be used from REQUEST_ROUTE.
Example 1.6. is_from_local usage
... if (is_from_local()) { ... }; ... if (is_from_local("$var(attrs)")) { xlog("Domain attributes are $var(attrs)\n"); ... }; ...
If called from route or failure route block, checks based on domain table if host part of Request-URI is one of the local domains that the proxy is responsible for. If called from branch route, the test is made on host part of URI of first branch, which thus must have been appended to the transaction before is_uri_host_local() is called. The argument is optional and if present it should contain a writable pseudo variable that will be populated with the attributes from the database.
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.7. is_uri_host_local usage
... if (is_uri_host_local()) { ... }; ... if (is_uri_host_local("$var(attrs)")) { xlog("Domain attributes are $var(attrs)\n"); ... };
This function checks if the domain contained in the pseudo_variable is local.
This function is a generalized form of the is_from_local() and is_uri_host_local() functions, being able to completely replace them and also extends them by allowing the domain to be taken from any of the above mentioned sources. The following equivalences exist:
is_domain_local("$rd") is same as is_uri_host_local()
is_domain_local("$fd") is same as is_from_local()
The second argument is optional and if present it should contain a writable pseudo variable that will be populated with the attributes from the database.
This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE.
Example 1.8. is_domain_local usage
... if (is_domain_local("$rd")) { ... }; if (is_domain_local("$fd")) { ... }; if (is_domain_local("$avp(some_avp_alias)")) { ... }; if (is_domain_local("$avp(850)")) { ... }; if (is_domain_local("$avp(some_avp)")) { ... }; if (is_domain_local("$avp(some_avp)", "$avp(attrs)")) { xlog("Domain attributes are $avp(attrs)\n"); ... }; ...
Causes domain module to re-read the contents of domain table into cache memory.
Name: domain_reload
Parameters: none
MI FIFO Command Format:
:domain_reload:_reply_fifo_file_ _empty_line_
The module provides is_domain_local API function for use by other OpenSIPS modules.
Table 3.1. Top contributors by DevScore(1), authored commits(2) and lines added/removed(3)
Name | DevScore | Commits | Lines ++ | Lines -- | |
---|---|---|---|---|---|
1. | Bogdan-Andrei Iancu (@bogdan-iancu) | 54 | 40 | 418 | 539 |
2. | Jan Janak (@janakj) | 32 | 21 | 999 | 113 |
3. | Juha Heinanen (@juha-h) | 31 | 20 | 700 | 233 |
4. | Daniel-Constantin Mierla (@miconda) | 19 | 16 | 92 | 79 |
5. | Razvan Crainea (@razvancrainea) | 19 | 12 | 285 | 219 |
6. | Liviu Chircu (@liviuchircu) | 11 | 8 | 45 | 109 |
7. | Andrei Pelinescu-Onciul | 9 | 4 | 186 | 121 |
8. | Dan Pascu (@danpascu) | 8 | 4 | 232 | 101 |
9. | Henning Westerholt (@henningw) | 7 | 5 | 44 | 48 |
10. | Edson Gellert Schubert | 5 | 1 | 0 | 195 |
All remaining contributors: Elena-Ramona Modroiu, Jiri Kuthan (@jiriatipteldotorg), @coxx, Konstantin Bokarius, Klaus Darilion, Anca Vamanu, Norman Brandinger (@NormB), UnixDev, Andreas Granig, Vlad Patrascu (@rvlad-patrascu).
(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. Regarding imported patches/code, we do our best to count the work on behalf of the proper owner, as per the "fix_authors" and "mod_renames" arrays in opensips/doc/build-contrib.sh. If you identify any patches/commits which do not get properly attributed to you, please submit a pull request which extends "fix_authors" and/or "mod_renames".
(3) ignoring whitespace edits, renamed files and auto-generated files
Table 3.2. Most recently active contributors(1) to this module
Name | Commit Activity | |
---|---|---|
1. | Bogdan-Andrei Iancu (@bogdan-iancu) | Oct 2005 - Jun 2020 |
2. | Razvan Crainea (@razvancrainea) | Jun 2011 - Sep 2019 |
3. | Liviu Chircu (@liviuchircu) | Mar 2014 - Nov 2018 |
4. | Vlad Patrascu (@rvlad-patrascu) | May 2017 - May 2017 |
5. | @coxx | Mar 2010 - Mar 2010 |
6. | Anca Vamanu | Sep 2009 - Sep 2009 |
7. | UnixDev | Feb 2009 - Feb 2009 |
8. | Juha Heinanen (@juha-h) | Jan 2003 - May 2008 |
9. | Henning Westerholt (@henningw) | May 2007 - May 2008 |
10. | Daniel-Constantin Mierla (@miconda) | Oct 2005 - Mar 2008 |
All remaining contributors: Konstantin Bokarius, Edson Gellert Schubert, Elena-Ramona Modroiu, Dan Pascu (@danpascu), Norman Brandinger (@NormB), Andreas Granig, Klaus Darilion, Jan Janak (@janakj), Andrei Pelinescu-Onciul, Jiri Kuthan (@jiriatipteldotorg).
(1) including any documentation-related commits, excluding merge commits
Last edited by: Bogdan-Andrei Iancu (@bogdan-iancu), Liviu Chircu (@liviuchircu), Razvan Crainea (@razvancrainea), Daniel-Constantin Mierla (@miconda), Konstantin Bokarius, Edson Gellert Schubert, Juha Heinanen (@juha-h), Elena-Ramona Modroiu, Dan Pascu (@danpascu), Klaus Darilion, Jan Janak (@janakj).
doc copyrights:
Copyright © 2002-2008 Juha Heinanen