[sr-dev] git:master: htable: elaborated docs about sht_lock() and sht_unlock()

Module: sip-router Branch: master Commit: 44269cd654a6ab0557ca242f25ec41158e7dcbaf URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=44269cd… Author: Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; Committer: Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; Date: Sat Nov 8 11:10:11 2014 +0100 htable: elaborated docs about sht_lock() and sht_unlock() --- modules/htable/README | 8 ++++++-- modules/htable/doc/htable_admin.xml | 8 ++++++-- 2 files changed, 12 insertions(+), 4 deletions(-) diff --git a/modules/htable/README b/modules/htable/README index 1a0ec5c..8ffde42 100644 --- a/modules/htable/README +++ b/modules/htable/README @@ -672,7 +672,9 @@ sht_reset("ha$var(x)"); 4.5. sht_lock(htable=>key) - Lock the slot in htable corespoding to the key item. + Lock the slot in htable corespoding to the key item. Note that the + locking is re-entrant for the process, therefore the lock and unlock + should be done by the same process. This function can be used from ANY_ROUTE. @@ -683,7 +685,9 @@ sht_lock("ha=>test"); 4.6. sht_unlock(htable=>key) - Unlock the slot in htable corespoding to the key item. + Unlock the slot in htable corespoding to the key item. Note that the + locking is re-entrant for the process, therefore the lock and unlock + should be done by the same process. This function can be used from ANY_ROUTE. diff --git a/modules/htable/doc/htable_admin.xml b/modules/htable/doc/htable_admin.xml index 9b5fe7a..2e78d0c 100644 --- a/modules/htable/doc/htable_admin.xml +++ b/modules/htable/doc/htable_admin.xml @@ -741,7 +741,9 @@ sht_reset("ha$var(x)"); <function moreinfo="none">sht_lock(htable=>key)</function> </title> <para> - Lock the slot in htable corespoding to the key item. + Lock the slot in htable corespoding to the key item. Note that + the locking is re-entrant for the process, therefore the lock + and unlock should be done by the same process. </para> <para> This function can be used from ANY_ROUTE. @@ -760,7 +762,9 @@ sht_lock("ha=>test"); <function moreinfo="none">sht_unlock(htable=>key)</function> </title> <para> - Unlock the slot in htable corespoding to the key item. + Unlock the slot in htable corespoding to the key item. Note that + the locking is re-entrant for the process, therefore the lock + and unlock should be done by the same process. </para> <para> This function can be used from ANY_ROUTE.