Module: sip-router Branch: master Commit: 6339389bae85814264a923ebbf938d70fa22c4db URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=6339389b...
Author: Olle E. Johansson oej@edvina.net Committer: Olle E. Johansson oej@edvina.net Date: Sun Oct 14 17:24:21 2012 +0200
async: Speling erors fixed
---
modules/async/README | 51 ++++++++++++++++-------------------- modules/async/doc/async_admin.xml | 44 ++++++++++++++----------------- 2 files changed, 43 insertions(+), 52 deletions(-)
diff --git a/modules/async/README b/modules/async/README index 21b2cc2..91ea07f 100644 --- a/modules/async/README +++ b/modules/async/README @@ -59,16 +59,16 @@ Chapter 1. Admin Guide
1. Overview
- This module provides asynchornous operations for handling SIP requests - in configuration file. + This module provides asynchronous operations for handling SIP requests + in the configuration file.
- It uses t_suspend() and t_continue() from TM module. + Async uses t_suspend() and t_continue() from the TM and TMX modules.
- Note that after invoking the an asyncronous operation, the processing - will continue later, in another application process. Therefore, do not - rely on variables stored in private memory, used shared memory if you - want to get values after the processing is resumend (e.g., $avp(...), - $xavp(...), $shv(...), htable $sht(...)). + Note that after invoking the an asynchronous operation, the processing + will continue later in another application process. Therefore variables + stored in private memory should not be used, try to use shared memory + if you want to get values after the processing is resumed (e.g., + $avp(...), $xavp(...), $shv(...), htable $sht(...)).
2. Dependencies
@@ -79,6 +79,7 @@ Chapter 1. Admin Guide
The following modules must be loaded before this module: * tm - transaction management. + tmx - transaction management extensions.
2.2. External Libraries or Applications
@@ -92,7 +93,7 @@ Chapter 1. Admin Guide
3.1. workers (int)
- Number of worker processes to be started to handle the asynchornous + Number of worker processes to be started to handle the asynchronous tasks.
Default value is 1. @@ -109,22 +110,22 @@ modparam("async", "workers", 2)
4.1. async_route(routename, seconds)
- Simulate a sleep of 'seconds' and then continue the processing of SIP - request with the route[routename]. In case of internal errors, the + Simulate a sleep of 'seconds' and then continue the processing of the + SIP request with the route[routename]. In case of internal errors, the function returns false, otherwise the function exits the execution of - config at that moment (return 0 behaviour). + the script at that moment (return 0 behaviour).
The routename parameter can be a static string or a dynamic string value with config variables.
- The sleep parameter represent the number of seconds to suppend the - processing of SIP request. Maximum value is 100. The parameter can be a - static integer or a varaible holding an integer. + The sleep parameter represent the number of seconds to suspend the + processing of a SIP request. Maximum value is 100. The parameter can be + a static integer or a variable holding an integer.
- Since the SIP request handling is resumed in another process, - practically the config file execution state is lost. Therefore beware - that the execution of config after resume will end once the - route[routename] is finished. + Since the SIP request handling is resumed in another process, the + config file execution state is practically lost. Therefore beware that + the execution of config after resume will end once the route[routename] + is finished.
This function can be used from REQUEST_ROUTE.
@@ -142,17 +143,11 @@ route[RESUME] {
Simulate a sleep of 'seconds' and then continue the processing of SIP request with the next action. In case of internal errors, the function - returns false, otherwise the function exits the execution of config at - that moment (return 0 behaviour). + returns false.
- The sleep parameter represent the number of seconds to suppend the + The sleep parameter represent the number of seconds to suspend the processing of SIP request. Maximum value is 100. The parameter can be a - static integer or a varaible holding an integer. - - Since the SIP request handling is resumed in another process, - practically the config file execution state is lost. Therefore beware - that the execution of config after resume will end once the route block - where async_sleep() is called is finished. + static integer or a variable holding an integer.
This function can be used from REQUEST_ROUTE.
diff --git a/modules/async/doc/async_admin.xml b/modules/async/doc/async_admin.xml index e4ddde4..b8744b9 100644 --- a/modules/async/doc/async_admin.xml +++ b/modules/async/doc/async_admin.xml @@ -16,17 +16,17 @@ <section> <title>Overview</title> <para> - This module provides asynchornous operations for handling SIP requests - in configuration file. + This module provides asynchronous operations for handling SIP requests + in the configuration file. </para> <para> - It uses t_suspend() and t_continue() from TM module. + Async uses t_suspend() and t_continue() from the TM and TMX modules. </para> <para> - Note that after invoking the an asyncronous operation, the processing - will continue later, in another application process. Therefore, do not - rely on variables stored in private memory, used shared memory if you - want to get values after the processing is resumend (e.g., $avp(...), + Note that after invoking the an asynchronous operation, the processing + will continue later in another application process. Therefore variables + stored in private memory should not be used, try to use shared memory if you + want to get values after the processing is resumed (e.g., $avp(...), $xavp(...), $shv(...), htable $sht(...)). </para> </section> @@ -42,6 +42,9 @@ <para> <emphasis>tm</emphasis> - transaction management. </para> + <para> + <emphasis>tmx</emphasis> - transaction management extensions. + </para> </listitem> </itemizedlist> </para> @@ -66,7 +69,7 @@ <section> <title><varname>workers</varname> (int)</title> <para> - Number of worker processes to be started to handle the asynchornous + Number of worker processes to be started to handle the asynchronous tasks. </para> <para> @@ -92,23 +95,23 @@ modparam("async", "workers", 2) <function moreinfo="none">async_route(routename, seconds)</function> </title> <para> - Simulate a sleep of 'seconds' and then continue the processing of SIP + Simulate a sleep of 'seconds' and then continue the processing of the SIP request with the route[routename]. In case of internal errors, the function returns false, otherwise the function exits the execution of - config at that moment (return 0 behaviour). + the script at that moment (return 0 behaviour). </para> <para> The routename parameter can be a static string or a dynamic string value with config variables. </para> <para> - The sleep parameter represent the number of seconds to suppend the - processing of SIP request. Maximum value is 100. The parameter can be - a static integer or a varaible holding an integer. + The sleep parameter represent the number of seconds to suspend the + processing of a SIP request. Maximum value is 100. The parameter can be + a static integer or a variable holding an integer. </para> <para> Since the SIP request handling is resumed in another process, - practically the config file execution state is lost. Therefore beware + the config file execution state is practically lost. Therefore beware that the execution of config after resume will end once the route[routename] is finished. </para> @@ -137,19 +140,12 @@ route[RESUME] { <para> Simulate a sleep of 'seconds' and then continue the processing of SIP request with the next action. In case of internal errors, the function - returns false, otherwise the function exits the execution of config - at that moment (return 0 behaviour). + returns false. </para> <para> - The sleep parameter represent the number of seconds to suppend the + The sleep parameter represent the number of seconds to suspend the processing of SIP request. Maximum value is 100. The parameter can be - a static integer or a varaible holding an integer. - </para> - <para> - Since the SIP request handling is resumed in another process, - practically the config file execution state is lost. Therefore beware - that the execution of config after resume will end once the route block - where async_sleep() is called is finished. + a static integer or a variable holding an integer. </para> <para> This function can be used from REQUEST_ROUTE.