Module: sip-router Branch: 4.1 Commit: 1ec2dfbd836872df4663c059c26f410935a51b62 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=1ec2dfbd...
Author: Carsten Bock carsten@ng-voice.com Committer: Carsten Bock carsten@ng-voice.com Date: Mon Feb 3 10:05:35 2014 +0100
presence: Regenerated README
---
modules/presence/README | 82 +++++++++++++++++++++++++++++----------------- 1 files changed, 52 insertions(+), 30 deletions(-)
diff --git a/modules/presence/README b/modules/presence/README index f8681e4..b905594 100644 --- a/modules/presence/README +++ b/modules/presence/README @@ -16,9 +16,9 @@ Edited by
Juha Heinanen
- Copyright � 2006 Voice Sistem SRL + Copyright © 2006 Voice Sistem SRL
- Copyright � 2009 Juha Heinanen + Copyright © 2009 Juha Heinanen __________________________________________________________________
Table of Contents @@ -54,6 +54,7 @@ Juha Heinanen 3.19. enable_sphere_check (int) 3.20. timeout_rm_subs (int) 3.21. fetch_rows (integer) + 3.22. db_table_lock_type (integer)
4. Functions
@@ -119,11 +120,12 @@ Juha Heinanen 1.19. Set enable_sphere_check parameter 1.20. Set timeout_rm_subs parameter 1.21. Set fetch_rows parameter - 1.22. handle_publish usage - 1.23. handle_subscribe usage - 1.24. pres_auth_status usage - 1.25. pres_refresh_watchers usage - 1.26. pres_update_watchers usage + 1.22. Set db_table_lock_type parameter + 1.23. handle_publish usage + 1.24. handle_subscribe usage + 1.25. pres_auth_status usage + 1.26. pres_refresh_watchers usage + 1.27. pres_update_watchers usage 2.1. presence_api_t structure
Chapter 1. Admin Guide @@ -159,6 +161,7 @@ Chapter 1. Admin Guide 3.19. enable_sphere_check (int) 3.20. timeout_rm_subs (int) 3.21. fetch_rows (integer) + 3.22. db_table_lock_type (integer)
4. Functions
@@ -245,6 +248,7 @@ Chapter 1. Admin Guide 3.19. enable_sphere_check (int) 3.20. timeout_rm_subs (int) 3.21. fetch_rows (integer) + 3.22. db_table_lock_type (integer)
3.1. db_url(str)
@@ -253,7 +257,7 @@ Chapter 1. Admin Guide If set, the module is a fully operational presence server. Otherwise, it is used as a 'library', for its exported functions.
- Default value is "NULL". + Default value is “NULL”.
Example 1.1. Set db_url parameter ... @@ -265,7 +269,7 @@ modparam("presence", "db_url",
The name of the db table where PUBLISH presence information is stored.
- Default value is "presentity". + Default value is “presentity”.
Example 1.2. Set presentity_table parameter ... @@ -277,7 +281,7 @@ modparam("presence", "presentity_table", "presentity") The name of the db table where active subscription information is stored.
- Default value is "active_watchers". + Default value is “active_watchers”.
Example 1.3. Set active_watchers_table parameter ... @@ -288,7 +292,7 @@ modparam("presence", "active_watchers_table", "active_watchers")
The name of the db table where subscription states are stored.
- Default value is "watchers". + Default value is “watchers”.
Example 1.4. Set watchers_table parameter ... @@ -300,7 +304,7 @@ modparam("presence", "watchers_table", "watchers") The period in seconds between checks if there are expired messages stored in database.
- Default value is "100". A zero or negative value disables this + Default value is “100”. A zero or negative value disables this activity.
Example 1.5. Set clean_period parameter @@ -313,7 +317,7 @@ modparam("presence", "clean_period", 100) The period at which to synchronize cached subscriber info with the database.
- Default value is "100". A zero or negative value disables + Default value is “100”. A zero or negative value disables synchronization.
Example 1.6. Set db_update_period parameter @@ -331,7 +335,7 @@ modparam("presence", "db_update_period", 100) than 0. When notifier_processes is less than or equal to 0 NOTIFY requests are sent immediately.
- Default value is "5". + Default value is “5”.
Example 1.7. Set waitn_time parameter ... @@ -348,7 +352,7 @@ modparam("presence", "waitn_time", 10) Separate notifier processes are only run when subs_db_mode is 3 (DB only mode).
- Default value is "10". + Default value is “10”.
Example 1.8. Set notifier_poll_rate parameter ... @@ -368,7 +372,7 @@ modparam("presence", "notifier_poll_rate", 20) NOTIFY requests can be sent on a dialog at the same time, there are race conditions which result in CSeq re-use.
- Default value is "1". + Default value is “1”.
Example 1.9. Set notifier_processes parameter ... @@ -380,7 +384,7 @@ modparam("presence", "notifier_processes", 2) The prefix used when generating to_tag when sending replies for SUBSCRIBE requests.
- Default value is "10". + Default value is “10”.
Example 1.10. Set to_tag_pref parameter ... @@ -393,7 +397,7 @@ modparam("presence", "to_tag_pref", 'pres') when sending a 200OK for a publish. It is used for forcing the client to send an update before the old publish expires.
- Default value is "0". + Default value is “0”.
Example 1.11. Set expires_offset parameter ... @@ -405,7 +409,7 @@ modparam("presence", "expires_offset", 10) The the maximum admissible expires value for PUBLISH/SUBSCRIBE message (in seconds).
- Default value is "3600". + Default value is “3600”.
Example 1.12. Set max_expires parameter ... @@ -476,7 +480,7 @@ modparam("presence", "subs_db_mode", 1) database or there are other external entities inserting data into the presentity table.
- Default value is "1". + Default value is “1”.
Example 1.15. Set publ_cache parameter ... @@ -489,7 +493,7 @@ modparam("presence", "publ_cache", 0) This parameter will be used as the power of 2 when computing table size.
- Default value is "9 (512)". + Default value is “9 (512)”.
Example 1.16. Set subs_htable_size parameter ... @@ -501,7 +505,7 @@ modparam("presence", "subs_htable_size", 11) The size of the in-memory hash table to store publish records. This parameter will be used as the power of 2 when computing table size.
- Default value is "9 (512)". + Default value is “9 (512)”.
Example 1.17. Set pres_htable_size parameter ... @@ -516,7 +520,7 @@ modparam("presence", "pres_htable_size", 11) empty NOTIFY to an message-summary event. This parameter is enabled by default, thus addering to the standard.
- Default value is "1 ". + Default value is “1 ”.
Example 1.18. Set send_fast_notify parameter ... @@ -531,7 +535,7 @@ modparam("presence", "send_fast_notify", 0) this check requires extra processing that should be avoided if this feature is not supported by the clients.
- Default value is "0 ". + Default value is “0 ”.
Example 1.19. Set enable_sphere_check parameter ... @@ -546,7 +550,7 @@ modparam("presence", "enable_sphere_check", 1) on. Disabling this will keep subscriptions active on unreliable networks.
- Default value is "1". + Default value is “1”.
Example 1.20. Set timeout_rm_subs parameter ... @@ -564,6 +568,24 @@ modparam("presence", "timeout_rm_subs", 0) modparam("presence", "fetch_rows", 1000) ...
+3.22. db_table_lock_type (integer) + + Enable (=1) or disable (=0) the Locks for table during an transaction. + Locking only the "current" table causes problems with a MySQL-Databases + in "DB-Only" mode. + + In order to use the Presence-Module in "DB_ONLY"-mode with a + MySQL-Backend, set this parameter to "0", otherwise the + MySQL-Operations will fail. The Presence-Module will generate a "500 + Server error" due to the failed MySQL-queries. + + Default value is 1 (Write Lock for the Tables). + + Example 1.22. Set db_table_lock_type parameter +... +modparam("presence", "db_table_lock_type", 0) +... + 4. Functions
4.1. handle_publish(char* sender_uri) @@ -592,7 +614,7 @@ modparam("presence", "fetch_rows", 1000)
The module sends an appropriate stateless reply in all cases.
- Example 1.22. handle_publish usage + Example 1.23. handle_publish usage ... if(is_method("PUBLISH")) { @@ -623,7 +645,7 @@ modparam("presence", "fetch_rows", 1000)
The module sends an appropriate stateless reply in all cases.
- Example 1.23. handle_subscribe usage + Example 1.24. handle_subscribe usage ... if(method=="SUBSCRIBE") handle_subscribe(); @@ -640,7 +662,7 @@ if(method=="SUBSCRIBE")
This function can be used from REQUEST_ROUTE.
- Example 1.24. pres_auth_status usage + Example 1.25. pres_auth_status usage ... if (method=="MESSAGE") { pres_auth_status("$fu", $ru"); @@ -676,7 +698,7 @@ if (method=="MESSAGE") {
This function can be used from ANY_ROUTE.
- Example 1.25. pres_refresh_watchers usage + Example 1.26. pres_refresh_watchers usage ... pres_refresh_watchers("sip:test@kamailio.org", "presence", 1); ... @@ -694,7 +716,7 @@ pres_refresh_watchers("sip:test@kamailio.org", "presence", 1);
This function can be used from ANY_ROUTE.
- Example 1.26. pres_update_watchers usage + Example 1.27. pres_update_watchers usage ... pres_update_watchers("sip:test@kamailio.org", "presence"); ...
-
Carsten Bock