presence_reginfo Module

Carsten Bock

Edited by

Carsten Bock


Table of Contents

1. Admin Guide
1. Overview
2. Dependencies
2.1. Kamailio Modules
2.2. External Libraries or Applications
3. Parameters
3.1. default_expires (int)
3.2. aggregate_presentities (int)
4. Functions

List of Examples

1.1. Set default_expires parameter
1.2. Set aggregate_presentities parameter

Chapter 1. Admin Guide

1. 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 Kamailio 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 Kamailio instances.

2. Dependencies

2.1. Kamailio Modules

The following modules must be loaded before this module:

  • presence.

2.2. External Libraries or Applications

None.

3. Parameters

3.1. default_expires (int)

The default expires value used when missing from SUBSCRIBE message (in seconds).

Default value is 3600.

Example 1.1. Set default_expires parameter

        ...
        modparam("presence_reginfo", "default_expires", 3600)
        ...

3.2. 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).

Example 1.2. Set aggregate_presentities parameter

					...
					modparam("presence_reginfo", "aggregate_presentities", 1)
					...

4. Functions

None to be used in configuration file.