Module: kamailio
Branch: master
Commit: cce29af41120cf30c4c22979e772d1ca666408c6
URL: 
https://github.com/kamailio/kamailio/commit/cce29af41120cf30c4c22979e772d1ca666408c6

Author: Daniel-Constantin Mierla <mico...@gmail.com>
Committer: Daniel-Constantin Mierla <mico...@gmail.com>
Date: 2024-10-16T11:46:37+02:00

async: docs updates for async_sleep()

---

Modified: src/modules/async/doc/async_admin.xml

---

Diff:  
https://github.com/kamailio/kamailio/commit/cce29af41120cf30c4c22979e772d1ca666408c6.diff
Patch: 
https://github.com/kamailio/kamailio/commit/cce29af41120cf30c4c22979e772d1ca666408c6.patch

---

diff --git a/src/modules/async/doc/async_admin.xml 
b/src/modules/async/doc/async_admin.xml
index 027cea11ed7..152c6be5db7 100644
--- a/src/modules/async/doc/async_admin.xml
+++ b/src/modules/async/doc/async_admin.xml
@@ -234,8 +234,11 @@ route[RESUME] {
                </title>
                <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.
+               request with the next action. Note that the processing 
continues till
+               the last action in the current route block. Consider using 
async_route()
+               instead if you want to control better what is executed after 
the wait
+               time. Beacuse the execution is resumed in another process, do 
not use
+               private memory variables before and after the async sleep.
                </para>
                <para>
                The sleep parameter represent the number of seconds to suspend 
the
@@ -243,6 +246,9 @@ route[RESUME] {
                a static integer or a variable holding an integer.
                </para>
                <para>
+               In case of internal errors, the function returns false.
+               </para>
+               <para>
                This function can be used from REQUEST_ROUTE.
                </para>
                <example>
@@ -262,15 +268,13 @@ exit;
                <function 
moreinfo="none">async_ms_sleep(milliseconds)</function>
                </title>
                <para>
-               Simulate a sleep of 'milliseconds' and then continue the 
processing of SIP
-               request with the next action. In case of internal errors, the 
function
-               returns false.
-               This function works only if the ms_timer parameter has a value 
greater than 0.
+               Similar to async_sleep(), but with a 'milliseconds' parameter. 
This
+               function works only if the ms_timer parameter has a value 
greater than 0.
                </para>
                <para>
                The sleep parameter represent the number of milliseconds to 
suspend the
-               processing of SIP request. Maximum value is 30000 (30 sec). The 
parameter can be
-               a static integer or a variable holding an integer.
+               processing of SIP request. Maximum value is 30000 (30 sec). The 
parameter
+               can be a static integer or a variable holding an integer.
                </para>
                <para>
                This function can be used from REQUEST_ROUTE.

_______________________________________________
Kamailio (SER) - Development Mailing List
To unsubscribe send an email to sr-dev-le...@lists.kamailio.org

Reply via email to