[sr-dev] git:4.1: presence: Regenerated README

Module: sip-router Branch: 4.1 Commit: 1ec2dfbd836872df4663c059c26f410935a51b62 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=1ec2dfb… Author: Carsten Bock <carsten(a)ng-voice.com> Committer: Carsten Bock <carsten(a)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"); ...