B2B_ENTITIES module
Admin Guide
Section titled “Admin Guide”Overview
Section titled “Overview”The B2BUA implementation in OpenSIPS is separated in two layers:
- a lower one(coded in this module)- which implements the basic functions of a UAS and UAC
- a upper one - which represents the logic engine of B2BUA, responsible of actually implementing the B2BUA services using the functions offered by the low level.
This module stores records corresponding to the dialogs in which the B2BUA is involved. It exports an API to be called from other modules which offers functions for creating a new dialog record, for sending requests or replies in one dialog and will also notify the upper level module when a request or reply is received inside one stored dialog.
The records are separated in two types: b2b server entities and b2b client entities depending on the mode they are created. An entity created for a received initial message will be a server entity, while a entity that will send an initial request(create a new dialog) will be a b2b client entity. The name corresponds to the behavior in the first transaction - if UAS - server entity and if UAC - client entity.
This module does not implement a B2BUA alone, but needs a B2B logic implementing module.
The module is able to respond to authentication challanges if the uac_auth module is loaded first. The list of credentials for b2b authentication is also provided by the uac_auth module.
Dependencies
Section titled “Dependencies”OpenSIPS Modules
Section titled “OpenSIPS Modules”- tm
- a db module
- uac_auth (mandatory if authentication is required)
External Libraries or Applications
Section titled “External Libraries or Applications”The following libraries or applications must be installed before running OpenSIPS with this module loaded:
- none
Exported Parameters
Section titled “Exported Parameters”server_hsize (int)
Section titled “server_hsize (int)”The size of the hash table that stores the b2b server entities. It is the 2 logarithmic value of the real size.
Default value is “9” (512 records).
...modparam("b2b_entities", "server_hsize", 10)...client_hsize (int)
Section titled “client_hsize (int)”The size of the hash table that stores the b2b client entities. It is the 2 logarithmic value of the real size.
Default value is “9” (512 records).
...modparam("b2b_entities", "client_hsize", 10)...script_req_route (str)
Section titled “script_req_route (str)”The name of the b2b script route that will be called when B2B requests are received.
...modparam("b2b_entities", "script_req_route", "b2b_request")...script_reply_route (str)
Section titled “script_reply_route (str)”The name of the b2b script route that will be called when B2B replies are received.
...modparam("b2b_entities", "script_reply_route", "b2b_reply")...db_url (str)
Section titled “db_url (str)”Database URL. It is not compulsory, if not set data is not stored in database.
...modparam("b2b_entities", "db_url", "mysql://opensips:opensipsrw@127.0.0.1/opensips")...update_period (int)
Section titled “update_period (int)”The time interval at which to update the info in database.
Default value is “100”.
...modparam("b2b_entities", "update_period", 60)...b2b_key_prefix (string)
Section titled “b2b_key_prefix (string)”The string to use when generating the key ( it is inserted in the SIP messages as callid or to tag. It is useful to set this prefix if you use more instances of opensips B2BUA cascaded in the same architecture. Sometimes opensips B2BUA looks at the callid or totag to see if it has the format it uses to determine if the request was sent by it.
Default value is “B2B”.
...modparam("b2b_entities", "b2b_key_prefix", "B2B1")...db_mode (int)
Section titled “db_mode (int)”The B2B modules have support for the 3 type of database storage
- NO DB STORAGE - set this parameter to 0
- WRITE THROUGH (synchronous write in database) - set this parameter to 1
- WRITE BACK (update in db from time to time) - set this parameter to 2
Default value is “2” (WRITE BACK).
...modparam("b2b_entities", "db_mode", 1)...db_table (str)
Section titled “db_table (str)”The name of the table that will be used for storing B2B entities
Default value is “b2b_entities”
...modparam("b2b_entities", "db_table", "some table name")...cluster_id (int)
Section titled “cluster_id (int)”The ID of the cluster this instance belongs to. Setting this parameter enables clustering support for the OpenSIPS B2BUA by replicating the B2B entities (B2B dialogs) between instances. This also ensures restart persistency through the clusterer module’s data “sync” mechanism.
Default value is “0” (clustering disabled)
...modparam("b2b_entities", "cluster_id", 10)...Exported Functions
Section titled “Exported Functions”The module does not export functions to be used in configuration script.
Exported MI Functions
Section titled “Exported MI Functions”b2be_list
Section titled “b2be_list”This command can be used to list the internals of the b2b entities.
Name: b2be_list
Parameters: none
MI FIFO Command Format:
opensips-cli -x mi b2be_listDeveloper Guide
Section titled “Developer Guide”The module provides an API that can be used from other OpenSIPS modules. The API offers the functions for creating and handing dialogs. A dialog can be created on a receipt initial message, and this will correspond to a b2b server entity, or initiated by the server and in this case a client entity will be created in b2b_entities module.
b2b_load_api(b2b_api_t* api)
Section titled “b2b_load_api(b2b_api_t* api)”This function binds the b2b_entities modules and fills the structure the exported functions that will be described in detail.
...typedef struct b2b_api { b2b_server_new_t server_new; b2b_client_new_t client_new;
b2b_send_request_t send_request; b2b_send_reply_t send_reply;
b2b_entity_delete_t entity_delete;
b2b_restore_linfo_t restore_logic_info; b2b_update_b2bl_param_t update_b2bl_param;}b2b_api_t;...server_new
Section titled “server_new”Field type:
...typedef str* (*b2b_server_new_t) (struct sip_msg* ,b2b_notify_t , void* param);...This function asks the b2b_entities modules to create a new server entity record. The internal processing actually extracts the dialog information from the message and constructs a record that will be stored in a hash table. The second parameters is a pointer to a function that the b2b_entities module will call when a event will come for that dialog (a request or reply). The third parameter is a pointer to a value that will be stored and given as a parameter when the notify function will be called(it has to be allocated in shared memory).
The return value is an identifier for the record that will be mentioned when calling other functions that represent actions in the dialog(send request, send reply).
The notify function has the following prototype:
...typedef int (*b2b_notify_t)(struct sip_msg* msg, str* id, int type, void* param);...This function is called when a request or reply is received for a dialog handled by b2b_entities. The first parameter is the message, the second is the identifier for the dialog, the third is a flag that says which is the type of the message(it has two possible values - B2B_REQUEST and B2B_REPLY). The last parameter is the parameter by the upper module when the entity was created.
client_new
Section titled “client_new”Field type:
...typedef str* (*b2b_client_new_t) (client_info_t* , b2b_notify_t b2b_cback, b2b_add_dlginfo_t add_dlginfo_f, str* param);...This function asks the b2b_entities modules to create a new client entity record and also create a new dialog by sending an initial message. The parameters are all the values needed for the initial request to which the notify function and parameter are added. The b2b_cback parameter is a pointer to the callback that must be called when an event happens(receiving a reply or request) in the dialog created with this function. The add_dlginfo_f parameter is also a function pointer to a callback that will be called when a final success response will be received for the created dialog. The callback will receive as parameter the complete dialog information for the record. It should be stored and used when calling send_request or send_reply functions.
The return value is an identifier for the record that will be mentioned when calling other functions that represent actions in the dialog(send request, send reply).
send_request
Section titled “send_request”Field type:
...typedef int (*b2b_send_request_t)(enum b2b_entity_type ,str* b2b_key, str* method, str* extra_headers, str* body, b2b_dlginfo_t*);...This function asks the b2b_entities modules to send a request inside a b2b dialog identified by b2b_key. The first parameter is the entity type and can have two values: B2B_SERVER and B2B_CLIENT. The second is the identifier returned by the create function(server_new or client_new) and the next are the informations needed for the new request: method, extra_headers, body. The last parameter contains the dialog information - callid, to tag, from tag. These are needed to make a perfect match to of b2b_entities record for which a new request must be sent.
The return value is 0 for success and a negative value for error.
send_reply
Section titled “send_reply”Field type:
...typedef int (*b2b_send_reply_t)(enum b2b_entity_type et, str* b2b_key, int code, str* text, str* body, str* extra_headers, b2b_dlginfo_t* dlginfo);...This function asks the b2b_entities modules to send a reply inside a b2b dialog identified by b2b_key. The first parameter is the entity type and can have two values: B2B_SERVER and B2B_CLIENT. The second is the identifier returned by the create function(server_new or client_new) and the next are the informations needed for the new reply: code, text, body, extra_headers. The last parameter contains the dialog information used for matching the right record.
The return value is 0 for success and a negative value for error.
entity_delete
Section titled “entity_delete”Field type:
...typedef void (*b2b_entity_delete_t)(enum b2b_entity_type et, str* b2b_key, b2b_dlginfo_t* dlginfo);...This function must be called by the upper level function to delete the records in b2b_entities. The records are not cleaned up by the b2b_entities module and the upper level module must take care to delete them.
restore_logic_info
Section titled “restore_logic_info”Field type:
...typedef int (*b2b_restore_linfo_t)(enum b2b_entity_type type, str* key, b2b_notify_t cback);...This function is used at startup when loading the data from the database to restore the pointer to the callback function.
update_b2bl_param
Section titled “update_b2bl_param”Field type:
...typedef int (*b2b_update_b2bl_param_t)(enum b2b_entity_type type, str* key, str* param, int replicate);...This function can be used to change the logic param stored for an entity ( useful in case an entity is moved between logic records).
Contributors
Section titled “Contributors”By Commit Statistics
Section titled “By Commit Statistics”Top contributors by DevScore(1), authored commits(2) and lines added/removed(3)
| # | Name | DevScore | Commits | Lines++ | Lines— |
|---|---|---|---|---|---|
| 1. | Anca Vamanu | 189 | 94 | 7072 | 2093 |
| 2. | Vlad Patrascu (@rvlad-patrascu) | 90 | 54 | 2507 | 843 |
| 3. | Razvan Crainea (@razvancrainea) | 61 | 51 | 505 | 299 |
| 4. | Bogdan-Andrei Iancu (@bogdan-iancu) | 56 | 47 | 542 | 238 |
| 5. | Ovidiu Sas (@ovidiusas) | 54 | 40 | 900 | 338 |
| 6. | Liviu Chircu (@liviuchircu) | 22 | 16 | 152 | 188 |
| 7. | Stefan Darius (@dariusstefan) | 12 | 5 | 585 | 89 |
| 8. | Vlad Paiu (@vladpaiu) | 6 | 4 | 78 | 51 |
| 9. | Nick Altmann (@nikbyte) | 5 | 2 | 167 | 36 |
| 10. | Maksym Sobolyev (@sobomax) | 4 | 2 | 20 | 13 |
All remaining contributors: Stanislaw Pitucha, Peter Lemenkov (@lemenkov), Ionut Ionita (@ionutrazvanionita), @DMOsipov, Walter Doekes (@wdoekes), Stéphane Alnet (@shimaore), Ryan Bullock (@rrb3942), Henk Hesselink.
(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
Section titled “By Commit Activity”| # | Name | Commit Activity |
|---|---|---|
| 1. | Stefan Darius (@dariusstefan) | Jun 2026 - Jul 2026 |
| 2. | Razvan Crainea (@razvancrainea) | Dec 2010 - Jun 2026 |
| 3. | Bogdan-Andrei Iancu (@bogdan-iancu) | Aug 2009 - Oct 2023 |
| 4. | Vlad Patrascu (@rvlad-patrascu) | May 2017 - Jun 2023 |
| 5. | Ovidiu Sas (@ovidiusas) | Nov 2010 - Feb 2023 |
| 6. | Liviu Chircu (@liviuchircu) | Mar 2014 - Nov 2022 |
| 7. | Nick Altmann (@nikbyte) | Jan 2013 - May 2021 |
| 8. | Maksym Sobolyev (@sobomax) | Jan 2021 - Mar 2021 |
| 9. | Peter Lemenkov (@lemenkov) | Jun 2018 - Feb 2020 |
| 10. | @DMOsipov | Mar 2016 - Mar 2016 |
All remaining contributors: Ionut Ionita (@ionutrazvanionita), Walter Doekes (@wdoekes), Vlad Paiu (@vladpaiu), Ryan Bullock (@rrb3942), Stéphane Alnet (@shimaore), Anca Vamanu, Henk Hesselink, Stanislaw Pitucha.
(1) including any documentation-related commits, excluding merge commits
Documentation
Section titled “Documentation”Contributors
Section titled “Contributors”Last edited by: Razvan Crainea (@razvancrainea), Vlad Patrascu (@rvlad-patrascu), Peter Lemenkov (@lemenkov), Liviu Chircu (@liviuchircu), Bogdan-Andrei Iancu (@bogdan-iancu), Vlad Paiu (@vladpaiu), Ovidiu Sas (@ovidiusas), Anca Vamanu.
License
Section titled “License”All documentation files (i.e. .md extension) are licensed under the Creative Common License 4.0