Module: sip-router Branch: master Commit: e09b92893fd35baf672541143951337b103bb65b URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=e09b9289...
Author: Olle E. Johansson oej@edvina.net Committer: Olle E. Johansson oej@edvina.net Date: Mon Dec 3 08:10:34 2012 +0100
mqueue: README update
---
modules/mqueue/README | 25 +++++++++++++------------ 1 files changed, 13 insertions(+), 12 deletions(-)
diff --git a/modules/mqueue/README b/modules/mqueue/README index 4206a19..8d41f8a 100644 --- a/modules/mqueue/README +++ b/modules/mqueue/README @@ -72,12 +72,13 @@ Chapter 1. Admin Guide
1. Overview
- This module offers generic message queue system in shared memory for - inter-process communication via config file. One example of usage is to - send time consuming operations to a timer process that consumes items - in the queue, without affecting SIP message handling. + The mqueue module offers a generic message queue system in shared + memory for inter-process communication using the config file. One + example of usage is to send time consuming operations to one or several + timer processes that consumes items in the queue, without affecting SIP + message handling in the socket-listening process.
- There can be defined many queues, access to values being done via + There can be many defined queues. Access to queued values is done via pseudo variables.
2. Dependencies @@ -102,7 +103,7 @@ Chapter 1. Admin Guide
3.1. mqueue (string)
- Definition of memory queue + Definition of a memory queue
Default value is "none".
@@ -111,7 +112,7 @@ Chapter 1. Admin Guide specifies the maximum number of items in queue, if it is execeeded the oldest one is removed.
- The parameter can be set many time, each holding the definition of one + The parameter can be set many times, each holding the definition of one queue.
Example 1.1. Set mqueue parameter @@ -127,7 +128,7 @@ modparam("mqueue", "mqueue", "name=qaz") 4.3. mq_pv_free(queue) 4.4. mq_size(queue)
-4.1. mq_add(queue, key, value) +4.1. mq_add(queue, key, value)
Add a new item (key, value) in the queue. If max size of queue is exceeded, the oldest one is removed. @@ -137,7 +138,7 @@ modparam("mqueue", "mqueue", "name=qaz") mq_add("myq", "$rU", "call from $fU"); ...
-4.2. mq_fetch(queue) +4.2. mq_fetch(queue)
Take oldest item from queue and fill $mqk(queue) and $mqv(queue) pseudo variables. @@ -153,17 +154,17 @@ while(mq_fetch("myq")) } ...
-4.3. mq_pv_free(queue) +4.3. mq_pv_free(queue)
Free the item fetched in pseudo-variables. It is optional, a new fetch - frees the old values. + frees the previous values.
Example 1.4. mq_pv_free usage ... mq_pv_free("myq"); ...
-4.4. mq_size(queue) +4.4. mq_size(queue)
Returns the current number of elements in the mqueue.