PUA BLA module
Admin Guide
Section titled “Admin Guide”Overview
Section titled “Overview”The pua_bla module enables Bridged Line Appearances support according to the specifications in draft-anil-sipping-bla-03.txt.
Dependencies
Section titled “Dependencies”OpenSIPS Modules
Section titled “OpenSIPS Modules”The following modules must be loaded before this module:
- usrloc.
- pua.
- presence.
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:
- libxml.
Exported Parameters
Section titled “Exported Parameters”default_domain(str)
Section titled “default_domain(str)”The default domain for the registered users to be used when constructing the uri for the registrar callback.
Default value is “NULL”.
...modparam("pua_bla", "default_domain", "opensips.org")...header_name(str)
Section titled “header_name(str)”The name of the header to be added to Publish requests. It will contain the uri of the user agent that sent the Notify that is transformed into Publish. It stops sending a Notification with the same information to the sender.
Default value is “NULL”.
...modparam("pua_bla", "header_name", "Sender")...outbound_proxy(str)
Section titled “outbound_proxy(str)”The outbound_proxy uri to be used when sending Subscribe requests.
Default value is “NULL”.
...modparam("pua_bla", "outbound_proxy", "sip:proxy@opensips.org")...server_address(str)
Section titled “server_address(str)”The IP address of the server.
...modparam("pua_bla", "server_address", "sip:bla@160.34.23.12")...presence_server(str)
Section titled “presence_server(str)”The address of the presence server - will be used as an outbound proxy when sending PUBLISH requests. It is optional.
Default value is “NULL”.
...modparam("pua_bla", "presence_server", "sip:pa@opensips.org")...Exported Functions
Section titled “Exported Functions”bla_set_flag()
Section titled “bla_set_flag()”The function is used to mark REGISTER requests made to a BLA AOR. The modules subscribes to the registered contacts for dialog;sla event.
...if(is_method("REGISTER") && $tu=~"bla_aor@opensips.org") bla_set_flag();...bla_handle_notify()
Section titled “bla_handle_notify()”The function handles Notify requests sent from phones on the same BLA to the server. The message is transformed in Publish request and passed to presence module for further handling. in case of a successful processing a 2xx reply should be sent.
...if(is_method("NOTIFY") && $tu=~"bla_aor@opensips.org"){ if( bla_handle_notify() ) t_reply(200, "OK");}...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 | 63 | 27 | 2198 | 1016 |
| 2. | Bogdan-Andrei Iancu (@bogdan-iancu) | 21 | 15 | 377 | 69 |
| 3. | Liviu Chircu (@liviuchircu) | 17 | 14 | 91 | 106 |
| 4. | Daniel-Constantin Mierla (@miconda) | 9 | 7 | 17 | 15 |
| 5. | Razvan Crainea (@razvancrainea) | 9 | 7 | 14 | 15 |
| 6. | Vlad Patrascu (@rvlad-patrascu) | 7 | 5 | 20 | 18 |
| 7. | Stefan Darius (@dariusstefan) | 6 | 3 | 187 | 20 |
| 8. | Ovidiu Sas (@ovidiusas) | 4 | 2 | 15 | 4 |
| 9. | Peter Lemenkov (@lemenkov) | 4 | 2 | 2 | 2 |
| 10. | Vlad Paiu (@vladpaiu) | 3 | 1 | 7 | 17 |
All remaining contributors: Sergio Gutierrez, Maksym Sobolyev (@sobomax), Juha Heinanen (@juha-h), Konstantin Bokarius, Ken Rice, Ezequiel Lovelle (@lovelle), Edson Gellert Schubert, Stanislaw Pitucha.
(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. | Bogdan-Andrei Iancu (@bogdan-iancu) | Jul 2007 - Jul 2026 |
| 2. | Stefan Darius (@dariusstefan) | Jun 2026 - Jul 2026 |
| 3. | Razvan Crainea (@razvancrainea) | Feb 2012 - Jun 2026 |
| 4. | Ken Rice | Sep 2025 - Sep 2025 |
| 5. | Peter Lemenkov (@lemenkov) | Jun 2018 - Jul 2025 |
| 6. | Liviu Chircu (@liviuchircu) | Mar 2014 - May 2024 |
| 7. | Maksym Sobolyev (@sobomax) | Feb 2023 - Feb 2023 |
| 8. | Vlad Patrascu (@rvlad-patrascu) | May 2017 - Apr 2019 |
| 9. | Ezequiel Lovelle (@lovelle) | Oct 2014 - Oct 2014 |
| 10. | Ovidiu Sas (@ovidiusas) | Dec 2010 - Jan 2013 |
All remaining contributors: Vlad Paiu (@vladpaiu), Anca Vamanu, Stanislaw Pitucha, Sergio Gutierrez, Daniel-Constantin Mierla (@miconda), Konstantin Bokarius, Edson Gellert Schubert, Juha Heinanen (@juha-h).
(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), Anca Vamanu, Daniel-Constantin Mierla (@miconda), Konstantin Bokarius, Edson Gellert Schubert.
License
Section titled “License”All documentation files (i.e. .md extension) are licensed under the Creative Common License 4.0