PRESENCE_REGINFO module
Admin Guide
Section titled “Admin Guide”Overview
Section titled “Overview”The module enables the handling of “Event: reg” (as defined in RFC 3680) inside of the presence module. This can be used distribute the registration-info status to the subscribed watchers.
The module does not currently implement any authorization rules. It assumes that publish requests are only issued by an authorized application and subscribe requests only by authorized users. Authorization can thus be easily done in OpenSIPS configuration file before calling handle_publish() and handle_subscribe() functions.
Note: This module only activates the processing of the “reg” in the presence module. To send dialog-info to watchers you also need a source which PUBLISH the reg info to the presence module. For example you can use the pua_reginfo module or any external component. This approach allows to have the presence server and the reg-info aware publisher (e.g. the main proxy) on different OpenSIPS instances.
Dependencies
Section titled “Dependencies”OpenSIPS Modules
Section titled “OpenSIPS Modules”The following modules must be loaded before this module:
- presence.
External Libraries or Applications
Section titled “External Libraries or Applications”None.
Exported Parameters
Section titled “Exported Parameters”default_expires (int)
Section titled “default_expires (int)”The default expires value used when missing from SUBSCRIBE message (in seconds).
Default value is “3600”.
...modparam("presence_reginfo", "default_expires", 3600)...aggregate_presentities (int)
Section titled “aggregate_presentities (int)”Whether to aggregate in a single notify body all registration presentities. Useful to have all registrations on first NOTIFY following initial SUBSCRIBE.
Default value is “0” (disabled).
...modparam("presence_reginfo", "aggregate_presentities", 1)...Exported Functions
Section titled “Exported Functions”None to be used in configuration file.
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. | Carsten Bock | 8 | 1 | 771 | 0 |
| 2. | Stefan Darius (@dariusstefan) | 7 | 4 | 126 | 26 |
| 3. | Bogdan-Andrei Iancu (@bogdan-iancu) | 4 | 2 | 17 | 20 |
| 4. | Razvan Crainea (@razvancrainea) | 4 | 2 | 2 | 4 |
| 5. | Ken Rice | 3 | 1 | 2 | 2 |
(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) | May 2026 - Jun 2026 |
| 3. | Ken Rice | Sep 2025 - Sep 2025 |
| 4. | Bogdan-Andrei Iancu (@bogdan-iancu) | Apr 2024 - Apr 2024 |
| 5. | Carsten Bock | Mar 2024 - Mar 2024 |
(1) including any documentation-related commits, excluding merge commits
Documentation
Section titled “Documentation”Contributors
Section titled “Contributors”Last edited by: Razvan Crainea (@razvancrainea), Bogdan-Andrei Iancu (@bogdan-iancu), Carsten Bock.
License
Section titled “License”All documentation files (i.e. .md extension) are licensed under the Creative Common License 4.0